Способы заполнения закладок

Материал из Формирование документов Word из 1C
Версия от 11:35, 21 ноября 2017; Харин Владимир (обсуждение | вклад) (Заполнение закладки значением поля объекта)
Перейти к: навигация, поиск

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

Можно заполнить закладку одним из 5 способов:

  • Значением поля объекта
  • Произвольным алгоритмом
  • Алгоритмом из библиотеки
  • Вставкой/удалением блока текста по условию
  • Выводом таблицы/коллекции

Заполнение закладки значением поля объекта

Заполнение значением поля объекта аналогично настройке полей в стандартных отчетах на СКД. Имеется несколько способов указания поля, рассмотрим их подробнее далее.

Простое поле

Под простым полем понимается выбор некоторого реквизита объекта 1С (или реквизита "через точку", поля табличной части).

Fillbookmark 1.png

Чаще всего указывается одно поле. В случае если значение имеет суммовой тип в некоторой валюте (сумма в рублях, например), то 2-м полем может быть выбрана валюта, что позволит корректно вывести сумму прописью в этой валюте (см. о форматировании).

Заполнение закладки произвольным алгоритмом

Информация для технических специалистов (программисты, консультанты, администраторы)

Способ заполнения "Произвольным алгоритмом"- для сложных ситуаций, когда невозможно описать заполнение закладки стандартным способом. Контекст алгоритма содержит следующие переменные:

  • Результат - в эту переменную должен быть присвоен результат выполнения алгоритма. Это значение будет подставлено в закладку. Если значение - Неопределено, то закладка не будет обработана (подстановка значения не производится). Значение по умолчанию - Неопределено.
  • Объект - ссылка на объект информационной базы 1С, на основе которого заполняется шаблон;
  • кэш - соответствие, доступное алгоритмам в процессе выполнения правила заполнения шаблона (его использование - на усмотрение программиста, чаще всего для кэширования);

Редактирование алгоритмов доступно только под полными правами.

Заполнение закладки алгоритмом из библиотеки

Информация для технических специалистов (программисты, консультанты, администраторы)

Способ заполнения " Алгоритмом из библиотеки" - для сложных ситуаций, когда невозможно описать заполнение закладки стандартным способом. Контекст алгоритма содержит следующие переменные:

  • Результат - в эту переменную должен быть присвоен результат выполнения алгоритма. Это значение будет подставлено в закладку. Если значение - Неопределено, то закладка не будет обработана (подстановка значения не производится). Значение по умолчанию - Неопределено.
  • Объект - ссылка на объект информационной базы 1С, на основе которого заполняется шаблон;
  • ПараметрАлгоритма - произвольный параметр, обычно строковый, который может быть передан алгоритму;
  • кэш - соответствие, доступное алгоритмам в процессе выполнения правила заполнения шаблона (его использование - на усмотрение программиста, чаще всего для кэширования);

Редактирование алгоритмов доступно только под полными правами.

Заполнение закладки с помощью вставки/удаления по условию

Удаление при условии подразумевает удаление блока текста, отмеченного закладкой, из документа, если выполняется заданное условие. Если условие не выполняется, то содержимое закладки остается без изменений. Условие также задается аналогично определению условий в стандартных отчетах на СКД.

Fillbookmark 2.png

Вставка при условии подразумевает,что блок текста, отмеченный закладкой в документе, останется без изменений, если выполняется заданное условие. Если условие не выполняется, то содержимое закладки удаляется. Условие также задается аналогично определению условий в стандартных отчетах на СКД.


Заполнение таблицы/коллекции