Диадок версии 2.0 / Настроить Диадок версии 2.0

Настроить Диадок версии 2.0

Начало внимание

Для корректной работы Диадок версии 2.0 выключите предыдущую его версию.

Конец внимание

Перейдите в раздел Администрирование > Модули. Вверху страницы в блоке Пользовательские модули найдите модуль Диадок 2.0 и нажмите на него.

На открывшейся странице настройки задаются в блоках:

  1. Настойка ELMA365 — синхронизировать ELMA365 и Диадок.
  2. Настройки Диадок — подключиться к Диадок, активировать используемые опции и настроить сопоставление типов документов.
  3. Работа с пакетами документов — указать бизнес-процесс для автоматического запуска при получении входящего пакета документов из Диадок.
  4. Синхронизация — определить параметры синхронизации данных между ELMA365 и Диадок.

Шаг 1. Синхронизировать ELMA365 и Диадок

Заполните поля:

diadoc-solution-1

  • API ключ ELMA365* — вставьте в это поле токен. Предварительно создайте его и скопируйте в разделе Администрирование > Токены. Подробнее об этом читайте в статье «Токены»;
  • Адрес ELMA365* — укажите URL-адрес главной страницы ELMA365, куда вы установили Диадок версии 2.0.

Шаг 2. Настроить Диадок

В блоке Настройки Диадок:

diadoc-solution-2

Настроить авторизацию в Диадок

Чтобы предоставить пользователям право отправлять документы в Диадок, настройте авторизацию для их аккаунтов. Это можно сделать одним из способов:

  1. Использовать персональную авторизацию.
     
    В этом случае пользователи сами вносят данные своего аккаунта в Диадок, когда работают с документом в рамках бизнес-процесса или через виджет.
     
    Авторизация действует три минуты. По истечении этого времени пользователь вводит логин и пароль повторно.
     
    Важно: если вы используете персональную авторизацию, в таблице Аккаунты пользователей укажите для учётной записи в ELMA365 данные одного аккаунта в Диадок. При этом у такого аккаунта должен быть доступ ко всем документам организации. Без этого нельзя синхронизировать типы документов.
  2. Сопоставить учётные записи в ELMA365 c аккаунтами в Диадок.
     
    Внесите в таблицу Аккаунты пользователей логины и пароли в Диадок тех пользователей, которые смогут выполнять задачи в ELMA365 по обработке документов.
     
    Для юридического лица, зарегистрированного в Диадок, можно создать несколько учётных записей. Каждую учётную запись в Диадок можно связать с конкретным пользователем, группой пользователей или элементом оргструктуры из ELMA365. Например, для группы пользователей Руководители можно настроить одну учётную запись в Диадок. Тогда все сотрудники, входящие в эту группу, смогут работать с документами в Диадок.
     
    В таблице заполните поля:
  • Юридическое лицо — выберите организацию из системного справочника Мои юридические лица, от имени которой будут выполняться действия в Диадок;
  • Логин — введите логин учётной записи в Диадок;
  • Пароль — укажите пароль учётной записи в Диадок;
  • Пользователи — выберите пользователя, группу или элемент оргструктуры, которым предоставляете право подписывать и отправлять документы от данного аккаунта в Диадок.

Вы можете удалить строку таблицы, нажав значок корзины.

Указать дополнительные настройки

После подключения аккаунта Диадок вы можете активировать опции:

  • Использовать трехстороннее подписание — включите опцию, если в вашем аккаунте Диадок активировано подписание документа тремя сторонами. Тогда в карточке задачи, которая формируется с помощью блока Диадок отправить документ:
    • в поле Контрагент выбирается основной получатель;
    • дополнительно отображается опция Использовать трехстороннее подписание. Пользователь может включить её и указать промежуточного контрагента;
  • Сделать заполнение доверенностей обязательным — включите опцию, если на стороне Диадок вы оформили доверенность для подписанта. В таком случае пользователю нужно приложить свою доверенность, чтобы отправить документ в Диадок.
     
    Если опция выключена, пользователь может выполнить задачу по отправке без добавления доверенности;
  • Ограничить синхронизацию исходящих документов — активируйте опцию, чтобы отключить загрузку в ELMA365 документов, которые созданы в Диадок.
     
    При выключенной опции в приложение ELMA365 импортируются все документы, которые подходят его сопоставлению, заданному в настройках модуля. Например, в кабинете Диадок пользователь создаёт исходящий договор. Если для документа настроено сопоставление, он автоматически добавится в приложение ELMA365.

 

Синхронизировать типы документов

После заполнения данных в блоках Настройка ELMA365 и Настройки Диадок нажмите Синхронизировать типы документов, чтобы получить данные из Диадок и ELMA365 для дальнейшей настройки.

Настроить соответствия документов

