Способы заполнения закладок — различия между версиями

Материал из Формирование документов Word из 1C
Перейти к: навигация, поиск
Строка 1: Строка 1:
 
В форме способа заполнения закладки описывается определение значения для конкретной закладки шаблона. Сначала выполняется собственно вычисление значения, после чего к этому значению может быть применено форматирование.
 
В форме способа заполнения закладки описывается определение значения для конкретной закладки шаблона. Сначала выполняется собственно вычисление значения, после чего к этому значению может быть применено форматирование.
 +
Можно заполнить закладку одним из 5 способов:
  
Предлагается 4 способа заполнения закладки:
+
*Значением поля объекта
 +
*Произвольным алгоритмом
 +
*Алгоритмом из библиотеки
 +
*Вставкой/удалением по условию
 +
*Выводом таблицы/коллекции
  
*Значением поля объекта;
+
После этого, при необходимости, возможно использование одного из способов форматирования:
  
*Произвольным алгоритмом;
+
*Форматная строка;
 +
*Число прописью;
 +
*Склонение (для ФИО и для не ФИО);
 +
*Фамилия, инициалы.
 +
 
 +
== Заполнение закладки значением поля объекта ==
 +
 
 +
 
 +
'''Заполнение значением поля объекта''' аналогично выбору полей в стандартных отчетах на СКД.
 +
 
 +
[[Файл:fillbookmark_1.png]]
 +
 
 +
Чаще всего указывается одно поле. В случае если значение имеет суммовой тип в некоторой валюте (сумма в рублях, например), то 2-м полем может быть выбрана валюта, что позволит корректно вывести сумму прописью в этой валюте (см. о форматировании ниже).
 +
 
 +
== Заполнение закладки произвольным алгоритмом ==
  
*Алгоритмом из библиотеки;
+
Способ заполнения "Произвольным алгоритмом"- для сложных ситуаций, когда невозможно описать заполнение закладки стандартным способом. Контекст алгоритма содержит следующие переменные:
  
*Удаление при условии.
+
*'''Результат''' - в эту переменную должен быть присвоен результат выполнения алгоритма. Это значение будет подставлено в закладку.  Если значение - '''Неопределено''', то закладка не будет обработана (подстановка значения не производится). Значение по умолчанию - '''Неопределено'''.
 +
*'''Объект''' - ссылка на объект информационной базы 1С, на основе которого заполняется шаблон;
 +
*'''кэш''' - соответствие, доступное алгоритмам в процессе выполнения правила заполнения шаблона (его использование - на усмотрение программиста, чаще всего для кэширования);
  
Дополнительно возможно использование следующих способов форматирования:
+
Редактирование алгоритмов доступно только под полными правами.
  
*Форматная строка;
+
== Заполнение закладки алгоритмом из библиотеки ==
  
*Число прописью;
+
Способ заполнения "[[Библиотека_алгоритмов| Алгоритмом из библиотеки]]" - для сложных ситуаций, когда невозможно описать заполнение закладки стандартным способом. Контекст алгоритма содержит следующие переменные:
  
*Склонение (для ФИО и для не ФИО);
+
*'''Результат''' - в эту переменную должен быть присвоен результат выполнения алгоритма. Это значение будет подставлено в закладку.  Если значение - '''Неопределено''', то закладка не будет обработана (подстановка значения не производится). Значение по умолчанию - '''Неопределено'''.
 +
*'''Объект''' - ссылка на объект информационной базы 1С, на основе которого заполняется шаблон;
 +
*'''ПараметрАлгоритма''' - произвольный параметр, обычно строковый, который может быть передан алгоритму;
 +
*'''кэш''' - соответствие, доступное алгоритмам в процессе выполнения правила заполнения шаблона (его использование - на усмотрение программиста, чаще всего для кэширования);
  
*Фамилия, инициалы.
+
Редактирование алгоритмов доступно только под полными правами.
  
== Простые способы заполнения и форматирование закладок ==
+
== Заполнение закладки с помощью вставки/удаления по условию ==
  
'''Заполнение значением поля объекта''' аналогично выбору полей в стандартных отчетах на СКД.
 
  
[[Файл:fillbookmark_1.png]]
 
  
Чаще всего указывается одно поле. В случае если значение имеет суммовой тип в некоторой валюте (сумма в рублях, например), то 2-м полем может быть выбрана валюта, что позволит корректно вывести сумму прописью в этой валюте (см. о форматировании ниже).
 
  
'''Удаление при условии''' подразумевает удаление закладки из документа, если выполняется заданное условие. Если условие не выполняется, то содержимое закладки остается без изменений. Условие также задается аналогично определению условий в стандартных отчетах на СКД.
+
'''Удаление при условии''' подразумевает удаление блока текста, отмеченного закладкой, из документа, если выполняется заданное условие. Если условие не выполняется, то содержимое закладки остается без изменений. Условие также задается аналогично определению условий в стандартных отчетах на СКД.
  
 
[[Файл:fillbookmark_2.png]]
 
[[Файл:fillbookmark_2.png]]
 +
 +
'''Вставка при условии''' подразумевает,что блок текста, отмеченный закладкой в документе, останется без изменений, если выполняется заданное условие. Если условие не выполняется, то содержимое закладки удаляется. Условие также задается аналогично определению условий в стандартных отчетах на СКД.
 +
 +
 +
== Заполнение таблицы/коллекции ==
 +
 +
 +
 +
 +
 +
 +
 +
== Форматирование закладок ==
  
 
Применение '''форматирования''' настраивается в нижней части формы:
 
Применение '''форматирования''' настраивается в нижней части формы:
Строка 46: Строка 80:
  
 
Способ "'''Фамилия, инициалы'''" позволяет сократить ФИО до варианта "Фамилия И.О." или "И.О. Фамилия". Его удобно применять в области подписей ответственных лиц и т.д.
 
Способ "'''Фамилия, инициалы'''" позволяет сократить ФИО до варианта "Фамилия И.О." или "И.О. Фамилия". Его удобно применять в области подписей ответственных лиц и т.д.
 +
 +
 +
 +
 +
 +
 +
'''Заполнение значением поля объекта''' аналогично выбору полей в стандартных отчетах на СКД.
 +
 +
[[Файл:fillbookmark_1.png]]
 +
 +
Чаще всего указывается одно поле. В случае если значение имеет суммовой тип в некоторой валюте (сумма в рублях, например), то 2-м полем может быть выбрана валюта, что позволит корректно вывести сумму прописью в этой валюте (см. о форматировании ниже).
 +
 +
'''Удаление при условии''' подразумевает удаление закладки из документа, если выполняется заданное условие. Если условие не выполняется, то содержимое закладки остается без изменений. Условие также задается аналогично определению условий в стандартных отчетах на СКД.
 +
 +
[[Файл:fillbookmark_2.png]]
 +
 +
  
 
<span style="color:#ff0000">Информация для технических специалистов (программисты, консультанты, администраторы)</span>
 
<span style="color:#ff0000">Информация для технических специалистов (программисты, консультанты, администраторы)</span>

Версия 08:18, 16 ноября 2017

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

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

После этого, при необходимости, возможно использование одного из способов форматирования:

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

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

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

Fillbookmark 1.png

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

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

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

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

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

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

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

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

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

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

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

Fillbookmark 2.png

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


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

Форматирование закладок

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

Fillbookmark 3.png

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

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

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

Fillbookmark 5.png

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




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

Fillbookmark 1.png

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

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

Fillbookmark 2.png


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

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

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

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

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