Contents x
      Справочники (источники данных)
      • 22 Dec 2022
      • 2 Minutes to read
      • Contributors
      • Print
      • Dark
        Light
      • PDF
      Contents

      Справочники (источники данных)

      • Updated on 22 Dec 2022
      • 2 Minutes to read
      • Contributors
      • Print
      • Dark
        Light
      • PDF
      Article summary

      Справочники полезны при настройке шаблонов. Вы можете подключить справочники к полям документа. Таким образом, заполнять документ станет существенно проще и будут исключены ошибки при заполнении.

      Пример заполнения документа, связанного со "Справочником организаций".

      Пример заполнения документа

      Создание и настройка источника данных

      Привязка справочника к переменной происходит непосредственно в шаблоне в настройках нужного элемента.

      1. Выберите способ заполнения значения в настройках элемента - Заполняется из БД.

      2. В настройках у вас автоматически появится область привязки:

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

      Если это ваша первая связка в документе, то нужно перейти к созданию источника данных, кликнув на кнопку "Добавить".

      3. Вам откроется окно настроек

      Слева будет отображен весь перечень(1) ваших источников данных. Справа же будет открываться окно настроек для каждого.

      Вы можете задавать наименования(2) своим источникам данных. Чтобы изменить наименование(2) нужно кликнуть на "..." в вернем правом углу.

      Во вкладке(3) "Настройки" вы настраиваете саму работу со справочником, т.е.:

      1) выбираете справочник(4);

       2) добавляете(6) все поля(7), которые будут задействованы. И те, которые участвуют в выражении для фильтрации и те, которые вы собираетесь привязывать для подтягивания данных:

      3) если требуется, то указываете выражения для фильтрации справочника(5). Подробнее про выражения фильтрации расскажем дальше в статье.

      Настройка фильтрации (опционально)

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

      💡 Например, у вас есть справочник подписантов, разные подписанты могут подписывать контракты на разные суммы. И вы можете настроить фильтрацию, в зависимости от суммы указанной в договоре, фильтровать подписантов. Таким образом, при заполнении анкеты пользователь не ошибется при выборе подписанта.  

      Выражение для фильтрации указывается в виде формулы. Все формулы вы можете найти в статье.

      Рассмотрим пример, описанный выше.

      1) У нас есть справочник подписантов, включающий минимальную и максимальную сумму договора:

      2) И в документе мы настраиваем фильтрацию выдачи подписантов, в зависимости от введенной суммы:

      3) В формулу вставляем идентификатор переменной с вводимой суммой - summa и идентификаторы колонок справочника - minSum и maxSum.

      4) Идентификаторы колонок генерируются автоматически при их добавлении в список. 

      5) Теперь в зависимости от указанной суммы, пользователю будут выдаваться только подходящие подписанты.

      Привязка переменных к источнику данных

      Всю настройку мы завершили во вкладке "Настройки". Теперь можно перейти к привязке переменных во вкладку "Связанные переменные". 

      Перед тем, как переходить во вкладку "Связанные переменные", не забудьте добавить в список все колонки справочника, которые вы планируете использовать. Только эти колонки система будет предлагать вам для привязки.

      В нашем примере: 

      1 - это колонки, которые использовались в формуле;

      2 - это колонки для привязки к переменным.

      Итак, привязка переменной - это последний шаг. Вы переходите во вкладку"Связанные переменные" и добавляете строку.

      В строке уже указываете соответствие переменной и колонки справочника.


      Was this article helpful?
      What's Next