В этой статье расскажу, почему штатного тестирования оказалось недостаточно для моих задач, как устроена подмена сервиса подписания и как я реализовал модуль aclips.fakesign.
Представьте, что вам нужно разработать интеграцию с КЭДО Bitrix24. Например, создать документ, отправить его на подписание, дождаться завершения процесса и выполнить какие-то действия после того, как сотрудник поставит подпись.
Задача вроде бы несложная. Но есть нюанс: чтобы проверить весь сценарий, нужно организовать процесс подписания.
А это означает подключение КЭДО, настройку провайдера, приглашение сотрудников, подтверждение личности, работу с Госключом и прочие радости, которые совершенно не нужны разработчику, пытающемуся проверить, что его бизнес-процесс работает правильно.
А если разработка ведётся локально? Если у заказчика закрытый контур? Если нужно прогнать десяток тестовых сценариев? Или просто хочется быстро проверить очередную гипотезу, не отправляя документы реальным сотрудникам?
В общем, я подумал как упростить задачу и сделал тестовый провайдер подписания документов для Bitrix24.
Зачем вообще тестировать КЭДО?
Представим типовой сценарий одной из моих сервисных услуг:
- • Пользователь отправляет заявку на получение услуги.
- • Bitrix24 запускает бизнес-процесс обработки заявки.
- • Формируется необходимый комплект документов.
- • Документы последовательно или параллельно отправляются на подписание разным сотрудникам.
- • После завершения подписания запускаются следующие этапы процесса.
- • Услуга завершается, а результат фиксируется в системе.
В другой услуге может быть больше документов, другие подписанты и дополнительные условия перехода между этапами. Но общая логика остаётся примерно одинаковой.
В результате получается довольно разветвлённая система зависимостей от процесса подписания.
И мне нужно тестировать именно её:
- • корректно ли формируются документы;
- • правильно ли определяются подписанты;
- • всем ли нужным сотрудникам отправлены документы;
- • корректно ли обрабатывается результат подписания;
- • запускаются ли последующие этапы;
- • правильно ли завершается услуга.
При этом реальное подписание документа не является предметом тестирования.
Мне не нужно каждый раз привлекать сотрудников, ждать их действий и проходить процедуру подтверждения личности. Мне нужно получить результат эмуляции подписания и продолжить выполнение бизнес-процесса.
Именно эту задачу и должен решать тестовый провайдер aclips.fakesign.

А разве в Bitrix24 нет штатного тестового подписания?
Есть… Но.. 🙂
Bitrix24 предоставляет возможность протестировать процесс подписания кадрового документа. Это удобно, чтобы познакомиться с КЭДО, проверить интерфейс и пройти демонстрационный сценарий.
Но штатный тестовый режим решает немного другую задачу.
Он предназначен для ознакомления с процессом подписания и имеет свои ограничения. Например, тестовое подписание доступно при определённых условиях, в частности, если в КЭДО ещё нет подписанных документов.
aclips.fakesign создавался для другой цели — тестирования бизнес-процессов и интеграций.
Нам не нужно знакомиться с интерфейсом подписания. Мы уже знаем, как он работает. Нам нужно проверить, что наша интеграция правильно обрабатывает отправку документа на подпись и дальнейшие события.
Именно здесь тестовый провайдер оказывается полезнее.
| Штатное тестирование Bitrix24 | aclips.fakesign | |
| Ознакомление с КЭДО | да | не является целью |
| Проверка процесса подписания | да | эмулируется |
| Тестирование интеграций | ограниченно | основное назначение |
| Тестирование бизнес-процессов | демо сценарий | да |
| Реальные подписи | нет | нет |
| Работа в локальной среде | ограничена инфраструктурой | да |
| Закрытые контуры | ограничена инфраструктурой | да |
| Диагностика через CLI | нет | да |
| Подписание разными сотрудниками | нет | да |
Итого
Если вам нужно просто познакомиться с КЭДО Bitrix24 — используйте штатный тестовый режим.
Если вы разрабатываете интеграцию, автоматизацию или бизнес-процесс, который использует подписание документов, и хотите тестировать его без реального подписания — попробуйте aclips.fakesign.
Установили модуль, отправили документ на подпись, получили результат и продолжили тестирование.
Без провайдеров. Без реальных подписей. Без Госключа. Без ожидания сотрудников.
Подключили aclips.fakesign — и занимаемся разработкой, а не организацией тестового подписания.
Исходный код и документация модуля: aclips.fakesign.