Для большинства сущностей в системе возможно определение настраиваемых параметров. Редактирование перечня параметров осуществляется в оснастке Администрирование=>Параметры интерфейса администратора. Выбор сущности, для которой определяются параметры, производится в выпадающем списке. Список сущностей может расширяться при установке плагинов.

...

Таблица параметров сущности выглядит подобным образом. Порядок записи в таблице определяется числовым полем Порядок параметра, либо порядком, задаваемым при привязке к типу процесса либо группе параметров.

Свойство Скрипт параметра позволяет установить динамический класс, обрабатывающий события изменения параметра.

...

# коды параметров сущности, которые должны быть заполнены перед установкой данного параметра
requireBeforeFillParamIds=<codes>
# коды параметров сущности, которые должны быть пустыми перед установкой данного параметра
requireBeforeEmptyParamIds=<codes>
# теги параметра через запятую - тегированный параметр можно просматривать или править 
# только явно разрешив тег в настройке прав на изменение параметра либо просмотр параметров
tags=<tags>
# редактор параметра недоступен (параметр загружается посредством API к БД либо HTTP API)
readonly=1 

Где:

• <codes> - коды параметров через запятую;
• <tags> - теги через запятую.

Группы параметров контрагентов

Группа параметров необходима для ограничения списка параметров контрагента определённого объекта. Например: "Физическое лицо", "Юридическое лицо".

Шаблоны названия контрагентов

Шаблон названия позволяет устанавливать зависимость названия объектов от его параметров. Подстановка параметров осуществляется макросами вида ${param_<code>}, где <code> - уникальный код параметра. Так, например, возможна генерация названия контрагента юридического лица из параметров спискового "Форма собственности" и текстового "Наименование организации", что предотвращает дублирование информации. При изменении параметров в дальнейшем наименование объекта будет правиться автоматически.

Параметр типа "text"

Однострочная строка до 250 символов.

...

saveOn=<saveOn>
# параметр содержит URL, в просмотре параметров отображение ссылки перехода по ссылке
showAsLink=1
# вместо значение параметра выводится <ЗНАЧЕНИЕ ЗАШИФРОВАНО>, параметр можно только поправить, нельзя просмотреть
encrypt=encrypted

Где:

• <saveOn> - режим сохранения, может быть "focusLost", по-умолчанию сохранение производится по нажатию кнопки Ок либо Enter.

...

regexp.<n>.title=<title> 
regexp.<n>.regexp=<regexp>

Где:

• <n> - число, порядковый номер регулярного выражения;
• <title> - наименование шаблона;
• <regexp> - Java регулярное выражение REGEXP, описывающее шаблон.

При наличии в конфигурации текстового параметра подобных конструкций вводимая строка будет проверяться на совпадение хотя бы с одним из шаблонов, например:

...

В таблице параметр выглядит следующим образом.

Параметр типа "blob"

Большая многострочная строка до 65000 символов.

...

rows=<rows>
saveOn=<saveOn>

Где:

• <rows> - количество отображаемых в редакторе строк, по-умолчанию 4;
• <saveOn> - режим сохранения, может быть "focusLost" (потеря фокуса полем), по-умолчанию сохранение производится по нажатию кнопки Ок.

В таблице параметр выглядит следующим образом.

Параметр типа "list"

Параметр с выбираемыми из набора значениями. Значения могут быть определены как конфигурации параметра так и во внешнем справочнике, на который ссылается параметр. Для некоторых значений можно добавить возможность или установить обязательное требование указания комментария.

...

# мультивыбор
multiple=1
# сохранение сразу после выбора значения, без нажатия кнопки Ок (только для параметра с одним выбором) 
saveOn=select
editAs=<editAs>
#
# сортировка значений по наименованию а не в порядке кодов
sort.mode=byTitle
#
allowCommentValues=<allowCommentValues>
needCommentValues=<needCommentValues>
#
directory=<dirName>
availableValues=<values>
availableValuesInnerJoinFilter=<joinTable>;<joinColumn>;<joinFilter>

