Modulo di questo articolo: iFlow Docs
Dopo il Deploy in SAP CPI: monitoraggio del deploy, documenti del pacchetto, panorama dei sistemi e Value Mapping in Excel
Scopri quando un iFlow è Started o perché non è riuscito, scegli il runtime Cloud o Edge, esegui nuovi controlli di design, documenta un intero pacchetto con il suo panorama dei sistemi, esporta i Value Mapping in Excel e disattiva qualsiasi strumento.
Premere Deploy in SAP Cloud Integration (SAP CPI) apre un'attesa: passare a Monitor, trovare l'iFlow, aggiornare finché non compare Started o Error, poi capire cosa significa l'errore. E quando un'interfaccia è finita, qualcuno chiede ancora il documento, il disegno del panorama dei sistemi e il Value Mapping in un foglio di calcolo.
Kitegra ora copre questa parte del lavoro accanto al designer di SAP Integration Suite: un monitoraggio del deploy con una chiamata di prova, una selezione del runtime per i tenant con Edge Integration Cell, nuovi controlli di design, un documento del pacchetto con un diagramma del panorama dei sistemi e lo stato della documentazione, un foglio Excel per i Value Mapping e spiegazioni in parole semplici degli script Groovy. Ogni strumento si può disattivare singolarmente. Questo articolo li passa in rassegna.
Monitoraggio del deploy: Started o Error, senza lasciare l'iFlow
Premi Deploy nel designer come al solito e conferma la finestra di dialogo di SAP. Compare un avviso Distribuzione con "Distribuzione…" e il tempo trascorso, e tu continui a lavorare. Kitegra chiede lo stato a SAP dopo tre secondi, poi sempre meno spesso, al massimo ogni 20 secondi. Quando SAP risponde, l'avviso diventa:
- Started, con la versione distribuita. Se l'iFlow ha un endpoint HTTP, Invia una chiamata di prova apre l'HTTP Runner con la richiesta pronta, e Mostra l’ultimo messaggio apre il pannello Messaggi aggiornato.
- Errore, con il testo dell'errore di SAP e, quando si tratta di un caso noto, cosa significa di solito: un altro iFlow distribuito usa già l'indirizzo mittente, uno script non viene compilato, un parametro esternalizzato non ha valore, oppure SAP non è riuscito a creare l'iFlow. Apri i contenuti distribuiti in SAP ti porta ai dettagli.
- Ancora in corso dopo dieci minuti, con un rimando ai contenuti distribuiti in SAP.
Se annulli la finestra Deploy di SAP, non viene monitorato nulla. Il monitoraggio legge solo lo stato della distribuzione; il deploy lo fa SAP, avviato dal tuo clic. Seguire poi un messaggio attraverso l'iFlow è descritto in tracciare un messaggio passo per passo, e la chiamata stessa in testare un iFlow HTTPS con una service key.
Selezione del runtime: Cloud o Edge
Un tenant con Edge Integration Cell esegue gli iFlow su più di un runtime. Solo su un tenant di questo tipo, il riquadro Kitegra mostra Runtime: Cloud (o il nome del runtime Edge). Scegli lì il runtime, e il Message Monitor legge i messaggi di questo iFlow e ne imposta il livello di log su quel runtime. La selezione mostra anche se l'iFlow è distribuito su ciascun runtime, e in quale versione. I tenant con un solo runtime non la vedono mai.
Nuovi controlli di design nell'iFlow Inspector
La checklist di revisione dell'iFlow ha cinque nuovi controlli, con una nuova categoria Documentazione:
| Controllo | Perché conta |
|---|---|
| Receiver senza indirizzo (errore) | L'iFlow viene distribuito, ma ogni chiamata a questo receiver fallisce a runtime. |
| Sender HTTPS con un indirizzo predefinito (avviso) | Un indirizzo vuoto, / o segnaposto come /test non dice nulla a chi chiama, e due iFlow possono entrare in conflitto su di esso. |
| Il sender HTTPS si aspetta un token CSRF (info) | Ogni chiamante deve prima ottenere un X-CSRF-Token, altrimenti la sua POST riceve un 403. |
| Indirizzo del receiver scritto nell'iFlow (info) | Passare tra DEV, QA e PROD significa modificare l'iFlow; Externalize Parameters lo risolve in un passo. |
| Il partecipante mantiene il nome predefinito (info, Documentazione) | "Sender" e "Receiver" compaiono anche nel monitoraggio, quindi nessuno capisce di quale sistema si tratti. |
Come gli altri controlli, contano per il punteggio e si possono disattivare uno per uno. Vederli è gratuito; esportare il report fa parte di Pro. Externalize Parameters e gli altri nuovi strumenti dell'Helper sono descritti in Externalize Parameters, copia dei passi e importazione dall'Hub.
Un documento per l'intero pacchetto
Accanto a Documenta questo iFlow, il menu Kitegra ora ha Documento del pacchetto. Legge uno per uno tutti gli iFlow del pacchetto dell'iFlow aperto ("Lettura dell’iFlow 2 di 5…"), e puoi interromperlo e aprire ciò che è stato letto fino a quel momento. Gli iFlow che non è stato possibile leggere vengono elencati. Il documento si apre in una nuova scheda, in Word, PDF o HTML, oppure compilato nel tuo modello Word, come il documento di design tecnico di un singolo iFlow. Contiene la versione, il fornitore, i tag e il numero di iFlow del pacchetto, poi ogni iFlow, e due parti nuove:
- Panorama dei sistemi: un diagramma con i mittenti a sinistra, gli iFlow del pacchetto al centro e i destinatari a destra. I partecipanti con lo stesso nome diventano un unico riquadro, e ogni linea riporta i tipi di adattatore.
- Stato della documentazione: ciò che serve a chi legge, verificato punto per punto: descrizione e tag del pacchetto, una descrizione per ogni iFlow, partecipanti rinominati da Sender e Receiver, e indirizzi dei receiver esternalizzati. Mostra quanti controlli sono superati e cosa manca, così puoi colmare le lacune prima della consegna.
Value Mapping in Excel
Nella pagina di iFlow Docs, in Value Mapping, carica lo ZIP di un Value Mapping (scaricalo dal suo pacchetto in SAP) o il suo value_mapping.xml. Kitegra elenca i valori e crea una cartella di lavoro Excel con un foglio per ogni coppia agenzia / identificatore: agenzia, identificatore e valore di origine, poi agenzia, identificatore e valore di destinazione. Il file viene letto nel tuo browser; non viene letto nulla da SAP e non viene inviato nulla da nessuna parte. Il foglio di Message Mapping funziona allo stesso modo per i mapping.
Script spiegati in parole semplici
Spiega gli script nel menu Kitegra elenca ogni passo di script Groovy dell'iFlow. Per ciascuno mostra il commento riassuntivo dell'autore, le funzioni che definisce, cosa legge (body, header, exchange property, allegati), cosa imposta e modifica, la logica principale (parsing o costruzione di XML o JSON, cicli, decisioni, chiamate HTTP, date), le API SAP che usa, come Security Material, Value Mapping o Partner Directory, e note e rischi. Fai clic sul nome di un passo per selezionarlo nel diagramma. La spiegazione viene ricavata dal testo dello script nel tuo browser; lo script non viene mai inviato da nessuna parte.
Disattiva gli strumenti che non usi
La pagina delle opzioni ora ha una sezione Strumenti con un interruttore per ogni strumento, raggruppato sotto il suo modulo: dalla verifica XPath, Disponi, Security Material, Externalize, copia dei passi e importazione dall'Hub nell'Helper, passando per Messaggi, la selezione del runtime, il visualizzatore log e il monitoraggio del deploy, Info iFlow, l'Inspector e la Ricerca, Documenti e Script spiegati, fino a Note, Snippet, Confronto, Conversione, Generazione e l'HTTP Runner nella Toolbox. Uno strumento disattivato sparisce subito dal designer e dal popup; i tuoi dati restano, e Attiva tutti ripristina tutto. Per disattivare un intero modulo, usa Moduli nella stessa pagina; vedi la pagina delle opzioni.
Il monitoraggio del deploy, la selezione del runtime, Script spiegati e la visualizzazione dei controlli di design sono gratuiti. Il documento del pacchetto, il panorama dei sistemi e il foglio dei Value Mapping fanno parte di iFlow Docs, con alcuni utilizzi nei piani Free e Starter. Durante il lancio di Kitegra, tutti gli strumenti sono aperti a chiunque abbia effettuato l'accesso. Confronta i piani.
Provalo nel tuo prossimo iFlow
Scopri cosa aggiunge Kitegra attorno al designer di SAP Integration Suite, oppure i nuovi strumenti per scrivere iFlow.
Domande frequenti
Kitegra distribuisce il mio iFlow?
No. Sei tu a premere Deploy in SAP; il monitoraggio del deploy legge solo lo stato della distribuzione e ti dice quando è Started o non riuscito.
Come documento un intero pacchetto SAP CPI?
Apri un qualsiasi iFlow del pacchetto e scegli Documento del pacchetto nel menu Kitegra. Legge ogni iFlow e apre un unico documento con il diagramma del panorama dei sistemi e lo stato della documentazione, in Word, PDF o HTML.
Posso esportare un Value Mapping in Excel?
Sì. Scarica lo ZIP del Value Mapping dal suo pacchetto in SAP e caricalo nella pagina di iFlow Docs. Ottieni un foglio per ogni coppia agenzia / identificatore; il file non lascia mai il tuo browser.
Perché non vedo la selezione del runtime?
Compare solo nei tenant con più di un runtime, ad esempio Cloud più Edge Integration Cell.
Se disattivo uno strumento, i miei dati vengono eliminati?
No. Lo strumento sparisce dal designer e dal popup, e i suoi dati restano. Riattivalo nella sezione Strumenti della pagina delle opzioni.