Modulo di questo articolo: iFlow Inspector
Checklist di revisione degli iFlow SAP CPI e come automatizzarla
Una checklist pratica per la revisione degli iFlow SAP CPI: gestione errori, livelli di log, segreti, protocolli, script e struttura, e come eseguirla in automatico con punteggio e report.
La revisione di un iFlow avviene di solito sotto pressione, poco prima di un trasporto, e controlla ciò che il revisore si ricorda. Così gli stessi problemi arrivano in produzione più e più volte: nessuna gestione degli errori, una password in un Content Modifier, un Router senza route predefinita.
Questo articolo propone una checklist di dodici controlli per gli iFlow di SAP Cloud Integration (SAP CPI), spiega perché ciascuno conta e mostra come eseguirli in automatico, con un punteggio e un report da allegare al trasporto.
Quando revisionare un iFlow
- Prima del primo trasporto verso un tenant di test o di produzione.
- Quando un iFlow passa a un altro sviluppatore o alle operations.
- Dopo una modifica importante, come un nuovo receiver o un nuovo script.
- Di tanto in tanto, per gli iFlow cresciuti negli anni.
La checklist
| Controllo | Perché conta | Categoria |
|---|---|---|
| Nessun Exception Subprocess | Un errore termina il messaggio con la gestione predefinita di SAP: nessun alert, nessuna risposta pulita al sender. | Affidabilità |
| Livello di log dettagliato | Registrare ogni step rallenta ogni messaggio e riempie l'archivio dei log del tenant. | Prestazioni |
| Nessuna descrizione | Gli altri non capiscono cosa fa l'iFlow o chi ne è responsabile senza aprirlo. | Manutenibilità |
| Segreto in chiaro | Chiunque possa aprire o scaricare l'iFlow può leggere una password o un token scritti al suo interno. | Sicurezza |
| Passaggio script senza script | Uno step di script senza file di script fallisce in fase di esecuzione. | Correttezza |
| Processo grande | Un processo con molti step è difficile da leggere, testare e modificare. | Manutenibilità |
| Protocollo non sicuro | HTTP o FTP semplici inviano i dati, e le credenziali Basic, senza cifratura. | Sicurezza |
| Chiamata senza Receiver | Uno step Request Reply o Send senza canale non ha dove inviare il messaggio. | Correttezza |
| Rischio nello script | println, la lettura di un body grande come un'unica String, script molto lunghi, parser XML esposti a XXE. | Prestazioni |
| Local Integration Process inutilizzato | Nessun Process Call lo raggiunge, quindi non viene mai eseguito. | Manutenibilità |
| Passaggio non collegato | Nessun percorso da un evento di inizio lo raggiunge, quindi non viene mai eseguito. | Correttezza |
| Router senza route predefinita | Quando nessuna condizione è soddisfatta, il messaggio fallisce invece di prendere un percorso noto. | Affidabilità |
Queste sono le categorie usate da Kitegra. In una revisione manuale, conta che ogni controllo abbia un motivo e una correzione su cui il team è d'accordo.
Cosa una checklist non vede
I controlli leggono il design dell'iFlow. Non sanno se il mapping è corretto per il business, se il receiver regge il carico o se la gestione degli errori invia l'alert a qualcuno che lo legge. Per queste domande una revisione ha ancora bisogno di una persona, e di un test con dati realistici.
I nomi sono una parte a sé della revisione: un pacchetto di regole di denominazione rende verificabili anche loro.
Eseguire i controlli in automatico
In Kitegra, apri l'iFlow, fai clic sul pulsante «Strumenti Kitegra» e scegli Ispettore. La sua scheda Progettazione esegue i dodici controlli qui sopra sull'iFlow aperto e sui suoi script:
- Ogni risultato mostra perché conta e una riga «Soluzione:».
- «Punteggio (0–100) e voto» riassume l'iFlow, da A a E.
- «Impostazioni controlli» disattiva un controllo o cambia quanto pesa nel punteggio; queste impostazioni si sincronizzano con il tuo account Kitegra.
- «Imposta baseline» segna i risultati di oggi come noti, così la revisione successiva mostra solo le novità.
- «Sopprimi» nasconde un risultato e chiede il motivo; «Mostra noti e soppressi» li fa ricomparire.
Un controllo riguarda il livello di log; perché TRACE non deve restare attivo lo spiega.
Condividere il risultato come report
Report apre il report iFlow in una nuova scheda: i dati dell'iFlow (step, script, adapter, processi), il suo punteggio, i risultati di design filtrabili per categoria o gravità, e i risultati di denominazione. Esportalo in HTML, PDF o Excel, oppure usa Stampa. In «Intestazione del report» puoi aggiungere il nome dell'azienda e un logo di 20 KB al massimo.
Il report viene letto dal modello dell'iFlow e non include alcun contenuto dei messaggi. Le etichette del PDF sono in inglese.
Come aiuta Kitegra
I controlli di design fanno parte dell'iFlow Inspector di Kitegra. Vengono eseguiti nel tuo browser sull'iFlow aperto; impostazioni dei controlli e baseline si sincronizzano con il tuo account Kitegra quando accedi, e script e mapping non vengono mai inviati.
Helper, Message Monitor, iFlow Inspector e iFlow Docs contano ciascuno gli iFlow su cui li usi: 5 per modulo senza un account Kitegra, 50 con il piano Free, 100 con Starter e 300 con Pro; Startup Team dà 300 a ogni membro, Growth Team e Scale Team non hanno limiti. La Toolbox e gli extra dell'area di lavoro non contano iFlow. Durante il lancio di Kitegra, tutti gli strumenti sono aperti a chiunque abbia effettuato l'accesso, anche con il piano Free. Confronta i piani.
Provalo nel tuo prossimo iFlow
Scopri cosa aggiunge Kitegra attorno al designer di SAP Integration Suite, oppure guardalo accanto alle altre estensioni Chrome di Kitegra.
Domande frequenti
Cosa dovrebbe controllare la revisione di un iFlow SAP CPI?
Gestione degli errori, livello di log, descrizione, segreti in chiaro, script, sicurezza dei protocolli, parti non collegate o inutilizzate e route predefinite dei Router, oltre alla denominazione e alla logica di business.
Perché un Router senza route predefinita è un problema?
Quando nessuna condizione è soddisfatta, il messaggio fallisce invece di prendere un percorso noto.
Come viene calcolato il punteggio?
Ogni risultato abbassa il punteggio, partendo da 100, di un peso che dipende dalla sua gravità, e il punteggio corrisponde a un voto da A a E. Puoi cambiare quanto pesa un controllo.
Cosa fa «Imposta baseline»?
Segna i risultati di oggi come noti, così una revisione successiva mostra solo quelli nuovi.
Posso esportare la revisione?
Sì. Il report iFlow si esporta in HTML, PDF o Excel, con il nome e il logo della tua azienda.
Il report contiene il contenuto dei messaggi?
No. Viene letto dal modello dell'iFlow e non include alcun contenuto dei messaggi.