Диадок версии 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

  • Бизнес процесс для пакета документов — для выбора доступны процессы, в контексте которых есть переменная типа Произвольное приложение с подтипом Несколько. Укажите процесс для обработки входящего пакета документов. Например, вы можете настроить подписание с помощью блока Диадок подписать пакет документов.
     
    Важно: чтобы с помощью этого блока пользователь мог разом подписать весь пакет, требуются настроенные сопоставления для каждого документа, входящего в его состав;
  • Атрибут бизнес процесса для передачи пакета документов — выберите переменную типа Произвольное приложение с подтипом Несколько, в которую запишутся документы из полученного пакета. Обратите внимание, чтобы документы пакета сохранились в этой переменной, настройте для них соответствия. В результате:
    1. Используя эту переменную, вы можете отобразить ссылки на документы пакета в рамках одного из этапов процесса, например на форме пользовательской задачи.
    2. Если для рассмотрения входящего пакета используется блок Диадок подписать пакет документов, ссылки на сопоставленные файлы пакета автоматически отобразятся в задаче подписания.

Кроме того, пользователи могут посмотреть состав входящего пакета в виджете Статус документа Диадок. Для этого разместите его в карточке документа.
 
Обратите внимание, если в виджете рядом с надписью Состав пакета документов отображается значок diadoc-solution-11, то видны не все файлы пакета. Чтобы пользователи могли ознакомиться с полным составом пакета, настройте сопоставления для необработанных файлов и повторно запустите синхронизацию данных.

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

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

diadoc-solution-6

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

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

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

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

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

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

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