Откройте блок Соответствие документов, нажав значок configure-diadoc-solution-1. В этом блоке:

  • выберите приложение типа Документ из ELMA365 для участия в обмене документами с Диадок;
  • укажите бизнес-процесс для обработки входящего документа или для рассмотрения запроса на аннулирование документа;
  • сопоставьте свойства выбранного приложения из ELMA365 и атрибуты в Диадок, статусы документа в ELMA365 и в Диадок.

Чтобы настроить соответствие документов:

  1. Нажмите кнопку Создать сопоставление.
    diadoc-solution-3
  1. В открывшемся окне заполните поля:
    diadoc-solution-4
  • Наименование для сопоставления — рекомендуется давать наименование по названию приложения или документа, для которого создаётся сопоставление, чтобы упростить дальнейшую работу и поиск.
     
    Это наименование отображается в задаче Диадок отправить документ в поле Вид документа для отправки, если в нескольких сопоставлениях вы укажете одно и то же приложение ELMA365;
  • Направление — выберите документопоток в ELMA365, с которым будете работать:
    • Входящий — документы, полученные от контрагента из Диадок;
    • Исходящий — документы, загружаемые в Диадок для отправки контрагенту;
  • Тип документа — выберите тип документа в Диадок. Подробнее с перечнем документов можно ознакомиться на официальном сайте Диадок.
     
    Обратите внимание, для входящих документов доступен тип Нераспознанный документ. Используйте его в качестве универсального сопоставления, чтобы поступающие в Диадок документы создавались в ELMA365. Например, когда вы тестируете входящий документопоток без детальной настройки атрибутов;
  • Функция — укажите функцию, которая соответствует выбранному типу документа. Например, для типа документа Договор выберите функцию Contract_default.
     
    Поле опционально при настройке сопоставления для исходящего документа;
  • Приложение ELMA — выберите приложение типа Документ. Если в поле Направление установлено Входящий, в это приложение поступают документы от контрагента из Диадок. При выборе опции Исходящий — в приложении создаются документы, которые вы отправляете контрагентам через Диадок.
     
    Для исходящего документопотока вы можете ограничить синхронизацию, чтобы в приложение ELMA365 сохранялись только документы, созданные в системе. Тогда исходящие документы, добавленные в кабинете Диадок, не будут автоматически импортироваться в приложение ELMA365, даже если для них настроено сопоставление.
     
    Одно приложение из системы ELMA365 можно указать в настройках сопоставления нескольких исходящих документов. Например, договор и дополнительные соглашения к нему хранятся в приложении Исходящие договоры. Оно выбирается при настройке сопоставлений и для договора, и для дополнительного соглашения. В таком случае в карточке задачи в поле Вид документа для отправки отобразятся наименования подходящих сопоставлений. В зависимости от направляемого документа пользователь выбирает нужный вариант.

начало внимание

Для одного приложения из ELMA365 можно назначить только одну функцию из Диадок.

конец внимание

  • Версия документа для создания — укажите версию для выбранного типа документа. В Диадок может создаваться новая версия для любого типа документа. Чаще всего это связано с изменением законодательства в сфере документооборота. Пример смотрите на официальном сайте Диадок.
     
    Поле опционально при настройке сопоставления для исходящего документа.
  1. Далее для входящего документа отобразятся дополнительные поля, где можно указать процесс его обработки:
    diadoc-solution-7
  • Бизнес процесс для входящего документа — для выбора доступны процессы, созданные на уровне приложения, указанного выше в поле Приложение ELMA365;
  • Поле для передачи документа — укажите переменную процесса типа Приложение, связанную с приложением типа Документ в ELMA365, для которого вы настраиваете сопоставление.
     
    Если настройки заданы, то выбранный процесс можно запустить для документа, полученного из Диадок.
     
    Вы можете настроить получение, отправку и подписание документов в бизнес-процессах, используя графические элементы, предназначенные для решения Диадок версии 2.0.
  1. Вы можете настроить автоматический запуск бизнес-процесса в ELMA365 каждый раз, когда контрагент отправляет запрос на аннулирование документа в Диадок. Для этого заполните поля:
    diadoc-solution-10
  • Бизнес процесс для входящего аннулирования — выберите настроенный процесс для обработки входящего аннулирования из Диадок. Такой процесс создаётся на уровне приложения, указанного в поле Приложение ELMA365;
  • Поле для передачи документа — укажите переменную типа Приложение из контекста процесса. При создании этой переменной укажите приложение типа Документ, для которого вы настраиваете сопоставление.
  1. Соотнесите свойства приложения типа Документ в ELMA365 и все атрибуты, использующиеся в Диадок. В противном случае работа с документами невозможна.
     
    Важно: атрибуты в Диадок и свойства в ELMA365 должны соответствовать по типу данных. Например, если регистрационный номер хранится в ELMA365 как строка, его нельзя сопоставить с числовым полем Диадок.
     
    Учитывайте особенности сопоставления атрибутов, в которых хранится денежная сумма. Атрибут в Диадок Сумма (Деньги) соответствует свойству типа Деньги (Российский рубль) из ELMA365. Для атрибутов с суммами в других валютах используются свойства Строка или Число.
     
    Занесите в таблицу каждое свойство по отдельности:
    diadoc-solution-5
  • Атрибут ELMA — укажите свойство приложения типа Документ;
  • Атрибут Диадок — выберите переменную, которая соответствует указанному выше свойству ELMA365.
     
    Для сохранения записи в таблице нажмите Добавить. Чтобы удалить строку таблицы, нажмите значок корзины.
  1. Соотнесите статусы приложения типа Документ в ELMA365 и документа в Диадок по такому же принципу, как на предыдущем шаге.

