41dots
Integrare un software senza API
Scegliere tra scambio di file e automazione dell’interfaccia, poi verificare che un trasferimento interrotto riparta senza duplicare i record.
Un gestionale contabile esporta le fatture una volta al giorno. Al sistema che le riceve servono entro la mattina successiva. Se può importare quel file e indicare quali righe ha rifiutato, un trasferimento programmato può bastare. Automatizzare la schermata del gestionale aggiungerebbe una dipendenza dalla sua interfaccia senza anticipare l’arrivo dei dati.
Parti dall’operazione e dalla scadenza: «copiare le fatture definitive entro le 7» è un requisito verificabile. «Collegare i sistemi» lascia aperto se occorra leggere record, crearli o sincronizzare le modifiche in entrambe le direzioni. I requisiti di integrazione descritti da Microsoft aiutano a impostare la scelta in base a volume, frequenza, direzione e funzioni disponibili nei sistemi.
Trovare un canale che copra tutta l’operazione
Controlla importazioni, esportazioni e connettori supportati dal fornitore prima di costruire un’integrazione. Un connettore che legge i clienti potrebbe non poter creare fatture. Per provare un’importazione, prepara un piccolo lotto con una riga errata: riesci a distinguere i record accettati, correggere quello rifiutato e ripetere l’invio senza duplicare gli altri? Il messaggio «importazione completata» serve a poco se nasconde errori parziali.
Un accesso autorizzato al database in sola lettura può aiutare a estrarre dati che mancano nelle esportazioni. Non risolve però la scrittura nel sistema di destinazione. Scrivere direttamente nelle tabelle può saltare i controlli applicativi: è preferibile usare un’importazione o un’interfaccia di scrittura supportata.
Se l’operazione richiesta è disponibile solo a schermo, puoi valutare l’automazione del browser o del desktop. Provala con i permessi e le approvazioni necessari all’account che verrà usato. Una persona potrebbe dover rinnovare la sessione o approvare un accesso; la pianificazione deve prevedere questa interruzione. Anche un endpoint interno osservato nel traffico di rete richiede un’autorizzazione esplicita e un piano di manutenzione: il fatto che esista non lo rende un’API supportata.
Nel caso di integrazione contabile legacy descriviamo un progetto basato sulla persistenza delle sessioni e sulle chiamate di rete interne. Quella scelta dipendeva dai vincoli della piattaforma. Con un altro gestionale, uno scambio di file supportato potrebbe rendere superflui quei componenti.
Riconoscere un record salvato dopo un timeout
Considera un trasferimento notturno di fatture definitive verso un sistema di gestione operativa. Supponiamo che la sorgente assegni identificativi stabili alle fatture e che la destinazione possa memorizzare e cercare un riferimento esterno. Limita la prima versione alla creazione dei record in una sola direzione; le correzioni alle fatture già trasferite passano a una persona finché non viene definita una regola di aggiornamento.
La chiave del trasferimento deve comprendere sistema sorgente, azienda e identificativo della fattura. La fattura 1842 dell’azienda A deve restare distinta dalla 1842 dell’azienda B. La destinazione può assegnare un proprio identificativo al record. Conserva entrambi gli identificativi in un registro dei trasferimenti, insieme all’esito di ogni tentativo.
Seguiamo accounts:A:1842 quando la conferma non arriva:
- Il processo registra il tentativo e invia la fattura con quel riferimento esterno.
- La destinazione la salva, ma la connessione cade prima della conferma. Nel registro l’esito resta sconosciuto.
- Al riavvio, il processo cerca
accounts:A:1842nella destinazione prima di inviare altro. - Un solo record con importo e valuta attesi permette di registrarne l’identificativo e confermare il trasferimento. Valori diversi o più corrispondenze richiedono una verifica manuale.
- L’assenza di risultati consente un nuovo invio solo se la ricerca riflette già tutte le scritture. Se i risultati si aggiornano in ritardo, attendi una verifica attendibile o chiedi a una persona di controllare: una ricerca subito vuota non dimostra che il salvataggio sia fallito.
Il registro, da solo, non impedisce a due processi di creare contemporaneamente la stessa fattura. Assegna ogni chiave a un solo processo e, se il sistema lo consente, imponi l’unicità del riferimento esterno nella destinazione. Senza quel vincolo, tra ricerca e scrittura resta un intervallo in cui un altro processo può inserire lo stesso record. Questa soluzione non garantisce scritture concorrenti prive di duplicati.
Provare l’interruzione prima di aumentare il volume
Esegui la sequenza su record di prova autorizzati: interrompi la connessione dopo l’invio, riavvia il processo e controlla sia il registro sia la destinazione. Dopo il riavvio deve esserci una sola fattura confermata nella destinazione, oppure il processo deve sospendere il trasferimento per verifica senza ripetere l’invio. Prova separatamente una riga rifiutata, per verificare che l’errore non provochi il reinvio di tutto il lotto.
Se automatizzi l’interfaccia, individua il record salvato oltre al comando che lo invia. Playwright consiglia locator basati su ruoli ed etichette; le azioni su un singolo elemento rifiutano corrispondenze ambigue. Questo aiuta a rilevare cambiamenti della schermata, ma trovare il pulsante Salva non permette di stabilire se il tentativo precedente sia riuscito.
Prima di estendere il flusso, prepara per chi gestisce gli errori una vista con chiavi ancora irrisolte, valori inviati e identificativi di destinazione, quando disponibili. Deve poter decidere se verificare, correggere o ripetere il trasferimento di un record preciso. Se la destinazione non offre un modo attendibile per ritrovare una scrittura dall’esito incerto, limita l’automazione alla preparazione dei dati e lascia l’invio a una persona finché il problema non è risolto.