Update form_fields.rst

forms/form_fields.rst

@@ -82,21 +82,6 @@
    Добавление новой строки в таблицу
 
 
-Настройки текстового поля
--------------------------
-
-Для компонента «Однострочное поле» доступны следующие настройки:
-
-* **Обязательное поле** — делает поле обязательным для заполнения;
-* **Заблокировать от изменений** — запрещает пользователю изменять значение;
-* **Шифровать данные** — шифрует введенные значения;
-* **Маска ввода** — ограничивает формат вводимых данных;
-* **Плейсхолдер** — отображает подсказку внутри пустого поля.
-
-В данном случае поле помечается как обязательное и блокируется
-от изменений пользователем, так как значение будет заполняться системой.
-
-
 Поле 2. Статус заказа
 --------------------
 
@@ -132,31 +117,121 @@
     * «Позволять поиск» позволяет найти нужное значение в справочнике
     * «Связь с компонентом» позволяет связывать справочники между собой, для фильтрации определенных значений в зависимости от другого справочника.
     
-Однострочные поля
--------------
+Поле 3. Тип заявителя
+--------------------
+Для поля «Тип заявителя» мы используем компонент **«Переключатель вариантов»**. Т.к в данном случае предполагается использование компонента, позволяющее выбрать только один возможный вариант.
+
+Переключатель вариантов по своим настройкам похож на компонент «Выпадающий список», внутри него так же используется вложенный справочник, либо возможные значения заполняются вручную по нажатию на вкладку **«Элементы»**
+
+**Шаги:**
+
+**Шаг 1.** На форме в нужной строке добавляем компонент **«Переключатель вариантов»**.
+
+**Шаг 2.** Кликаем по компоненту и переходим в его настройки.
+
+**Шаг 3.** Открываем вкладку **«Элементы»**.
+
+**Шаг 4.** В таблице ниже добавляем возможные варианты:
+
+* указываем наименование значения («ЮЛ», «ИП»);
+
+* задаём соответствующее значение (код, может быть как числовым так и буквенным).
 
-Компонент «Однострочное поле» используется для ввода и отображения
-произвольного текстового значения в одну строку.
+**Шаг 5.** После указания всех необходимых значений нажимаем «ОК».
+
+Поля 4,5,6,7,8,9: «БИН организации», «ИИН индивидуального предпринимателя», «Наименование организации или индивидуального предпринимателя», «ФИО Руководителя организации», «Номер телефона», «Адрес электронной почты»
+--------------------
+
+Поля 4–9 предназначены для ввода идентификационных и контактных данных заявителя.
+Все эти значения представляют собой короткий текст, вводимый в одну строку, поэтому для них используется компонент **«Однострочное поле**.
+
+Компонент **«Однострочное поле»** позволяет вводить и отображать произвольное текстовое значение в одну строку (без абзацев) и подходит для таких данных, как:
+
+* идентификаторы (БИН, ИИН);
+
+* наименования и ФИО;
+
+* номер телефона;
+
+* адрес электронной почты.
 
 .. figure:: ../resources/img/field_text_input.png
 
    Компонент «Однострочное поле»
 
+.. note::
+
+ Для компонента «Однострочное поле» доступны следующие настройки:
+
+ * **Обязательное поле** — делает поле обязательным для заполнения;
+ * **Заблокировать от изменений** — запрещает пользователю изменять значение;
+ * **Шифровать данные** — шифрует введенные значения;
+ * **Маска ввода** — ограничивает формат вводимых данных;
+ * **Плейсхолдер** — отображает подсказку внутри пустого поля.
+
+**Шаги:**
+
+**Шаг 1.** Для каждого из полей 4-9 добавляем в правую ячейку компонент **"Однострочное поле"**
+
+**Шаг 2.** В настройках каждого компонента присваем читаемый и логичный код поля.
 
-Продолжение добавления полей
-----------------------------
+**Шаг 3.** Отмечаем галочку «Обязательное поле» — согласно звёздочке в ордере рядом с названием поля.
 
-Аналогичным образом на форму добавляются остальные поля заявки,
-описанные в ордере.
+**Шаг 4.** Отмечаем галочку "Заблокировать от изменений" тем полям, у которых в примечании ордера указано что поля заполняются автоматически.
 
-Для каждого поля:
+Настройки формата (маска ввода и регулярные выражения)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-* выбирается соответствующий тип компонента;
-* добавляется название поля;
-* настраиваются свойства компонента в соответствии с типом данных.
+⚠️ Маска ввода настраивается отдельно для каждого компонента.
+
+1. Формат полей **"ИИН индивидуального предпринимателя" и "БИН организации"**
+
+**Шаги:**
+
+**Шаг 1.** В настройках компонента включаем галочку **«Маска ввода»**
+
+**Шаг 2.** В октрывшемся поле открываем настройки маски ввода
+
+**Шаг 3.** В таблице с настройками для задания формата 12-значного числового значения используем маску ############. 
+
+Маску можно:
+
+ * Ввести вручную
+ * Кликом по строке в предложенной таблице
+
+
+2. Формат поля **"Номер телефона"**
+
+**Шаг 1.** Для поля «Номер телефона» также включаем настройку «Маска ввода».
+
+**Шаг 2.** В маске указываем формат с фиксированными символами, например: +7 (###) ###-##-##
+
+Фиксированные символы (например, +7) будут:
+
+* автоматически подставляться;
+
+* недоступны для удаления или изменения пользователем.
+
+Это позволяет обеспечить корректный формат ввода номера телефона.
+
+3. Настройки формата поля **"Электронная почта"**
+
+Для поля «Адрес электронной почты» требуется строгая проверка формата.
+
+**Шаг 1.** Включаем настройку «Маска ввода».
+
+**Шаг 2.** После этого становится доступна дополнительная галочка **Регулярное выражение* - отмечаем её
+
+**Шаг 3.** Нажимаем на иконку настроек уже в октрывшемся поле **Регулярное выражения**
+
+**Шаг 4.** В открывшемся окне выбираем готовый шаблон формата e-mail из списка доступных регулярных выражений.
+
+**Шаг 5.** Нажимаем "Ок"
+
+.. note::
+
+ При ручном редактировании регулярного выражения для применения изменений необходимо нажать Enter.
 
-После добавления всех полей форма полностью соответствует
-структуре данных ордера и готова к дальнейшей настройке.
 
 .. seealso::
 
@@ -164,8 +239,6 @@
    http://rtd.lan.arta.kz/docs/docs-po-platforme-arta-synergy/ru/latest/form/components.html
 
 
-
-
 Результат этапа
 ---------------
 
@@ -175,6 +248,4 @@
 * каждому полю соответствует правильный тип компонента;
 * форма готова к настройке форматных ограничений и логики отображения.
 
-В следующем этапе будет выполнена настройка форматов ввода
-и масок для отдельных полей.