Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Merged branch "DOC0000070" into parent

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

Структура


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

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

Элементы 


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

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

Атрибуты


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

Атрибут

Тип

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

Описание

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

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

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

шаблоне

примере ниже

Code Block
languagexml
title
Form name
Шаблон
<Form tableName="{data.table_name}" sysId="{data.record_id}" name="custom"></Form>

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

Code Block
languagejs
themeEclipse
title
Клиентский скрипт
linenumberstrue
Form name
const builtInForm = s_widgets.getForm('custom');
await builtInForm.save();


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

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

Используйте 

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

"

false

"

).

titleHideBooleanНет
При установленном по умолчанию значении "true"

Установите значение атрибута true, чтобы отразить заголовок формы

скрыт

. Значение по умолчанию: false.

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

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

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

Предварительно нужно указать саму таблицу в атрибуте tableName.

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

Если не указать sysid, то отображается форма создания записи.


Пример

формы

:

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

Image Removed

<form
    name="leadForm"
    tableName="crm_leads"
    view="Modal Form Disqualify"
    uiActions="false"
    userScripts="true"
></form>
<div class="buttonsModalQualify">
    <button buttonType="unstyled" event-click="window.s_widget_custom.cancel()">{data.cancel}</button>
    <button disabled="{data.isDisabled}" buttonType="primary" event-click="window.s_widget_custom.save()">{data.save}</button>
</div>

Шаблон из примера добавляет следующий элемент на страницу:

Image Added

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


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

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

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

АтрибутТипОбязательныйОписание
tableNameStringДа

Укажите название таблицы. Значение должно соответствовать значению атрибута tableName тега <Form>.

recordIdStringДа

Укажите ID записи таблицы. Значение должно соответствовать значению атрибута sysid тега <Form>.

Пример:

Code Block
languagexml
themeEclipse
titleIndicatePresence
linenumberstrue
<IndicatePresence tableName="{data.table_name}" recordId="{data.record_id}"></IndicatePresence>

Шаблон из примера добавляет следующий элемент на страницу:

Image Added

Table of Contents
absoluteUrltrue
classfixedCondition
Table of Contents
absoluteUrltrue
printablefalse