Параметры заполнения шаблона — различия между версиями
Материал из Формирование документов Word из 1C
| (не показано 5 промежуточных версий этого же участника) | |||
| Строка 7: | Строка 7: | ||
Параметры может заполнить пользователь интерактивно перед заполнением шаблона | Параметры может заполнить пользователь интерактивно перед заполнением шаблона | ||
| − | + | [[Файл:Parameters_selection.png]] | |
В версии ПРОФ параметры могут быть заполнены программно (в обработчике "Перед подготовкой") | В версии ПРОФ параметры могут быть заполнены программно (в обработчике "Перед подготовкой") | ||
| + | Пример кода: | ||
| + | <code>ПараметрыПользователя.Вставить("ОсновнойОтпуск", ПродолжительностьОсновногоОтпуска);</code> | ||
Параметры могут быть использованы в настройке заполнения шаблона: | Параметры могут быть использованы в настройке заполнения шаблона: | ||
| + | |||
| + | [[Файл:Parameters_use.png]] | ||
| + | |||
| + | == Настройка параметров == | ||
| + | |||
| + | Для каждого параметра указывается: | ||
| + | |||
| + | * Имя - должно быть уникальным, используется при программном обращении | ||
| + | * Заголовок - имя, которое показывается пользователю | ||
| + | * Тип - типы могут быть простые (число, строка, дата, булево), так и ссылочные (справочник, документ и т.д.). Можно указать несколько типов (составной тип). Пользователь будет указывать значение выбранного здесь типа. | ||
| + | * Значение - значение по умолчанию | ||
| + | * Вводит пользователь - если этот флаг установлен, то значение параметра будет запрошено у пользователя перед заполнением шаблона | ||
| + | * Список значение - список, из которого пользователю будет предложено выбрать значение параметра (если указан) | ||
| + | |||
| + | == Использование параметров == | ||
| + | |||
| + | Параметры рекомендуется использовать в следующих случаях: | ||
| + | |||
| + | * В информационной базе нет некоторых данных, необходимых для заполнения шаблона, и хранить эти данные в базе нет необходимости. В этом случае можно добавить параметр, который будет указывать пользователь перед заполнением шаблона. | ||
| + | * Необходимые данные нельзя получить простой настройкой, необходимо использовать алгоритм. Но данные выводятся в шаблон (или используются в настройке заполнения) несколько раз. В этом случае удобно добавить параметр, который будет заполняться алгоритмом один раз - в обработчике "Перед подготовкой", а потом параметр можно использовать несколько раз в настройке заполнения шаблона. (В ЗУП 3 удобно использовать параметры для кадровых данных сотрудника, заполняемых с помощью стандартной функции получения кадровых данных). | ||
| + | * При настройке заполнения нет ясности как получить те или иные данные. В этом случае можно добавить параметр со значением по умолчанию, и использовать его в настройке заполнения. А позже либо разработать алгоритм для установки значения этого параметра, либо указать, что параметр вводит пользователь. | ||
Текущая версия на 13:47, 15 марта 2021
поддерживается только с версии 2.0
В настройке заполнения шаблона есть возможность указать параметры:
Параметры может заполнить пользователь интерактивно перед заполнением шаблона
В версии ПРОФ параметры могут быть заполнены программно (в обработчике "Перед подготовкой")
Пример кода:
ПараметрыПользователя.Вставить("ОсновнойОтпуск", ПродолжительностьОсновногоОтпуска);
Параметры могут быть использованы в настройке заполнения шаблона:
Настройка параметров
Для каждого параметра указывается:
- Имя - должно быть уникальным, используется при программном обращении
- Заголовок - имя, которое показывается пользователю
- Тип - типы могут быть простые (число, строка, дата, булево), так и ссылочные (справочник, документ и т.д.). Можно указать несколько типов (составной тип). Пользователь будет указывать значение выбранного здесь типа.
- Значение - значение по умолчанию
- Вводит пользователь - если этот флаг установлен, то значение параметра будет запрошено у пользователя перед заполнением шаблона
- Список значение - список, из которого пользователю будет предложено выбрать значение параметра (если указан)
Использование параметров
Параметры рекомендуется использовать в следующих случаях:
- В информационной базе нет некоторых данных, необходимых для заполнения шаблона, и хранить эти данные в базе нет необходимости. В этом случае можно добавить параметр, который будет указывать пользователь перед заполнением шаблона.
- Необходимые данные нельзя получить простой настройкой, необходимо использовать алгоритм. Но данные выводятся в шаблон (или используются в настройке заполнения) несколько раз. В этом случае удобно добавить параметр, который будет заполняться алгоритмом один раз - в обработчике "Перед подготовкой", а потом параметр можно использовать несколько раз в настройке заполнения шаблона. (В ЗУП 3 удобно использовать параметры для кадровых данных сотрудника, заполняемых с помощью стандартной функции получения кадровых данных).
- При настройке заполнения нет ясности как получить те или иные данные. В этом случае можно добавить параметр со значением по умолчанию, и использовать его в настройке заполнения. А позже либо разработать алгоритм для установки значения этого параметра, либо указать, что параметр вводит пользователь.
