Свойства поля формы

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

../../../_images/properties_form11.png
../../../_images/properties_form22.png
  • <: выход из Свойства поля формы.

  • Корзина: удаление панели, панель удаляется вместе с содержимым.

  • Фильтр: поиск по наименованию. При вводе текста выполняется фильтрация по подстроке — отображаются все значения, в которых введенный текст встречается в любом месте слова, регистр не важен.

  • Уникальный идентификатор: уникальный ID поля, формируется системно. Только для чтения с возможностью копирования.

  • Наименование: название поля, доступно для редактирования.

Если заполнено Наименование и Наименование представления, в поле отображается Наименование представления, чтобы отображалось Наименование, Наименование представления необходимо удалить.

  • Наименование представления: название поля, доступно для редактирования. Если заполнено название, в поле отображается именно оно.

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

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

  • Разрешить для поля значение по умолчанию: в случае установки чек-бокса на поле, если нет Источника данных или нет передачи данных в поле (то есть предполагается пустое значение в поле), то при первом отображении формы в данных поля будет заполнено пустое значение.

Например: есть “Поле1” без данных.

При активном чек-боксе в структуре поле будет выглядеть так: “Поле1”: “”, в ином случае в структуре поле с пустым значением отображаться не будет.

Актуально для запуска бизнес-процесса для сопоставления структуры.

По умолчанию чек-бокс выключен.

  • Тип поля: указывается Тип поля, выбор из представленных значений:

  • Строка; текстовое значение: буквы, цифры, символы.

  • Число; цифровое значение: целое или дробное.

  • Логическое/флаг; чек-бокс.

  • Дата/время; установка даты и времени.

  • Перечисление; тип данных “Перечисление”, задается в “Центре настройки”, числовое значение и наименование. Доступен выбор одного значения.

  • Форматированный Json.

  • Дата/время UTC; значение даты и времени по всемирному времени (UTC).

  • Дата; значение даты.

  • Дата UTC дата в UTC.

  • Массив; доступный выбор нескольких значений.

  • Выбираемые данные; выбор одного значения из символа с тремя точками.

  • Выпадающий список; выбор одного значения из представленного списка.

  • Пароль введенное значение будет закрыто звездочками.

  • Выбор категории; выбор одного значения из списка категорий.

  • Html элемент; код HTML, который отобразится в элементе в преобразованном виде.

  • Группа переключателей Radio; группа круглых радио-переключателей, расположенных рядом друг с другом.

  • Группа переключателей radio категории; список категорий с возможностью выбора через радио-переключатели.

  • Выпадающий список категории; набор категорий в виде выпадающего списка.

  • Поле генератор полей по ссылке на тип данных забирает его форму и вставляет вместо себя.

  • Многострочное текстовое поле; текст, состоящий из нескольких строк.

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

  • Компонент сравнения данных; компонент сравнения схожих элементов и отображающий результат объединения.

  • Константное значение: фиксированное, заранее заданное значение, которое не изменяется пользователем.

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

  • Селектор категории элемент - селектор, с возможностью поиска и выбора таблицы с категориями для отображения ее в новом окне.

  • Выпадающий список в виде таблицы выпадающий список с возможностью пагинации и фильтрации.

  • Выпадающий список категорий в виде таблицы выпадающий список категорий с возможностью пагинации фильтрации.

  • Скрывать поле с пустыми данными: при активации чек-бокса, если в поле не указано значение, поле не будет видно. По умолчанию чек-бокс не активен.

  • Формат данных: применяется в случае установки в Тип поля значений: Дата/время; Дата/время UTC; Дата; Дата UTC.

Формат для даты и времени: dd.MM.yyyy HH:mm:ss

Для даты: dd.MM.yyyy

  • Видимость: видимость поля в Функциональной области и ее содержания, управляется с помощью чек-бокса - если заполнен, поле видно, если не заполнен - не видно.

Восстановить видимость возможно через Поля UI элемента Левой панели инструментов.

  • Разрешить редактирование: доступность редактирования поля.

При активном чек-боксе содержание поля можно редактировать, в ином случае содержимое только для чтения.

По умолчанию чек-бокс не активен.

  • Перечисление: в случае, если указан Тип поля колонки Перечисление, задается ID перечисления.

