Описания интерфейса
Интерфейс для работы с объектами позволяет просматривать и редактировать информацию об объектах, работать с различными визуальными элементами, а также выполнять действия с объектами.
Описание интерфейса системы является частью схемы домена и включается в поле views на уровне домена.
Структура actions
Поле actions представляет собой массив записей действий и является необязательным.
Записи действий включают общие поля, а также специфические поля, которые наличествуют в зависимости от типа действия.
Общие поля для всех типов действий
Следующая таблица описывает поля, которые присутствуют во всех записях действий, независимо от их типа.
| Поле | Обязательность и значение по умолчанию | Описание | Тип данных |
|---|---|---|---|
|
Да |
Уникальный идентификатор действия. |
View ID |
|
Нет (по умолчанию: пустая строка) |
Наименование действия. Используется, если не определен или не может быть определен |
строка |
|
Нет (по умолчанию: пустая строка) |
Описание действия. Не выводится в представлениях, но отображается в схеме домена. |
строка |
|
Да |
Тип действия. Ознакомьтесь со списком доступных действий. |
перечисление |
Допустимые значения для поля type
Поле type в записи действия может принимать следующие значения, каждое из которых определяет специфические поля действия:
-
open_panel— открыть панель деталей объекта (только для панели); -
open_modal— открыть модальное окно для создания или редактирования объекта (только для модального окна); -
open_list— открыть списочное представление объектов с заполненным контекстом на основании выбранного объекта в текущем списке; -
open_page— открыть полноэкранную карточку объекта; -
open_graph_view— открыть граф связей, позволяющий создавать, изменять и удалять экземпляры связей, а также просматривать связи объекта на разных уровнях; -
remove— удалить объект; -
bulk— массовое действие; -
playbook— запуск выполнения указанного плейбука или скрипта; -
generate_qr_code— открыть модальное окно со сгенерированным QR-кодом, содержащим ссылку на компактное представление сущности; -
copy_entity_link— скопировать полный URL объекта, включая параметры текущего состояния формы.
Поля, применимые при type: open_panel
Эта таблица описывает поля, применимые для действий типа open_panel.
| Поле | Обязательность и значение по умолчанию | Описание | Тип данных |
|---|---|---|---|
|
Да |
Ссылка на панель, которая будет открываться при этом действии. |
строка |
|
Да |
Ссылка на сущность, над экземпляром которой производится действие. |
Data ID Ref или FQID |
Поля, применимые при type: open_modal
Эта таблица описывает поля, применимые для действий типа open_modal.
| Поле | Обязательность и значение по умолчанию | Описание | Тип данных |
|---|---|---|---|
|
Да |
Ссылка на модальное окно, которое будет открываться при этом действии. |
строка |
|
Да |
Ссылка на сущность, над экземпляром которой производится действие. |
Data ID Ref или FQID |
|
Да |
Тип операции над объектом. Доступные значения:
|
перечисление |
Поля, применимые при type: open_list
Эта таблица описывает поля, применимые для действий типа open_list.
| Поле | Обязательность и значение по умолчанию | Описание | Тип данных |
|---|---|---|---|
|
Да |
Ссылка на списочное представление объектов, зависимых от контекста. |
View ID Ref |
|
Нет (по умолчанию: |
Флаг, запрещающий удаление контекста из фильтра списка объектов. |
булево |
|
Нет |
Окно, в котором будет отображен список. Возможные значения:
|
перечисление |
|
Нет |
Ссылка на атрибут-ссылку, для которого будет применен контекст. Список объектов можно отфильтровать по значению атрибута-ссылки. Нельзя указывать одновременно с |
строка |
|
Нет |
Ссылка на связь, для которой будет применен контекст. Список объектов можно отфильтровать по одной из сторон связи. Нельзя указывать одновременно с |
строка |
|
Нет |
Сторона ссылки или связи, в соответствии с которой отображаются объекты в списочном представлении с контекстом. Указывается только для симметричной направленной связи. Возможные значения:
|
Data ID Ref или FQID |
Поля, применимые при type: open_page
Эта таблица описывает поля, применимые для действий типа open_page.
| Поле | Обязательность и значение по умолчанию | Описание | Тип данных |
|---|---|---|---|
|
Да |
Ссылка на списочное представление объектов, зависимых от контекста. |
View ID Ref |
|
Да |
Ссылка на сущность, над экземпляром которой производится действие. |
Data ID Ref или FQID |
|
Да |
Тип операции над объектом. Доступные значения:
|
перечисление |
Поля, применимые при type: open_graph_view
Эта таблица описывает поля, применимые для действий типа open_graph_view.
| Поле | Обязательность и значение по умолчанию | Описание | Тип данных |
|---|---|---|---|
|
Да |
Ссылка на сущность, над экземпляром которой производится действие. |
Data ID Ref или FQID |
Поля, применимые при type: remove
Эта таблица описывает поля, применимые для действий типа remove.
| Поле | Обязательность и значение по умолчанию | Описание | Тип данных |
|---|---|---|---|
|
Да |
Ссылка на сущность, над экземпляром которой производится действие. |
Data ID Ref или FQID |
Поля, применимые при type: bulk
Эта таблица описывает поля, применимые для действий типа bulk (массовые операции).
| Поле | Обязательность и значение по умолчанию | Описание | Тип данных |
|---|---|---|---|
|
Да |
Ссылка на сущность, над экземпляром которой производится действие. |
Data ID Ref или FQID |
|
Да |
Тип операции над объектом. Доступные значения:
|
перечисление |
|
Нет |
Ссылка на атрибут-ссылку, для которого будет применен контекст. |
строка |
|
Да (для |
Массив параметров атрибутов, доступных для массового редактирования. Подробнее о поле |
массив |
Структура attributes (в описании действия)
В поле attributes задаются параметры атрибутов, доступных для массового редактирования. Оно включает следующие поля:
| Поле | Обязательность и значение по умолчанию | Описание | Тип данных |
|---|---|---|---|
|
Да |
Тип атрибутов. Указывается значение |
перечисление |
|
Да |
Массив Data ID Ref атрибутов сущности, доступных для массового редактирования. |
массив |
Поля, применимые при type: playbook
Эта таблица описывает поля, применимые для действий типа playbook.
| Поле | Обязательность и значение по умолчанию | Описание | Тип данных |
|---|---|---|---|
|
Нет |
Ссылка на плейбук или скрипт. Уникальное наименование плейбука или скрипта в рамках текущей экспертизы. |
строка |
|
Нет |
Тег воркера, используемый для выполнения запуска. |
строка |
Структура menus
Поле menus представляет собой массив записей элементов меню.
Запись включает следующие поля:
| Поле | Обязательное поле | Описание | Комментарий |
|---|---|---|---|
|
да |
Идентификатор элемента меню. |
View ID |
|
нет |
Описание меню. Не выводится в представлениях. |
строка |
|
да |
Компонент адреса текущего пункта меню, отображаемый в строке веб-браузера. Фактически определяет путь в адресной строке, по которому можно перейти на целевую страницу. Пути должны быть уникальными как в рамках одной схемы домена, так и в разных схемах. |
путь в URL |
|
да |
Отображаемое в меню системы название раздела домена. |
строка |
|
нет |
Ссылка на медиа-ресурс. |
строка |
|
да |
Тип элемента меню:
|
перечисление |
|
да |
Настройки расположения меню в левой панели:
|
перечисление |
|
нет |
Параметр, определяющий положение в главном меню, чем больше — тем выше в списке. Значение должно быть не меньше |
целое число |
|
да |
Ссылка на списочное представление или на представление списков с вкладками. Поле доступно только для типа |
View ID Ref |
|
да |
Дочерние элементы для корневой группы меню. Массив записей меню с подразделами типов сущностей. Используется для типа элементов меню Ознакомьтесь с описанием поля |
массив |
Структура items
Поле items используется для создания массива записей пунктов меню в разделе домена.
Запись включает следующие поля:
| Поле | Обязательное поле | Описание | Тип данных |
|---|---|---|---|
|
да |
Идентификатор элемента меню. |
View ID |
|
нет |
Описание меню. Не выводится в представлениях. |
строка |
|
да |
Компонент адреса текущего пункта меню, отображаемый в строке веб-браузера. Фактически определяет путь в адресной строке, по которому можно перейти на целевую страницу. |
путь в URL |
|
да |
Отображаемое в меню системы название пункта меню. |
строка |
|
да |
Тип элемента меню. Устанавливается значение |
перечисление |
|
да |
Ссылка на представление. Ссылка на списочное представление или на представление списков с вкладками. |
View ID Ref |
|
нет |
Параметр, определяющий положение элемента в корневом меню, чем больше — тем выше в списке. Значение должно быть не меньше |
целое число |
Структура medias
Поле medias представляет собой массив записей элементов иконок.
Запись включает следующие поля:
| Поле | Обязательное поле | Значение по умолчанию | Описание | Тип данных | Комментарий |
|---|---|---|---|---|---|
|
да |
Идентификатор иконки, которая будет использоваться в виджетах представлений и элементах меню. |
View ID |
||
|
нет |
Пустая строка |
Описание элемента домена. |
строка |
Не выводится в представлениях. Отображается в схеме домена |
|
да |
Тип иконки. |
перечисление |
Определяет тип медиа ресурса и его возможности. В текущей реализации поддерживается один тип иконки |
|
|
да |
Идентификатор медиаресурса в библиотеке |
строка |
Структура views
Поле views представляет собой массив записей, описывающих различные интерфейсы системы (представления). Каждая запись включает общие поля, а также специфические поля, которые зависят от типа представления, указанного в поле type.
Общие поля для всех типов представлений
Следующая таблица описывает поля, которые присутствуют во всех записях представлений, независимо от их типа.
| Поле | Обязательность и значение по умолчанию | Описание | Тип данных |
|---|---|---|---|
|
Да |
Уникальный идентификатор интерфейса. |
View ID |
|
Да |
Тип интерфейса. Определяет, какие специфические поля будут применяться. Ознакомьтесь со списком доступных типов. |
перечисление |
|
Нет (по умолчанию: пустая строка) |
Наименование, используемое в заголовках. Для полноэкранной карточки поддерживаются форматы: |
строка |
|
Нет (по умолчанию: пустая строка) |
Описание элемента. Не выводится в интерфейсе, но отображается на схеме домена. |
строка |
Допустимые типы представлений (type)
Поле type может принимать следующие значения:
-
entity— представление одного объекта (панели, модальные окна). -
page— представление полноэкранной карточки объекта. -
list— представление списка объектов (таблица с фильтрами и действиями). -
tabs_list— группа вкладок, каждая из которых содержит список объектов. -
dashboard— дашборд (группа виджетов-плиток с действиями). -
tree— представление древовидных связей.
Поля, применимые при type: entity
Эта таблица описывает поля, применимые для представлений типа entity.
| Поле | Обязательность и значение по умолчанию | Описание | Тип данных |
|---|---|---|---|
|
Да |
Ссылка на идентификатор сущности. |
Data ID Ref или FQID |
|
Да |
Массив записей виджетов, используемых в представлении. |
массив |
|
Да |
Массив записей групп (блоков, вкладок, форм). |
массив |
|
Да |
Массив записей, описывающих конкретные панели и модальные окна. |
массив |
Поля, применимые при type: page
Эта таблица описывает поля, применимые для представлений типа page (полноэкранная карточка).
| Поле | Обязательность и значение по умолчанию | Описание | Тип данных |
|---|---|---|---|
|
Да |
Ссылка на идентификатор сущности. |
Data ID Ref или FQID |
|
Да |
Массив записей виджетов, используемых в представлении. |
массив |
|
Да |
Массив записей групп (блоков, вкладок, форм). |
массив |
|
Нет |
Массив ссылок на группы или виджеты, отображаемые в карточке. Нельзя использовать одновременно с |
массив ссылок |
|
Нет |
Массив ссылок на вкладки, отображаемые в карточке. Нельзя использовать одновременно с |
массив ссылок |
|
Нет |
Блок, закрепленный в карточке для постоянного отображения. |
объект |
Структура pinnedView
Настройки в поле pinnedView определяют, какой блок будет закреплен для постоянного отображения в карточке. Поле имеет следующую структуру:
| Поле | Обязательность и значение по умолчанию | Описание | Тип данных |
|---|---|---|---|
|
Да |
Ссылка на группу или виджет, закрепленные на странице. |
Data ID Ref |
|
Нет |
Параметры закрепления блока. Допустимые значения:
|
перечисление |
|
Нет |
Минимальная высота блока. Задается в процентах или пикселях (например, |
строка |
|
Нет |
Максимальная высота блока. Задается в процентах или пикселях (например, |
строка |
Поля, применимые при type: list
Эта таблица описывает поля, применимые для представлений типа list.
| Поле | Обязательность и значение по умолчанию | Описание | Тип данных |
|---|---|---|---|
|
Да |
Источник списка объектов. |
объект |
|
Нет (по умолчанию: пустой массив) |
Массив ссылок на виджеты действий, отображаемые на панели действий над списком. |
массив ссылок |
|
Да |
Таблица списка объектов. Доступно для интерфейса списка объектов. Ознакомьтесь с описанием поля |
объект |
Структура source
Поле source представляет собой параметры источника объектов для списка. Запись включает следующие поля:
| Поле | Обязательность и значение по умолчанию | Описание | Тип данных |
|---|---|---|---|
|
Да (по умолчанию: |
Тип источника. Всегда устанавливается значение |
перечисление |
|
Да |
Ссылка на сущность, данные объектов и связей которой отображаются в списке. |
Data ID Ref или FQID |
|
Нет |
Массив записей связей с сущностями, данные которых будут отображаться в списке. Подробнее. |
массив |
Структура joins
Поле joins представляет собой массив записей связей с сущностями, данные которых будут отображаться в списке.
| Поле | Обязательность и значение по умолчанию | Описание | Тип данных |
|---|---|---|---|
|
Да |
Идентификатор связи. |
Data ID |
|
Да |
Ссылка на связь с сущностью. |
Data ID Ref |
|
Нет |
Сторона связи. Доступные значения:
|
перечисление |
|
Нет (по умолчанию: пустая строка) |
Описание связи. |
строка |
Поля, применимые при type: tabs_list
Эта таблица описывает поля, применимые для представлений типа tabs_list.
| Поле | Обязательность и значение по умолчанию | Описание | Тип данных |
|---|---|---|---|
|
Нет (по умолчанию: первая вкладка) |
View ID Ref вкладки, которая будет открыта по умолчанию. |
View ID Ref |
|
Да |
Массив ссылок на идентификаторы описаний интерфейсов списков. |
массив ссылок |
Поля, применимые при type: dashboard
Эта таблица описывает поля, применимые для представлений типа dashboard.
| Поле | Обязательность и значение по умолчанию | Описание | Тип данных |
|---|---|---|---|
|
Да |
Массив записей виджетов, используемых на дашборде. |
массив |
|
Нет |
Настройки взаимного расположения виджетов на дашборде. |
объект |
Структура layout (в интерфейсе дашбордов)
В поле layout задаются настройки взаимного расположения компонентов в интерфейсе. Оно включает следующие поля:
| Поле | Обязательность и значение по умолчанию | Описание | Тип данных |
|---|---|---|---|
|
Нет (по умолчанию: |
Тип взаимного расположения виджетов. Значение |
перечисление |
|
Нет (по умолчанию: |
Количество столбцов в сетке (при |
число |
Поля, применимые при type: tree
Эта таблица описывает поля, применимые для представлений типа tree (древовидные связи).
| Поле | Обязательность и значение по умолчанию | Описание | Тип данных |
|---|---|---|---|
|
Да |
Ссылка на идентификатор дерева, описанного в блоке |
Data ID Ref |
|
Да |
В интерфейсе рядом со свернутым узлом связи дерева отображается команда Показать еще n, где |
целое число |
|
Да |
Определяет, как будет отображаться представление. Доступные значения:
|
перечисление |
|
Нет (по умолчанию: |
Булево поле, разрешающее изменять расположение узлов в дереве. Требует, чтобы в самом дереве ( |
булево |
|
Да (для древовидных связей при |
Ссылка на идентификатор описания интерфейса списка объектов. |
ViewID |
|
Нет |
Название корневого узла древовидной структуры узлов связи в окне слева. Доступно для древовидных связей при |
строка |
|
Да |
Заголовок окна со списком объектов в листовых узлах. Доступно для древовидных связей при |
строка |
|
Нет |
Массив записей со ссылками на действия, доступные в представлении. Доступно для древовидных связей при |
массив |
|
Да |
Настройки табличного отображения. |
объект |
Поле variant
Значения поля variant определяет отображение представления древовидной связи:
-
Если в поле установлено значение
splitted, в представлении отобразятся два окна:-
окно с деревом узлов связи;
-
окно со списком объектов в листовых узлах, являющихся дочерними для узла, выбранного в окне с деревом.
-
-
Если установлено значение
merged, в представлении отобразится одно окно, содержащее дерево узлов связи и список объектов в листовых узлах, являющихся дочерними для узла, выбранного в дереве.
Структура widgets
Поле widgets представляет собой массив записей, описывающих виджеты — визуальные компоненты интерфейса. Каждая запись виджета включает общие поля, а также специфические поля, которые зависят от типа виджета, указанного в поле type.
Общие поля для всех типов виджетов
Следующая таблица описывает поля, которые присутствуют во всех записях виджетов, независимо от их типа.
| Поле | Обязательность и значение по умолчанию | Описание | Тип данных |
|---|---|---|---|
|
Да |
Уникальный идентификатор виджета. |
View ID |
|
Да |
Тип виджета. Определяет, какие специфические поля будут применяться. Ознакомьтесь со списком доступных типов. |
перечисление |
|
Нет |
Описание виджета. |
строка |
Допустимые типы виджетов (type)
Поле type в записи виджета может принимать следующие значения:
-
attribute— виджет атрибута, позволяющий отображать и редактировать значение атрибута объекта. -
action— виджет действия, позволяющий запускать действие с передачей контекста. -
linkage— виджет связи, позволяющий отображать и менять список связанных объектов. -
visualization— виджет графического отображения (графики, диаграммы). -
history— виджет истории изменений, отображающий события аудита. -
comments— виджет комментариев. -
linkage_list— виджет списка связей. -
card— виджет для дашбордов. -
conversation— виджет переписок.
Поля, применимые при type: attribute
Эта таблица описывает поля, применимые для виджетов типа attribute.
| Поле | Обязательность и значение по умолчанию | Описание | Тип данных |
|---|---|---|---|
|
Да |
Ссылка на атрибут сущности, значение которого будет отображаться и редактироваться. |
Data ID Ref |
|
Нет |
Элемент управления для отображения атрибута. Если не указан, определяется автоматически. |
объект |
|
Нет |
Высота поля по умолчанию в количестве текстовых строк (только для атрибутов типа |
целое число |
Поля, применимые при type: action
Эта таблица описывает поля, применимые для виджетов типа action.
| Поле | Обязательность и значение по умолчанию | Описание | Тип данных |
|---|---|---|---|
|
Да (если |
Ссылка на одно действие, которое будет выполняться. Нельзя использовать одновременно с |
View ID Ref |
|
Да (если |
Массив ссылок на действия. Формирует выпадающее меню. Нельзя использовать одновременно с |
массив ссылок |
|
Нет |
Элемент управления (кнопка). Можно задать иконку. |
объект |
Поля, применимые при type: linkage
Эта таблица описывает поля, применимые для виджетов типа linkage.
| Поле | Обязательность и значение по умолчанию | Описание | Тип данных |
|---|---|---|---|
|
Да |
Ссылка на связь сущности, состав которой будет отображаться и редактироваться. |
Data ID Ref |
|
Да (для внешней связи) (по умолчанию: |
Сторона связи. Возможные значения:
|
перечисление |
|
Нет (по умолчанию: пустая строка) |
Наименование связи, отображаемое в виджете. |
строка |
|
Нет |
Элемент управления для отображения связи. Возможные значения:
|
объект |
Поля, применимые при type: visualization
Эта таблица описывает поля, применимые для виджетов типа visualization.
| Поле | Обязательность и значение по умолчанию | Описание | Тип данных |
|---|---|---|---|
|
Нет |
Название визуализации. |
строка |
|
Да |
RQL-запрос для построения визуализации. |
RQL-запрос |
|
Да |
Массив атрибутов сущности, используемых как переменные в RQL-запросе. |
массив |
|
Да |
Временной период отображения данных. |
объект |
|
Да |
Ограничение на количество строк в результате RQL-запроса. |
целое число |
|
Да |
Тип источника данных. Устанавливается значение |
перечисление |
|
Да |
Тип визуализации. Доступные значения:
|
перечисление |
|
Да |
Имя переменной, соответствующей хранилищу событий или активному списку. |
массив |
|
Да |
Сопоставление полей данных с элементами графика (оси, группировка). |
массив |
Поля, применимые при type: history
Эта таблица описывает поля, применимые для виджетов типа history.
| Поле | Обязательность и значение по умолчанию | Описание | Тип данных |
|---|---|---|---|
|
Да |
Идентификатор хранилища событий, из которого загружаются события для отображения. |
строка |
Поля, применимые при type: comments
Виджет типа comments использует только общие поля, описанные в разделе Общие поля для всех типов виджетов. Дополнительных специфических полей для этого типа не требуется.
Поля, применимые при type: linkage_list
Эта таблица описывает поля, применимые для виджетов типа linkage_list.
| Поле | Обязательность и значение по умолчанию | Описание | Тип данных |
|---|---|---|---|
|
Да |
Правило, определяющее, какие связи доступны для просмотра и редактирования. Если не заполнено, доступны все связи. |
объект |
Поля, применимые при type: card
Эта таблица описывает поля, применимые для виджетов типа card (используются на дашбордах).
| Поле | Обязательность и значение по умолчанию | Описание | Тип данных |
|---|---|---|---|
|
Нет |
Ссылка на идентификатор медиаресурса (иконки). |
View ID Ref |
|
Да (в |
Ссылка на действие, которое будет запускаться при клике на виджет. |
View ID Ref |
Поля, применимые при type: conversation
Эта таблица описывает поля, применимые для виджетов типа conversation.
| Поле | Обязательность и значение по умолчанию | Описание | Тип данных |
|---|---|---|---|
|
Да |
Ссылка на связь сущности из текущего домена с сущностью |
Data ID Ref |
|
Нет |
Массив для ограничения доступных транспортов (например, только email). Если не указан, доступны все транспорты. |
массив |
Структура groups
Поле groups представляет собой массив записей визуальных элементов, на которые ссылается представление.
Поле groups включает следующие поля:
| Поле | Обязательное поле | Значение по умолчанию | Описание | Тип данных | Комментарий |
|---|---|---|---|---|---|
|
да |
Уникальный идентификатор группы представления. |
View ID |
||
|
нет |
Пустая строка |
Описание группы представления. |
строка |
|
|
да |
Тип группы. |
перечисление |
Доступные значения:
Блоки, вкладки и формы описаны ниже. |
|
|
нет |
Настройки взаимного расположения компонентов в группе. |
размещение компонентов группы представлений |
Ознакомьтесь с описанием поля Доступно только для типов |
|
|
да |
Массив записей блоков, из которых состоит вкладка. |
массив |
Ознакомьтесь с описанием поля |
|
|
нет |
Меню группы представления. |
массив |
Доступно только для типа |
|
|
нет |
Пустая строка |
Наименование группы представления. |
строка |
Доступно только для типов:
|
Структура layout (в группе представления)
Поле layout представляет собой массив записей настроек взаимного расположения элементов. Доступно только для типов block и resizable_block_pair.
Описание поля для типа block
Запись включает следующие поля:
| Поле | Обязательное поле | Значение по умолчанию | Описание | Тип данных | Комментарий |
|---|---|---|---|---|---|
|
да |
Порядок отображения элементов в записи группы |
строка |
Направление размещения определяет, как будут располагаться компоненты внутри группы. Возможное значение — |
|
|
нет |
false |
Возможность развернуть элемент |
булево |
Доступные значения:
|
Описание поля для типа resizable_block_pair
Запись включает следующие поля:
| Поле | Обязательное поле | Значение по умолчанию | Описание | Тип данных | Комментарий |
|---|---|---|---|---|---|
|
нет |
Минимальная высота блока |
строка |
Задается в процентах или пикселях. Формат: числовое значение и единица измерения без пробелов. Например, |
|
|
нет |
Максимальная высота блока |
строка |
Задается в процентах или пикселях. Формат: числовое значение и единица измерения без пробелов. Например, |
|
|
нет |
Соотношение размеров секций |
строка |
Можно указать либо одну из сторон, либо обе стороны. Сначала указывается значение для левой секции, а затем для правой. Формат: |
Структура components
Поле components используется для перечисления компонентов элемента поля groups. Такими компонентами могут быть:
-
виджеты — для блоков, форм и вкладок;
-
блоки — для форм, вкладок, панелей вкладок и блоков, содержащих две секции с регулируемыми размерами.
Поле components включает поля следующих типов:
| Поле | Описание | Тип данных |
|---|---|---|
|
Уникальный идентификатор блока. Блоки перечисляются только для типов |
View ID Ref |
|
Уникальный идентификатор виджета. |
View ID Ref |
Тип компонентов определяется типом группы:
-
Для групп типа
block— ссылки на виджеты. -
Для групп типа
tabиform— ссылки на группы типаblock, а также виджеты. -
Для группы типа
tabs— ссылки на группы типаtab. -
Для группы типа
resizable_block_pair— две ссылки на группы типаblockилиtabs.
Структура views (панели и модальные окна)
Конфигурация интерфейса объекта включает следующие поля:
| Поле | Обязательное поле | Значение по умолчанию | Описание | Тип данных | Комментарий |
|---|---|---|---|---|---|
|
да |
Уникальный идентификатор представления одного объекта. |
View ID |
||
|
нет |
Пустая строка |
Описание элемента домена. |
строка |
|
|
да |
Тип представления одного объекта. |
строка |
Определяет тип представления одного объекта, который влияет на поведение и возможности интерфейса с учетом контекста использования. Возможные значения:
|
|
|
нет |
Пустая строка |
Название, отображаемое в интерфейсе. |
строка |
|
|
нет |
Действия, отображаемые в меню панели. |
массив |
Доступно только для представлений с типом Ознакомьтесь с описанием поля. |
|
|
да |
Вкладки, отображаемые в панели. |
массив |
Ознакомьтесь с описанием поля. |
|
|
Ссылка на группу с типом |
ссылка на форму |
|||
|
Массив записей кнопок, отображаемых в модальном окне. |
массив |
Доступно только для представлений с типом Ознакомьтесь с описанием поля |
Схема записи панели
views:
# Уникальный идентификатор.
- id:
# Описание.
description:
# Тип представления (панель).
type: panel
# Название панели.
label:
# Меню панели.
menu:
# Действие.
- action:
# Параметры управления.
# Массив записей вкладок панели.
tabs:
# Идентификатор вкладки.
- tab:
Схема записи модального окна
views:
# Уникальный идентификатор.
id:
# Описание.
description:
# Тип представления (модальное окно).
type: modal
# Ссылка на форму (описывается в поле groups с типом form).
form:
# Название модального окна.
label:
Схема записи блока из двух секций регулируемой ширины
groups:
# Идентификатор записи в группе
- id:
# Описание записи в группе
description:
# Тип записи в группе
type: resizable_block_pair
# Настройки взаимного расположения элементов
layout:
# Минимальная высота секций
minHeight:
# Максимальная высота секций
maxHeight:
# Параметр расположения элементов
sizeRatio:
# Ссылки на блоки, отображаемые в блоке из двух секций
components:
# Ссылка на первый блок вкладки
- block: deviceInfoBlock
# Ссылка на второй блок вкладки
- block: deviceConfigurationBlock
Структура menu
Поле menu представляет собой массив записей элементов меню.
Запись включает следующие поля:
| Поле | Обязательное поле | Значение по умолчанию | Описание | Тип данных | Комментарий |
|---|---|---|---|---|---|
|
да |
Ссылка на действие, вызываемое в меню. |
View ID Ref |
Действие, которое будет вызвано при нажатии на элемент меню. Действия, которые работают с контекстом списка, могут быть недоступны, если в списке не выбраны нужные данные. Например, действие массового удаления объектов не будет работать, если в списке не выбран ни один объект. |
Структура buttons
Поле buttons используется для создания массива записей кнопок, отображаемых в модальном окне.
Запись включает следующие поля:
| Поле | Описание | Тип данных | Комментарий |
|---|---|---|---|
|
Идентификатор модального окна. |
строка |
Доступные значения типа:
|
|
Название кнопки. |
строка |
Необязательное поле. Если значение не указано, система добавляет название по умолчанию. |
Схема записи кнопки
buttons:
# Название кнопки.
label:
# Описание типа кнопки.
- type:
# Описание настроек параметров управления.
control:
# Тип параметра управления (кнопка).
type: regular_button
# Идентификатор медиаресурса для иконки кнопки.
icon:
Структура layout (в интерфейсе дашбордов)
В поле layout задаются настройки взаимного расположения компонентов в интерфейсе.
Оно включает следующие поля:
| Поле | Обязательное поле | Значение по умолчанию | Описание | Тип данных | Комментарий |
|---|---|---|---|---|---|
|
нет |
grid |
Тип взаимного расположения виджетов в интерфейсе. |
перечисление |
Значение |
|
нет |
3 |
Количество столбцов в интерфейсе виджетов. |
число |
Значение указывается, если в поле |
Структура table (список объектов)
Поле table содержит настройки табличного отображения сведений о списке объектов.
Оно включает следующие поля:
| Поле | Обязательное поле | Значение по умолчанию | Описание | Тип данных | Комментарий |
|---|---|---|---|---|---|
|
да |
Массив записей с описанием столбцов таблицы. |
массив столбцов таблицы |
Ознакомьтесь с описанием поля |
|
|
нет |
Настройки фильтрации столбцов. |
объект |
Ознакомьтесь с описанием поля |
|
|
нет |
Ссылки на правила сортировки атрибутов сущности. |
объект |
Ознакомьтесь с описанием поля |
|
|
нет |
Пагинация данных. |
объект Ознакомьтесь с описанием поля |
refresh |
|
|
Обновление данных. |
объект |
Ознакомьтесь с описанием поля |
selection |
|
|
|
Возможность выбора строки таблицы. |
булево |
Ознакомьтесь с описанием поля |
actions |
|
Пустой массив |
Действие при нажатии на строку таблицы. |
массив действий на события таблицы |
Ознакомьтесь с описанием поля |
empty |
|
Информация, отображаемая в таблице, если данные отсутствуют. |
сообщение при отсутствии строк в таблице |
Ознакомьтесь с описанием поля |
Структура empty
Поле empty содержит настройки отображения сообщения в таблице, если данные отсутствуют.
Настройка включает следующие поля:
| Поле | Описание | Тип данных | Комментарий |
|---|---|---|---|
|
Отображение сообщения в таблице, если данные отсутствуют. |
строка |
Необходимо указать отображаемое сообщение в поле |
Структура columns (в таблице списка объектов)
Поле columns содержит массив записей столбцов таблицы.
Столбец включает следующие поля:
| Поле | Обязательное поле | Значение по умолчанию | Описание | Тип данных | Комментарий |
|---|---|---|---|---|---|
|
да |
Идентификатор столбца таблицы. |
массив |
||
|
да |
Атрибут столбца. |
строка |
||
|
нет |
Ссылка на идентификатор связи с сущностью, атрибут которой будет отображаться. |
Data ID Ref |
Значение в этом поле указывается, только если необходимо описать атрибут связанной сущности. Связь, на которую вы ссылаетесь, должна быть предварительно задана в поле |
|
|
Элемент управления для атрибута, отображаемого в колонке таблицы. |
объект |
Описывает элемент управления для атрибута, отображаемого в столбце таблицы, для древовидной связи — отображение пути от корня дерева до узла. Ознакомьтесь с описанием поля |
||
|
нет |
Массив настроек размера и видимости столбца. |
массив |
Ознакомьтесь с описанием поля |
|
|
нет |
Наименование столбца. |
строка |
Если значение этого поля не задано, в качестве наименования берется |
Поле control в столбце таблицы
Поле control содержит настройку отображения в столбце значения атрибута, а также пути от корня дерева до узла при использовании таблицы в древовидной связи.
Настройка включает следующие поля:
| Поле | Обязательное поле | Описание | Тип данных | Комментарий |
|---|---|---|---|---|
|
да |
Тип редактора, используемый в столбце, в соответствии с таблицей. |
строка |
В этом поле можно изменить используемый по умолчанию тип редактора в столбце на другой допустимый тип. Допустимые типы для разных контекстов представлены в таблице. Для пути от корня в представлении древовидной связи устанавливается значение |
|
да (для древовидных связей) |
Ссылка на идентификатор дерева |
FQID Ref |
|
|
да (при type: |
Отображаемая строка для значения |
строка |
|
|
да (при type: |
Отображаемая строка для значения |
строка |
Структура layout (в столбце списка объектов)
Поле layout содержит массив настроек размера и видимости.
Настройка включает следующие поля:
| Поле | Обязательное поле | Значение по умолчанию | Описание | Тип данных | Комментарий |
|---|---|---|---|---|---|
|
нет |
|
Видимость столбца. |
строка |
В этом поле доступны следующие значения:
|
|
нет |
Ширина столбца в пикселях. |
объект |
Ознакомьтесь с описанием поля |
Схема использования столбца
table:
columns:
# Идентификатор столбца.
- id:
# Атрибут столбца.
attribute:
# Тип данных в столбце.
type
# Массив настроек столбца.
layout:
# Параметр видимости столбца.
visible:
# Ширина столбца (по умолчанию, минимальная, максимальная).
width:
default:
min:
max:
Настройки ширины столбца (width)
Поле width содержит массив настроек ширины столбца.
Настройка включает следующие поля:
| Поле | Обязательное поле | Значение по умолчанию | Описание | Тип данных |
|---|---|---|---|---|
|
да |
Ширина столбца по умолчанию, в пикселях. |
целое положительное число |
|
|
да |
Максимальная ширина столбца в пикселях. |
целое положительное число |
|
|
да |
Минимальная ширина столбца в пикселях. |
целое положительное число |
Структура filter
Данные, по которым осуществляется фильтрация, должны быть описаны в настройках фильтрации. Фильтрация по этим данным в системе доступна независимо от того, отображаются ли они в интерфейсе списка объектов (таблице).
Фильтровать данные можно:
-
по атрибутам сущности;
-
по лейблу и атрибутам связанного объекта.
Фильтрация по атрибутам связанного объекта невозможна, если связь установлена через атрибут типа Reference.Для ссылки на атрибут в настройках фильтрации используйте значение поля idв описании атрибута сущности.
Поле filter содержит массив настроек фильтрации столбцов таблицы.
Фильтр включает следующие поля:
| Поле | Обязательное поле | Значение по умолчанию | Описание | Тип данных | Комментарий |
|---|---|---|---|---|---|
|
нет |
Массив ссылок на атрибуты сущности, по которым производится фильтрация. |
Ознакомьтесь с описанием поля |
||
|
нет |
Массив ссылок на связи сущности, по которым производится фильтрация. |
Ознакомьтесь с описанием поля |
Структура attributes (в фильтре списка объектов)
Поле attributes содержит массив ссылок на атрибуты сущности, по которым производится фильтрация.
Оно включает следующие поля:
| Поле | Обязательное поля | Описание | Тип данных |
|---|---|---|---|
|
да |
тип фильтрации. Доступные значения:
|
перечисление |
|
да (при |
Массив ссылок на атрибуты, по которым производится фильтрация. Запись атрибута включает поля:
Ознакомьтесь со схемой. |
массив |
Структура linkages (в фильтре списка объектов)
Поле linkages используется:
-
для задания ссылок на связи сущности, по которым производится фильтрация;
-
для задания атрибутов связанных сущностей, по которым производится фильтрация.
Структура включает следующие поля:
| Поле | Обязательное поле | Значение по умолчанию | Описание | Тип данных | Комментарий |
|---|---|---|---|---|---|
|
да (при ссылках на связи) |
Тип фильтрации. |
Заполняется при задании ссылок на связи сущности. Можно указать следующие типы фильтрации:
|
||
|
да (при ссылках на связи) |
Массив ссылок на связи, по которым производится фильтрация. |
Задается, если в поле В этом поле перечисляются связи, по которым осуществляется фильтрация в таблице. Ознакомьтесь со схемой. |
||
|
да (при ссылках на атрибуты) |
Ссылка на связь с другой сущностью. |
Заполняется при задании ссылок на атрибуты связанных сущностей. Поле |
Схема фильтрации по отдельным атрибутам и связям
table:
# Поле фильтрации.
filter:
# Тип фильтрации по отдельным атрибутам, перечисленным в поле use.
attributes:
type: specific
use:
- attribute: <attribute_1>
- attribute: <attribute_2>
...
# Фильтрация по атрибутам атрибута-таблицы.
- attribute: <table_attribute>
use:
- attribute: <table_attribute_1>
- attribute: <table_attribute_2>
...
# Тип фильтрации по отдельным связям, перечисленным в поле use.
linkages:
type: specific
use:
# Ссылка на связь с сущностью.
- linkage: <entity_1>
linkedEntity:
# Ссылки на атрибуты связанной сущности, по которым будет производиться фильтрация.
- attribute: <attribute_3>
- attribute: <attribute_4>
...
- linkage: <entity_2>
...
Сортировка в столбцах таблицы (sortingBy)
Поле sortingBy содержит описание сортировки в столбцах таблицы.
Настройки включают следующие поля:
| Поле | Обязательное поле | Значение по умолчанию | Описание | Тип данных | Комментарий |
|---|---|---|---|---|---|
|
да |
Массив записей столбцов, для которых возможна сортировка в таблице. |
массив привязок правил сортировки к столбцам |
В этом поле указывается:
|
|
|
нет |
Массив записей столбцов с указанием направления сортировки по умолчанию. |
сортировка таблицы по умолчанию |
В этом поле указывается:
|
Настройки количества записей в таблице (paging)
Поле paging содержит настройки количества записей, показываемых в таблице.
Настройка включает следующие поля:
| Поле | Обязательное поле | Значение по умолчанию | Описание | Тип данных | Комментарий |
|---|---|---|---|---|---|
|
да |
Количество записей, показываемых в таблице. |
массив целых положительных чисел |
В этом поле указываются варианты количества записей, доступные для выбора в настройке. Например, |
|
|
да |
Количество записей, показываемых по умолчанию. |
целое положительное число |
Структура refresh
Поле refresh содержит настройки обновления записей, показываемых в таблице.
Настройка включает следующие поля:
| Поле | Обязательное поле | Значение по умолчанию | Описание | Тип данных | Комментарий |
|---|---|---|---|---|---|
|
да |
Режимы обновления. |
перечисление |
В этом поле указываются режимы обновления записей:
|
|
|
да |
Настройки автообновления. |
объект |
Поле доступно только для настроек фильтров таблиц с типами:
Ознакомьтесь с описанием поля |
Структура defaults
Поле defaults содержит настройки автообновления записей, показываемых в таблице. Используется, если в поле mode установлено значение auto или all.
Настройка включает следующие поля:
| Поле | Описание | Тип данных | Комментарий |
|---|---|---|---|
|
Включение и выключение автообновления. |
булево |
|
|
Единица измерения интервала автообновления. |
перечисление |
Доступные значения:
|
|
Количество единиц измерения интервала автообновления. |
целое положительное число |
Структура selection
Поле selection содержит настройки возможности выбора записей, показываемых в таблице.
Настройка включает следующие поля:
| Поле | Описание | Тип данных | Комментарий |
|---|---|---|---|
|
Возможность выбора записей. |
булево |
Доступные значения:
|
Структура actions (в списке объектов)
Поле actions содержит настройки действий в таблице.
Настройка включает следующие поля:
| Поле | Описание | Тип данных | Комментарий |
|---|---|---|---|
|
Тип действия. |
строка |
Доступные значения:
|
|
Ссылка на идентификатор действия. |
строка |
Доступно только для действия типа |
|
Массив ссылок на идентификаторы действий в контекстном меню. |
строка |
Максимальное количество записей в массиве: 7. Доступно только для действия типа Ознакомьтесь с описанием поля |
Структура items
Поле items содержит массив ссылок на идентификаторы действий в контекстном меню.
Настройка включает следующие поля:
| Поле | Описание | Тип данных | Комментарий |
|---|---|---|---|
|
Действие. |
Ссылка на идентификатор действия |
|
|
Название действия, отображаемое в контекстном меню. |
строка |
Если значение поля не задано, отображается значение поля |
|
Иконка действия в контекстном меню. |
Ссылка на идентификатор иконки |
Настройка интерфейса полноэкранной карточки объекта
Полноэкранная карточка объекта отображается на всю рабочую область экрана. В полноэкранной карточке можно отображать следующие визуальные элементы интерфейса, которые должны быть предварительно описаны в схеме:
-
виджеты действий, отображаемые на панели действий над карточкой.
-
блоки контента полноэкранного представления, содержащие виджеты или наборы виджетов. Блоки могут содержать несколько вкладок.
-
панель вкладок полноэкранного представления. Каждая вкладка содержит по крайней мере один блок полноэкранного представления.
Возможны следующие варианты отображения полноэкранной карточки:
-
блок контента полноэкранного представления или несколько блоков. Блоки включают в себя виджеты или группы виджетов. Вкладки отсутствуют.
-
блок, включающий несколько вкладок с виджетами или группами виджетов.
-
панель вкладок, содержащих блоки контента. Блоки могут содержать вкладки.
В каждом варианте в зависимости от настроек может отображаться панель действий карточки.
Действия создания и редактирования объектов в полноэкранной карточке
Вы можете задать в схеме домена действие, использующее конфигурацию type = open_page и operation = create.
Виджет действия, ссылающийся на это действие, позволяет отобразить полноэкранную карточку в режиме создания объекта.
Здесь можно указать данные для создания нового объекта текущей сущности. В панели действий карточки в режиме создания
всегда первой отображается кнопка Создать, позволяющая сохранить созданный объект.
Если действие использует конфигурацию type = open_page и operation = edit, его виджет позволяет отобразить
полноэкранную карточку в режиме редактирования объекта. В карточке можно отредактировать объект текущей сущности.
В панели действий карточки в режиме редактирования всегда первой отображается кнопка Сохранить, позволяющая сохранить внесенные изменения.
| Перед сохранением данных карточки объекта убедитесь, что все необходимые поля заполнены. |
Блок контента полноэкранной карточки
Ссылка на блок контента размещается в поле block интерфейса полноэкранной карточки. Блок контента может содержать набор виджетов или несколько вкладок с наборами виджетов.
| Элемент | Как задается в схеме домена |
|---|---|
Заголовок |
Поле |
Набор виджетов в блоке контента |
В поле |
Панель вкладок в блоке контента |
Массив ссылок на вкладки в интерфейсе объекта.
|
Отображаемая вкладка или блок виджетов |
Ссылка на вкладку в интерфейсе объекта, размещенная первой в массиве ссылок, или ссылка на блок с набором виджетов атрибутов.
|
Панель вкладок полноэкранной карточки
Ссылки на вкладки панели размещаются как записи массива в поле tabs интерфейса полноэкранной карточки. Каждая вкладка содержит по крайней мере один блок контента.
| Элемент | Как задается в схеме домена |
|---|---|
Заголовок |
Поле |
Вкладка в панели вкладок |
Описывается как ссылка на вкладку в массиве ссылок на вкладки в интерфейсе объекта. Каждая вкладка содержит как минимум одну ссылку на блок контента. |
Отображаемая вкладка или блок виджетов |
Описывается как ссылка на вкладку панели, размещенная первой в поле tabs. Вкладка описывается в поле |
Отображение в блоке контента двух секций регулируемой ширины
В блоке контента можно отображать две секции, каждая из которых представляет собой блок с виджетами. Для этого:
-
Опишите блок с двумя секциями:
-
Укажите в поле
groupsинтерфейса объекта группу типаresizable_block_pair. -
Укажите в группе ссылки на блоки, отображаемые в секциях блока контента.
-
Укажите параметры ширины секций.
-
-
Сошлитесь на идентификатор блока с двумя секциями при описании блока контента.
Размеры секций блока в интерфейсе можно изменять, перетаскивая их границы курсором мыши.
Была ли полезна эта страница?