Select journal

Контрол Select journal позволяет выбирать значения из журнала платформы Citeck. Используется для заполнения полей-ассоциаций: пользователь открывает модальное окно с записями журнала и выбирает нужное значение. Компонент поддерживает автоматическое определение журнала по типу ассоциации, предустановленные фильтры, настройку сортировки, агрегацию данных из нескольких рабочих пространств, а также режим пользовательских значений.

Настройка компонента

Журнал можно задать в поле ID журнала (journalId), вычислить выражением customJournalId или определить автоматически по типу ассоциации атрибута. Если журнал определяется из типа ассоциации, вручную заполнять ID журнала не требуется.

Режим отображения «Пользовательские значения»

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

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

При этом все поля, связанные с фильтрацией, сортировкой и табличным представлением скрываются.

Выбор рабочих пространств для агрегации данных

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

Значение по умолчанию - Только текущее пространство. Для выбора доступны значения:

  • Все пространства

  • Только текущее пространство (по умолчанию)

  • Текущее и дополнительные пространства

  • Только дополнительные пространства

При выборе Текущее и дополнительные пространства или Только дополнительные пространства становится доступен выбор дополнительных пространств:

Динамические критерии для поиска

На вкладке Данные в поле Пользовательские данные запроса есть возможность генерировать дополнительные параметры поиска:

Список предикатов описан в статье Язык предикатов в разделе JSON представление.

Предустановленные фильтры

На вкладке Данные в поле Предикаты предустановленного фильтра можно настроить фильтры компонента, которые будут применены при инициализации. Поле Предикаты предустановленного фильтра принимает javascript-выражение, в котором необходимо присвоить переменной value массив из предикатов.

Пример для компонента с установленным ID журнала = „currency“:

В результате при открытии модального окна выбора по умолчанию будет применён фильтр по полю «Заголовок» с типом предикатом «contains» и значением «рубль».

Список предикатов описан в статье Язык предикатов в разделе JSON представление.

Настройка сортировки по атрибуту

Для настройки сортировки по атрибуту в разделе «Сортировка» указать атрибут и порядок сортировки:

Вычисление ID журнала динамически из данных формы

Ранее поле SelectJournal поддерживало только статический journalId или подстановку через шаблон.

Для вычисления ID журнала из данных формы используется JS-выражение (customJournalId). Его непустой результат переопределяет статический journalId. При пустом результате или ошибке выражения используется статический ID. При смене ID обновляется конфигурация журнала; первое разрешение динамического ID сохраняет начальное выбранное значение.

На вкладке Данные поле Пользовательское значение ID журнала:

../../../../../_images/dynamic_01.png

Рассмотрим пример:

value = data.name === "Другой журнал" ? "country-iso3166" : "legal-entities";

Если указанное условие выполняется, то открывается журнал из условия:



Если условие не выполняется, выражение возвращает legal-entities, и открывается этот журнал. Чтобы в этом случае использовать статическое поле ID журнала, верните пустую строку:

value = data.name === 'Другой журнал' ? 'country-iso3166' : '';


Миграция инварианта «Value Title» на новые формы

Если журнал используется для выбора ассоциаций, то лучше в данном случае зарегистрировать эвалюатор для отображаемого имени в DisplayNameService на сервере. В таком случае отображаемое имя сможет использоваться на формах, в журналах и много где еще.

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

В скрипте поля Отображаемое имя значения нужно присвоить переменной disp вычисленное имя. В качестве аргументов доступны:

_

lodash библиотека с утилитными функциями

value

значение, отображаемое имя которого мы хотим вычислить (даже если поле множественное в скрипт за раз попадает только одно значение)

../../../../../_images/select_journal_4.png

В некоторых случаях value.att() может возвращать пустое значение т.к. значение не было подгружено. Можно использовать следующий код для корректного отображения даже если значение не подгружено.

../../../../../_images/select_journal_5.png