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

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

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

Предлагается 4 способа заполнения закладки:

  • Значением поля объекта;
  • Произвольным алгоритмом;
  • Алгоритмом из библиотеки;
  • Удаление при условии.

Дополнительно возможно использование следующих способов форматирования:

  • Форматная строка;
  • Число прописью;
  • Склонение (для ФИО и для не ФИО);
  • Фамилия, инициалы.

Простые способы заполнения и форматирование закладок

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

Fillbookmark 1.png

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

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

Fillbookmark 2.png

Применение форматирования настраивается в нижней части формы:

Fillbookmark 3.png

Способ "Форматная строка" предоставляет стандартные возможности платформы 1С: Предприятие по форматированию значений типа Число, Дата, Булево (функция Формат). В поле Формат должна быть задана форматная строка. Форматную строку удобно задавать с помощью конструктора форматной строки, открываемого кнопкой выбора (формат здесь задается по составляющим параметрам, можно сразу видеть результат форматирования для различных значений).

Способ "Число прописью" предоставляет также стандартные возможности платформы 1С: Предприятие по формированию числа прописью (функция ЧислоПрописью). В поле Формат можно выбрать один из предопределенных вариантов или задать свою строку форматирования - в этом случае форматная строка и параметры предмета исчисления задаются вместе (см. пример в варианте "{произвольный}").

Способы "Склонение (ФИО)" и "Склонение (не ФИО)" позволяют склонять представления объектов. При использовании данных способов нужно дополнительно указывать падеж. Функционал склонения предоставляется библиотекой стандартных подсистем и доступен в большинстве типовых конфигураций. Для некоторых справочников склонения могут быть заданы вручную:

Fillbookmark 5.png

Способ "Фамилия, инициалы" позволяет сократить ФИО до варианта "Фамилия И.О." или "И.О. Фамилия". Его удобно применять в области подписей ответственных лиц и т.д.

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

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

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

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

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