Inizia definendo l'evento aziendale che l'integrazione deve gestire. Identifica cosa deve fare il sistema ricevente e quale fonte prevale quando le registrazioni non coincidono.
Scrivi le specifiche dell'interfaccia intorno all'evento
| Elemento delle specifiche | Domanda a cui rispondere |
|---|---|
| Evento scatenante | Cosa è successo e quale sistema lo ha confermato? |
| Identità | Quali identificativi di conto ed evento rimangono stabili tra i sistemi? |
| Contenuto del messaggio | Quali campi sono obbligatori, facoltativi o sensibili? |
| Conferma | Quale risposta dimostra la ricezione o il completamento? |
| Errore | Quali azioni vengono ripetute, attendono, si fermano o richiedono revisione? |
| Rettifica | Come si riferisce una modifica successiva all'evento originale? |
Per esempio, una decisione di verifica richiede più di un'etichetta copiata in un altro database. Definisci il momento di efficacia, la versione e l'azione consentita da quello stato. Limita l'accesso ai dati a quanto richiesto dal flusso di lavoro ricevente.
Assegna la responsabilità per uno stato incerto della transazione
Quando una richiesta va in timeout, identifica chi determina se l'azione è avvenuta. Un nuovo tentativo non deve creare un duplicato involontario e una conferma mancante non deve essere considerata prova di errore senza controllare le specifiche.
Specifica il monitoraggio degli eventi in ritardo o rifiutati e il team responsabile della loro risoluzione. L'operatore deve poter distinguere un arretrato dell'integrazione da una decisione ancora in attesa di revisione umana.
Testa le modifiche oltre alla connessione iniziale
Usa un evento valido, un campo obbligatorio mancante, una richiesta duplicata, una rettifica fuori sequenza e un'interruzione temporanea della fonte. Confronta le registrazioni risultanti nei due sistemi. Conserva identificativi e informazioni di stato sufficienti a indagare ogni esito.
Testa poi un cambio di versione o l'aggiunta di un campo facoltativo secondo le regole di compatibilità concordate. Definisci il responsabile del rilascio, i criteri di ripristino della versione precedente e il processo di notifica delle modifiche del fornitore. Una prima connessione riuscita è solo una parte del ciclo di vita di un'integrazione.
Prepara un brief di integrazione utile
Fornisci i sistemi, la documentazione disponibile, esempi di eventi e il flusso di lavoro da migliorare. Includi lo stato di errore che il tuo team non riesce attualmente a spiegare. Per sostituire il sistema principale dei conti, valuta anche l'ambito del PAM e il lavoro di migrazione.
Richiedi una revisione dell'interfaccia con questi elementi. La proposta dovrebbe indicare risultati da consegnare, dipendenze e prove per il collaudo.