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

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

Версия 08:46, 15 ноября 2017

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

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

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

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

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

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

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

Fillbookmark 1.png

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

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

Fillbookmark 2.png

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

Fillbookmark 3.png

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

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

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

Fillbookmark 5.png

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

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

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

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

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

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