Начните с бизнес-события, которое должна обрабатывать интеграция. Определите, что должна сделать принимающая система и какой источник имеет приоритет при расхождении записей.
Опишите интерфейс через обрабатываемое событие
| Элемент спецификации | На какой вопрос ответить |
|---|---|
| Триггер | Что произошло и какая система это подтвердила? |
| Идентификация | Какие идентификаторы аккаунта и события остаются одинаковыми между системами? |
| Данные запроса | Какие поля обязательны, необязательны или содержат конфиденциальные данные? |
| Подтверждение | Какой ответ доказывает получение или завершение? |
| Сбой | Какие действия повторяются, ожидают, прекращаются или требуют проверки? |
| Корректировка | Как последующее изменение ссылается на исходное событие? |
Например, решение по верификации требует большего, чем копирование статуса в другую базу. Определите время вступления в силу, версию и действие, разрешённое этим состоянием. Ограничьте доступ к данным тем, что необходимо принимающему процессу.
Назначьте ответственного за неизвестное состояние транзакции
При тайм-ауте запроса определите, кто устанавливает, произошло ли действие. Повтор не должен создавать непреднамеренный дубликат, а отсутствие подтверждения нельзя считать доказательством сбоя без проверки спецификации.
Предусмотрите мониторинг задержанных или отклонённых событий и назначьте команду, которая их разбирает. Оператору нужно отличать очередь необработанных событий интеграции от решения, которое ещё ожидает проверки сотрудником.
Проверьте изменения, а не только первое подключение
Используйте корректное событие, отсутствие обязательного поля, повторный запрос, корректировку не по порядку и временную недоступность источника. Сравните получившиеся записи в обеих системах. Сохраните достаточно идентификаторов и сведений о статусах для расследования каждого результата.
Затем проверьте смену версии или добавление необязательного поля по согласованным правилам совместимости. Определите ответственного за релиз, критерии отката и порядок уведомления об изменениях поставщика. Успешное первое подключение — только часть жизненного цикла интеграции.
Подготовьте содержательное задание на интеграцию
Предоставьте список систем, доступную документацию, примеры событий и процесс, который нужно улучшить. Включите состояние сбоя, которое команда сейчас не может объяснить. При замене основной системы аккаунтов также оцените объём PAM и работы по миграции.
Запросите проверку интерфейса с этими данными. Предложение должно определять результаты работ, зависимости и подтверждения для приёмки.