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

Материал из Формирование документов Word из 1C
Перейти к: навигация, поиск

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

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

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

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

Fillbookmark 1.png

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

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

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

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

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

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

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

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

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

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

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

Fillbookmark 2.png

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


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

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

Fillbookmark 1.png

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

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

Fillbookmark 2.png


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

Алгоритмические способы заполнения закладок

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

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

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