4.1. Хранение настроек. Интеграция. Хранение шаблонов документов

Для удобного использования решений, их настройки и расширения без написания кода, можно создавать параметры для настройки. Ниже разберём существующие места хранения настроек в системе и сценарии их использования.

Дополнительные параметры

Дополнительные параметры позволяют хранить значения констант. С такими параметрами можно работать в сценариях бизнес-процессов, сохраняя при этом возможность изменения этих настроек через пользовательский интерфейс.

Например, нам нужно рассчитать размер суточных на основании длительности командировки. Размер суточных принят в компании за X рублей и ни от чего не зависит.

Длительность командировки — величина непостоянная и зависит от дат конкретной командировки. Она будет храниться в контексте бизнес-процесса Оформление командировки или в контексте приложения Командировка.

Настройки модуля

Вы можете добавить параметры для настройки модуля.

Например, при реализации модуля интеграции с учётной системой нужно где-то хранить параметры подключения к ней. Эти параметры можно вынести в настройки модуля. В testing-среде в настройках модуля вы можете указать адрес для подключения, логин и пароль от тестового сервера учётной системы.

Приложение

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

Например, необходимо рассчитать размер суточных на основании длительности командировки. Размер суточных зависит от места назначения. Так, для командировок в Москву и Санкт-Петербург размер суточных — X рублей, а для остальных городов России — Y рублей.

Чтобы хранить суточные для Москвы и Санкт-Петербурга, создадим приложение Суточные по городам. В нём сделаем ссылку на элемент приложения Город и будем хранить сумму суточных для него. Размер суточных «по умолчанию» (Y рублей) будем хранить в дополнительных параметрах. В сценарии получения размера суточных реализуем простую логику:

1. установить место назначения командировки;
2. найти его в приложении Суточные по городам:

a. если нашли, установить размер суточных;
b. если не нашли, получить размер суточных по умолчанию из дополнительных параметров.​

Интеграция

Для интеграции с другими системами используйте модули.

Модуль позволяет:

• создать настройки подключения к системе;
• создать новые элементы для дизайнера бизнес-процессов, чтобы интеграцию было просто встроить в бизнес-процессы компании;
• создать методы для Web API, которые будут вызываться из интегрируемой системы. Перед созданием методов проверьте, возможно, вам подойдут уже существующие.

Хранение шаблонов документов

Для генерации печатных форм документов в системе используются шаблоны документов. В зависимости от решаемой задачи способ хранения этих шаблонов может отличаться.

Один шаблон на документ

Если для одного документа вы используете один шаблон для генерации, то разместите его в приложении и выберите в бизнес-процессе в элементе Генерация по шаблону.

Например, в организации для генерации приказа на материальную помощь используется один шаблон. Он не зависит ни от каких параметров и всегда один.

Несколько шаблонов на документ

Если для одного типа документов используется несколько шаблонов, разместите их в разделе Администрирование — Шаблоны документов или в отдельном приложении.

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

Если необходимо генерировать договор, шаблон которого зависит от определённых параметров (например, от вида договора), используйте приложения для хранения шаблонов. Создайте приложение Договор типа Документ с полем Вид договора и приложение Шаблон договора с полями Файл для хранения шаблона, и Вид договора. Загрузите в приложение Шаблон договора шаблоны документов с указанием вида договора, для которых они подходят. В бизнес-процессе нужный шаблон можно получить с помощью сценария, используя поиск шаблона по виду договора. Для формирования документов используйте элемент Генерация по файлу.