Где:

• <editAs> - может принимать значения combo - по-умолчанию, выпадающий список, radio - выбор значения в виде переключателей, select - выпадающий список с возможностью поиска значения;
• <dirName> - справочник, из которого берутся значения, может быть "address_city" для городов, если справочника нет - значения указываются в самом параметре;
• <values> - допустимые коды значений через запятую;
• <allowCommentValues> - перечень значений для которых допустимо указание комментария, возможно указание диапазонов, например: 1-3,7,9-14
• <needCommentValues> - перечень значений для которых обязателен комментарий, указывается аналогично <allowCommentValues>;
• <joinTable> - имя таблицы, с которой осуществляется фильтрующая операция SQL INNER JOIN справочной таблицы;
• <joinColumn> - колонка таблицы, по которой проводится JOIN столбца id справочной таблицы;
• <joinFilter> - дополнительное условие INNER JOIN.

...

Пример параметра с несколькими значениями (мультивыбор). Конфигурация - как выглядит в таблице и редактирование.

Параметр типа "listcount"

Позволяет выбирать перечислимые значения с указанием количества для них. На снимке экрана ниже - редактор свойств параметра, конфигурирование значений аналогично параметру типа "list".

Image Added

В таблице параметров.

Image Added

Редактор.

Image Added

Поддержка дробных значений позволяет учитывать, например, метраж кабеля и прочие нецелые количества. Дробные значения вводятся через точку.

Параметр типа "tree"

Допустимые значения могут быть организованы в дерево.

В конфигурации параметра могут быть указаны следующие необязательные параметры:

# несколько значений в дереве
multiple=1

Как выглядят конфигурация, таблица параметров и редактирование.

Image Added

Image Added

Image Added

Параметр типа "date"

Дата: год - месяц - день.

...

# возможность смены месяца
changeMonth=true
# возможность смены года
changeYear=true
yearRange=<yearRange>
# возможность редактирования поля с клавиатуры
editable=1
saveOn=<saveOn>
# при редактировании поля отправка классу-обработчику изменений параметра события ru.bgcrm.event.DateChangingEvent, позволяющего раскрашивать даты различными цветами и сопровождать примечаниями 
#sendColorMapRequest=1

Где:

• <yearRange> - диапазон отображаемых лет в выпадающем списке годов, могут быть значения от текущего года (, например: -10:+30) , либо значения от текущей выбранной даты (, например: c:-10:c+30), по-умолчанию с-10:с+10;
• <saveOn> - режим сохранения, может быть "focusLost" (потеря фокуса полем) либо "enter" (нажатие клавиши "Enter"), по-умолчанию режим "enter"; актуально только при editable=1.

В таблице параметр и его редактор выглядят следующим образом.

Параметр типа "datetime"

Дата + время различной точности.

...

type=<type>
stepHour=<stepHour>
stepMinute=<stepMinute>
#
# при редактировании поля отправка классу-обработчику изменений параметра события ru.bgcrm.event.DateChangingEvent, позволяющего раскрашивать даты различными цветами и сопровождать примечаниями 
#sendColorMapRequest=1

Где:

• <type> - может принимать значения ymdh, ymdhm, ymdhms в зависимости от требуемой точности поля;
• <stepHour> - шаг в выборе часов;
• <stepMinute> - шаг в выборе минут.

Пример параметра. Конфигурация, как выглядит в таблице и редактирование.

Параметр типа "address"

Адресный, ссылающийся на дом в справочнике адресов.

...

Параметр типа "phone"

Один или несколько телефонов с комментариями.

...

Параметр типа "email"

Один или несколько EMail адресов либо только адресов доменов с комментариями.

...

Как выглядит в таблице и редактирование.

Параметр типа "file"

Один или несколько файлов.

...