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

Материал из Формирование документов Word из 1C
Перейти к: навигация, поиск
 
(не показаны 2 промежуточные версии этого же участника)
Строка 18: Строка 18:
  
 
[[Файл:Parameters_use.png]]
 
[[Файл:Parameters_use.png]]
 +
 +
== Настройка параметров ==
 +
 +
Для каждого параметра указывается:
 +
 +
* Имя - должно быть уникальным, используется при программном обращении
 +
* Заголовок - имя, которое показывается пользователю
 +
* Тип - типы могут быть простые (число, строка, дата, булево), так и ссылочные (справочник, документ и т.д.). Можно указать несколько типов (составной тип). Пользователь будет указывать значение выбранного здесь типа.
 +
* Значение - значение по умолчанию
 +
* Вводит пользователь - если этот флаг установлен, то значение параметра будет запрошено у пользователя перед заполнением шаблона
 +
* Список значение - список, из которого пользователю будет предложено выбрать значение параметра (если указан)
 +
 +
== Использование параметров ==
 +
 +
Параметры рекомендуется использовать в следующих случаях:
 +
 +
* В информационной базе нет некоторых данных, необходимых для заполнения шаблона, и хранить эти данные в базе нет необходимости. В этом случае можно добавить параметр, который будет указывать пользователь перед заполнением шаблона.
 +
* Необходимые данные нельзя получить простой настройкой, необходимо использовать алгоритм. Но данные выводятся в шаблон (или используются в настройке заполнения) несколько раз. В этом случае удобно добавить параметр, который будет заполняться алгоритмом один раз - в обработчике "Перед подготовкой", а потом параметр можно использовать несколько раз в настройке заполнения шаблона. (В ЗУП 3 удобно использовать параметры для кадровых данных сотрудника, заполняемых с помощью стандартной функции получения кадровых данных).
 +
* При настройке заполнения нет ясности как получить те или иные данные. В этом случае можно добавить параметр со значением по умолчанию, и использовать его в настройке заполнения. А позже либо разработать алгоритм для установки значения этого параметра, либо указать, что параметр вводит пользователь.

Текущая версия на 13:47, 15 марта 2021

поддерживается только с версии 2.0

В настройке заполнения шаблона есть возможность указать параметры:

Parameters form.png

Параметры может заполнить пользователь интерактивно перед заполнением шаблона

Parameters selection.png

В версии ПРОФ параметры могут быть заполнены программно (в обработчике "Перед подготовкой")

Пример кода:

ПараметрыПользователя.Вставить("ОсновнойОтпуск", ПродолжительностьОсновногоОтпуска);

Параметры могут быть использованы в настройке заполнения шаблона:

Parameters use.png

Настройка параметров

Для каждого параметра указывается:

  • Имя - должно быть уникальным, используется при программном обращении
  • Заголовок - имя, которое показывается пользователю
  • Тип - типы могут быть простые (число, строка, дата, булево), так и ссылочные (справочник, документ и т.д.). Можно указать несколько типов (составной тип). Пользователь будет указывать значение выбранного здесь типа.
  • Значение - значение по умолчанию
  • Вводит пользователь - если этот флаг установлен, то значение параметра будет запрошено у пользователя перед заполнением шаблона
  • Список значение - список, из которого пользователю будет предложено выбрать значение параметра (если указан)

Использование параметров

Параметры рекомендуется использовать в следующих случаях:

  • В информационной базе нет некоторых данных, необходимых для заполнения шаблона, и хранить эти данные в базе нет необходимости. В этом случае можно добавить параметр, который будет указывать пользователь перед заполнением шаблона.
  • Необходимые данные нельзя получить простой настройкой, необходимо использовать алгоритм. Но данные выводятся в шаблон (или используются в настройке заполнения) несколько раз. В этом случае удобно добавить параметр, который будет заполняться алгоритмом один раз - в обработчике "Перед подготовкой", а потом параметр можно использовать несколько раз в настройке заполнения шаблона. (В ЗУП 3 удобно использовать параметры для кадровых данных сотрудника, заполняемых с помощью стандартной функции получения кадровых данных).
  • При настройке заполнения нет ясности как получить те или иные данные. В этом случае можно добавить параметр со значением по умолчанию, и использовать его в настройке заполнения. А позже либо разработать алгоритм для установки значения этого параметра, либо указать, что параметр вводит пользователь.