Стандартный процесс интеграции с использованием веб-сервисов "Первой Формы" строится следующим образом:
1. В случае forms-аутентификации "Первая Форма" проверяет от внешнего приложения аутентификационную cookie. В случае windows-аутентификации или при запросе изнутри приложения (например, из JS вставки или доп. формы) этого не требуется.
2. Внешняя система обращается к определенному URL адресу API "Первой Формы".
3. В "Первой Форме" создается специальный пользователь, олицетворяющий внешнюю систему. От имени этого пользователя в "Первой Форме" будут осуществляться все действия, совершаемые по инициативе внешней системы. Этот пользователь должен обладать необходимыми правами на все необходимые действия внутри "Первой Формы".
4. Во внешней системе реализуется логика обмена. При вызовах методов web-сервиса созданный ранее идентификатор пользователя используется как константа (или настройка – по усмотрению разработчиков внешней системы).
На усмотрение разработчиков также остается вопрос с обеспечением отказоустойчивости обмена в случае сетевых проблем между двумя системами. Стандартная практика обеспечения отказоустойчивости – реализация очереди событий для некритичных транзакций и механизм отката для критичных транзакций.
Для новых разработок мы рекомендуем использовать веб-сервис Valhalla. Веб-сервис TCWebService поддерживается для совместимости с более ранними разработками. Также при интеграции систем есть возможность настроить подписку на уведомления об изменениях в задачах "Первой Формы" (применяется крайне редко).
Полезные ссылки
