Параметры заполнения шаблона
Материал из Формирование документов Word из 1C
Версия от 13:45, 15 марта 2021; Харин Владимир (обсуждение | вклад)
поддерживается только с версии 2.0
В настройке заполнения шаблона есть возможность указать параметры:
Параметры может заполнить пользователь интерактивно перед заполнением шаблона
В версии ПРОФ параметры могут быть заполнены программно (в обработчике "Перед подготовкой")
Пример кода:
ПараметрыПользователя.Вставить("ОсновнойОтпуск", ПродолжительностьОсновногоОтпуска);
Параметры могут быть использованы в настройке заполнения шаблона:
Настройка параметров
Для каждого параметра указывается:
- Имя - должно быть уникальным, используется при программном обращении
- Заголовок - имя, которое показывается пользователю
- Тип - типы могут быть простые (число, строка, дата, булево), так и ссылочные (справочник, документ и т.д.). Можно указать несколько типов (составной тип). Пользователь будет указывать значение выбранного здесь типа.
- Значение - значение по умолчанию
- Вводит пользователь - если этот флаг установлен, то значение параметра будет запрошено у пользователя перед заполнением шаблона
- Список значение - список, из которого пользователю будет предложено выбрать значение параметра (если указан)
Использование параметров
Параметры рекомендуется использовать в следующих случаях:
- В информационной базе нет некоторых данных, необходимых для заполнения шаблона, и хранить эти данные в базе нет необходимости. В этом случае можно добавить параметр, который будет указывать пользователь перед заполнением шаблона.
- Необходимые данные нельзя получить простой настройкой, необходимо использовать алгоритм. Но данные выводятся в шаблон (или используются в настройке заполнения) несколько раз. В этом случае удобно добавить параметр, который будет заполняться алгоритмом один раз - в обработчике "Перед подготовкой", а потом параметр можно использовать несколько раз в настройке заполнения шаблона.
- При настройке заполнения нет ясности как получить те или иные данные. В этом случае можно добавить параметр со значением по умолчанию, и использовать его в настройке заполнения. А позже либо разработать алгоритм для установки значения этого параметра, либо указать, что параметр вводит пользователь.