Пользовательские поля — различия между версиями

Материал из Меасофт
Перейти к: навигация, поиск
м
 
(не показано 11 промежуточных версий 5 участников)
Строка 1: Строка 1:
Пользовательские поля прикрепляются как отдельные вкладки (с именем "Пользовательская") к карточкам заказа, корреспонденции, курьера, клиента и зарплата сотрудникам. По умолчанию вкладки скрыты, чтобы они появились необходимо прописать поля и их типы в Справочники -> Статусы.
+
Пользовательские поля отображаются на вкладке '''Пользовательская''' в карточках следующих объектов системы:
В статусах определены следующие типы:
+
* заказ;
*Пользовательские поля для клиентов
+
* корреспонденция;
*Пользовательские поля для курьеров
+
* сотрудник;
*Пользовательские поля для корреспонденции
+
* клиент;
*Пользовательские поля для заказов
+
* тариф;
*Пользовательские поля для зарплаты
+
* зарплата сотрудников.
  
Одно пользовательское поле соответствует одному статусу, название статуса будет использовано как название пользовательского поля. Тип пользовательского поля определяется в дополнительной информации статуса.
+
По умолчанию вкладки скрыты. Чтобы они отобразились, укажите поля и их типы в '''Справочники''' > '''Статусы''' > '''42 Пользовательские поля'''.
  
Формат записи: ''Видимость, тип поля [, параметры в зависимости от типа ]''
+
Одно пользовательское поле соответствует одному статусу, название статуса используется как название пользовательского поля. Тип поля определяется в дополнительной информации статуса.
  
Пример записи: ''1, DATE, 01.01.2013''
+
Формат записи: <code>Видимость, тип поля, [параметры в зависимости от типа]</code>
  
'''первый параметр''' указывает,  отображается поле или нет :<br/>
+
Пример записи:
*1 - отображается
+
1, DATE, 01.01.2020
*0 - скрыто
 
  
'''второй параметр''' определяет тип поля:
+
Первый параметр указывает, отображается поле или нет:
*INT – вводит целое число (как UPDOWN, с границами диапазона от -1000000 до 1000000)
+
* '''1''' — отображается;
*STR – вводит строку
+
* '''0''' — скрыто.
*CUSTSTR – вводит строку, но не экранирует ее при подстановке в запрос
+
Этот параметр устарел, хоть и поддерживается. Рекомендуется управлять видимостью поля с помощью пункта контекстного меню '''Выключить/Включить'''.
*FLOAT – вводит число с плавающей точкой
 
*CHECK – вводит булево значение (отображается на форме в виде галочки)
 
*DATE – вводит дату
 
*COMBO - вводит текст с возможностью выбора из выпадающего списка
 
*COMBOLIST - вводит текст из выпадающего списка
 
*UPDOWN - вводит целое число со стрелками уменьшения/увеличения
 
*(Типы FILESTR и SAVEFILESTR не поддерживаются)
 
  
'''третий параметр''' это значение по умолчанию (в случае с COMBOBOX, третий параметр это sql запрос для заполнения, а четвёртый номер записи из списка)
+
Второй параметр определяет тип поля:
 +
* INT — вводит целое число (как UPDOWN, с границами диапазона от −1000000 до 1000000);
 +
* STR — вводит строку;
 +
* CUSTSTR — вводит строку, но не экранирует ее при подстановке в запрос;
 +
* FLOAT — вводит число с плавающей точкой;
 +
* CHECK — вводит булево значение, отображается на форме в виде флажка;
 +
* DATE — вводит дату;
 +
* COMBO — вводит текст с возможностью выбора из выпадающего списка;
 +
* COMBOLIST — вводит текст из выпадающего списка;
 +
* UPDOWN — вводит целое число со стрелками уменьшения/увеличения, с возможностью определения диапазона (пример: UPDOWN, 0-100, 1);
 +
* (типы FILESTR и SAVEFILESTR не поддерживаются);
 +
* GROUPBOX — создает панель и помещает на нее последующие поля. Можно добавлять все поля или только указанное количество в третьем параметре. Пример: GROUPBOX, название группы;
 +
* CHECKLISTBOX - выводит список с галочками.
  
Все три параметра нужно указывать обязательно.
+
Третий параметр — значение по умолчанию.
  
  примеры объявления  
+
Все три параметра обязательные.
 +
 
 +
'''Особенности:'''
 +
* для поля типа COMBOBOX третий параметр — это SQL-запрос для заполнения, а четвёртый — номер записи из списка;
 +
* для поля типа CHECKLISTBOX третий параметр — это SQL-запрос для заполнения, в котором поля name и code соответственно наименование и внутренний код для сохранения, если пункт отмечен. Коды сохраняются через запятую. Если не отмечено ничего, сохраняется 0.
 +
* для поля типа UPDOWN третий параметр — это границы диапазона изменения значений (указываются через тире), а четвертый — значение по умолчанию. Пример использования: 1,UPDOWN,0-100,1 — поле с возможностью выбора значения с помощью стрелок уменьшения/увеличения, возможные значения поля лежат в диапазоне от 0 до 100, значение по умолчанию равно 1.
 +
 
 +
