Skip to content

Latest commit

 

History

History
313 lines (199 loc) · 12.4 KB

form_examples.rst

File metadata and controls

313 lines (199 loc) · 12.4 KB

Примеры компонент

Columns

Компонент Columns позволяет удобно расположить компоненты формы.

_static/form_examples/columns_1.png

Свойства столбца - основной параметр настройки, позволяет определить как по колонкам будет разбиваться компонент. Компонент основан на использовании Bootstrap Grid.

_static/form_examples/columns_2.png

На вкладке «Вид» в разделе Свойства столбца указать количество столбцов и их размер.

_static/form_examples/columns_3.png

Далее нажать "Сохранить". Результат:

_static/form_examples/columns_4.png

Text field

Text field - текстовый компонент. Будем использовать, например, для полей «Код», «Имя», «Фамилия», «Отчество».

На вкладке «Базовые» заполняется:

  • Название поля - имя компонента, как оно будет отражаться на форме (1).
  • Имя свойства - имя свойства в типе данных (2).

Обязательность поля выставляется отдельным чекбоксом. (3)

_static/form_examples/Text_field_1.png

ECOS Select Component

ECOS Select Component - компонент формы для выбора значения из списка. Будем использовать для поля «Пол».

На вкладке «Базовые» заполняется:

  • Название поля - имя компонента, как оно будет отражаться на форме (1).
  • Имя свойства - имя свойства в типе данных (2).

Обязательность поля выставляется отдельным чекбоксом. (3)

_static/form_examples/ECOS_Select_1.png

На вкладке «Данные» в "Типе источника данных" выбрать Values (1).

Data Source Values заполняется значениями, которые должны быть для выбора в списке (2):

  • Название поле - отображаемое имя,
  • Значение - значение, которое содержится.
_static/form_examples/ECOS_Select_2.png

Date / Time Component

Date / Time Component - компонент даты / времени. Будем использовать для поля «Дата рождения».

На вкладке «Базовые» заполняется:

  • Название поля - имя компонента, как оно будет отражаться на форме (1).
  • Имя свойства - имя свойства в типе данных (2).

Обязательность поля выставляется отдельным чекбоксом. (3)

_static/form_examples/Date_Time_1.png

На вкладке «Вид» указать формат даты (5) и возможность ручного ввода (4).

_static/form_examples/Date_Time_2.png

Select Journal Component

Select Journal Component - компонент для выбора значения из журнала. Будем использовать для поля «Город».

На вкладке «Базовые» заполняется:

  • Название поля - имя компонента, как оно будет отражаться на форме (1).
  • Имя свойства - имя свойства в типе данных (2).

Обязательность поля выставляется отдельным чекбоксом. (3)

_static/form_examples/Select_Journal_1.png

На вкладке «Данные» заполняется ID журнала - идентификатор журнала, который будет использовать в компоненте. (4)

_static/form_examples/Select_Journal_2.png

Button Component

Button Component - компонент для добавления кнопок для выполнения различных действий в форме.

На вкладке «Базовые» заполняются:

  • Название поля - наименование кнопки, как оно будет отражаться на форме (1).
  • Имя свойства - имя свойства кнопки (2).
  • Действия - указать действие кнопки (3)
_static/form_examples/button.png

Собранная в конструкторе форма с компонентами:

_static/form_examples/form_full.png

Для отображения кнопки на всю ширину ячейки необходимо на вкладке "Вид" выставить чекбокс "Блокировать":

_static/form_examples/button_1.png

Panel

Panel - компонент - заголовок, в который помещаются близкие по смыслу компоненты. Будем использовать, например, для раздела «Регистрация».

_static/form_examples/form_2.png

Заполняется «Имя свойства» - имя компонента.

_static/form_examples/form_3.png

И на вкладке "Вид" заполнить "Название свойства" (2):

_static/form_examples/form_14.png

Select Orgstruct Component

Select Orgstruct Component - компонент для выбора из оргструктуры. Будем использовать, например, для поля "Инициатор" («idocs:initiator»).

На вкладке «Базовые» заполняется:

  • Название поля - имя компонента, как оно будет отражаться на форме (1).
  • Имя свойства - имя свойства в типе данных (2).
_static/form_examples/form_4.png

На вкладке «Кастомные» - можно указать:

  • допустимый «Разрешенный тип полномочий» (3)
  • Текущий пользователь по умолчанию - настройка, позволяющая подставить в компонент пользователя, который открыл форму на создание (4).
_static/form_examples/form_5.png

Async Data Component

Async Data Component - асинхронный компонент. Будем использовать, например, для поля "Инициатор".

_static/form_examples/form_6.png

На вкладке «Асинхронные данные» заполняется:

  • Название поля - имя компонента, как оно будет отражаться на форме (1).
  • Тип данных - тип данных (2).
_static/form_examples/form_7.png

Пояснения к скрипту (3):

_static/form_examples/form_8.png
  • emodel/type@hr-grades-type - тип, из которого необходимо получить данные.
  • gradesSimpleRoleTypeAssoc - сравниваемое свойство типа, из которого получаем данные.
  • offerPosition - свойство, которое используем для сравнения со свойством типа, из которого получаем данные.

В «Атрибуты» указываются атрибуты, который необходимо получить (4).

На вкладке «Расширенные настройки» заполняется:

  • Обновлять при -параметр, в котором указывается элемент формы, которые следует отслеживать (5).
_static/form_examples/form_9.png

На вкладке «API» заполняется:

  • Имя свойства - имя свойства компонента.
_static/form_examples/form_10.png

Чтобы компонент формы реагировал на асинхронный компонент, необходимо сделать следующие настройки во вкладке «Данные» в компоненте Грейд:

_static/form_examples/form_11.png

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

В Вычисляемые значения:

_static/form_examples/form_12.png

Теперь при выборе должности в компонент формы «Грейд» в зависимости от значения компонента «Должность», будет автоматически выставлено значение.

How to

Сделать компонент нередактируемым

  • вкладка «Вид» - Скрыть поле - делает компонент нередактируемым.
_static/form_examples/form_13.png

Скрыть поле на форме, если оно пустое

Полезно, например, на :ref:`канбан-доске<kanban_board>`:

_static/form_examples/form_15.png

Текст скрипта:

show = !_.isEmpty(value)

Статус

На форме документа :ref:`статус<associations>` может быть отражен следующим образом:

_static/form_examples/form_status.png

В компоненте :ref:`Text field <Text_Field>`:

  • название поля может быть любым,
  • имя свойства - _status,
  • скрыть и заблокировать на ввод, если необходимо не отображать на форме.