^{Как создать шаблон документа в Doc.one для Case.one? Как добавить шаблон Doc.one?}

Если шаблон был получен в результате синхронизации с Doc.one, вместо прикрепленного файла шаблона отображается ссылка на шаблон в Doc.one.

Настройка полей шаблона Doc.one

Для настройки шаблона, полученного из Doc.one:

1. Настройте на форме просмотра шаблона Doc.one возможность открыть шаблон документа перед созданием.
2. Нажмите кнопку перехода по ссылке на форме просмотра шаблона Doc.one.
3. Укажите данные вашей учетной записи Doc.one и нажмите кнопку Начать работу.

Форма настройки шаблона содержит следующие вкладки:

• Шаблон — основная вкладка для работы с шаблоном
• Предпросмотр — на вкладке доступен просмотр настроенного шаблона
• История — на вкладке можно посмотреть историю изменений шаблона по версиям
• Настройки — на вкладке можно указать свойства шаблона

На вкладке Шаблон:

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

Чтобы настроить поля шаблона Doc.one:

1. Нажмите на поле шаблона. В правой части формы отобразятся параметры поля.
2. Обязательно присвойте такой внешний идентификатору полю, который указан в качестве тега в настройках поля в Case.one.
3. Укажите значение параметра Внешний идентификатор соответствующими значениями тегов из Case.one в остальных полях шаблона. Теги для документов, доступные для шаблонов документов Case.one, также могут быть использованы в шаблоне Doc.one.
4. Проверьте форматы полей в выбранном типе объекта в Case.one и определите соответствующие форматы полей в шаблоне — шаблоны Doc.one размечаются с использованием типов полей, которые доступны для добавления в редакторе Doc.one, и соотносятся с типами полей Case.one.

В шаблоне Doc.one вы можете использовать как собственные теги, так и системные.

_{Описание соотношения типов полей}

Поскольку связь полей осуществляется с помощью указания тега поля в Case.one, в параметре Внешний идентификатор поля Doc.one:

• Если формат поля не совпадает с форматом, описанным в таблице выше, такие значения игнорируются в получаемом документе (остаются пустыми)
• Если в Doc.one указан не корректный тег, и документ не получается сгенерировать, отображается ошибка генерации документа по шаблону

Не забудьте перейти на вкладку Настройки и выбрать формат, в котором будет создан файл документа в Case.one на основе этого шаблона.

_{Описание соотношения форматов шаблона}

После всех настроек шаблона:

1. Нажмите кнопку Опубликовать. Шаблон будет сохранен и опубликован в Doc.one, а в Case.one данные шаблона обновятся после синхронизации.
2. Откройте карточку дела или объекта в Case.one и на вкладке Документы сформируйте документ по шаблону из Doc.one.

Настройка вопроса в шаблоне Doc.one

При редактировании шаблона на боковой панели на вкладке Вопросы вы можете добавить условия/вопросы (по И/ИЛИ) к полю или блоку.

Если вопрос настроен для поля, при определенном ответе в документе будет отображаться соответствующий текст.

Вы можете добавить нескольких ответов, в зависимости от выбора которых будет отображаться настроенный для ответа текст. Также вы можете добавить несколько вопросов для отображения одного и того же фрагмента текста.

Чтобы добавить вопрос к полю выполните следующие действия:

1. Добавьте нужный тип поля и пропишите все варианты текста в шаблоне, которые при различных обстоятельствах могут появляться в документе. 
2. Выделите фрагмент текста и нажмите кнопку Добавить условие. Отобразится параметры условия. 
3. Укажите настройки
   • В поле Название введите вопрос к выделенному тексту и нажмите клавишу ENTER (доступен выбор вопросов из списка вопросов этого шаблона)
   • В поле Ответ — ответ на него, при выборе которого выделенный текст будет появляться в документе
4. Выделите следующий фрагмент текста и нажмите кнопку Добавить условие. Отобразится параметры условия. 
5. Укажите настройки:
   • В поле Название введите вопрос к выделенному тексту и нажмите клавишу ENTER (доступен выбор вопросов из списка вопросов этого шаблона)
   • В поле Ответ — ответ на него, при выборе которого выделенный текст будет появляться в документе
6. Перейдите в настройки поля и укажите разные теги для разных вариантов. 

Работа с мультиблоками и мультистроками в шаблоне Doc.one

При работе с мультиблоками и мультистроками в шаблоне Doc.one табличные данные будут заполняться из:

• Простого блока Case.one с мультистроками — в Case.one по тегу поля будет собран массив всех значений (количество значений равно количеству строк в блоке). Если значение в строке не заполнено, в качестве элемента в этом месте массива будет передано null.
• Мультиблока Case.one c простыми строками — в Case.one по тегу поля будет собран массив всех значений (количество значений равно количеству строк в блоке). Если значение в строке не заполнено, в качестве элемента в этом месте массива будет передано null.
• Мультиблока Case.one с мультистроками — по каждому добавленному мультиблоку будут собраны массивы с данными по мультистрокам:
  • Если значение в строке не заполнено, в качестве элемента в этом месте массива будет передано null
  • Если в шаблоне в таблице первого уровня полей для заполнения больше 1, для предотвращения созданий копий мультистроки ко всем тегам, используемым в Doc.one и Case.one, необходимо добавлять префикс «__». Благодаря префиксу поля будут добавлены в таблицу один раз

Связь полей также осуществляется с помощью указания тега поля в Case.one в параметре Внешний идентификатор поля Doc.one. 

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

При работе с массивами в Doc.one предусмотрены следующие ограничения:

• Если массив передается в простое поле, все значения будут записаны через разделитель — « , »
• Если массив передается в строку таблицы, отмеченную как мультистрока, будут созданы дополнительные строки (количество строк зависит от длины массива)
• Массив может передаваться в условия с единичным и множественным выбором
• Теперь при работе с вопросами с мультивыбором, если передать пустой массив в ответ на такой вопрос, то выбор по умолчанию будет автоматически сброшен (особенность работы API v3 Doc.one)
• При работе с повторяющимися полями разных типов (разные поля с одним тегом) — ответ будет применяться с тем типом, в поле какого типа он попал первым

Например, в шаблоне присутствует два числовых поля (целое и дробное число) с одним тегом. В Case.one поле с этим тегом заполнено числом с дробной частью:

• Если дробное значение первым придет в числовое поле с форматом Целое число, в поле с форматом Дробное число попадет уже округленное значение без дробной части.
• Если же первым значение придет в поле с форматом Дробное число, заполнение целого числа будет с ошибкой несовпадения форматов.

Обратите внимание, при создании документа через АПИ v3 Doc.one предусмотрены следующие ограничения на вложенные мультистроки:

• Передавать одинаковые значения для полей внешней мультистроки нельзя во вложенном массиве — данные будут перезаписываться (разрешается использовать для внутренних полей)
• Если в мультистроках больше двух полей, и два из них заполняются вложенным массивом, документ не будет создан, пока не будут переданы данные (хотя бы пустые строки)
• При передаче данных для нескольких полей с одинаковым названием и внешним идентификатором (Title и ExternalID), возможно некорректное отображение данных, особенно при наличии таких полей до таблицы с мультистроками
• При заполнении поля вложенным массивом функция заполнения полей при одновременном выборе условий недоступна
• Создать документ с переиспользованными полями и заполнением вложенным массивом можно в двух случаях:
  • Если в мультистроках переиспользуется блок с полем
  • Если таблица с мультистроками и переиспользованными полями находится в блоке, помещенном в шаблон