Примеры объявления  
 
   1, COMBOLIST, 'Нет, Вечерний менеджер 1, Вечерний менеджер 2', 'Нет'
 
   1, COMBOLIST, 'Нет, Вечерний менеджер 1, Вечерний менеджер 2', 'Нет'
 
   1, COMBOLIST, 'Нет, Вечерний менеджер 1, Вечерний менеджер 2', 0
 
   1, COMBOLIST, 'Нет, Вечерний менеджер 1, Вечерний менеджер 2', 0
Строка 40: Строка 51:
  
 
При наличии хотя бы одного видимого поля вкладка будет отображена.
 
При наличии хотя бы одного видимого поля вкладка будет отображена.
 +
 +
== Пример использования ==
 +
 +
Чтобы только для конкретных клиентов работала отправка электронного сообщения с отчетом о доставленных заказах:
 +
# Перейдите в '''Справочники''' > '''Статусы''' > '''42 Пользовательские поля''' > '''Пользовательские поля для клиентов''' и нажмите на кнопку F3.
 +
# В окне «Создание статуса» введите название поля.
 +
# В контекстном меню созданного статуса выберите пункт '''Дополнительная информация''', укажите строкой параметры <code>1, CHECK, F</code> и нажмите на кнопку '''ОК'''.
 +
 +
В результате в карточке клиента появится вкладка '''Пользовательская''', и будет создан флажок:
 +
 +
[[Файл:UserField_1.png|500 px|none]]
 +
 +
Если установить флажок в карточке клиента, будет работать отправка электронного сообщения (при наличии задания в модуле автоматизации).

Текущая версия на 14:27, 31 мая 2023

Пользовательские поля отображаются на вкладке Пользовательская в карточках следующих объектов системы:

  • заказ;
  • корреспонденция;
  • сотрудник;
  • клиент;
  • тариф;
  • зарплата сотрудников.

По умолчанию вкладки скрыты. Чтобы они отобразились, укажите поля и их типы в Справочники > Статусы > 42 Пользовательские поля.

Одно пользовательское поле соответствует одному статусу, название статуса используется как название пользовательского поля. Тип поля определяется в дополнительной информации статуса.

Формат записи: Видимость, тип поля, [параметры в зависимости от типа]

Пример записи:

1, DATE, 01.01.2020

Первый параметр указывает, отображается поле или нет:

  • 1 — отображается;
  • 0 — скрыто.

Этот параметр устарел, хоть и поддерживается. Рекомендуется управлять видимостью поля с помощью пункта контекстного меню Выключить/Включить.

Второй параметр определяет тип поля:

  • INT — вводит целое число (как UPDOWN, с границами диапазона от −1000000 до 1000000);
  • STR — вводит строку;
  • CUSTSTR — вводит строку, но не экранирует ее при подстановке в запрос;
  • FLOAT — вводит число с плавающей точкой;
  • CHECK — вводит булево значение, отображается на форме в виде флажка;
  • DATE — вводит дату;
  • COMBO — вводит текст с возможностью выбора из выпадающего списка;
  • COMBOLIST — вводит текст из выпадающего списка;
  • UPDOWN — вводит целое число со стрелками уменьшения/увеличения, с возможностью определения диапазона (пример: UPDOWN, 0-100, 1);
  • (типы FILESTR и SAVEFILESTR не поддерживаются);
  • GROUPBOX — создает панель и помещает на нее последующие поля. Можно добавлять все поля или только указанное количество в третьем параметре. Пример: GROUPBOX, название группы;
  • CHECKLISTBOX - выводит список с галочками.

Третий параметр — значение по умолчанию.

Все три параметра обязательные.

Особенности:

  • для поля типа COMBOBOX третий параметр — это SQL-запрос для заполнения, а четвёртый — номер записи из списка;
  • для поля типа CHECKLISTBOX третий параметр — это SQL-запрос для заполнения, в котором поля name и code соответственно наименование и внутренний код для сохранения, если пункт отмечен. Коды сохраняются через запятую. Если не отмечено ничего, сохраняется 0.
  • для поля типа UPDOWN третий параметр — это границы диапазона изменения значений (указываются через тире), а четвертый — значение по умолчанию. Пример использования: 1,UPDOWN,0-100,1 — поле с возможностью выбора значения с помощью стрелок уменьшения/увеличения, возможные значения поля лежат в диапазоне от 0 до 100, значение по умолчанию равно 1.

Примеры объявления

 1, COMBOLIST, 'Нет, Вечерний менеджер 1, Вечерний менеджер 2', 'Нет'
 1, COMBOLIST, 'Нет, Вечерний менеджер 1, Вечерний менеджер 2', 0
 1, COMBOLIST, 'select "Нет SMS" as name union select "SMS Обычные" union select "SMS Китай"', 0
 1, STR, ''

При наличии хотя бы одного видимого поля вкладка будет отображена.

Пример использования

Чтобы только для конкретных клиентов работала отправка электронного сообщения с отчетом о доставленных заказах:

  1. Перейдите в Справочники > Статусы > 42 Пользовательские поля > Пользовательские поля для клиентов и нажмите на кнопку F3.
  2. В окне «Создание статуса» введите название поля.
  3. В контекстном меню созданного статуса выберите пункт Дополнительная информация, укажите строкой параметры 1, CHECK, F и нажмите на кнопку ОК.

В результате в карточке клиента появится вкладка Пользовательская, и будет создан флажок:

UserField 1.png

Если установить флажок в карточке клиента, будет работать отправка электронного сообщения (при наличии задания в модуле автоматизации).