diadoc-solution-8

  1. После заполнения всех полей нажмите кнопку Создать.
  1. В блоке Соответствие документов напротив поля Сопоставление документов нажмите на значок лупы. Выберите все приложения, для которых вы создали сопоставления. Они будут участвовать в обмене документами с Диадок.
  1. В блоке Соответствие документов можно внести изменения в настроенные сопоставления. Для этого нажмите Редактировать сопоставление. В открывшемся окне выберите созданное ранее сравнение для структуры документа. Оно загрузится на странице.

Проверить соединение с Диадок

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

  1. В блоке Настройки Диадок под таблицей Аккаунты пользователей нажмите Проверить соединение с Диадок.
  2. В открывшемся окне выберите один из аккаунтов пользователей и нажмите Проверить доступ.
    configure-diadoc-solution-2
  3. В случае успешного соединения с Диадок вы увидите:
  1. Вы можете проверить отправку доступных типов документов. Для этого в поле Тип документа для отправки тестового черновика выберите одно из настроенных сопоставлений и прикрепите файл черновика. Нажмите Отправить тестовый черновик.

Шаг 3. Настроить работу с пакетами документов

В этом блоке можно указать бизнес-процесс обработки входящего пакета документов из Диадок. Процесс автоматически запустится, если поступит пакет документов из Диадок. Также будут созданы элементы приложений типа Документ в ELMA365, которые сопоставлены входящим документам в составе пакета.

diadoc-solution-9

  • Бизнес процесс для пакета документов — для выбора доступны процессы, в контексте которых есть переменная типа Произвольное приложение с подтипом Несколько;
  • Атрибут бизнес процесса для передачи пакета документов — выберите переменную типа Произвольное приложение с подтипом Несколько, в которую запишутся документы из полученного пакета.

Шаг 4. Задать параметры синхронизации

Синхронизация позволяет своевременно обмениваться данными между ELMA365 и Диадок. В этом блоке доступны следующие настройки:

diadoc-solution-6

  1. Логирование — для диагностики проблем в работе модуля можно регистрировать возникающие ошибки. Данные сохранятся в разделе Диадок Модуль > Логи в виде элементов приложения. Вы можете включать логирование в модуле на 5-15 минут. Это позволит собрать нужные данные и не перегружать оперативную память.
     
    Для этого активируйте опцию Включить логирование синхронизации и выберите, какие записи отслеживать: логирование синхронизации, внешних запросов или внутренних запросов.
  2. Фоновые задачи — синхронизацию можно включить в фоновом режиме, нажав кнопку Запустить фоновые задачи. После этого каждые три минуты начнут выполняться запросы в Диадок и обновляться данные в ELMA365.
     
    Чтобы не получать новые входящие документы из Диадок, нажмите кнопку Остановить фоновые задачи.
  3. Дополнительные параметры — вы можете управлять количеством событий, которые поступают из Диадок и обрабатываются в ELMA365 при синхронизации данных в рамках одного запроса. Это позволит стабилизировать нагрузку на ресурсы и предотвратить сбои в работе системы. Настройка доступна для всех поставок, но зачастую применяется при использовании модуля Диадок 2.0 в поставках ELMA365 On-Premises.

Рекомендуемые значения параметров для синхронизации данных при использовании модуля Диадок 2.0

  1. Задать дату повторного обновления — если пропадёт связь, возникнет ошибка при обмене документами. Чтобы обновить данные:
  1. Укажите дату обновления и нажмите кнопку Запомнить дату.
  2. Нажмите Запустить фоновые задачи. Синхронизируются данные за период с даты обновления по текущее число.
  3. После обновления данных в настройках отобразится информация об успешной синхронизации.

Начало внимание

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

Конец внимание

Когда вы установите параметры в блоках Настройка ELMA365, Настройки Диадок, Работа с пакетами документов и выполните настройку синхронизации, нажмите Сохранить внизу страницы.