Виджет «Документы»

Ключ documents

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

Описание сверено с исходниками ecos-ui:2.32.0-snapshot. Ниже показан настольный интерфейс. На мобильных устройствах расположение элементов отличается. Возможность загрузки зависит от настроек выбранного типа и доступности соответствующих операций.

Настройка

В окне настройки выберите типы, документы которых должны отображаться в виджете. Если в дереве настройки один корневой тип (на скриншоте — Базовый тип), он раскрывается по умолчанию:

Документы

../../../_images/documents_01.png

Пример административной карточки «Синхронизация пользователей»

../../../_images/documents_02.png

Флаг Подгружать типы документов из чек-листов дополняет настроенные типы данными чек-листов текущей записи.

Флаг Отображать только выбранные фильтрует дерево в окне настройки: в нём остаются только отмеченные типы. Сам состав типов виджета задаётся чекбоксами типов и сохраняется кнопкой Готово. Для заблокированных типов изменение выбора недоступно.

../../../_images/documents_03.png

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

../../../_images/documents_04.png ../../../_images/documents_05.png

Параметры типа:

Поле

Назначение

Разрешить загрузку файлов

Разрешает загрузку файлов для выбранного типа.

Разрешённое количество файлов

Только один или Несколько файлов. При выборе одного файла повторная загрузка при уже существующем документе может выполняться как обновление его версии.

Журнал с настройками колонок и действий

Журнал, из которого берутся колонки и действия для таблицы выбранного типа. Если журнал не указан, конфигурация колонок запрашивается по типу. Это не означает полного совпадения возможностей таблицы с обычным журналом.

Подтвердите параметры типа кнопкой Готово, затем сохраните общий выбор в окне настройки типов.

При поиске раскрываются ветви с найденными типами, а совпадения в названиях подсвечиваются:

../../../_images/documents_06.png

Настроенный вид

Документы:

../../../_images/documents_07.png

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

../../../_images/documents_08.png

Скачивание документов

Кнопка Скачать все документы запрашивает ZIP-архив для списка документов, сформированного виджетом. При выбранном типе используются записи его текущей таблицы; в общем представлении — документы из загруженных групп типов. Кнопка недоступна, пока список подготавливается, во время скачивания и при отсутствии документов.

Эта операция не означает скачивание всех документов карточки независимо от конфигурации виджета или всех исторических версий файлов.

Фильтрация по заполненности типов

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

Состояние

Условие

Все статусы

Без ограничения по заполненности.

Добавлен файл

Для типа есть один документ.

Добавлено несколько файлов

Для типа есть более одного документа.

Необходимо добавить файл / Необходимо добавить файлы

Документов нет, тип обязательный. Формулировка зависит от разрешённого количества файлов.

Можно добавить файл / Можно добавить файлы

Документов нет, тип необязательный. Формулировка зависит от разрешённого количества файлов.

../../../_images/documents_10.png

Пример виджета в административной карточке «Синхронизация пользователей»:

../../../_images/documents_09.png