Представления

Этот раздел описывает действия с сущностями в схеме домена.

Интерфейс для работы с объектами позволяет просматривать и редактировать информацию об объектах, работать с различными визуальными элементами, а также выполнять действия с объектами. Описание интерфейса системы является частью схемы домена и включается в поле views на уровне домена.

В описаниях интерфейса используются ссылки на действия, меню домена, а также иконки для виджетов представлений и элементов меню.

Ознакомьтесь с правилами нотации в схеме домена. Это позволит присваивать корректные названия создаваемым элементам схемы. Эти названия будут отображаться в интерфейсе системы.

Структура views

Путь в схеме: views[]

Поле views представляет собой массив записей, описывающих различные интерфейсы системы — представления.

Описания представлений включают общие поля и специфические в зависимости от типа представления.

Общие поля для всех типов представлений

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

Поле Обязательность и значение по умолчанию Описание Тип данных

id

Да

Уникальный идентификатор интерфейса.

View ID

label

Нет (по умолчанию: пустая строка)

Наименование, используемое в заголовках. Для полноэкранной карточки поддерживаются форматы: "строка" или "{<attribute_id>}".

строка

description

Нет (по умолчанию: пустая строка)

Описание элемента. Не выводится в интерфейсе, но отображается на схеме домена.

строка

type

Да

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

перечисление

Типы представлений (type)

Путь в схеме: views[].type

Поле type может принимать следующие значения:

  • entity — представление одного объекта.

  • list — представление списка объектов.

  • tabs_list — группа вкладок, каждая из которых содержит список объектов.

  • dashboard — дашборд: группа виджетов-плиток с действиями.

  • tree — представление древовидных связей.

  • dashboard_tree — представление навигации по списочным представлениям.

Представление объекта (type: entity)

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

Списочное представление (type: list)

Представление списка объектов содержит таблицу с возможностью фильтрами и панель действий. Ознакомьтесь с описанием списочного представления.

Списочное представление с несколькими вкладками (type: tabs_list)

Описание представления типа tabs_list дополнительно включает поля:

Поле Обязательность и значение по умолчанию Описание Тип данных

defaultTab

Нет (по умолчанию: первая вкладка)

View ID Ref вкладки, которая будет открыта по умолчанию.

View ID Ref

tabs

Да

Массив ссылок на идентификаторы описаний интерфейсов списков.
Формат: tabs: - view: <ссылка>

массив ссылок

Дашборд (type: dashboard)

Описание представления типа dashboard дополнительно включает поля:

Поле Обязательность и значение по умолчанию Описание Тип данных

widgets

Да

Массив записей виджетов, используемых на дашборде.

массив

layout

Нет

Настройки взаимного расположения виджетов на дашборде. Ознакомьтесь с описанием поля layout.

объект

Расположение компонентов (layout)

Путь в схеме: views[].layout

В поле layout задаются настройки взаимного расположения компонентов в интерфейсе. Поле имеет следующую структуру:

Поле Обязательность и значение по умолчанию Описание Тип данных

type

Нет (по умолчанию: grid)

Тип взаимного расположения виджетов. Значение grid позволяет расположить виджеты в виде сетки.

перечисление

columns

Нет (по умолчанию: 3)

Количество столбцов в сетке (при type: grid).

число

Дерево (type: tree)

Дерево отображает древовидные связи между сущностями. Ознакомьтесь с описанием интерфейса древовидной связи.

Навигация (type: dashboard_tree)

Описание представления типа dashboard_tree дополнительно включает поля:

Поле Обязательное поле Описание Тип данных

defaultItem

нет

Настройка отображения общедоменных виджетов.

Указывается идентификатор представления с type: dashboard. При открытии дашборда будут отображены только общедоменные виджеты из указанного представления.

View ID Ref

tree

да

Настройка структуры дерева навигации.

Ознакомьтесь с описанием поля tree.

массив

Структуры дерева навигации (tree)

Путь в схеме: views[].tree

Поле tree является массивом элементов дерева навигации. Каждый элемент массива имеет следующую структуру:

Поле Обязательное поле Описание Тип данных

view

да

Представление, которое отображается при нажатии на элемент дерева.

Указывается идентификатор представления с типом dashboard или list. В последнем случае при нажатии будет отображаться указанное списочное представление с панелью действий.

View ID Ref

label

нет

Отображаемое название элемента дерева. Если не указано, отображается название, указанное в поле label списочного представления.

строка

autoTree

нет

Настройка автоматического построения дерева наследников. Содержит поле entity, где указывается идентификатор родительской сущности, от которой строится дерево наследников.

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

Если у сущности нет наследников, выводится только она.

объект

children

нет

Настройка вложенной структуры дерева. Имеет такую же структуру, как и поле tree.

Доступно, если не указано поле autoTree.

массив

Пример описания дерева
tree:
    - view: allCards
      children:
          - view: serviceVacation
          - view: serviceWorkplace
          - view: serviceVpn
    - view: CI
      label: Конфигурационная единица
      autoTree:
          entity: example.com/CI

Иконки (medias)

Путь в схеме: medias[]

Поле medias представляет собой массив записей элементов иконок. Каждый элемент массива имеет следующую структуру:

Поле Обязательное поле Значение по умолчанию Описание Тип данных Комментарий

id

да

Идентификатор иконки, которая будет использоваться в виджетах представлений и элементах меню.

View ID

description

нет

Пустая строка

Описание элемента домена.

строка

Не выводится в представлениях. Отображается в схеме домена

type

да

Тип иконки.

перечисление

Определяет тип медиаресурса и его возможности.

В текущей реализации поддерживается один тип иконки icon_name — именованная иконка из дизайн-системы.

iconName

да

Идентификатор медиаресурса в библиотеке

строка

Была ли полезна эта страница?

Обратная связь