Externalize Parameters, copiare le impostazioni dei passi e importare API da SAP Business Accelerator Hub in SAP CPI

Il lavoro più lento in un iFlow di SAP Cloud Integration (SAP CPI) spesso non è la logica. È digitare lo stesso indirizzo del receiver in tre tenant, copiare a mano dieci righe di Content Modifier da un iFlow all'altro, ricostruire una query OData scritta il mese scorso, o scaricare una specifica API solo per conoscere i campi di un entity set.

L'Helper di Kitegra ora ha uno strumento per ciascuno di questi lavori, accanto al designer di SAP Integration Suite: Externalize Parameters, il copia e incolla delle impostazioni dei passi con modelli di query OData, l'importazione da SAP Business Accelerator Hub, una verifica XPath sul tuo payload di esempio e Disponi per le espressioni di Message Mapping. Questo articolo spiega cosa fa ognuno, quando modifica il tuo iFlow e cosa conserva.

Externalize Parameters in un passo

Un indirizzo scritto direttamente in un canale receiver significa modificare l'iFlow stesso ogni volta che passa da DEV a QA a PROD. La risposta di SAP è un parametro esternalizzato: {{Receiver_OData_Address}} nel campo, con il valore impostato per ogni tenant in Configure. Externalize Parameters lo scrive al posto tuo.

Apri un iFlow, premi Edit in SAP e scegli Externalize Parameters nel menu Kitegra. Il pannello elenca i valori fissi che di solito cambiano da un tenant all'altro:

• Indirizzi: URL, host, endpoint, percorsi, directory e WSDL. Sono già spuntati, tranne gli indirizzi proxy e gli indirizzi ProcessDirect o JMS.
• Altri valori: nomi di code e di Data Store, percorsi e query OData, timeout, nomi e alias delle credenziali, e porte.
• Costanti nelle tabelle di Content Modifier e Write Variables.

Ogni valore riceve un nome proposto, come Receiver_OData_Address, composto dal partecipante e dal campo, che puoi cambiare. I valori che sono già {{…}} o ${…} vengono indicati come tali. Fai clic su Esternalizza e i campi spuntati diventano parametri nell'iFlow aperto. Non viene salvato nulla finché non salvi l'iFlow in SAP.

Dopo un'esecuzione, Annulla ripristina i valori precedenti, e Copia valori attuali copia ogni parametro con il valore che ha sostituito: dopo il deploy, SAP chiede ogni valore in Configure, e tu li incolli lì. Per ogni iFlow restano disponibili per Annulla le ultime dieci esecuzioni. I controlli di design dell'iFlow Inspector rimandano a questo strumento quando l'indirizzo di un receiver è scritto nell'iFlow.

Copiare le impostazioni di un passo in un altro passo o iFlow

Scegli Copia e incolla impostazioni dei passi nel menu Kitegra, seleziona un passo nel diagramma (o sceglilo nel pannello) e fai clic su Copia impostazioni. La copia contiene gli header, le exchange property e i campi dell'adattatore del passo. Il pannello conserva le tue ultime dieci copie, dalla più recente, per tutti i tenant e gli iFlow in questo browser.

Per incollare, premi Edit in SAP, seleziona il passo di destinazione e fai clic su Incolla in. Prima di scrivere, il pannello elenca i campi che cambieranno. Per ogni tabella scegli Mantieni, Aggiungi righe (aggiunge solo le righe copiate che mancano) o Sostituisci righe. Una copia va solo in un passo dello stesso tipo, e può finire in un altro iFlow, tranne un percorso EDMX e i campi degli script, che indicano file dell'iFlow da cui provengono. Annulla ripristina ciò che l'ultimo incolla ha cambiato.

Modelli di query OData

Lo stesso pannello conserva i Modelli di query OData. Seleziona un canale receiver OData di cui hai costruito la query, fai clic su Salva query come modello e dagli un nome. Un modello conserva l'operazione, il percorso della risorsa e le opzioni di query come $select, $filter e $expand. In seguito, in modalità di modifica, seleziona un altro receiver OData e fai clic su Applica. Salvare con un nome già esistente sostituisce quel modello. Per le opzioni in sé, vedi le opzioni di query del receiver OData.

