^{Какие теги можно использовать для шаблона документа? Как создать файл шаблона документа?}

Чтобы подготовить файл шаблона, вам нужно создать документ в Word с необходимыми вам элементами: шапкой и футером, а также прописать нужные теги полей, которые вы хотите отображать в документе. 

Шаблон документа может быть подготовлен в формате .*docx или .*pdf.

Теги должны быть введены в соответствующие поля при создании блоков карточки дела, чтобы нужная информация подтягивалась в документ по шаблону.

Для создания файла шаблона:

1. Создайте документ в Word и напишите текст шаблона.
2. Пропишите теги полей, которые вы хотите отображать в документе:
   • Для системных полей используйте системные теги (например: название проекта — ProjectGroup_Name, название участника — Project_Participant_Name)
   • Для обычных полей пропишите теги вручную

Помните, что при использовании тегов регистр не учитывается.

Вы можете указать следующие типы полей:

1. Одиночное поле. Для одиночного поля используйте конструкцию <#field Название тега #>. Конструкция должна быть одним элементом управления содержимым «форматированный текст» или элементом управления содержимым «обычный текст».
2. Список полей. Для списка полей используйте конструкцию <#list Название тега 1, Название тега 2, Название тега 3 #>. В конструкции каждый элемент должен быть отдельным элементом управления содержимым «форматированный текст» или элементом управления содержимом «обычный текст»:
   • #list
   • Название тега 1
   • Название тега 2
   • Название тега 3
   • #>

Для тегов по мультиблокам обязательно указывайте у тега номер блока в [ ], например: <#field tag_for_multiblok[1] #>.

При необходимости вывести дополнительный атрибут объекта из поля, который находится в мультиблоке, используйте конструкцию <#field tag_for_multiblok[2].tag_dopatributa #>.

Вы можете прописать в шаблоне документа тег, указывающий на поле из мультистроки с использованием индекса, чтобы при формировании документа по шаблону подставлялись все значения из мультистроки (например, для отображения сведений по нескольким участникам, сведения из которых расположены в мультистроке):

• При использовании индекса в тегах во время формирования документа по шаблону будут выполнены поиск поля из мультистроки, соответствующей указанному индексу, и подстановка данных из этого поля в шаблон:
  • Индекс мультистроки должен быть больше 0 и представлен в виде целого числа — пример: <#field tag_for_multiline[2]#>
  • Индексация мультистрок начинается с 1 и соответствует порядку в блоке
  • Порядок мультистрок считается сверху вниз — первая мультистрока будет иметь индекс [1], вторая — [2] и т.д.
  • Теги мультистрок с индексом доступно использовать в таблице
• Если индекс мультистроки не указан в шаблоне, в документе будут добавлены сведения из первой мультистроки, как и прежде.
• При загрузке шаблона с тегами полей из мультиблоков и мультистрок выполняются проверки индексов тегов:
  • Если индекс присвоен тегу системного поля, отображается ошибка: Тег является системным и не может содержать порядковый номер {error tag name}
  • Если указанный для мультистроки или мультиблока индекс равен 0, отображается ошибка: Порядковый номер должен быть больше 0 {error tag name}
  • Если индекс указан для тега не из мультистроки или мультиблока, отображается ошибка: "{field name}" не находится в мультистроке или мультиблоке, поэтому тег не может содержать порядковый номер {error tag name}=