Update form_fields.rst

forms/form_fields.rst

@@ -116,6 +116,65 @@
     * **«Позволять поиск»** позволяет найти нужное значение в справочнике
     * **«Связь с компонентом»** позволяет связывать справочники между собой, для фильтрации определенных значений в зависимости от другого справочника.
     
+Объект приложения "Справочник"
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Справочник — это отдельный объект приложения, представляющий собой таблицу со списком значений, которая используется в компонентах выбора (выпадающие списки, переключатели вариантов и т.д.).
+
+Справочник нужен, чтобы:
+* не вводить одни и те же значения каждый раз;
+* избежать ошибок и опечаток;
+* использовать единые значения во всех формах и процессах;
+* управлять логикой процесса (условия, переходы, фильтрация).
+
+В этом шаге мы создадим статичный справочник, который будет универсальным для всего приложения.
+
+Создание справочника:
+^^^^^^^^^^^^^^^^^^^^^^
+**Шаг 1.** В дереве приложения кликаем правой кнопкой мыши по нужной папке.
+
+**Шаг 2.** Выбираем: Добавить → Базовые сущности → Справочник
+
+**Шаг 3.** В открывшемся окне указываем:
+* **Наименование справочника** (например, «Тип услуги»);
+* **Код справочника** — интуитивно понятный (можно оставить автоматически сгенерированный транслит).
+
+**Шаг 4.** Ниже отображается таблица колонок справочника. Эта таблица определяет, какие столбцы будет иметь справочник.
+Добавляем минимум один столбец, указав:
+* Наименование столбца;
+* Код столбца.
+
+Пример:
+* Наименование → status_name
+* Код → status_code
+
+При необходимости, отмечаем галочкой столбец “Перевод» если нужно добавить переводы значений.
+
+**Шаг 5.** Сохраняем справочник
+
+Справочник создан. После сохранения рядом с кнопкой "Сохранить" появляется вкладка "Элементы". Переходим к добавлению значений в справочник
+
+Доабвление значений в справочник:
+^^^^^^^^^^^^^^^^^^^^^^
+На этом этапе мы наполняем справочник конкретными значениями, которые позже будут отображаться пользователю в форме.
+
+**Шаг 1.** Переходим во вкладку **"Элементы"**
+
+**Шаг 2.** Нажимаем кнопку «+» на верхней панели – добавляются пустые строки
+
+**Шаг 3.** Заполняем значения в созданных колонках
+
+Привязка справочника к полю на форме:
+^^^^^^^^^^^^^^^^^^^^^^
+
+**Шаг 1.** Возвращаемся в форму заявки
+
+**Шаг 2.** Кликаем по компоненту «Выпадающий список» в соответствующем поле (например "Статус заявки")
+
+**Шаг 3.** Переходим во вкладку «Элементы» в свойствах компонента
+
+**Шаг 4.** В выпадающем списке выбираем созданный справочник и нажимаем «Ок»
+
 Поле 3. Тип заявителя
 --------------------
 Для поля «Тип заявителя» мы используем компонент **«Переключатель вариантов»**. Т.к в данном случае предполагается использование компонента, позволяющее выбрать только один возможный вариант.