Начало внимание
Для корректной работы Диадок версии 2.0 выключите предыдущую его версию.
Конец внимание
Перейдите в раздел Администрирование > Модули. Вверху страницы в блоке Пользовательские модули найдите модуль Диадок 2.0 и нажмите на него.
На открывшейся странице настройки задаются в блоках:
- Настойка ELMA365 — синхронизировать ELMA365 и Диадок.
- Настройки Диадок — подключиться к Диадок, активировать используемые опции и настроить сопоставление типов документов.
- Работа с пакетами документов — указать бизнес-процесс для автоматического запуска при получении входящего пакета документов из Диадок.
- Синхронизация — определить параметры синхронизации данных между ELMA365 и Диадок.
Шаг 1. Синхронизировать ELMA365 и Диадок
Заполните поля:
- API ключ ELMA365* — вставьте в это поле токен. Предварительно создайте его и скопируйте в разделе Администрирование > Токены. Подробнее об этом читайте в статье «Токены»;
- Адрес ELMA365* — укажите URL-адрес главной страницы ELMA365, куда вы установили Диадок версии 2.0.
Шаг 2. Настроить Диадок
В блоке Настройки Диадок:
- укажите данные, чтобы подключиться к аккаунту Диадок;
- включите дополнительные опции для работы с документами;
- синхронизируйте типы документов и создайте сопоставления для них;
- проверьте соединение с Диадок.
Настроить авторизацию в Диадок
Чтобы предоставить пользователям право отправлять документы в Диадок, настройте авторизацию для их аккаунтов. Это можно сделать одним из способов:
- Использовать персональную авторизацию.
В этом случае пользователи сами вносят данные своего аккаунта в Диадок, когда работают с документом в рамках бизнес-процесса или через виджет.
Авторизация действует три минуты. По истечении этого времени пользователь вводит логин и пароль повторно.
Важно: если вы используете персональную авторизацию, в таблице Аккаунты пользователей укажите для учётной записи в ELMA365 данные одного аккаунта в Диадок. При этом у такого аккаунта должен быть доступ ко всем документам организации. Без этого нельзя синхронизировать типы документов. - Сопоставить учётные записи в ELMA365 c аккаунтами в Диадок.
Внесите в таблицу Аккаунты пользователей логины и пароли в Диадок тех пользователей, которые смогут выполнять задачи в ELMA365 по обработке документов.
Для юридического лица, зарегистрированного в Диадок, можно создать несколько учётных записей. Каждую учётную запись в Диадок можно связать с конкретным пользователем, группой пользователей или элементом оргструктуры из ELMA365. Например, для группы пользователей Руководители можно настроить одну учётную запись в Диадок. Тогда все сотрудники, входящие в эту группу, смогут работать с документами в Диадок.
В таблице заполните поля:
- Юридическое лицо — выберите организацию из системного справочника Мои юридические лица, от имени которой будут выполняться действия в Диадок;
- Логин — введите логин учётной записи в Диадок;
- Пароль — укажите пароль учётной записи в Диадок;
- Пользователи — выберите пользователя, группу или элемент оргструктуры, которым предоставляете право подписывать и отправлять документы от данного аккаунта в Диадок.
Вы можете удалить строку таблицы, нажав значок корзины.
Указать дополнительные настройки
После подключения аккаунта Диадок вы можете активировать опции:
- Использовать трехстороннее подписание — включите опцию, если в вашем аккаунте Диадок активировано подписание документа тремя сторонами. Тогда в карточке задачи, которая формируется с помощью блока Диадок отправить документ:
- в поле Контрагент выбирается основной получатель;
- дополнительно отображается опция Использовать трехстороннее подписание. Пользователь может включить её и указать промежуточного контрагента;
- Сделать заполнение доверенностей обязательным — включите опцию, если на стороне Диадок вы оформили доверенность для подписанта. В таком случае пользователю нужно приложить свою доверенность, чтобы отправить документ в Диадок.
Если опция выключена, пользователь может выполнить задачу по отправке без добавления доверенности; - Ограничить синхронизацию исходящих документов — активируйте опцию, чтобы отключить загрузку в ELMA365 документов, которые созданы в Диадок.
При выключенной опции в приложение ELMA365 импортируются все документы, которые подходят его сопоставлению, заданному в настройках модуля. Например, в кабинете Диадок пользователь создаёт исходящий договор. Если для документа настроено сопоставление, он автоматически добавится в приложение ELMA365.
Синхронизировать типы документов
После заполнения данных в блоках Настройка ELMA365 и Настройки Диадок нажмите Синхронизировать типы документов, чтобы получить данные из Диадок и ELMA365 для дальнейшей настройки.
Настроить соответствия документов
Откройте блок Соответствие документов, нажав значок . В этом блоке:
- выберите приложение типа Документ из ELMA365 для участия в обмене документами с Диадок;
- укажите бизнес-процесс для обработки входящего документа или для рассмотрения запроса на аннулирование документа;
- сопоставьте свойства выбранного приложения из ELMA365 и атрибуты в Диадок, статусы документа в ELMA365 и в Диадок.
Чтобы настроить соответствие документов:
- Нажмите кнопку Создать сопоставление.
- В открывшемся окне заполните поля:
- Наименование для сопоставления — рекомендуется давать наименование по названию приложения или документа, для которого создаётся сопоставление, чтобы упростить дальнейшую работу и поиск.
Это наименование отображается в задаче Диадок отправить документ в поле Вид документа для отправки, если в нескольких сопоставлениях вы укажете одно и то же приложение ELMA365; - Направление — выберите документопоток в ELMA365, с которым будете работать:
- Входящий — документы, полученные от контрагента из Диадок;
- Исходящий — документы, загружаемые в Диадок для отправки контрагенту;
- Тип документа — выберите тип документа в Диадок. Подробнее с перечнем документов можно ознакомиться на официальном сайте Диадок.
Обратите внимание, для входящих документов доступен тип Нераспознанный документ. Используйте его в качестве универсального сопоставления, чтобы поступающие в Диадок документы создавались в ELMA365. Например, когда вы тестируете входящий документопоток без детальной настройки атрибутов; - Функция — укажите функцию, которая соответствует выбранному типу документа. Например, для типа документа Договор выберите функцию Contract_default.
Поле опционально при настройке сопоставления для исходящего документа; - Приложение ELMA — выберите приложение типа Документ. Если в поле Направление установлено Входящий, в это приложение поступают документы от контрагента из Диадок. При выборе опции Исходящий — в приложении создаются документы, которые вы отправляете контрагентам через Диадок.
Для исходящего документопотока вы можете ограничить синхронизацию, чтобы в приложение ELMA365 сохранялись только документы, созданные в системе. Тогда исходящие документы, добавленные в кабинете Диадок, не будут автоматически импортироваться в приложение ELMA365, даже если для них настроено сопоставление.
Одно приложение из системы ELMA365 можно указать в настройках сопоставления нескольких исходящих документов. Например, договор и дополнительные соглашения к нему хранятся в приложении Исходящие договоры. Оно выбирается при настройке сопоставлений и для договора, и для дополнительного соглашения. В таком случае в карточке задачи в поле Вид документа для отправки отобразятся наименования подходящих сопоставлений. В зависимости от направляемого документа пользователь выбирает нужный вариант.
начало внимание
Для одного приложения из ELMA365 можно назначить только одну функцию из Диадок.
конец внимание
- Версия документа для создания — укажите версию для выбранного типа документа. В Диадок может создаваться новая версия для любого типа документа. Чаще всего это связано с изменением законодательства в сфере документооборота. Пример смотрите на официальном сайте Диадок.
Поле опционально при настройке сопоставления для исходящего документа.
- Далее для входящего документа отобразятся дополнительные поля, где можно указать процесс его обработки:
- Бизнес процесс для входящего документа — для выбора доступны процессы, созданные на уровне приложения, указанного выше в поле Приложение ELMA365;
- Поле для передачи документа — укажите переменную процесса типа Приложение, связанную с приложением типа Документ в ELMA365, для которого вы настраиваете сопоставление.
Если настройки заданы, то выбранный процесс можно запустить для документа, полученного из Диадок.
Вы можете настроить получение, отправку и подписание документов в бизнес-процессах, используя графические элементы, предназначенные для решения Диадок версии 2.0.
- Вы можете настроить автоматический запуск бизнес-процесса в ELMA365 каждый раз, когда контрагент отправляет запрос на аннулирование документа в Диадок. Для этого заполните поля:
- Бизнес процесс для входящего аннулирования — выберите настроенный процесс для обработки входящего аннулирования из Диадок. Такой процесс создаётся на уровне приложения, указанного в поле Приложение ELMA365;
- Поле для передачи документа — укажите переменную типа Приложение из контекста процесса. При создании этой переменной укажите приложение типа Документ, для которого вы настраиваете сопоставление.
- Соотнесите свойства приложения типа Документ в ELMA365 и все атрибуты, использующиеся в Диадок. В противном случае работа с документами невозможна.
Важно: атрибуты в Диадок и свойства в ELMA365 должны соответствовать по типу данных. Например, если регистрационный номер хранится в ELMA365 как строка, его нельзя сопоставить с числовым полем Диадок.
Учитывайте особенности сопоставления атрибутов, в которых хранится денежная сумма. Атрибут в Диадок Сумма (Деньги) соответствует свойству типа Деньги (Российский рубль) из ELMA365. Для атрибутов с суммами в других валютах используются свойства Строка или Число.
Занесите в таблицу каждое свойство по отдельности:
- Атрибут ELMA — укажите свойство приложения типа Документ;
- Атрибут Диадок — выберите переменную, которая соответствует указанному выше свойству ELMA365.
Для сохранения записи в таблице нажмите Добавить. Чтобы удалить строку таблицы, нажмите значок корзины.
- Соотнесите статусы приложения типа Документ в ELMA365 и документа в Диадок по такому же принципу, как на предыдущем шаге.
- После заполнения всех полей нажмите кнопку Создать.
- В блоке Соответствие документов напротив поля Сопоставление документов нажмите на значок лупы. Выберите все приложения, для которых вы создали сопоставления. Они будут участвовать в обмене документами с Диадок.
- В блоке Соответствие документов можно внести изменения в настроенные сопоставления. Для этого нажмите Редактировать сопоставление. В открывшемся окне выберите созданное ранее сравнение для структуры документа. Оно загрузится на странице.
Проверить соединение с Диадок
Вы можете проверить подключение аккаунта к Диадок, а также корректную отправку настроенных сопоставлений документов. Для этого:
- В блоке Настройки Диадок под таблицей Аккаунты пользователей нажмите Проверить соединение с Диадок.
- В открывшемся окне выберите один из аккаунтов пользователей и нажмите Проверить доступ.
- В случае успешного соединения с Диадок вы увидите:
- название подключённой организации;
- типы документов, для которых настроены сопоставления.
- Вы можете проверить отправку доступных типов документов. Для этого в поле Тип документа для отправки тестового черновика выберите одно из настроенных сопоставлений и прикрепите файл черновика. Нажмите Отправить тестовый черновик.
Шаг 3. Настроить работу с пакетами документов
В этом блоке можно указать бизнес-процесс обработки входящего пакета документов из Диадок. Процесс автоматически запустится, если поступит пакет документов из Диадок. Также будут созданы элементы приложений типа Документ в ELMA365, которые сопоставлены входящим документам в составе пакета.
- Бизнес процесс для пакета документов — для выбора доступны процессы, в контексте которых есть переменная типа Произвольное приложение с подтипом Несколько;
- Атрибут бизнес процесса для передачи пакета документов — выберите переменную типа Произвольное приложение с подтипом Несколько, в которую запишутся документы из полученного пакета.
Шаг 4. Задать параметры синхронизации
Синхронизация позволяет своевременно обмениваться данными между ELMA365 и Диадок. В этом блоке доступны следующие настройки:
- Логирование — для диагностики проблем в работе модуля можно регистрировать возникающие ошибки. Данные сохранятся в разделе Диадок Модуль > Логи в виде элементов приложения. Вы можете включать логирование в модуле на 5-15 минут. Это позволит собрать нужные данные и не перегружать оперативную память.
Для этого активируйте опцию Включить логирование синхронизации и выберите, какие записи отслеживать: логирование синхронизации, внешних запросов или внутренних запросов. - Фоновые задачи — синхронизацию можно включить в фоновом режиме, нажав кнопку Запустить фоновые задачи. После этого каждые три минуты начнут выполняться запросы в Диадок и обновляться данные в ELMA365.
Чтобы не получать новые входящие документы из Диадок, нажмите кнопку Остановить фоновые задачи. - Дополнительные параметры — вы можете управлять количеством событий, которые поступают из Диадок и обрабатываются в ELMA365 при синхронизации данных в рамках одного запроса. Это позволит стабилизировать нагрузку на ресурсы и предотвратить сбои в работе системы. Настройка доступна для всех поставок, но зачастую применяется при использовании модуля Диадок 2.0 в поставках ELMA365 On-Premises.
Рекомендуемые значения параметров для синхронизации данных при использовании модуля Диадок 2.0
|
- Задать дату повторного обновления — если пропадёт связь, возникнет ошибка при обмене документами. Чтобы обновить данные:
- Укажите дату обновления и нажмите кнопку Запомнить дату.
- Нажмите Запустить фоновые задачи. Синхронизируются данные за период с даты обновления по текущее число.
- После обновления данных в настройках отобразится информация об успешной синхронизации.
Начало внимание
Чем более раннюю дату вы выберете, тем больше времени может занять синхронизация. Вы можете продолжить работу с модулем, не дожидаясь окончания обновления данных.
Конец внимание
Когда вы установите параметры в блоках Настройка ELMA365, Настройки Диадок, Работа с пакетами документов и выполните настройку синхронизации, нажмите Сохранить внизу страницы.