form

Тег <Form> представляет собой виджет, отображающий форму записи при задании необходимых параметров (таких, как таблица, вид формы, ID записи). Это позволяет пользователю редактировать поля, сохраняя при этом реакцию формы. Он также поддерживает функциональность виджетов, добавленных на форму.

Структура

Данный виджет имеет следующую структуру:

Встроенный виджет, содержащий элементы формы.
Блок заголовка:
1. Заголовок может быть взят из колонки с установленным флажком Полнотекстовый поиск.
Блок секций:
1. Секция Default должна быть первой в списке секций, если их больше одной.
2. Каждая секция виджета относится к соответствующей секции формы и имеет собственный заголовок.
3. Этот блок обязателен.
Блок нижнего колонтитула, который содержит UI-действия (кнопки и другое).

Элементы

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

Элементы виджета отображают дату и время в часовом поясе пользователя.
Элементы виджета, содержащие поля типа Translated Text (например, заголовки таблиц и колонок, выбор опций) отображают значения на языке текущего пользователя.

Атрибуты

Для создания динамической формы, используйте следующие атрибуты:

Атрибут	Тип	Обязательный	Описание
class	String	Нет	Укажите название класса CSS, указанного в поле виджете CSS.
isPortal	Boolean	Нет	Чтобы задать тегу портальное поведение и визуализацию, установите значение true. По умолчанию установлено значение false.
name	String	Нет	Этот атрибут содержит название формы. Задайте название формы через поле Шаблон, как в примере ниже: Шаблон <Form tableName="{data.table_name}" sysId="{data.record_id}" name="custom"></Form> Затем вызовите его через клиентский скрипт виджета: Клиентский скрипт const builtInForm = s_widgets.getForm('custom'); await builtInForm.save();
tableName	String	Да	Укажите название таблицы.
view	String	Нет	Укажите название вида формы таблицы, например, По умолчанию.
save	String	Нет	Добавьте на форму кнопку сохранения, добавив на нее необходимый текст (см. пример ниже). Используйте этот атрибут, когда по каким-либо причинам невозможно использовать UI-действия (значение атрибута uiActions false).
titleHide	Boolean	Нет	При установленном по умолчанию значении true заголовок формы скрыт.
uiActions	Boolean	Нет	Установите значение true, чтобы сделать возможным использование UI-действий. В противном случае их использование будет запрещено (кроме кнопки Сохранить, определенной атрибутом save).
userScripts	Boolean	Нет	Чтобы отключить клиентские скрипты выбранной таблицы, установите для этого атрибута значение false. Значение по умолчанию true.
sysid	String	Нет	Укажите ID записи таблицы, но сначала укажите таблицу через параметр tableName. Если не указать sysid, то отобразится форма новой записи.

Пример формы

Form

<Form tableName="user" sysid="158747771611397284" view="Profile" save="Новая кнопка сохранения" uiActions="true" userScripts="true"></Form>

Дочерний тег IndicatePresence

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

Для отображения виджета, на форме таблицы должен быть установлен флажок Отображать присутствие (indicate_presence=true).

Доступные атрибуты:

Атрибут	Тип	Обязательный	Описание
tableName	String	Да	Укажите название таблицы. Значение должно соответствовать значению атрибута tableName тега <Form>.
recordId	String	Да	Укажите ID записи таблицы. Значение должно соответствовать значению атрибута sysid тега <Form>.

Пример:

IndicatePresence

<IndicatePresence tableName="{data.table_name}" recordId="{data.record_id}"></IndicatePresence>

Page tree