Представление форм

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

Форма записи

Форма записи состоит из следующих элементов:

1. Шапка – содержит название таблицы, бургер-меню , доступные действия пользовательского интерфейса, а также индикатор присутствия.
2. Основная область – содержит название записи и поля.
3. Область связанных ссылок – содержит действия пользовательского интерфейса в формате ссылок.
4. Область связанных списков – содержит списки записей из таблиц, связанных с текущей таблицей.

Доступ к записям

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

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

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

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

Настройка индикации присутствия

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

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

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

По умолчанию отображаются картинка профиля пользователя, его имя и дополнительная строка, в которую транслируется должность. Чтобы изменить информацию, указываемую в дополнительной строке или скрыть ее, отредактируйте системное свойство simple.presence_indication.additional_info_column_name.

Настройка представления формы

Настройка макетов форм позволяет администраторами изменять представления форм для различных бизнес-задач. Создание отдельных видов с наборами полей и виджетов полезно для разных процессов или ролей пользователей.

Каждая таблица SimpleOne имеет представление формы По умолчанию, которое администраторы могут настроить с помощью настройки представления формы.

Чтобы изменить представление, выполните следующие действия:

1. На форме записи в бургер-меню и выберите Настроить → Форма → Макет, чтобы открыть настройки вида формы.
2. В области Формы и секции поле Имя вида отображает вид, из которого вы перешли на страницу настройки. Если вы хотите изменить другой вид формы, выберите его.
3. Настройте представление формы, выполнив следующие действия:
   1. Настройте набор полей в секциях. 
   2. Добавьте новые секции формы.
   3. Разделите секции на вертикальные столбцы.
4. Нажмите Сохранить.

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

Создание вида формы

Чтобы создать отдельный вид, выполните следующие шаги:

1. На форме записи в бургер-меню выберите Настроить → Форма → Макет, чтобы открыть настройки вида формы.
2. В области Формы и секции под полем Имя вида нажмите Добавить.
3. В появившемся модальном окне, введите название вида и нажмите Создать.
   
   
4. Настройте набор отображаемых полей, переместив их из окна Доступно для выбора в окно Выбрано.
5. (опционально) Используйте опцию Секция, чтобы добавить дополнительные секции формы, нажав Добавить.
6. Нажмите Сохранить, чтобы применить изменения.

Настройка секции формы

Секции необходимы для логичного и наглядного разделения полей.

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

Создание секции

Чтобы создать секцию и дополнить ее полями, выполните следующие шаги:

1. На форме записи в бургер-меню и выберите Настроить → Форма → Макет, чтобы открыть настройки вида формы.
2. В области Формы и секции нажмите Добавить под полем Секция.
3. В появившемся модальном окне, введите название секции и нажмите Создать.
   
4. Настройте набор отображаемых полей, переместив их и из окна Доступно для выбора в окно Выбрано.
5. Нажмите Сохранить.

Разделение полей секции

Вы можете настроить местоположение полей и виджетов на форме. Подробнее о виджетах на формах читайте в статье Добавление виджета на форму.

По умолчанию они идут сверху вниз в один столбец. Разделители Начало и Конец не требуются для макета формы, организованного в один столбец. Если вам нужно переставить их в два и более столбца, вы можете использовать для этого разделители.

Чтобы разделить поля на столбцы, выполните следующие действия:

1. Нажмите Начало, чтобы добавить элемент |-begin-split-| в окно Выбрано. Переместите этот элемент, чтобы указать, где начинается область разделения.
2. Нажмите Конец, чтобы добавить элемент |-end-split-| в окно Выбрано. Переместите этот элемент, чтобы указать, где заканчивается область разделения.
3. Нажмите Разделитель, чтобы добавить элемент |-split-| в окно Выбрано. Переместите этот элемент между |-begin-split-| и |-end-split-|, чтобы указать, где поля разделяются на столбцы.
4. (опционально) Добавьте больше элементов |-split-| между |-begin-split-| и |-end-split-|, если вы хотите распределить поля формы в более чем два столбца.
5. (опционально) Добавьте дополнительные наборы элементов |-begin-split-|, |-end-split-| и |-split-| внутри существующих для создания вложенного разделения. Для этого поместите элементы между существующими |-begin-split-| и |-end-split-|. Эти разделения создают подстолбцы внутри столбца. Количество вложенных разделений не ограничено. 
6. Нажмите Сохранить, чтобы применить изменения.

На примере ниже форма разделена на два столбца:

1. Таблица, Тип колонки, Заголовок, Наименование колонки.
2. Активно, Только для чтения, Обязательно, Полнотекстовый поиск, Отображаемое поле, Уникально.

Вторая колонка разделена на еще две колонки:

1. Только для чтения, Обязательно
2. Полнотекстовый поиск, Отображаемое поле

Настройка сложного макета формы

В следующем примере рассмотрим случай создания сложного макета формы. Пунктирные линии на скриншотах ниже обозначают элемент |-split-|. 

Базовая структура макета формы выглядит следующим образом:

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

Настройка области связанных списков

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

Форма записи VCS

Форма записи VCS является агрегатной и содержит данные обо всех связанных с ней элементах: Элементы форм (sys_ui_form_element), Секции форм (sys_ui_form_section), Связанный список (sys_ui_related_list), и Элемент связанного списка (sys_ui_related_list_element). Все они хранятся в поле Копия записи (JSON). 

Схематичное изображение содержания записи VCS:

В поле Копия записи (JSON) хранятся данные обо всех связанных элементах в следующем виде:

 "title": "Default",
    "policy": "Changed",
    "sys_id": 155964310500000007,
    "user_id": null,
    "table_id": 155931135900000083,
    "aggregate":
    {
        "sys_ui_form_element":
        {
            "156863988112688893":
            {
                "sys_id": 156863988112688893,
                "position": 7,
                "column_id": 155931135900001081,
                "formatter": null,
                "_TABLE_NAME_": "sys_ui_form_element",
                "sys_created_at": "2019-09-30 00:00:00",
                "sys_created_by": 155931135900000001,
                "sys_updated_at": "2022-11-10 12:59:02",
                "sys_updated_by": 155931135900000001,
                "form_section_id": 155964310500000007,
                "displayable_path": null,
                "widget_instance_id": null,
                "form_split_element_type": null
				}
   "sys_ui_related_list":
        {
            "156931267516865423":
            {
                "title": "Default",
                "sys_id": 156931267516865423,
                "form_id": 155964310500000007,
                "user_id": null,
                "table_id": 155931135900000083,
                "_TABLE_NAME_": "sys_ui_related_list",
                "sys_created_at": "2019-09-30 00:00:00",
                "sys_created_by": 155931135900000001,
                "sys_updated_at": "2020-04-27 14:50:56",
                "sys_updated_by": null
            }
        }