Описание реквизитов класса:
• Системное имя - имя таблицы в базе данных;
• Название - наименование класса, которое будет отображаться в интерфейсе Системы для пользователей (название может быть изменено в конфигурационных настройках рабочего стола системного администратора);
• Тип - тип класса (не доступно для редактирования). Значение подставляется автоматически (CONTENT, LINK, TASK_OBJECT, VALUE_OBJECT, VERSIONABLE_OBJECT) при создании класса к одному из родительских классов.
• Тип хранилища - определяет базу данных, используемую для хранения объектов. Доступно одно из следующих значений: − CE – Content Engine (хранится в объектном хранилище);
− PE – Process Engine (хранится на бизнес-процессе).
• Является виртуальным – установка данного флага в момент создания класса, говорит, что класс не создается и не хранится в базе данных;
• Идентификатор - внутренний идентификатор класса в базе данных;
Если сущность хранит состояние процесса, то необходимо использовать тип хранилища РЕ. Объекты с типом хранилища РЕ создаются при запуске бизнес-процесса и существуют до завершения бизнес-процесса. В остальных случаях необходимо использовать тип хранилища CE.
Смена класса
Система предоставляет возможность переноса дочерних классов из одно родительского класса к другому родительскому классу. Для этого необходимо выбрать класс, которому требуется сменить родительский класс, кликнуть по инструменту «Сменить класс», выбрать из выпадающего списка (содержит все классы дерева модели данных) новый родительский класс и подтвердить действие. Выбранный ранее класс будет успешно перенесен к новому родительскому классу.
4.1.2 Описание свойства класса
Для создания нового свойства класса необходимо в дереве родительских классов выбрать родительский класс, в котором будет создано новое свойство, и кликнуть на инструмент “Создать свойство”. Экран будет разделен на две части: слева отображено дерево с классами и свойствами, а справа реквизиты выбранного в дереве класса или свойства. Затем требуется заполнить информацию о свойстве класса и нажать инструмент “Сохранить свойство”.
Описание реквизитов свойства класса:
• Системное имя - имя столбца таблицы в базе данных;
• Название - имя свойства, которое будет отображаться в интерфейсе системы для пользователей (название может быть изменено в конфигурационных настройках рабочего стола системного администратора);
• Тип данных - тип данных свойства. Доступно одно из следующих значений:
− BOOLEAN – логический тип данных (значения true/false);
− FLOATRANGE – тип вещественного числа с плавающей запятой;
− DATE – тип данных дата;
− STRING – строковый тип данных;
− JSON – тип используется для доп. настройки полей;
− POINT – тип данных точка. Используется для полей с геоданными; − LINE –тип данных линия. Используется для полей с геоданными; − POLYGON – тип данных полигон. Используется для полей с геоданными;
− GUID – глобальный идентификатор;
− DATERANGE – тип используется для работы с диапазонами дат;
− TEXT – тип текст, большая колонка.
− TIME –тип данных время;
− DOUBLE – тип данных для чисел с плавающей запятой
− LONGRANGE – тип данных используется для работы с диапазоном чисел 8 байт.
− LONG – тип данных число 8 байт.
− PASSWORD – тип используется для хранения пароля в зашифрованном виде;
− TSVECTOR – тип используется для полнотекстового поиска
(FullTextSearch).
Метод отображения - тип отображения данных. Метод отображения данных можно указать редакторе классов в поле “Метод отображения” для свойства объекта или переопределив параметр “templateName” в карточке объекта, указав необходимый метод отображения.
Доступно одно из следующих значений:
− dateTimePicker – вывод даты в формате «dd.MM.yyyy HH:mm:ss»;
− datePicker – дата в формате «dd.MM.yyyy». Значение по умолчанию для полей с типом дата;
− textarea – многострочное текстовое значение (соответствует установленному чек-боксу “Большая колонка” в редакторе классов для свойства класса);
− currency – отображение валют. Разделитель тысяч - пробел, разделитель дробной части - запятая, отображение 2-х знаков после запятой (для типа данных FLOAT, DOUBLE).
− select – выбор одного значения из справочника;
− multiselect – выбор одного или нескольких значений из справочника. Для свойства в редакторе классов должен быть установлен чек-бокс “Является множественным”;
− input – однострочное текстовое значение. Значение по умолчанию для большинства полей;
− choiceIcon – отображение иконки, рядом с полем, соответствующая выбранному значению в справочнике;
− password - поле для ввода пароля, вводимые символы отображаются звездочками, точками или другими знаками (в зависимости от используемого браузера);
− checkbox – поле типа «флаг», значение установлено/значение не установлено. Значение по умолчанию для полей типа Boolean;
− currency – отображение валют. Разделитель тысяч - пробел, разделитель дробной части - запятая, отображение 2-х знаков после запятой (для типа данных FLOAT, DOUBLE).
Дополнительный параметр “null_value” - который позволяет задать значение по умолчанию, если поле пусто (например: -, 0).
При этом в поле «Пользовательская конфигурация поля (JSON)» необходимо указать:
{
"currency" :
{
"null_value": "-"
}
}
− loadData - быстрый поиск значений справочника. В основном используется для справочников, которые содержат большое количество данных. Для реализации необходимо добавить в редакторе классов для свойства в поле «Пользовательская конфигурация поля (JSON)» следующий код:
{
"dataController":"ChoiceLiveSearch",
"dataService":"choiceLiveSearchService"
}
Примечание: Если требуется добавить быстрый поиск по справочнику в фильтр в папке, то необходимо в конфигурацию (Поиски) добавить параметр “renderer”: “loadData”.
− attachmentList - отображение списка вложений (для свойства ‘Files’) в карточке объект
Пример конфигурации:
{ "panels": [
{ "legend": "Значения параметра templateName в карточке объекта",
"componentsRows": [
{"components": [ {"cssClass": "span6", "propName":
"DocumentStatus","label":"choiceIcon","templateName":
"choiceIcon"},
{"cssClass": "span4", "propName": "checkbox",
"templateName":"checkbox"}]},
{"components": [ {"cssClass": "span6", "propName":
"Test","label":"password", "templateName": "password"},
{"cssClass": "span3", "propName": "currency",
"templateName":"currency"}]}
]
},
{ "legend": "Отображение параметра attachmentList в templateName",
"componentsRows": [
{"components": [ {"cssClass": "span8", "propName":
"Files", "templateName": "attachmentList","required": true}]}
]
}
]
}
− staticText - отображение статического текста с сообщением пользователю. Дополнительный параметр params: messageCode - сообщение, с поддержкой интернационализации.
Пример конфигурации:
{"components": [{"cssClass": "span6", "propName": "Code",
"templateName": "staticText",
"params": {"messageCode": "Штрих код не
распознан, повторите сканирование"}}]}
− hidden – скрытое поле, на карточке не отображается;
− code – отображение конфигурационных скриптов. Дополнительный параметр “mode”, который отвечает за подсветку синтаксиса для кода скриптов. Доступны два значения: groovy или json; Пример конфигурации:
"components": [ {"cssClass": "span8", "propName": "TestCode",
"templateName": "code", "params":{"mode":"json"}}]}
• Справочник - имя справочника, из которого необходимо отобрать значения. Используется для полей, содержащих список значений для выбора;
• Шаблон атрибута - имя шаблона атрибут. Данный параметр добавляется только для свойств с типом данным STRING. Шаблон атрибутов позволяет выполнять арифметические операции (тип данных свойств объекта должен совпадать), а также указывать различные условия (if).;
• Сортируемое - в табличном отображении папки для столбца с данными добавляется кнопка, позволяющая сортировать значения по возрастанию/убыванию, если флаг установлен;
• Обязательно для заполнения - при установленном флаге, поле в карточке объекта помечается как обязательное для заполнения;
• Только для чтения - установленный флаг означает, что поле доступно только для чтения;
• Является множественным - установленный флаг означает, что в поле доступно введение нескольких значений установленного типа;
• Является уникальным – установленный флаг говорит, что в поле будут содержаться только уникальные данные;
• Является скрытым - установленный флаг означает, что поле не будет отображаться в карточке объекта;
• Подсказка – введенное строковое значение будет отображено пользователю Системы при взаимодействии со свойством.
• Значение по умолчанию - значение, которое будет отображаться в поле при создании карточки объекта;
− Можно передавать значение справочника, указав значение свойства, по которому настроен поиск в справочнике (напр.: 789).
− Можно передавать массив значений справочника, в формате: [5,10,12] - числовые значения (ID) или ["appAdmin", "user"] - строковые значения.
Примечание: Свойство должно являться множественным (чек-бокс установлен) и метод отображения указан - multiselect.
• Максимальная длина - максимальное количество символов допустимых в поле;
• Пользовательская конфигурация поля (JSON) - поддерживает json-скрипт, определяет поведение поля (например, задается правило, по которому вычисляется поле);
• Является системным – свойство недоступно для редактирования и используется для выполнения системных операций;
• Является виртуальным – обозначает, что свойство класса не создается и не хранится в базе данных;
• Родительский класс – автоматически заполняется названием родительского класса для которого создается свойство;
• Идентификатор - внутренний ID свойства класса в базе данных;
Система поддерживает наследование свойств классов. Дочерний класс наследует все свойства родительского класса.
Переопределение свойств классов
Система предоставляет возможность переопределения поведения свойств
родительского класса для дочерних классов. Например, изменить шаблон атрибута, значение по умолчанию, метод отображения, справочник, но нельзя переопределять системное имя и
название свойства.
4.1.3 Удаление классов и свойств
Для удаления класса или свойства класса необходимо установить флаг напротив нужного элемента модели данных и нажать инструмент «Удалить свойство»/«Удалить класс».
Доступны следующие варианты удаления:
– частичное удаление класса или свойства класса - удаление из дерева модели данных;
– полное удаление класса или свойства класса - удаление из дерева модели данных и в базе данных.
Для полного удаления по умолчанию установлен флаг “Удалить все связанные данные”.
4.1.4 Фильтрация по дереву классов и свойств
Для быстроты передвижения по дереву в Системе реализован поиск классов и свойств классов по названию или системному имени на панели фильтрации данных. Система разворачивает дерево и подсвечивает классы и свойства с заданными критериями поиска.
4.1.5 Создание конфигурационных настроек для класса
Системному администратору доступен инструмент создания автоматически конфигурационных настроек для класса, созданного в редакторе классов.
Данный инструмент автоматически генерирует соответствующие конфигурации в подразделах «Папки», «Карточки», «Отображения папок», «Поиски» для выбранного класса объектов, а также устанавливает расположение папки для объектов класса в соответствующей конфигурационной настройке в подразделе «Группы папок».
Для запуска генератора необходимо кликнуть на инструмент «Мета-генератор» и заполнить следующие атрибуты:
• Для атрибута «Тип документа» необходимо указать из выпадающего списка доступных классов имя класса для объектов которого будут созданы конфигурационные настройки на одном из рабочих столов.
• Для атрибута «Папка» требуется указать название папки для объектов класса, которое будет использоваться в системе и отображено для пользователей системы, если наименование отлично от названия класса в «Редакторе классов». Если атрибут «Папка» оставить пустым, то Система использует наименование выбранного класса в «Редакторе классов» в качестве наименования папки.
• Для атрибута «Название рабочего стола» выбрать необходимый рабочий стол, на котором будет создана папка с объектами настраиваемого класса.
• Для атрибута «Группа папок» необходимо выбрать из списка одну из имеющихся групп папок в Системе, к которой будет добавлена новая папка объектов.
• Установить флаги «Папка», Фильтр, Карточка для создания конфигурационных настроек в соответствующих подразделах «Папки», «Поиски», «Карточки». Если данные конфигурационные настройки для настраиваемого класса будут созданы вручную или уже имеются в Системе, то флаги устанавливать не нужно. В этом случае будут созданы дубли конфигурационных настроек.
4.2 Подраздел «Пользователи»
В подразделе “Пользователи” содержаться пользователи, заведенные в Системе.
База пользователей напрямую в системе ведутся при использовании метода аутентификации с использованием типа репозитория «LOCAL».
Системная роль определяет вид пользовательского интерфейса при работе c Системой. Каждому пользователю присваивается хотя бы одна системная роль. Доступ в соответствующий интерфейс пользователя, осуществляется на основе установленной системной роли.
Система поддерживает три вида системных ролей:
– «Системный администратор» отвечает за настройку платформы;
– «Прикладной администратор» отвечает за настройку и работу со справочниками системы;
– «Пользователь» работает в системе.
Создание нового пользователя
Для создания нового пользователя, требуется в подразделе «Пользователи» кликнуть на инструмент «Новый документ», подтвердить создание нового объекта класса «Пользователи», заполнить обязательные поля (в том числе: установить логин, пароль, ФИО, роли пользователя, рабочие столы пользователя и правила доступа) и нажать инструмент «Сохранить».
В результате новый пользователь будет создан.
Для редактирования информации о пользователе требуется в подразделе «Пользователи» выбрать необходимый элемент из табличного отображения данных, открыть карточку, внесите изменения и нажмите кнопку “Сохранить”.
Удаление элемента справочника “Пользователи”
В подразделе «Пользователи» требуется выбрать необходимый элемент из табличного отображения данных, открыть карточку пользователя и нажать инструмент «Удалить».
В результате выбранный элемент справочника будет удален.
После выполнения данного действия системным администратором пользователь больше не сможет авторизоваться в системе, до момента заведения данному пользователю новой учетной записи в Системе или до момента восстановления из корзины удаленной ранее учетной записи пользователя.
4.3 Подраздел «Хранилища файлов»
Для хранения файлов, загружаемых в систему (например, файлы добавленные на вкладку “Вложения” в карточки объектов) необходимо создать конфигурацию с указанием пути к хранилищу файлов.
Хранилище файлов – это область на файловой системе для хранения бинарных данных (файлов).
Для того чтобы создать хранилище файлов необходимо выполнить следующие действия:
1. Перейти в раздел «Конфигурация приложения», а затем в подраздел «Хранилища файлов»;
2. Нажать на инструмент «Новый документ» и подтвердить создание нового хранилища; 3. В поле «Путь» указать путь к папке, где будут храниться файлы и установить флаг
«Используется по умолчанию»;
4. Нажать инструмент «Сохранить».
Конфигураций с указанием пути к хранилищу файлов может быть создано несколько, но в одной из конфигураций обязательно должен быть установлен флаг “Используется по умолчанию”. Новые файлы в системе, будут храниться именно в хранилище, где установлен флаг “Используется по умолчанию”.
При необходимости хранилище может быть изменено.
В карточке хранилища файлов доступны следующие инструменты для редактирования:
- «Изменить путь к хранилищу» - позволяет задать для хранилища новый пусть к хранению файлов.
- «Установить хранилищем по умолчанию» - если хранилищ несколько, позволяет сменить хранилище по умолчанию
Также доступны инструменты для просмотра дополнительной информации о хранилище файлов:
- «Рассчитать статистику по хранилищу» - обновляет информацию об общем размере занимаемого файлами и о количестве файлов.
- «Проверка текущего состояния» - проводится тестовая запись файла в хранилище и удаление для проверки доступности хранилища. По результатам проверки пользователю выдается соответствующее сообщение.
4.4 Подраздел «Поиски»
Запросы поиска - это программные фильтры, которые позволяют задавать условия поиска объектов в папках или в карточке объекта по какому-то признаку.
Создание конфигурационной настройки запроса поиска
Для того чтобы создать конфигурационную настройку запроса поиска, необходимо перейти в подраздел «Поиски» кликнуть на инструмент «Новый документ», подтвердить создание новой конфигурационной настройки запроса поиска, в форме создания заполнить обязательные поля и нажать инструмент «Сохранить».
В результате конфигурационная настройка пользовательского запроса поиска будет создан.
4.4.1 Формирование данных конфигурационной настройки
Поле «Данные конфигурации» содержит JSON-блок настройки поиска. Ниже в таблицах приведены атрибуты (см. Табл. “Атрибуты данных конфигурации”) и условия (см. Табл. “Условия данных конфигурации”), используемые при формировании данных конфигурации.
Таблица 1. Атрибуты данных конфигурации
|
|
|
|
|||
|
|
|
|
|||
|
binding |
AND, OR |
AND |
|||
|
|
|
|
|||
|
value |
Может содержать как константу, так и стандартный макрос: ${user.id}, ${user.name}, |
|
|||
|
|
${role.id}, ${role.name} или разработанный свой макрос. |
|
Таблица 2. Условия данных конфигурации
|
|
|
|
|||
|
|
|
|
|||
|
|
EQUAL |
Равно |
|||
|
|
|
||||
|
GREATER_THAN |
Больше чем |
||||
|
|
|
||||
|
LESS_THAN |
Меньше чем |
||||
|
|
|
||||
|
LIKE |
Как |
||||
|
|
|
||||
|
EMPTY |
Пусто |
||||
|
|
|
||||
|
|
IS_NULL |
Не заполнено |
|||
|
|
|
|
|||
|
CONTAINS_ALL |
Содержит все |
||||
|
|
|
||||
|
|
CONTAINS_ONE_OF |
Содержит один из |
|||
|
|
|
|
|||
|
IN |
Входит в |
||||
|
|
|
Пример конфигурационной настройки:
1. {"criteria":
2. {"id": "criteria_Mediator", "binding": "AND", "conditions": [
3. {"id": "FolderName", "field": "FolderName", "label": "Номер","readonly": false,
"visible": true, "condition": "EQUAL", "maxlength": 255 },
4. {"id": "PackageNumber", "field": "PackageNumber", "readonly": false,
"label":"Номер агентского договора", "visible": true, "condition": "LIKE" },
5. {"id": "Branch", "field": "Branch", "label":"Филиал", "readonly": false,
"visible": true, "condition": "IN", "maxlength": 255 },
6. {"id": "DateCreated", "field": "DateCreated", "label": "Дата создания",
"readonly": false, "visible": true, "condition": "BETWEEN" },
7. {"id": "Author", "field": "Author", "readonly":false, "visible": true,
"condition": "EQUAL", "value": "${user.login}"},
8. ]}
9. }
Описание скрипта
1 строка – начало скрипта;
2 строка – наименование (id) скрипта, условие объединения запросов (binding); 3 – 7 строка – условия поиска:
• id – уникальный идентификатор запроса;
• field – наименование поля для поиска (как в “Редакторе классов”);
• label – наименование поля для пользователя, если отличается от заданного в “Редакторе классов”;
• readonly – признак редактирования условия поиска (см. Таблицу 2);
• visible – признак видимости условия поиска (см. Таблицу 2);
• condition – условия фильтрации (см. Таблицу 3);
• maxlength – максимальное количество символов для ввода в условие;
• value - дополнительное условие для поиска. Может содержать константу или макрос ($макрос).
Где макрос — это код groovy, возвращающий строку.
После создания шаблона поиска его необходимо связать с папкой, в которой он будет использоваться по умолчанию. Об этом написано в разделе «Папки».
Так же допустима настройка сложных поисков с несколькими вложенными критериями, в таком случае атрибут И/ИЛИ будет отображаться в фильтре. Пример
конфигурационной настройки приведен ниже:
Пример конфигурационной настройки:
{
"criteria": {
"id": "criteria_1",
"binding": "AND",
"conditions": [
{"id":"IsCurrentVersion", "field":"IsCurrentVersion", "visible":false,
"condition": "EQUAL", "value": true},
{"id": "ContractNumber", "field": "ContractNumber", "visible": true,
"condition": "LIKE"},
{"id": "ContractDate", "field": "ContractDate", "visible": true,
"condition": "BETWEEN"},
{"id": "Performer", "field": "Performer", "visible": true, "condition": "EQUAL"},
{"id": "ContractState1", "field": "ContractState", "visible": false,
"condition": "IN", "value": [175, 187, 181, 177]},
{"id": "criteria_2",
"binding": "OR",
"conditions": [
{"id": "Author", "field": "Author", "visible": true,
"condition": "EQUAL", "value": "${user.login}"},
{"id": "ApprovalDepartments", "field":
"ApprovalDepartments", "visible": false, "condition": "OVERLAP", "value":
$user.params.Department}
]}
]}
}
Фильтрация записей раздела
Поиск записей в папке осуществляется с помощью настроенной панели фильтрации. Панель фильтрации может быть отредактирована. Для этого необходимо выполнить следующие действия:
1. Перейти в интерфейс «Пользователь», открыть необходимый раздел и папку, нажать кнопку «Фильтр»;
2. Нажать кнопку в панели фильтрации «Сменить режим»;
3. Отредактировать критерии поиска (выпадающий список);
4. Выбрать условия поиска (чек-боксы), которые будут отображаться в панели фильтрации (если чек-бокс не установлен, то поле не будет отображаться на панели фильтрации);
5. Нажать кнопку «Сменить режим» еще раз.
В результате набор полей и критерии поиска для полей на панели фильтрации будут изменены в соответствии с новыми настройками.
4.4.2 Управление шаблонами поиска
Для удобства поиска по записям разделов пользователь может создать собственный шаблон поиска, состоящий из набора условий и критериев поиска.
Создание шаблона поиска
Для того чтобы создать шаблон поиска, необходимо выполнить следующие действия:
1. В папке нажать кнопку «Сменить режим»;
2. Настроить критерии поиска;
3. Нажать кнопку «Сохранить как»;
4. В окне сохранения шаблона поиска ввести имя шаблона поиска;
5. Нажать кнопку «Сохранить».
Удаление конфигурационной настройки запроса поиска
Для того чтобы удалить конфигурационную настройку запроса поиска, необходимо открыть карточку объекта и нажать инструмент “Удалить”. А также в конфигурационной настройки папки, для параметра “Search” указать значение по умолчанию “DefaultSearch” (в данном случае, для папки панель фильтрации отображаться не будет) или другое существующее наименование конфигурационной настройки поиска, подходящего для папки.
4.5 Подраздел «Группы папок»
Группы папок и папки – это логические разделы, в которых отображаются бизнесобъекты.
Создание конфигурационной настройки группы папок
Для создания конфигурационной настройки групп папок необходимо перейти в раздел “Пользовательская конфигурация”, папку “Группы папок” и нажать на инструмент “Новый документ”. Выбрать в поле “Название рабочего стола“ рабочий стол, для которого необходимо создать группы папок, и заполнить поле “Данные конфигурации”, при необходимости добавить описание в поле “Описание конфигурации”.
Конфигурационная настройка создается один раз для каждого рабочего стола.
Формирование данных конфигурационной настройки
Конфигурационная настройка представляет собой json-скрипт, в котором указываются следующие параметры:
• class – класс, который реализует логику группировки папок;
• label – название группировки(раздела);
• inboxes – список названий папок входящих в группировку(раздел).
Пример конфигурационной настройки:
{
"Мои данные" : {
"label" : "Мои данные",
"inboxes" : [ "EmployeesМуData", "Employees" ]
},
"Внесение данных" : {
"label" : "Внесение данных",
"inboxes" : [ "DataInput" ]
}
}
Удаление конфигурационной настройки группы папок
Для того чтобы удалить конфигурационную настройку группы папок, необходимо нажать инструмент “Удалить” в карточке. В результате конфигурационная настройка группы папок будет удалена.
4.6 Подраздел «Папки»
Папка – это сущность, определяющая группировку объектов по каким-то критериям.
В папке отображаются объекты.
Создание конфигурационной настройки папки
Для того чтобы создать папку, необходимо выполнить следующие действия. Перейти в раздел “Конфигурация приложения”, открыть подраздел “Папки” и нажать на инструмент “Новый документ”. Заполнить поля “Название конфигурации “, “Данные конфигурации”, при необходимости добавить описание в поле “Описание конфигурации”.
Формирование данных конфигурации
Конфигурационная настройка представляет собой json-скрипт, в котором указываются следующие параметры:
• label – имя папки в системе;
• caseName – название класса объектов в редакторе классов, для которых создается папка;
• type – тип папки (СЕ или PE);
• inboxView – наименование конфигурации табличного отображения папки;
• roles – список ролей, для которой будет доступна папка;
• search – наименование конфигурации поиска для папки;
• showCount - отображение количества объектов рядом с названием папки. Доступно два значения: true - количество объектов отображается, false - не отображается (значение по умолчанию).
Пример конфигурации:
{
"label": "База точек мониторинга",
"caseName": "MonitoringPoint",
"inboxView": "MonitoringPoint",
"roles": ["appAdmin"],
"search": "MonitoringPointSearch",
"showCount":true
}
Удаление конфигурационной настройки папки
Для того чтобы удалить конфигурационную настройку папку, необходимо нажать кнопку “Удалить”. А также удалить название конфигурации папки из конфигурационной настройки групп папок, где было указано название данной конфигурационной настройки папки.
4.7 Подраздел «Отображения папок»
Отображение папок создается на основе типа объекта и определяет набор столбцов, видимых пользователю во время просмотра папки.
Создание конфигурационной настройки отображения папки
Для того чтобы создать конфигурационную настройку отображения папки, необходимо перейти в раздел “Конфигурация приложения”, открыть подраздел “Отображения папок” и нажать на инструмент “Новый документ”. Заполнить поля “Название конфигурации “, “Данные конфигурации”, при необходимости добавить описание в поле “Описание конфигурации”.
В результате конфигурационная настройка отображения папки будет создана. После создания конфигурационной настройки отображения папки ее необходимо связать с конфигурационной настройкой папки, в которой она будет использоваться по умолчанию.
Об этом написано в подразделе “Папки”.
Формирование данных конфигурации
Конфигурационная настройка представляет собой json-скрипт, состоящий из двух обязательных блоков class и fields и дополнительных: rowsPerPage, params и orderBy.
Блок class содержит название используемого класса представления, доступен один класс platform.dataengine.model.inbox.InboxView.
Блок fields содержит поля, которые будут отображаться в виде столбцов в таблице. В каждом элементе блока необходимо указать обязательный параметр fieldName:
• fieldName – имя свойства объекта, в соответствии с системным именем свойства в редакторе классов;
Для дополнительной настройки формата вывода значения поля, в блоке fields, доступны следующие необязательные параметры:
• label – название поля, отображаемое в табличном представлении папки. Если значение не задано, устанавливается название в соответствии с названием свойства в редакторе классов;
• renderer – компонент, отвечающий за вывод значения. Доступны следующие компоненты:
o checkbox – компонент выбора для полей типа «флаг», значение установлено/значение не установлено. Значение по умолчанию для полей типа Boolean;
o date – вывод даты в формате «dd.mm.yyyy». Значение по
умолчанию для полей с типом дата; o dateTime – вывод даты в формате «dd.mm.yyyy hh:mm:ss»; o double – вывод вещественных чисел в формате «#.##»; o number – вывод числовых значений, ограничивает количество
выводимых символов до 100; o text – вывод текстового значения, ограничивает количество
выводимых символов до 100; o choiceIcon - используется для отображения иконок, в соответствии с выбранным значением из справочника.
• hidden – позволяет скрыть поле. Принимает значения true - поле скрыто, false - поле не скрыто. По умолчанию принимает значение false;
• sortable – позволяет отсортировать значения. Принимает значения true - сортировка разрешена, false - запрещена;
• width - позволяет задать ширину колонки. В формате:”200px”.
Блок rowsPerPage содержит количество строк выводимых на одной странице в таблице.
Блок orderBy предназначен для вывода объектов в отсортированном виде. Параметры:
• fieldName - системное имя свойства по которому будут сортироваться объекты;
• direction- направление сортировки: ASC – по возрастанию, DESC – по убыванию.
Блок params предназначен для дополнительной настройки табличного отображения папки. Параметры и значения:
• newWindow – тип boolean, параметр отвечает за открытие карточки объекта в новом окне. Принимает два значение: true - открывать карточку в новом окне, false - не открывать (значение по умолчанию).
• availableViewConfigs – параметр отвечает за отображение данных. Возможны следующие значения параметра availableViewConfigs: dataTable - отображает объекты в табличном виде и map - позволяет отобразить объекты на карте. При использовании двух параметров одновременно данные отображаются в соответствии с первым указанным значением, а также добавляется переключатель между табличным представлением данных и картой.
Пример конфигурации:
{
"params": {"newWindow": true},
"rowsPerPage":20,
"fields" : [
{
"fieldName" : "ContractNumber"
}, {
"fieldName" : "ContractDate",
"renderer":"dateTime"
},
{
"fieldName" : "Customer"
},
{
"fieldName" : "Performer"
},
{
"fieldName" : "ContractState"
},
{
"fieldName" : "Urgent"
}
],
"orderBy" : {
"fieldName" : "DateCreated",
"direction" : "DESC"
}
}
Настройка отображения иконок в зависимости от значения справочника
В системе есть возможность отображать в табличном отображении иконки в соответствии c выбранным значением из справочника.
Для добавления иконки в табличное отображение папки необходимо выполнить следующие действия:
1. В редакторе классов в классе “Справочник(ChoiceList)” создать свойство со следующими атрибутами:
Системное имя: IconCssClass
Название: Css класс иконки
Тип данных: STRING
Максимальная длина: 64
Сортируемое: установить чек-бокс
2. В карточку справочника для которого необходимо добавить иконку требуется добавить поле и “IconCssClass” и указать CSS класс. Ссылки на доступные иконки и цвета.
3. Переопределить справочник в конфигурации “choices”, добавив в параметр “itemFields” значение “IconCssClass”.
Пример:
MissionStatus : new SimpleChoice('MissionStatus',
'criteriaChoiceListProcessor', [ index : 'ID', label : '${fields.Title}', search :
Search.from('MissionStatus').whereCurrentVersion().orderBy('Title'), fields : ['ID','Title'], itemFields: ['Title','IconCssClass']
4. В конфигурационной настройке табличного отображения добавить в блок fields компонент “renderer”: “choiceIcon” Пример конфигурационной настройки:
{
"fields" : [
{
"fieldName" : "MissionStatus",
"renderer": "choiceIcon",
"label":"",
"width":"25px"
},
{
"fieldName" : "Executor"
}
],
"orderBy" : {
"fieldName" : "DateCreated",
"direction" : "ASC"
}
}
Удаление конфигурационной настройки отображения папки
Для того чтобы удалить конфигурационную настройку табличного отображения папки, необходимо нажать на инструмент “Удалить”. А также необходимо заменить наименование конфигурационной настройки отображения папки во всех конфигурационных настройках папок (подраздел «Папки»), где использовалась данная конфигурационная настройка и заменить на другое существующее наименование конфигурационной настройки.
4.8 Подраздел «Карточки»
Карточка - это набор полей с информацией об объекте, расположенной в определенном порядке. Поля в карточке - это визуальное отображение свойств объектов.
Создание конфигурационной настройки карточки объекта
Для того чтобы создать конфигурационную настройку карточки объекта необходимо перейти в раздел «Конфигурация приложения», подраздел «Карточки», нажать инструмент “Новый документ”. Или открыть карточку, которая была сгенерирована при помощи инструмента «Мета-генератор». Конфигурационная настройка карточки объекта была сформирована только с системными атрибутами такие как автор, пользователь, внесший последние изменения, дата создания и дата последнего изменения.
Формирование данных конфигурации
Конфигурационная настройка представляет json-скрипт.
panels – это секции на которые разбиваются поля на карточке, секции можно
сворачивать/разворачивать.
Каждая секция имеет заголовок (элемент legend) и набор выводимых компонентов componentsRows – это строки в рамках панели.
Для описания полей в карточке предназначен элемент конфигурации components. Для настройки расположения, формата и других параметров доступны следующие параметры:
• cssClass – название css классов применяемых к полю (разделитель пробел). Доступные классы можно посмотреть в файлах с расширением css проекта.
Наиболее часто используемые классы это span1 – span12;
• propName – название свойства объекта. Обязательный параметр;
• readonly – тип boolean, позволяет сделать поле доступным или недоступным для редактирования (true - нередактируемое поле, false - редактируемое, является значением по умолчанию);
• required – тип boolean, позволяет указать что свойство является обязательным для заполнения (true - обязательное, false - необязательное, является значением по умолчанию);
• koBinding – используется для добавления дополнительной не универсальной и не настраиваемой логики к полю. В поле требуется указать название предварительно разработанного биндинга и его параметры;
• maxLength – ограничивает максимально допустимое количество символов для поля с текстовым значением;
• label – название поля, выводится перед значением. По умолчанию используется название свойства свойства;
• choiceName – название справочника для полей с выбором значений из справочника. По умолчанию используется справочник, указанный в атрибуте choice в Редакторе классов;
• templateName – название компонента для вывода значения поля.
Доступны следующие значения:
o text – нередактируемый текст; o input – однострочное текстовое значение. Значение по
умолчанию для большинства полей; o textarea – многострочное текстовое значение; o select – выбор значения из справочника. Значение по
умолчанию для полей по справочнику; o multiselect – выбор значения из справочника, позволяет
выбрать несколько значений; o attachmentList - отображение списка вложений (для свойства
‘Files’) в карточке объекта;
o checkbox – для полей типа «флаг», значение установлено/значение не установлено. Значение по умолчанию для полей типа Boolean; o datePicker – дата в формате «dd.MM.yyyy». Значение по
умолчанию для полей с типом дата; o dateTimePicker – дата в формате «dd.MM.yyyy HH:mm:ss»; o hidden – скрытое поле, на карточке не отображается; o staticText – отображение статического текста с сообщением пользователю. Дополнительный параметр params: messageCode - сообщение, с поддержкой интернационализации; o code – для полей, содержащих конфигурационный скрипт. Для
полей с таким templateName доступен дополнительный параметр «mode»; o table – для полей, содержащих объекты другого класса объектов. Для полей с таким templateName требуется дополнительно указывать следующие атрибуты:
§ view – название табличного представления;
§ className – класс выводимых объектов.
o choiceIcon – используется для полей, содержащих значения из справочника. Рядом с полем выводится иконка, соответствующая выбранному значению в справочнике. В справочнике для каждого значения должен быть указан CSS класс иконки.
params – дополнительные параметры. Доступны следующие дополнительные параметры:
o linkedChoice - тип boolean, реализует предзаполнение полей на основе данных других полей. Значения true - предзаполнять поле, false - не предзаполнять (значение по умолчанию); o hideLabel – не выводить название поля. Принимает два значения, true (не выводить) и false (выводить). По умолчанию для полей название выводиться; o mode – доступно для templateName «code»; Позволяет управлять подсветкой синтаксиса для кода скриптов. Доступны два значения: groovy или json;
o link – используется для отображения наименования поля (‘label’) в виде ссылки на связанный объект. Для настройки используется два параметра:
§ ‘to’ - название класса;
§ ‘binding’ - используется для задания доп. поисков, позволяющих найти связанный объект.
Доп. параметры для ‘binding’: “IsCurrentVersion” - указатель на версию объекта (‘true’ - последняя версия объекта, ‘false’ - все версии объекта);
“VersionSeriesId” - идентификатор последовательности версий объекта.
o mask – позволяет задать правило для проверки формата
вводимого значения. Для параметра требуется указать следующие атрибуты;
§ pattern – паттерн для проверки значения, более подробно можно прочитать в документации по JavaScript;
§ msg – сообщение для некорректных значений.
Пример конфигурационной настройки:
{
"panels": [
{ "legend": "Description",
"componentsRows": [{"components": [{"cssClass": "span12",
"propName": "ProgramRole"}]},
{"components": [{"cssClass": "span4", "propName":
"Surname"}, {"cssClass": "span4", "propName": "FirstName"}, {"cssClass": "span4",
"propName": "MiddleName"}]},
{"components": [{"cssClass": "span6", "propName":
"Department"}, {"cssClass": "span6", "propName": "Position"}]},
{"components": [{"cssClass": "span12", "propName":
"OrganizationalUnit"}]},
{"components": [{"cssClass": "span12", "propName":
"Name", "templateName":"hidden"}]},
{"components": [{"cssClass": "span6", "propName":
"Email"}, {"cssClass": "span6", "propName": "Telephone"}]},
{"components": [ {"cssClass": "span10", "propName": "INN", "label":"ИНН", "params": {"mask": {"pattern": "^\\d{13}$", "msg": "Поле должно содержать 13 цифр!"}}}]}
]
},
{ "legend": "Access",
"componentsRows": [
{"components": [{"cssClass": "span6", "propName":
"Login"}, {"cssClass": "span6", "propName": "Password"}]},
{"components": [{"cssClass": "span6", "propName":
"Roles", "templateName":"hidden"}]},
{"components": [{"cssClass": "span6", "propName":
"Desktops", "templateName":"hidden"}]},
|
"AccessRule"}]} |
{"components": [{"cssClass": "span6", "propName": |
|
|
] |
}
]
}
Удаление конфигурационной настройки карточки объекта
Для того чтобы удалить конфигурационную настройку карточки объекта, необходимо нажать на инструмент “Удалить”.
4.9 Подраздел «Скрипты»
Подраздел предназначен для изменения базового поведения системы. Например, отображение инструментов, вкладок, полей в карточках в зависимости от требований, накладываемых системой (должностная роль, рабочий стол, статус объекта и др.) Для переопределения поведения системы необходимо создать одну из следующих конфигураций и переопределить методы
Доступные конфигурационные скрипты:
• tabsScript - предназначен для управления набором вкладок в карточке объекта;
• toolsScript - предназначен для управления инструментами в папке и в карточке объекта, а также для управления приложенными файлами к карточке объекта;
• layoutsScript - предназначен для управления отображением карточки объекта, а также переопределением карточки в зависимости от параметров;
• inboxesScript - предназначен для управления табличным
представлением папки;
• activitiScript - предназначен для описания методов и вызова их в Workflow engine.
Описание конфигурационного скрипта закладок
Для того чтобы создать конфигурационный скрипт закладок (tabsScript) необходимо перейти в раздел “Конфигурация приложения”, открыть подраздел “Скрипты”, нажать инструмент “Новый документ”, заполнить поле “Название конфигурации” значением tabsScript.
В поле “Данные конфигурации” создать новый класс, реализующий методы интерфейса или наследующий класс, и переопределить требуемые методы.
Свойства входящих параметров CalculatorContextForTab context:
user - пользователь;
desktopName - название рабочего стола пользователя; tabName - название текущей вкладки; vo - объект.
Пример конфигурационного скрипта закладок:
import org.springframework.web.context.request.RequestContextHolder import platform.dataengine.meta.context.CalculatorContextForTab import platform.dataengine.meta.impl.DefaultTabsCalculator
class CommonTabCalculator extends DefaultTabsCalculator {
@Override
Collection<String> getCaseTabs(CalculatorContextForTab context) { def isNew = context.vo.id == null def session =
RequestContextHolder.currentRequestAttributes().getSession() def tabs = []
switch (context.vo.classType) { case 'Statement': tabs << 'details' if (!isNew) {
tabs << 'content' tabs << 'salesProduct' tabs << 'history'
} break case 'DataInput': if (!isNew) { tabs << 'content' tabs << 'details' tabs << 'history' } else if (isNew) { tabs << 'details'
} break
default:
tabs << 'details' if (!isNew) { tabs << 'content' tabs << 'history'
}
} tabs
}
}
Описание конфигурационного скрипта инструментов
Для того чтобы создать конфигурационный скрипт инструментов (toolsScript) необходимо перейти в раздел “Конфигурация приложения”, открыть подраздел “Скрипты”, нажать инструмент “Новый документ”, заполнить поле “Название конфигурации” значением toolsScript.
В поле “Данные конфигурации” создать новый класс, реализующий методы интерфейса или наследующий класс, и переопределить требуемые методы.
Свойства входящего параметра ToolCalculatorContextForInbox context:
user пользователь;
desktopName - название рабочего стола пользователя; inboxConfig - название папки; inboxViewType - название табличного отображения папки.
Свойства входящего параметра CalculatorContextForTab context:
user - пользователь;
desktopName - название рабочего стола пользователя; tabName - название текущей вкладки; vo - объект.
Свойства входящего параметра ToolCalculatorContextForContent context:
user - пользователь;
desktopName - название рабочего стола пользователя; tabName - название текущей вкладки.
Пример конфигурационного скрипта инструментов:
import platform.dataengine.meta.context.CalculatorContextForTab import platform.dataengine.meta.context.ToolCalculatorContextForContent import platform.dataengine.meta.context.ToolCalculatorContextForInbox import platform.dataengine.meta.impl.DefaultToolsCalculator import platform.object.store.common.meta.constants.Desktop
class ToolsScript extends DefaultToolsCalculator {
static final String RULE_RightsAssign = "e7518dd2-d6a4-4009-acb638ff6cbba578"
@Override
Collection<String> getTools(ToolCalculatorContextForInbox context) { //
Инструменты для папок def result = super.getTools(context) def desktopName = context.desktopName def inboxConfig = context.inboxConfig def isRightsAssign =
context.user.accessRules.contains(RULE_RightsAssign) def user = context.user
if (desktopName == Desktop.APP_ADMIN) { switch (inboxConfig.caseName) { case 'MonitoringPoint': case "Instructions": case "Handbooks": case "Orders": case "RiskScales":
case "AirChemicalPollutants": case "IndividualMeasures": case "OrganizationalUnits":
case "QuantificationTechniques": case "CodesCriticalOrgans":
case "PostType": case "ObservationProgram": case "DepartmentalSubordination": case "Settlement": case "Region": case "RiskType": case "ProgramRole": case "ResearchMethodType":
case "MeasurementUnits": result << 'exportData' result << 'importData' break
case "RiskCalculations": result << 'exportData' break
case "DataInput": result = [] result << 'newCaseDataInput' result << 'provideForm' break case "Users":
if (!isRightsAssign && user?.login != 'admin'){ result = []
} else { result = [] result << 'newCaseUsers'
} break
}
} return result
}
@Override
Collection<String> getTools(CalculatorContextForTab context) { //
Инструменты для карточек def tools = super.getTools(context) def isNew = context.vo.id == null def isRightsAssign =
context.user.accessRules.contains(RULE_RightsAssign) def user = context.user
tools.remove('saveCaseAsMinor')
if (context.vo.classType in ['Instructions', 'Orders', 'Handbooks']) { switch (context.tabName) { case 'content': tools = [] tools << 'uploadContentNonVers' tools << 'deleteContentsNonVers' break
} } if (context.vo.classType in ['DataInput']) { switch (context.tabName) { case 'content': tools = [] tools << 'uploadContentNonVers' tools << 'deleteContentsNonVers' tools << 'deleteCase' break
}
}
if (context.vo.classType =='Users' && !isNew && !isRightsAssign &&
user?.login != 'admin') { switch (context.tabName) { case 'details': tools = [] tools << 'saveCase' break
}
} tools
}
@Override
Collection<String> getTools(ToolCalculatorContextForContent context) { def tools = super.getTools(context) tools << 'updateContentTool' tools << 'deleteContentNonVers' tools
}
}
Описание конфигурационного скрипта отображения карточек объектов
Для того чтобы создать конфигурационный скрипт карточек объектов (layoutsScript) необходимо перейти в раздел “Конфигурация приложения”, подраздел “Скрипты”, нажать инструмент “Новый документ”, заполнить поле “Название конфигурации” значением layoutsScript.
В поле “Данные конфигурации” создать новый класс, реализующий методы интерфейса или наследующий класс, и переопределить требуемые методы.
Свойства входящего параметра LayoutCalculatorContext context:
user - пользователь;
desktopName - название рабочего стола пользователя; tabName - название текущей вкладки; vo - объект; layout - базовая карточка объекта.
Свойства входящего параметра CalculatorContextForTab context:
user - пользователь;
desktopName - название рабочего стола пользователя; tabName - название текущей вкладки; vo - объект.
Пример конфигурационного скрипта отображения карточек объектов:
import platform.dataengine.meta.context.CalculatorContextForTab import platform.dataengine.meta.context.LayoutCalculatorContext import platform.dataengine.meta.impl.DefaultLayoutsCalculator import platform.dataengine.meta.model.Layout
class LayoutsScript extends DefaultLayoutsCalculator {
static final String RULE_RightsAssign = "e7518dd2-d6a4-4009-acb6-
38ff6cbba578"
@Override
Layout processLayout(LayoutCalculatorContext context) { super.processLayout(context) def vo = context.vo def layout = context.layout def isRightsAssign =
context.user.accessRules.contains(RULE_RightsAssign) def user = context.user def isNew = context.vo.id == null
if (context.vo.classType == 'Users' && !isNew && !isRightsAssign &&
user?.login != 'admin') {
//context.layout.readonly = true findComponent(layout, 'ProgramRole').readonly = true findComponent(layout, 'Surname').readonly = true findComponent(layout, 'FirstName').readonly = true findComponent(layout, 'MiddleName').readonly = true findComponent(layout, 'Department').readonly = true findComponent(layout, 'Position').readonly = true findComponent(layout, 'OrganizationalUnit').readonly = true findComponent(layout, 'Email').readonly = true findComponent(layout, 'Telephone').readonly = true findComponent(layout, 'Login').readonly = true findComponent(layout, 'AccessRule').readonly = true
} return layout
}
@Override
String getLayoutName(CalculatorContextForTab context) { def caseName = context.vo.classType def layoutName = super.getLayoutName(context)
if (caseName == 'Users') { layoutName = 'Employees'
} return layoutName
}
}
Описание конфигурационного скрипта отображения табличных представлений
Для того чтобы создать конфигурационный скрипт отображения табличных представлений (inboxesScript) необходимо перейти в раздел “Конфигурация приложения”, открыть подраздел “Скрипты”, нажать инструмент “Новый документ”, заполнить поле “Название конфигурации” значением inboxesScript.
В поле “Данные конфигурации” создать новый класс, реализующий методы интерфейса или наследующий класс, и переопределить требуемые методы.
Доступный параметр inboxView - табличное отображение папки;
Пример конфигурационного скрипта отображения табличных представлений:
import platform.dataengine.meta.DefaultInboxesCalculator import platform.dataengine.inbox.InboxView
class CommonInboxesCalculator extends DefaultInboxesCalculator {
@Override
InboxView processInboxView(InboxView inboxView) { def diffField = ["fieldName": "DocumentStatus" ] def fields = inboxView.fields if (inboxView.name == "Document"){ fields<<diffField
} inboxView
}
}
Описание конфигурационного скрипта по работе с бизнес процессами
Для того чтобы создать конфигурационный скрипт по работе с бизнес-процессами (activitiScript) необходимо перейти в раздел “Конфигурация приложения”, открыть подраздел “Скрипты”, нажать инструмент “Новый документ”, заполнить поле “Название конфигурации” значением activitiScript.
В поле “Данные конфигурации” описать методы, которые необходимо будет вызывать в Workflow engine.
Пример конфигурационного скрипта:
import platform.dataengine.bpm.activiti.meta.BaseActivitiScript import platform.dataengine.api.search.type.ConditionType import org.activiti.engine.delegate.VariableScope import platform.dataengine.api.search.model.Search
class ActivitiScript extends BaseActivitiScript {
public void getAuthorEmail(VariableScope execution) {
def user = userService.findByLogin(execution.getVariable("Author")) if (user != null && user.params.Email != null) execution.setVariable("AuthorEmail", user.params.Email) else
execution.setVariable("AuthorEmail", null)
}
}
Пример: Для вызова методов, из activiti-app необходимо выполнить следующие действия действия:
1. Создать”Execution listeners”, добавить в поле “Expression” выражение: ${ecmOperations.callAction(execution, ‘getAuthorEmail’)} где callAction вызывает методы из ActivitiScript, execution - параметр, куда
передаются значения, ‘getAuthorEmail’ - название метода в ActivitiScript.
2. В поле “Name” добавить значение “MethodeName”
3. Сохранить “Execution listeners”
Если необходимо создать “Task listeners”, то в поле “Expression”, требуется указать парамтер “task”: ${ecmOperations.callAction(task, ‘getAuthorEmail’)}.
4.10 Подраздел «Пользовательская конфигурация»
Подраздел содержит настройки пользовательской конфигурации системы. Система распознает следующие файлы конфигурационных скриптов (название конфигурации):
1. choice.reload.cron - скрипт для обновления справочников по cron;
2. choice.reload.crud - скрипт обновления справочников по crud;
3. choices - скрипт описания справочников;
4. tabs - скрипт описания вкладок;
5. tools - скрипт описания инструментов.
Описание конфигурационного скрипта обновления справочников по расписанию
Скрипт представляет собой json-скрипт для обновления справочников по cron.
В скрипте указываются следующие параметры:
- interval – интервал для задания времени выполнения, используется синтаксис cron:
* * * * *
- - - - -
| | | | |
| | | | ----- День недели (0 - 7) (Воскресенье =0 или =7)
| | | ------- Месяц (1 - 12)
| | --------- День (1 - 31)
| ----------- Час (0 - 23)
------------- Минута (0 - 59);
initialDelay – задержка перед первым выполнением в миллисекундах; choices – список в формате: [‘название справочника’, …].
Пример конфигурации:
[ [
interval : '0 0/5 * * * *', initialDelay: 1000 * 60, choices : ['Users']
]
]
Примеры использования интервалов в формате по cron:
* * * * * Каждую минуту
59 23 31 12 5 За минуту до конца года, если последний день года - пятница
59 23 31 Dec Fri За минуту до конца года, если последний день года - пятница
(еще один вариант записи)
0 12 * * 1-5 (0 12 * * Mon-Fri) В полдень по рабочим дням
* * * 1,3,5,7,9,11 * Каждую минуту в январе, марте, мае, июле, сентябре и ноябре
0 9 1-7 * 1 Первый понедельник каждого месяца, в 9 утра
0 0 1 * * В полночь, первого числа, каждый месяц
* 0-11 * * Каждую минуту до полудня
* * * 1,2,3 * Каждую минуту в январе, феврале и марте
* * * Jan,Feb,Mar * Каждую минуту в январе, феврале и марте
0 0 * * * Каждый день в полночь
0 0 * * 3 Каждую среду в полночь
Описание конфигурационного скрипта обновления справочников по событиям
Скрипт представляет собой json-скрипт для обновления справочников по событиям в хранилище объектов:
1. событие «создан» – создан новый объект в хранилище;
2. событие «обновлен» – существующий объект обновлён в хранилище;
3. событие «удален» – объект удален из хранилища;
Конфигурация обновления справочников имеет следующий формат:
[Системное имя класса: [‘название справочника’, …]].
Пример конфигурации:
[
'FileStores': [ 'FileStores'] ,
'DocStatusList': [ 'DocStatusList']
]
Описание конфигурационного скрипта описания справочников
Описание справочника c контроллером criteriaChoiceListProcessor соответствует схеме:
Наименование справочника : new Реализация справочника(’Системное имя справочника’, ’название контроллера’, [
index : '' - название поля используемого в качестве идентификатора элемента справочника,
label : '' - название элемента справочника, которое выводится пользователю, search : '' sql запрос,
fields: ['','',...] - набор полей для формировании описания элемента справочника, itemFields: ['','',...] - набор кэшируемых полей
])
Доступные реализации справочников:
• SimpleChoice - базовая реализация справочника;
• LinkedChoice - связанный справочник, содержит дополнительный параметр в поле params: linkedChoice - название связанного справочника, обязательный для заполнения параметр;
• ParametrizedChoice
• TimeCacheChoice - временный справочник. Справочника переформировывается, через заданный промежуток времени.
Список контроллеров:
1. criteriaChoiceListProcessor – обеспечивает поиск в основном хранилище по sql запросу.Параметры: