Правила заполнения шаблонов - История изменений

Харин Владимир: /* События */

2017-11-22T13:21:30Z

‎События

Харина Александра в 08:33, 15 ноября 2017

2017-11-15T08:33:04Z

Харина Александра в 08:12, 15 ноября 2017

2017-11-15T08:12:53Z

Харина Александра в 08:09, 15 ноября 2017

2017-11-15T08:09:38Z

Харина Александра в 08:06, 15 ноября 2017

2017-11-15T08:06:26Z

Харина Александра в 07:58, 15 ноября 2017

2017-11-15T07:58:35Z

Внесённые изменения

Харина Александра в 07:43, 15 ноября 2017

2017-11-15T07:43:05Z

Харина Александра в 07:38, 15 ноября 2017

2017-11-15T07:38:43Z

Харина Александра: Новая страница: «В правилах заполнения описывается заполнение каждой закладки шаблона. Правило заполнен…»

2017-11-15T07:32:51Z

Новая страница: «В правилах заполнения описывается заполнение каждой закладки шаблона. Правило заполнен…»

Новая страница

В правилах заполнения описывается заполнение каждой закладки шаблона. Правило заполнения описывает заполнение закладок одного шаблона на основе данных одного объекта 1С (справочника или документа).

Закладки

[[Файл:temprule_1.png]]

На вкладке "Закладки" выводится дерево закладок (закладки могут включаться одна в другую). Для каждой закладки указывается способ ее заполнения. Всего предусмотрено 4 способа заполнения каждой закладки: значением поля объекта, произвольным алгоритмом, алгоритмом из библиотеки, удаление при условии. Подробнее о способах заполнения см. в разделе "Способы заполнения закладок".

Видимость
На вкладке "Видимость" можно определить условие, при котором данное правило заполнения будет доступно пользователю. Условия видимости проверяются при формировании списка шаблонов, которые могут быть заполнены из объекта 1С. Это может быть полезно, например, когда у каждой организации свой шаблон договора - в этом случае условие видимости может быть задано по реквизиту Организация.

Условие может быть задано 3-мя способами.

1. Стандартными отборами СКД.

2. Произвольным алгоритмом.

3. Указанием алгоритма из библиотеки алгоритмов.

Первый вариант аналогичен настройке отборов в типовых отчетах.

[[Файл:temprule_1.png]]

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

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

- Результат - в эту переменную должен быть присвоен результат выполнения алгоритма. Если присваивается значение типа Булево, то оно и будет определять видимость правила заполнения. Если присваивается значение другого типа, то видимость определяется с помощью стандартной функции ЗначениеЗаполнено к этому значению.

- Объект - ссылка на объект информационной базы 1С, для которого необходимо определить возможность использования правила заполнения;

- ПараметрАлгоритма - произвольный параметр, обычно строковый, который может быть передан алгоритму (только для алгоритмов из библиотеки);

- кэш - соответствие, доступное алгоритмам в процессе формирования списка правил заполнения для выбора пользователем (его использование - на усмотрение программиста, чаще всего для кэширования);

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

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

Обработчики событий реализуются на встроенном языке 1С. Формирование документа Word производитмя в 2 этапа

1. Подготовка данных для заполнения закладок. Выполняется на сервере.

2. Обработка и заполнение закладок в документе Word. Выполняется на клиенте.

Обработчики событий подготовки данных для заполнения шаблона
Данные обработчики выполняются на сервере. Из обработчиков событий данной группы можно выполнять вызовы алгоритмов библиотек (см. раздел Библиотеки алгоритмов)

Перед подготовкой данных заполнения
Возникает в начале процедуры подготовки данных для заполнения шаблона. Контекст:

- Объект - ссылка на объект информационной базы 1С, на основе которого выполняется заполнение шаблона;

- кэш - соответствие, доступное алгоритмам в процессе выполнения правила заполнения шаблона (его использование - на усмотрение программиста, чаще всего для кэширования);

Может использоваться, например, для подготовки данных в кэше.

При подготовке данных закладки
Возникает после вычисления значения для очередной закладки (в цикле вычисления значений для закладок). Контекст:

- Объект - ссылка на объект информационной базы 1С, на основе которого выполняется заполнение шаблона;

- ИмяЗакладки - имя закладки, для которой вычисляется значение;

- ЗначениеЗакладки - вычисленное значение для подстановки в закладку до форматирования (см. раздел "Способы заполнения закладок");

- ЗначениеЗакладкиСтр - ЗначениеЗакладки после форматирования и преобразования значения в строку, изменение данной переменной изменяет подставляемое в закладку значение;

- кэш - соответствие, доступное алгоритмам в процессе выполнения правила заполнения шаблона (его использование - на усмотрение программиста, чаще всего для кэширования);

Отметим, что если значение закладки = Неопередено, то закладка при заполнении шаблона не обрабатывается. Например, для способа заполнения "Удалить при условии" значение закладки либо Неопределено (если условие НЕ выполняется), либо пустая строка (если условие выполняется).

После подготовки данных заполнения
Возникает после цикла вычисления значений закладок. Контекст:

- Объект - ссылка на объект информационной базы 1С, на основе которого выполняется заполнение шаблона;

- кэш - соответствие, доступное алгоритмам в процессе выполнения правила заполнения шаблона (его использование - на усмотрение программиста, чаще всего для кэширования);

Может использоваться, например, для простановки отметки в информационной базе о том, что было выполнено формирование документа Word (отметка "договор распечатан").

Обработчики событий заполнения шаблона
Данные обработчики выполняются на клиенте. Здесь невозможен вызов алгоритмов из библиотек.

Перед заполнением
Возникает перед началом цикла обработки закладок Word-документа. Контекст:

- WordDocument - COM-объект объектной модели Word, тип - Document (https://msdn.microsoft.com/en-us/vba/word-vba/articles/document-object-word) - заполняемый документ-шаблон.

- СоответствиеЗакладокИЗначений - соответствие, в котором ключ - имя закладки, а значение - то, на что будет заменено значение закладки;

Может использоваться, например, для предобработки документа или значений закладок.

При заполнении закладки
Возникает после выделения закладки в тексте документа (WordDocument.Application.Selection - объект Selection - https://msdn.microsoft.com/en-us/vba/word-vba/articles/selection-object-word), но до подстановки значения закладки. Контекст:

WordDocument - COM-объект объектной модели Word, тип - Document (https://msdn.microsoft.com/en-us/vba/word-vba/articles/document-object-word) - заполняемый документ-шаблон.

СоответствиеЗакладокИЗначений - соответствие, в котором ключ - имя закладки, а значение - то, на что будет заменено значение закладки.

ИмяЗакладки - имя закладки, в которую подставляется значение;

ЗначениеЗакладки - значение, которое после преобразования в строку будет подставлено в закладку;

ЗначениеЗакладкиСтр - строковое значение, подставляемое в закладку. Изменение значения данной переменной изменяет подставляемое значение. Если присвоить данной переменной значение Неопределено, то закладка не будет обработана (можно обработать закладку по своему усмотрению);

Может использоваться, например, для переопределения типового механизма обработки закладок.

После заполнения
Возникает перед началом цикла обработки закладок Word-документа. Контекст:

- WordDocument - COM-объект объектной модели Word, тип - Document (https://msdn.microsoft.com/en-us/vba/word-vba/articles/document-object-word) - заполняемый документ-шаблон.

- СоответствиеЗакладокИЗначений - соответствие, в котором ключ - имя закладки, а значение - то, на что выполнялась замена закладки;

Может использоваться, например, для постобработки документа.

@@ Строка 34: / Строка 34: @@
 == События ==
-На закладке события можно определить обработчики событий, которые запускаются на различных этапах подготовки данных и вывода их в документ Word. Они применяются в случаях, когда не хватает стандартного функционала и простых настроек.
+На закладке события можно определить обработчики событий, которые запускаются на различных этапах подготовки данных и вывода их в документ Word.
-Обработчики событий реализуются на встроенном языке 1С. Формирование документа Word производится в 2 этапа
+См. подробнее в разделе [[Обработчики_событий|Обработчики событий]].

@@ Строка 21: / Строка 21: @@
 [[Файл:temprule_2.png]]
-'''Информация для технических специалистов (программисты, консультанты, администраторы)'''
+<span style="color:#ff0000">Информация для технических специалистов (программисты, консультанты, администраторы)</span>
 Последние 2 варианта для случаев сложных условий, которые невозможно описать стандартным способом. Контекст алгоритма содержит следующие переменные:

@@ Строка 21: / Строка 21: @@
 [[Файл:temprule_2.png]]
-'''''Информация для технических специалистов (программисты, консультанты, администраторы)'''
+'''Информация для технических специалистов (программисты, консультанты, администраторы)'''
 Последние 2 варианта для случаев сложных условий, которые невозможно описать стандартным способом. Контекст алгоритма содержит следующие переменные:
@@ Строка 30: / Строка 30: @@
 *'''кэш''' - соответствие, доступное алгоритмам в процессе формирования списка правил заполнения для выбора пользователем (его использование - на усмотрение программиста, чаще всего для кэширования);
-Редактирование алгоритмов доступно только под полными правами.''
+Редактирование алгоритмов доступно только под полными правами.
 == События ==
@@ Строка 36: / Строка 36: @@
 На закладке события можно определить обработчики событий, которые запускаются на различных этапах подготовки данных и вывода их в документ Word. Они применяются в случаях, когда не хватает стандартного функционала и простых настроек.
-Обработчики событий реализуются на встроенном языке 1С. Формирование документа Word производитмя в 2 этапа
+Обработчики событий реализуются на встроенном языке 1С. Формирование документа Word производится в 2 этапа
 #Подготовка данных для заполнения закладок.''' Выполняется на сервере'''.
@@ Строка 43: / Строка 43: @@
 ===Обработчики событий подготовки данных для заполнения шаблона===
-Данные обработчики выполняются на сервере. Из обработчиков событий данной группы можно выполнять вызовы алгоритмов библиотек (см. раздел [[Библиотеки алгоритмов]])
+Данные обработчики выполняются на сервере. Из обработчиков событий данной группы можно выполнять вызовы алгоритмов библиотек (см. раздел [[Библиотека алгоритмов]])
 ====Перед подготовкой данных заполнения====

@@ Строка 21: / Строка 21: @@
 [[Файл:temprule_2.png]]
-'''Далее информация для технических специалистов (программисты, консультанты, администраторы)'''
+'''''Информация для технических специалистов (программисты, консультанты, администраторы)'''
 Последние 2 варианта для случаев сложных условий, которые невозможно описать стандартным способом. Контекст алгоритма содержит следующие переменные:
@@ Строка 30: / Строка 30: @@
 *'''кэш''' - соответствие, доступное алгоритмам в процессе формирования списка правил заполнения для выбора пользователем (его использование - на усмотрение программиста, чаще всего для кэширования);
-Редактирование алгоритмов доступно только под полными правами.
+Редактирование алгоритмов доступно только под полными правами.''
 == События ==

@@ Строка 79: / Строка 79: @@
 Возникает перед началом цикла обработки закладок Word-документа. Контекст:
-*'''WordDocument''' - COM-объект объектной модели Word, тип - Document (https://msdn.microsoft.com/en-us/vba/word-vba/articles/document-object-word) - заполняемый документ-шаблон.
+*'''WordDocument''' - COM-объект объектной модели Word, тип - [https://msdn.microsoft.com/en-us/vba/word-vba/articles/document-object-word Document] - заполняемый документ-шаблон.
 *'''СоответствиеЗакладокИЗначений''' - соответствие, в котором ключ - имя закладки, а значение - то, на что будет заменено значение закладки;
@@ Строка 85: / Строка 85: @@
 ====При заполнении закладки====
-Возникает после выделения закладки в тексте документа (WordDocument.Application.Selection - объект Selection - https://msdn.microsoft.com/en-us/vba/word-vba/articles/selection-object-word), но до подстановки значения закладки. Контекст:
+Возникает после выделения закладки в тексте документа (WordDocument.Application.Selection - объект [https://msdn.microsoft.com/en-us/vba/word-vba/articles/selection-object-word Selection]), но до подстановки значения закладки. Контекст:
-'''WordDocument''' - COM-объект объектной модели Word, тип - Document (https://msdn.microsoft.com/en-us/vba/word-vba/articles/document-object-word) - заполняемый документ-шаблон.
+'''WordDocument''' - COM-объект объектной модели Word, тип - [https://msdn.microsoft.com/en-us/vba/word-vba/articles/document-object-word Document] - заполняемый документ-шаблон.
 '''СоответствиеЗакладокИЗначений''' - соответствие, в котором ключ - имя закладки, а значение - то, на что будет заменено значение закладки.
@@ Строка 95: / Строка 95: @@
 '''ЗначениеЗакладки''' - значение, которое после преобразования в строку будет подставлено в закладку;
-ЗначениеЗакладкиСтр - строковое значение, подставляемое в закладку. Изменение значения данной переменной изменяет подставляемое значение. Если присвоить данной переменной значение Неопределено, то закладка не будет обработана (можно обработать закладку по своему усмотрению);
+'''ЗначениеЗакладкиСтр''' - строковое значение, подставляемое в закладку. Изменение значения данной переменной изменяет подставляемое значение. Если присвоить данной переменной значение '''Неопределено''', то закладка не будет обработана (можно обработать закладку по своему усмотрению);
 Может использоваться, например, для переопределения типового механизма обработки закладок.
@@ Строка 102: / Строка 102: @@
 Возникает перед началом цикла обработки закладок Word-документа. Контекст:
-*'''WordDocument''' - COM-объект объектной модели Word, тип - Document (https://msdn.microsoft.com/en-us/vba/word-vba/articles/document-object-word) - заполняемый документ-шаблон.
+*'''WordDocument''' - COM-объект объектной модели Word, тип - [https://msdn.microsoft.com/en-us/vba/word-vba/articles/document-object-word Document] - заполняемый документ-шаблон.
 *'''СоответствиеЗакладокИЗначений''' - соответствие, в котором ключ - имя закладки, а значение - то, на что выполнялась замена закладки;
 Может использоваться, например, для постобработки документа.

@@ Строка 1: / Строка 1: @@
 В правилах заполнения описывается заполнение каждой закладки шаблона. Правило заполнения описывает заполнение закладок одного шаблона на основе данных одного объекта 1С (справочника или документа).
-Закладки
+== Закладки ==
 [[Файл:temprule_1.png]]
@@ Строка 7: / Строка 7: @@
 На вкладке "Закладки" выводится дерево закладок (закладки могут включаться одна в другую). Для каждой закладки указывается способ ее заполнения. Всего предусмотрено 4 способа заполнения каждой закладки: значением поля объекта, произвольным алгоритмом, алгоритмом из библиотеки, удаление при условии. Подробнее о способах заполнения см. в разделе "Способы заполнения закладок".
-Видимость
+== Видимость ==
 На вкладке "Видимость" можно определить условие, при котором данное правило заполнения будет доступно пользователю. Условия видимости проверяются при формировании списка шаблонов, которые могут быть заполнены из объекта 1С. Это может быть полезно, например, когда у каждой организации свой шаблон договора - в этом случае условие видимости может быть задано по реквизиту Организация.
@@ Строка 13: / Строка 14: @@
 #Стандартными отборами СКД.
 #Произвольным алгоритмом.
 #Указанием алгоритма из библиотеки алгоритмов.

@@ Строка 12: / Строка 12: @@
 Условие может быть задано 3-мя способами.
-. Стандартными отборами СКД.
+#Стандартными отборами СКД.
-. Произвольным алгоритмом.
+#Произвольным алгоритмом.
-. Указанием алгоритма из библиотеки алгоритмов.
+#Указанием алгоритма из библиотеки алгоритмов.
 Первый вариант аналогичен настройке отборов в типовых отчетах.
-[[Файл:temprule_1.png]]
+[[Файл:temprule_2.png]]
 Далее информация для технических специалистов (программисты, консультанты, администраторы)
@@ Строка 26: / Строка 26: @@
 Последние 2 варианта для случаев сложных условий, которые невозможно описать стандартным способом. Контекст алгоритма содержит следующие переменные:
-- Результат - в эту переменную должен быть присвоен результат выполнения алгоритма. Если присваивается значение типа Булево, то оно и будет определять видимость правила заполнения. Если присваивается значение другого типа, то видимость определяется с помощью стандартной функции ЗначениеЗаполнено к этому значению.
+*Результат - в эту переменную должен быть присвоен результат выполнения алгоритма. Если присваивается значение типа Булево, то оно и будет определять видимость правила заполнения. Если присваивается значение другого типа, то видимость определяется с помощью стандартной функции ЗначениеЗаполнено к этому значению.
-- Объект - ссылка на объект информационной базы 1С, для которого необходимо определить возможность использования правила заполнения;
+*Объект - ссылка на объект информационной базы 1С, для которого необходимо определить возможность использования правила заполнения;
-- ПараметрАлгоритма - произвольный параметр, обычно строковый, который может быть передан алгоритму (только для алгоритмов из библиотеки);
+*ПараметрАлгоритма - произвольный параметр, обычно строковый, который может быть передан алгоритму (только для алгоритмов из библиотеки);
-- кэш - соответствие, доступное алгоритмам в процессе формирования списка правил заполнения для выбора пользователем (его использование - на усмотрение программиста, чаще всего для кэширования);
+*кэш - соответствие, доступное алгоритмам в процессе формирования списка правил заполнения для выбора пользователем (его использование - на усмотрение программиста, чаще всего для кэширования);
 Редактирование алгоритмов доступно только под полными правами.
@@ Строка 41: / Строка 41: @@
 Обработчики событий реализуются на встроенном языке 1С. Формирование документа Word производитмя в 2 этапа
-. Подготовка данных для заполнения закладок. Выполняется на сервере.
+#Подготовка данных для заполнения закладок. Выполняется на сервере.
-. Обработка и заполнение закладок в документе Word. Выполняется на клиенте.
+#Обработка и заполнение закладок в документе Word. Выполняется на клиенте.
 Обработчики событий подготовки данных для заполнения шаблона
@@ Строка 51: / Строка 51: @@
 Возникает в начале процедуры подготовки данных для заполнения шаблона. Контекст:
-- Объект - ссылка на объект информационной базы 1С, на основе которого выполняется заполнение шаблона;
+*Объект - ссылка на объект информационной базы 1С, на основе которого выполняется заполнение шаблона;
-- кэш - соответствие, доступное алгоритмам в процессе выполнения правила заполнения шаблона (его использование - на усмотрение программиста, чаще всего для кэширования);
+*кэш - соответствие, доступное алгоритмам в процессе выполнения правила заполнения шаблона (его использование - на усмотрение программиста, чаще всего для кэширования);
 Может использоваться, например, для подготовки данных в кэше.
@@ Строка 60: / Строка 60: @@
 Возникает после вычисления значения для очередной закладки (в цикле вычисления значений для закладок). Контекст:
-- Объект - ссылка на объект информационной базы 1С, на основе которого выполняется заполнение шаблона;
+*Объект - ссылка на объект информационной базы 1С, на основе которого выполняется заполнение шаблона;
-- ИмяЗакладки - имя закладки, для которой вычисляется значение;
+*ИмяЗакладки - имя закладки, для которой вычисляется значение;
-- ЗначениеЗакладки - вычисленное значение для подстановки в закладку до форматирования (см. раздел "Способы заполнения закладок");
+*ЗначениеЗакладки - вычисленное значение для подстановки в закладку до форматирования (см. раздел "Способы заполнения закладок");
-- ЗначениеЗакладкиСтр - ЗначениеЗакладки после форматирования и преобразования значения в строку, изменение данной переменной изменяет подставляемое в закладку значение;
+*ЗначениеЗакладкиСтр - ЗначениеЗакладки после форматирования и преобразования значения в строку, изменение данной переменной изменяет подставляемое в закладку значение;
-- кэш - соответствие, доступное алгоритмам в процессе выполнения правила заполнения шаблона (его использование - на усмотрение программиста, чаще всего для кэширования);
+*кэш - соответствие, доступное алгоритмам в процессе выполнения правила заполнения шаблона (его использование - на усмотрение программиста, чаще всего для кэширования);
 Отметим, что если значение закладки = Неопередено, то закладка при заполнении шаблона не обрабатывается. Например, для способа заполнения "Удалить при условии" значение закладки либо Неопределено (если условие НЕ выполняется), либо пустая строка (если условие выполняется).
@@ Строка 75: / Строка 75: @@
 Возникает после цикла вычисления значений закладок. Контекст:
-- Объект - ссылка на объект информационной базы 1С, на основе которого выполняется заполнение шаблона;
+*Объект - ссылка на объект информационной базы 1С, на основе которого выполняется заполнение шаблона;
-- кэш - соответствие, доступное алгоритмам в процессе выполнения правила заполнения шаблона (его использование - на усмотрение программиста, чаще всего для кэширования);
+*кэш - соответствие, доступное алгоритмам в процессе выполнения правила заполнения шаблона (его использование - на усмотрение программиста, чаще всего для кэширования);
 Может использоваться, например, для простановки отметки в информационной базе о том, что было выполнено формирование документа Word (отметка "договор распечатан").
@@ Строка 87: / Строка 87: @@
 Возникает перед началом цикла обработки закладок Word-документа. Контекст:
-- WordDocument - COM-объект объектной модели Word, тип - Document (https://msdn.microsoft.com/en-us/vba/word-vba/articles/document-object-word) - заполняемый документ-шаблон.
+*WordDocument - COM-объект объектной модели Word, тип - Document (https://msdn.microsoft.com/en-us/vba/word-vba/articles/document-object-word) - заполняемый документ-шаблон.
-- СоответствиеЗакладокИЗначений - соответствие, в котором ключ - имя закладки, а значение - то, на что будет заменено значение закладки;
+*СоответствиеЗакладокИЗначений - соответствие, в котором ключ - имя закладки, а значение - то, на что будет заменено значение закладки;
 Может использоваться, например, для предобработки документа или значений закладок.
@@ Строка 111: / Строка 111: @@
 Возникает перед началом цикла обработки закладок Word-документа. Контекст:
-- WordDocument - COM-объект объектной модели Word, тип - Document (https://msdn.microsoft.com/en-us/vba/word-vba/articles/document-object-word) - заполняемый документ-шаблон.
+:- WordDocument - COM-объект объектной модели Word, тип - Document (https://msdn.microsoft.com/en-us/vba/word-vba/articles/document-object-word) - заполняемый документ-шаблон.
-- СоответствиеЗакладокИЗначений - соответствие, в котором ключ - имя закладки, а значение - то, на что выполнялась замена закладки;
+:- СоответствиеЗакладокИЗначений - соответствие, в котором ключ - имя закладки, а значение - то, на что выполнялась замена закладки;
 Может использоваться, например, для постобработки документа.