ID находится в URL конкретного Типа данных в Центре настройки

../../../_images/table_column3.png

При переходе в конкретное Перечисление Центра настройки ID указан после Enum

../../../_images/table_column4.png
  • Контент: указывается в случае, если в Тип поля Выбираемые данные.

  • Наименование группы.

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

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

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

Например:

Необходимо создать новый массив и в него записывать “Поле1”, “Поле2”.

“Путь объединения данных” - СводныеДанные

для “Поля1” и “Поля2” в свойствах “Путь объединения данных” указывается СводныеДанные

создается новый массив, в него записываются построчно Поле1 и Поле2 в случае изменения значений в соответствующем поле.

  • Порядковый номер.

  • Путь к данным проверки.

  • Тип данных: заданные элементы. Типы данных создаются в Центре настроек.

  • Сортировка.

  • Значимое: при установке чек-бокса значение поля выделяется жирным.

../../../_images/properties_form3.png

По умолчанию чек-бокс выключен.

  • Обновление полей шаблонов родителя: свойство будет работать, если у формы указан Тип данных, соответственно, у поля указан Путь к данным.

При активации чек-бокса на поле происходит обновление полей шаблона родителя (поля, которое связано с полем, где установлен чек-бокс).

Шаблон задается в Центре настроек: “Тип данных” ‣ “Шаблон наименований”

../../../_images/properties_form4.png

Например: Форма с заданным “Типом данных”.

На поле “Артикул” включен чек-бокс “Обновление полей шаблонов родителя”.

В “Центре настроек” в “Шаблоне наименований” в связанном поле указан шаблон заполнения с участием поля “Артикул”.

При изменении данных в поле “Артикул” в связанном поле (где настроен шаблон) значения будут меняться.

Чек-бокс по умолчанию выключен.

Валидация

Помимо настройки валидации по полю в Свойствах также валидация указывается в Центре настройки для заданных Типов данных в Проверке.

../../../_images/properties_form5.png
  • Валидация: чтобы работала валидация по полю, необходимо в свойствах формы включить чек-бокс Валидация.

При включении чек-бокса Валидация на поле будет валидироваться значение поля, актуально также для случая Проверки для типа данных в Центре настроек, то есть чек-бокс Валидация на поле должен быть включен.

Настройки валидации задаются ниже в группе.

По умолчанию чек-бокс включен.

  • Валидация на нулевое значение: проверка на заполненность поля.

При включении чек-бокса предполагается обязательное заполнение поля, в случае пустого будет подсвечиваться ошибка Поле не должно быть пустым.

По умолчанию чек-бокс выключен.

  • Регулярное выражение валидации: шаблон, по которому проверяется правильность ввода данных (например, email, номер телефона или код).

Например, регулярное выражение “^d{10}$” проверяет ввод только 10 цифр (актуально для указания номера телефона).

  • Описание ошибки валидации регулярного выражения: указывается текст ошибки в случае неверно указанного регулярного значения.

Источник данных

Для настройки свойств источников данных для полей Источник данных должен быть настроен на весь UI элемент Форма, таким образом можно выбрать, какие данные из источника наследовать в конкретное поле.

  • Путь к данным в источнике. указывается, какие данные необходимо получить из источника.

Данные отображаются в поле в случае совпадения “ключа” (EntityId) в Путь к данным привязки в мастере источнике и Путь к данным в источнике текущего поля.

Например, “ТипыКонтрагентов.Наименование”

  • Путь к данным привязки в мастере источнике: путь к ключу данных из всей Формы, по которым осуществляется привязка данных из источника формы. С ним будет сравниваться Путь к данным в источнике текущего поля.

Например: “ТипыКонтрагентов.EntityId”

  • Путь к данным в источнике текущего поля: путь к данным из источника данных конкретного поля.

Например: “ТипыКонтрагентов.EntityId”

EntityId - ID поля, уникальный идентификатор

  • Источник данных: перечень Источников данных, настроенных в Левой панели инструментов. Источники данных служат для связывания сущностей для построения таблиц и других объектов.

Для снятия Источника данных необходимо нажать на Х

../../../_images/panel_chart21.png