В этой статье расскажу, почему штатного тестирования оказалось недостаточно для моих задач, как устроена подмена сервиса подписания и как я реализовал модуль aclips.fakesign.

Представьте, что вам нужно разработать интеграцию с КЭДО Bitrix24. Например, создать документ, отправить его на подписание, дождаться завершения процесса и выполнить какие-то действия после того, как сотрудник поставит подпись.

Задача вроде бы несложная. Но есть нюанс: чтобы проверить весь сценарий, нужно организовать процесс подписания.

А это означает подключение КЭДО, настройку провайдера, приглашение сотрудников, подтверждение личности, работу с Госключом и прочие радости, которые совершенно не нужны разработчику, пытающемуся проверить, что его бизнес-процесс работает правильно.

А если разработка ведётся локально? Если у заказчика закрытый контур? Если нужно прогнать десяток тестовых сценариев? Или просто хочется быстро проверить очередную гипотезу, не отправляя документы реальным сотрудникам?

В общем, я подумал как упростить задачу и сделал тестовый провайдер подписания документов для Bitrix24.

Зачем вообще тестировать КЭДО?

Представим типовой сценарий одной из моих сервисных услуг:

  • • Пользователь отправляет заявку на получение услуги.
  • • Bitrix24 запускает бизнес-процесс обработки заявки.
  • • Формируется необходимый комплект документов.
  • • Документы последовательно или параллельно отправляются на подписание разным сотрудникам.
  • • После завершения подписания запускаются следующие этапы процесса.
  • • Услуга завершается, а результат фиксируется в системе.

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

В результате получается довольно разветвлённая система зависимостей от процесса подписания.

И мне нужно тестировать именно её:

  • • корректно ли формируются документы;
  • • правильно ли определяются подписанты;
  • • всем ли нужным сотрудникам отправлены документы;
  • • корректно ли обрабатывается результат подписания;
  • • запускаются ли последующие этапы;
  • • правильно ли завершается услуга.

При этом реальное подписание документа не является предметом тестирования.

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

Именно эту задачу и должен решать тестовый провайдер aclips.fakesign.

А разве в Bitrix24 нет штатного тестового подписания?

Есть… Но.. 🙂

Bitrix24 предоставляет возможность протестировать процесс подписания кадрового документа. Это удобно, чтобы познакомиться с КЭДО, проверить интерфейс и пройти демонстрационный сценарий.

Но штатный тестовый режим решает немного другую задачу.

Он предназначен для ознакомления с процессом подписания и имеет свои ограничения. Например, тестовое подписание доступно при определённых условиях, в частности, если в КЭДО ещё нет подписанных документов.

aclips.fakesign создавался для другой цели — тестирования бизнес-процессов и интеграций.

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

Именно здесь тестовый провайдер оказывается полезнее.

Штатное тестирование Bitrix24aclips.fakesign
Ознакомление с КЭДОдане является целью
Проверка процесса подписаниядаэмулируется
Тестирование интеграцийограниченноосновное назначение
Тестирование бизнес-процессовдемо сценарийда
Реальные подписинетнет
Работа в локальной средеограничена инфраструктуройда
Закрытые контурыограничена инфраструктуройда
Диагностика через CLIнетда
Подписание разными сотрудникаминетда

Итого

Если вам нужно просто познакомиться с КЭДО Bitrix24 — используйте штатный тестовый режим.

Если вы разрабатываете интеграцию, автоматизацию или бизнес-процесс, который использует подписание документов, и хотите тестировать его без реального подписания — попробуйте aclips.fakesign.

Установили модуль, отправили документ на подпись, получили результат и продолжили тестирование.

Без провайдеров. Без реальных подписей. Без Госключа. Без ожидания сотрудников.

Подключили aclips.fakesign — и занимаемся разработкой, а не организацией тестового подписания.

Исходный код и документация модуля: aclips.fakesign.