Copie e modelli restano nello spazio di archiviazione dell'estensione in questo browser. Non vengono sincronizzati con il tuo account Kitegra e non vengono mai inviati da nessuna parte.

Importare un'API da SAP Business Accelerator Hub

L'Helper suggerisce entity set e campi OData da un EDMX, e percorsi HTTP da un file OpenAPI. Con l'importazione dall'Hub non devi più scaricare prima quel file. Nel popup dell'estensione, apri la pagina Payload di esempio e specifica API di un iFlow e cerca Importa da SAP Business Accelerator Hub.

1. La prima volta, fai clic su Consenti accesso: il browser chiede una volta l'accesso ad api.sap.com. Kitegra non lo ottiene finché non acconsenti.
2. Cerca un'API, ad esempio API_PRODUCT_SRV. La ricerca non richiede l'accesso.
3. Fai clic su Importa. Per scaricare la specifica serve l'accesso ad api.sap.com in questo browser; se non l'hai effettuato, il pannello te lo dice e apre l'Hub.

Gli entity set e i campi di un'API OData vengono poi suggeriti nei receiver OData di quell'iFlow che non hanno un proprio EDMX. I percorsi di un'API REST vengono suggeriti nei campi HTTP, come se avessi caricato il file, come descrive l'articolo su OpenAPI e Postman. La specifica è conservata per ogni iFlow, solo in questo browser, fino a 8 MB, e Rimuovi la elimina.

XPath verificati sul tuo payload di esempio

Con un payload di esempio salvato per l'iFlow, l'Helper già suggerisce percorsi XPath a partire da esso. Ora verifica anche l'XPath che hai digitato. Quando nessun nodo dell'esempio corrisponde, un avviso sotto il campo dice "Nessun nodo del payload di esempio corrisponde a questo XPath." Quando uno corrisponde, una riga informativa mostra il valore trovato.

La verifica copre le righe XPath negli header e nelle property del Content Modifier e in Write Variables, le condizioni dell'XML Router e gli splitter XPath. Viene eseguita solo dove l'esempio salvato è davvero ciò che arriva a quel passo: un esempio XML preceduto solo da passi che mantengono il body, oppure un esempio JSON dopo un JSON to XML Converter. Resta in silenzio nei Local Integration Process, negli Exception Subprocess e per gli XPath costruiti con ${…} o {{…}}, quindi un avviso indica una discrepanza reale.

Disporre un'espressione di Message Mapping

Un'espressione di Message Mapping con una dozzina di funzioni diventa presto un groviglio di linee che si incrociano. Sul canvas dell'espressione, accanto ai pulsanti di SAP, ora c'è un pulsante Disponi. Dispone i nodi dai campi di origine fino al campo di destinazione. In modalità di modifica, Save mantiene il layout e il pulsante Annulla accanto lo ripristina; in modalità di visualizzazione aiuta solo a leggere, e il layout sparisce quando SAP ridisegna l'espressione. Non viene salvato né inviato nulla a SAP. Anche il diagramma dell'iFlow ha un proprio pulsante Disponi, in modalità di modifica, con Annulla.

Cosa cambia nel tuo iFlow

Externalize Parameters, Incolla e Applica modello scrivono nell'iFlow aperto nel designer, solo in modalità di modifica, e il designer mostra l'iFlow come modificato. Non salvano né distribuiscono mai: sei tu a salvare in SAP, oppure Discard per scartare la modifica. Ognuno di questi strumenti si può disattivare singolarmente nella pagina delle opzioni, in Strumenti; sparisce subito dal designer. Externalize, il copia e incolla dei passi e l'importazione dall'Hub fanno parte dei piani a pagamento, con alcuni utilizzi nel piano Free; la verifica XPath e Disponi sono gratuiti. 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 cosa fa dopo che premi Deploy.

Domande frequenti