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