Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

Структура


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

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

Элементы 


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

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

Атрибуты


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

Атрибут

Тип

Обязательный

Описание

classStringНетУкажите название класса CSS, указанного в поле CSS.
isPortalBooleanНетЧтобы отобразить виджет на портале, установите значение “true”. По умолчанию установлено значение “false”.
nameStringНет

Этот атрибут содержит название формы.

Задайте название формы через поле Шаблон в шаблоне: 

Code Block
languagexml
titleForm name
<Form tableName="{data.table_name}" sysId="{data.record_id}" name="custom"></Form>

Затем вызовите его через клиентский скрипт виджета:

Code Block
languagejs
themeEclipse
titleForm name
const builtInForm = s_widgets.getForm('custom');
await builtInForm.save();


tableNameStringДаУкажите название таблицы.
viewStringНетУкажите название шаблона таблицы, например, «По умолчанию».
saveStringНет

Добавьте на форму кнопку сохранения, добавив на нее необходимый текст (см. пример ниже)

Используйте  этот атрибут, когда по каким-либо причинам невозможно использовать UI-действия (значение атрибута uiActions  "false").

titleHideBooleanНетПри установленном по умолчанию значении "true" заголовок формы скрыт. 
uiActionsBooleanНетУстановите значение "true", чтобы сделать возможным использование UI-действий. В противном случае их использование будет запрещено (кроме кнопки Сохранить, определенной атрибутом save).
userScriptsBooleanНетЧтобы клиентские скрипты, указанные в поле Клиентский скрипт, были доступны для использования, установите для этого атрибута значение "true". В противном случае их использование запрещено.
sysidStringНет

Укажите ID записи таблицы.

Info

Сначала укажите таблицу через параметр tableName.


Note

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


Пример формы


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


Table of Contents
absoluteUrltrue
printablefalse