Creare flussi di lavoro per scenari di integrazione SAP comuni in App per la logica di Azure

Si applica a: App per la logica di Azure (a consumo e standard)

Questa guida pratica illustra come creare flussi di lavoro di esempio per le app per la logica per alcuni scenari di integrazione SAP comuni usando App per la logica di Azure e il connettore SAP.

I flussi di lavoro delle app per la logica Standard e A consumo offrono il connettore gestito SAP che è ospitato ed eseguito in Azure multi-tenant. I flussi di lavoro Standard offrono anche il connettore del provider di servizi predefinito SAP, ospitato ed eseguito in App per la logica di Azure a tenant singolo. Per altre informazioni, vedere Informazioni tecniche sul connettore.

Prerequisiti

• Prima di iniziare, assicurarsi di esaminare e soddisfare i requisiti del connettore SAP per lo scenario specifico.

• Installare o usare uno strumento che può inviare richieste HTTP per testare la soluzione, ad esempio:

  • Visual Studio Code con un'estensione da Visual Studio Marketplace
  • Invoke-RestMethod di PowerShell
  • Microsoft Edge - Strumento console di rete
  • Bruno
  • curl

  Attenzione

  Per gli scenari in cui sono presenti dati sensibili, ad esempio credenziali, segreti, token di accesso, chiavi API e altre informazioni simili, assicurarsi di usare uno strumento che protegge i dati con le funzionalità di sicurezza necessarie, funziona offline o in locale, non sincronizza i dati nel cloud e non richiede l'accesso a un account online. In questo modo si riduce il rischio di esporre i dati sensibili al pubblico.

Ricevere messaggi dal SAP

Il flusso di lavoro dell'app per la logica di esempio seguente viene attivato quando il trigger SAP del flusso di lavoro riceve un messaggio da un server SAP.

Aggiungere un trigger SAP

In base al fatto che si abbia un flusso di lavoro A consumo in App per la logica di Azure multi-tenant o un flusso di lavoro Standard in App per la logica di Azure a tenant singolo, seguire i passaggi corrispondenti:

Ricevere pacchetti IDoc da SAP

Per ricevere pacchetti IDoc, che sono batch o gruppi di IDocs, il trigger SAP non richiede una configurazione aggiuntiva. Tuttavia, per elaborare ogni elemento di un pacchetto IDoc dopo che il trigger ha ricevuto il pacchetto, è necessario implementare alcuni passaggi per suddividere il pacchetto in singoli IDoc configurando SAP per inviare IDocs nei pacchetti.

Il seguente flusso di lavoro di esempio illustra come estrarre singoli IDocs da un pacchetto usando la funzione xpath():

1. Prima di iniziare, è necessario un flusso di lavoro dell'app per la logica A consumo o Standard con un trigger SAP. Se il flusso di lavoro non inizia già con questo trigger, seguire i passaggi precedenti descritti in questa guida per aggiungere al flusso di lavoro il trigger SAP in grado di ricevere messaggi.

2. Per rispondere immediatamente al server SAP con lo stato della richiesta SAP, aggiungere l'azione di risposta seguente, in base al fatto che si usi un trigger gestito SAP o un trigger predefinito SAP:

   • Trigger gestito SAP: per questo trigger aggiungere un'azione di risposta al flusso di lavoro.

     Nell'azione di risposta usare uno dei codici di stato seguenti (statusCode):

     Codice di stato	Descrizione
     202 Accettato	La richiesta è stata accettata per l'elaborazione, ma l'elaborazione non è ancora stata completata.
     204 Nessun contenuto	Il server ha soddisfatto correttamente la richiesta e nel corpo del payload della risposta non è presente contenuto aggiuntivo da inviare.
     200 OK	Questo codice di stato contiene sempre un payload, anche se il server genera un corpo del payload di lunghezza zero.

   • Trigger predefinito SAP: per questo trigger aggiungere l'azione Rispondi al server SAP al flusso di lavoro.

   Nota

   Come procedura consigliata, aggiungere l'azione di risposta immediatamente dopo il trigger per liberare il canale di comunicazione con il server SAP.

3. Ottenere lo spazio dei nomi radice dall'IDoc XML che il flusso di lavoro riceve da SAP.

   1. Per estrarre questo spazio dei nomi dal documento XML e archiviare lo spazio dei nomi in una variabile stringa locale, aggiungere l'azione Inizializza variabile.

   2. Rinominare il titolo dell'azione in Ottieni spazio dei nomi per il nodo radice in IDoc ricevuto.

   3. Specificare un nome per la variabile e impostare il tipo su Stringa.

   4. Nel parametro Valore dell'azione selezionare all'interno della casella di modifica, aprire l'editor della funzione o dell'espressione e creare l'espressione seguente usando la funzione xpath():

      xpath(xml(triggerBody()?['Content']), 'namespace-uri(/*)')

      Flusso di lavoro A consumo

      

      Flusso di lavoro Standard

      

      Completata l'operazione, l'espressione viene risolta e ora viene visualizzata nel formato seguente:

      

4. Per estrarre un singolo IDoc archiviando la raccolta IDoc in una variabile di array locale, seguire questa procedura:

   1. Aggiungere un'altra azione Inizializza variabile.

   2. Rinominare il titolo dell'azione in Ottieni array con gli elementi dati IDoc.

   3. Specificare un nome per la variabile e impostare il tipo su array.

      La variabile di array rende ogni IDoc disponibile per l'elaborazione individuale del flusso di lavoro enumerando la raccolta.

   4. Nel parametro Valore dell'azione selezionare all'interno della casella di modifica, aprire l'editor della funzione o dell'espressione e creare l'espressione xpath() seguente:

      xpath(xml(triggerBody()?['Content']), '/*[local-name()="Receive"]/*[local-name()="idocData"]')

      Completata l'operazione, l'espressione viene risolta e ora viene visualizzata nel formato seguente:

      Flusso di lavoro A consumo

      

      In questo esempio, il flusso di lavoro seguente trasferisce ogni IDoc a un server SFTP usando un'azione di Controllo denominata Per ognuno e l'azione SFTP-SSH denominata Crea file. Ogni IDoc deve includere lo spazio dei nomi radice, motivo per cui il contenuto del file viene incluso all'interno di un elemento <Receive></Receive> insieme allo spazio dei nomi radice prima di inviare l'IDoc all'app downstream, o al server SFTP in questo caso.

      

      Nota

      Per i flussi di lavoro A consumo, questo criterio è disponibile come criterio di avvio rapido, che è possibile selezionare dalla raccolta dei modelli quando si crea una risorsa app per la logica A consumo e un flusso di lavoro vuoto. In alternativa, quando la finestra di progettazione del flusso di lavoro è aperta, nella barra degli strumenti della finestra di progettazione selezionare Modelli.

      

      Flusso di lavoro Standard

      

      In questo esempio, il flusso di lavoro seguente trasferisce ogni IDoc a un server SFTP usando un'azione di Controllo denominata Per ognuno e l'azione SFTP-SSH denominata Crea file. Ogni IDoc deve includere lo spazio dei nomi radice, motivo per cui il contenuto del file viene incluso all'interno di un elemento <Receive></Receive> insieme allo spazio dei nomi radice prima di inviare l'IDoc all'app downstream, o al server SFTP in questo caso.

      

Filtrare i messaggi ricevuti con azioni SAP

Se si usa il connettore gestito SAP nel trigger del flusso di lavoro, configurare un modo per filtrare in modo esplicito eventuali azioni indesiderate dal server SAP, in base allo spazio dei nomi del nodo radice nel payload XML ricevuto. È possibile fornire un elenco (array) con una o più azioni SAP. Per impostazione predefinita, questa array è vuota, il che significa che il flusso di lavoro riceve tutti i messaggi dal server SAP senza che vengano filtrati. Quando si configura il filtro di array, il trigger riceve i messaggi solo dai tipi di azione SAP specificati e rifiuta tutti gli altri messaggi dal server SAP. Tuttavia, questo filtro non influisce sul fatto che la tipizzazione del payload ricevuto sia debole o forte. Qualsiasi filtro delle azioni SAP viene applicato al livello dell'adapter SAP per il gateway dati locale. Per altre informazioni, vedere come testare l'invio di IDocs ad App per la logica di Azure da SAP.

Configurare il criterio richiesta-risposta asincrone per i trigger

Il connettore gestito SAP supporta il criterio richiesta-risposta asincrone di Azure per i trigger di App per la logica di Azure. È possibile usare questo criterio per creare richieste riuscite che altrimenti non avrebbero esito positivo con il criterio di richiesta-risposta sincrone predefinito.

Se si abilita una risposta asincrona per l'azione Risposta, il flusso di lavoro può rispondere con una risposta 202 Accettato dopo aver accettato una richiesta di elaborazione. La risposta contiene un'intestazione di posizione che è possibile usare per recuperare lo stato finale della richiesta.

Per configurare un criterio richiesta-risposta asincrone per il flusso di lavoro usando il connettore SAP, seguire questa procedura:

1. Nella finestra di progettazione aprire il flusso di lavoro dell'app per la logica. Verificare che il flusso di lavoro inizi con un trigger SAP.

2. Nel flusso di lavoro individuare l'azione Risposta e aprire le Impostazioni di tale azione.

3. A seconda che si disponga di un flusso di lavoro a consumo o Standard, seguire i passaggi corrispondenti:

   • A consumo: in Risposta asincrona, modificare l'impostazione da Off a On e selezionare Fine.
   • Standard: espandere Rete e in Risposta asincrona modificare l'impostazione da Off a On.

4. Salvare il flusso di lavoro.

Inviare IDOC a SAP

Per creare un flusso di lavoro dell'app per la logica che invia un IDoc a un server SAP e restituisce una risposta, seguire questi esempi:

1. Creare un flusso di lavoro dell'app per la logica attivato da una richiesta HTTP.
2. Aggiungere un'azione SAP al flusso di lavoro per l'invio di un IDoc a SAP.
3. Aggiungere un'azione di risposta al flusso di lavoro.
4. Creare un criterio di richiesta-risposta Remote Function Call (RFC), se si usa un RFC per ricevere risposte da ABAP SAP.
5. Testare il flusso di lavoro.

Aggiungere il trigger Request

Per fare in modo che il flusso di lavoro riceva IDocs da SAP su HTTP XML, è possibile usare il trigger predefinito Richiesta. Questo trigger crea un endpoint con un URL in cui il server SAP può inviare richieste HTTP POST al flusso di lavoro. Quando il flusso di lavoro riceve le richieste, il trigger viene attivato ed esegue il passaggio successivo nel flusso di lavoro.

Per ricevere IDoc su Common Programming Interface Communication (CPIC) come XML normale o come file flat, consultare la sezione Ricevere un messaggio da SAP.

In base al fatto che si abbia un flusso di lavoro A consumo in App per la logica di Azure multi-tenant o un flusso di lavoro Standard in App per la logica di Azure a tenant singolo, seguire i passaggi corrispondenti:

Aggiungere un'azione SAP per inviare un IDoc

Creare quindi un'azione per inviare l'IDoc a SAP quando viene attivato il trigger Richiesta del flusso di lavoro. In base al fatto che si abbia un flusso di lavoro A consumo in App per la logica di Azure multi-tenant o un flusso di lavoro Standard in App per la logica di Azure a tenant singolo, seguire i passaggi corrispondenti:

Inviare IDoc file flat al server SAP (solo connettore gestito)

Per inviare un IDoc usando uno schema file flat quando si usa il connettore gestito SAP, è possibile eseguire il wrapping dell'IDoc in una busta XML e seguire i passaggi generali per aggiungere un'azione SAP per inviare un IDoc, ma con le modifiche seguenti.

Eseguire il wrapping di un IDoc con una busta XML

1. Nell'azione SAP usata per inviare il messaggio usare l'URI seguente:

   http://Microsoft.LobServices.Sap/2007/03/Idoc/SendIdoc

2. Formattare il messaggio di input con una busta XML.

L'esempio seguente mostra un payload XML di esempio:

<SendIdoc xmlns="http://Microsoft.LobServices.Sap/2007/03/Idoc/">
  <idocData>EDI_DC 3000000001017945375750 30INVOIC011BTSVLINV30KUABCABCFPPC LDCA X004010810 4 SAPMSX LSEDI ABCABCFPPC 000d3ae4-723e-1edb-9ca4-cc017365c9fd 20210217054521INVOICINVOIC01ZINVOIC2RE 20210217054520
E2EDK010013000000001017945375000001E2EDK01001000000010 ABCABC1.00000 0060 INVO9988298128 298.000 298.000 LB Z4LR EN 0005065828 L
E2EDKA1 3000000001017945375000002E2EDKA1 000000020 RS ABCABCFPPC 0005065828 ABCABCABC ABCABC Inc. Limited Risk Distributor ABCABC 1950 ABCABCABCA Blvd ABCABAABCAB L5N8L9 CA ABCABC E ON V-ABCABC LDCA
E2EDKA1 3000000001017945375000003E2EDKA1 000000020 AG 0005065828 ABCABCFPPC ABCABC ABCABC ABCABC - FPP ONLY 88 ABCABC Crescent ABCABAABCAB L5R 4A2 CA ABCABC 111 111 1111 E ON ABCABCFPPC EN
E2EDKA1 3000000001017945375000004E2EDKA1 000000020 RE 0005065828 ABCABCFPPC ABCABC ABCABC ABCABC - FPP ONLY 88 ABCABC Crescent ABCABAABCAB L5R 4A2 CA ABCABC 111 111 1111 E ON ABCABCFPPC EN
E2EDKA1 3000000001017945375000005E2EDKA1 000000020 RG 0005065828 ABCABCFPPC ABCABC ABCABC ABCABC - FPP ONLY 88 ABCABC Crescent ABCABAABCAB L5R 4A2 CA ABCABC 111 111 1111 E ON ABCABCFPPC EN
E2EDKA1 3000000001017945375000006E2EDKA1 000000020 WE 0005001847 41 ABCABC ABCABC INC (ABCABC) DC A. ABCABCAB 88 ABCABC CRESCENT ABCABAABCAB L5R 4A2 CA ABCABC 111-111-1111 E ON ABCABCFPPC EN
E2EDKA1 3000000001017945375000007E2EDKA1 000000020 Z3 0005533050 ABCABCABC ABCABC Inc. ABCA Bank Swift Code -ABCABCABCAB Sort Code - 1950 ABCABCABCA Blvd. Acc No -1111111111 ABCABAABCAB L5N8L9 CA ABCABC E ON ABCABCFPPC EN
E2EDKA1 3000000001017945375000008E2EDKA1 000000020 BK 1075 ABCABCABC ABCABC Inc 1950 ABCABCABCA Blvd ABCABAABCAB ON L5N 8L9 CA ABCABC (111) 111-1111 (111) 111-1111 ON
E2EDKA1 3000000001017945375000009E2EDKA1 000000020 CR 1075 CONTACT ABCABCABC 1950 ABCABCABCA Blvd ABCABAABCAB ON L5N 8L9 CA ABCABC (111) 111-1111 (111) 111-1111 ON
E2EDK02 3000000001017945375000010E2EDK02 000000020 0099988298128 20210217
E2EDK02 3000000001017945375000011E2EDK02 000000020 00140-N6260-S 20210205
E2EDK02 3000000001017945375000012E2EDK02 000000020 0026336270425 20210217
E2EDK02 3000000001017945375000013E2EDK02 000000020 0128026580537 20210224
E2EDK02 3000000001017945375000014E2EDK02 000000020 01740-N6260-S
E2EDK02 3000000001017945375000015E2EDK02 000000020 900IAC
E2EDK02 3000000001017945375000016E2EDK02 000000020 901ZSH
E2EDK02 3000000001017945375000017E2EDK02 000000020 9078026580537 20210217
E2EDK03 3000000001017945375000018E2EDK03 000000020 02620210217
E2EDK03 3000000001017945375000019E2EDK03 000000020 00120210224
E2EDK03 3000000001017945375000020E2EDK03 000000020 02220210205
E2EDK03 3000000001017945375000021E2EDK03 000000020 01220210217
E2EDK03 3000000001017945375000022E2EDK03 000000020 01120210217
E2EDK03 3000000001017945375000023E2EDK03 000000020 02420210217
E2EDK03 3000000001017945375000024E2EDK03 000000020 02820210418
E2EDK03 3000000001017945375000025E2EDK03 000000020 04820210217
E2EDK17 3000000001017945375000026E2EDK17 000000020 001DDPDelivered Duty Paid
E2EDK17 3000000001017945375000027E2EDK17 000000020 002DDPdestination
E2EDK18 3000000001017945375000028E2EDK18 000000020 00160 0 Up to 04/18/2021 without deduction
E2EDK28 3000000001017945375000029E2EDK28 000000020 CA BOFACATT Bank of ABCABAB ABCABC ABCABAB 50127217 ABCABCABC ABCABC Inc.
E2EDK28 3000000001017945375000030E2EDK28 000000020 CA 026000082 ABCAbank ABCABC ABCABAB 201456700OLD ABCABCABC ABCABC Inc.
E2EDK28 3000000001017945375000031E2EDK28 000000020 GB ABCAGB2L ABCAbank N.A ABCABA E14, 5LB GB63ABCA18500803115593 ABCABCABC ABCABC Inc. GB63ABCA18500803115593
E2EDK28 3000000001017945375000032E2EDK28 000000020 CA 020012328 ABCABANK ABCABC ABCABAB ON M5J 2M3 2014567007 ABCABCABC ABCABC Inc.
E2EDK28 3000000001017945375000033E2EDK28 000000020 CA 03722010 ABCABABC ABCABABC Bank of Commerce ABCABAABCAB 64-04812 ABCABCABC ABCABC Inc.
E2EDK28 3000000001017945375000034E2EDK28 000000020 IE IHCC In-House Cash Center IHCC1075 ABCABCABC ABCABC Inc.
E2EDK28 3000000001017945375000035E2EDK28 000000020 CA 000300002 ABCAB Bank of ABCABC ABCABAB 0021520584OLD ABCABCABC ABCABC Inc.
E2EDK28 3000000001017945375000036E2EDK28 000000020 US USCC US Cash Center (IHC) city USCC1075 ABCABCABC ABCABC Inc.
E2EDK29 3000000001017945375000037E2EDK29 000000020 0064848944US A CAD CA ABCABC CA United States US CA A Air Air
E2EDKT1 3000000001017945375000038E2EDKT1 000000020 ZJ32E EN
E2EDKT2 3000000001017945375000039E2EDKT2 000038030 GST/HST877845941RT0001 *
E2EDKT2 3000000001017945375000040E2EDKT2 000038030 QST1021036966TQ0001 *
E2EDKT1 3000000001017945375000041E2EDKT1 000000020 Z4VL
E2EDKT2 3000000001017945375000042E2EDKT2 000041030 0.000 *
E2EDKT1 3000000001017945375000043E2EDKT1 000000020 Z4VH
E2EDKT2 3000000001017945375000044E2EDKT2 000043030 *
E2EDK14 3000000001017945375000045E2EDK14 000000020 008LDCA
E2EDK14 3000000001017945375000046E2EDK14 000000020 00710
E2EDK14 3000000001017945375000047E2EDK14 000000020 00610
E2EDK14 3000000001017945375000048E2EDK14 000000020 015Z4F2
E2EDK14 3000000001017945375000049E2EDK14 000000020 0031075
E2EDK14 3000000001017945375000050E2EDK14 000000020 021M
E2EDK14 3000000001017945375000051E2EDK14 000000020 0161075
E2EDK14 3000000001017945375000052E2EDK14 000000020 962M
E2EDP010013000000001017945375000053E2EDP01001000000020 000011 2980.000 EA 298.000 LB MOUSE 298.000 Z4TN 4260
E2EDP02 3000000001017945375000054E2EDP02 000053030 00140-N6260-S 00000120210205 DFUE
E2EDP02 3000000001017945375000055E2EDP02 000053030 0026336270425 00001120210217
E2EDP02 3000000001017945375000056E2EDP02 000053030 0168026580537 00001020210224
E2EDP02 3000000001017945375000057E2EDP02 000053030 9100000 00000120210205 DFUE
E2EDP02 3000000001017945375000058E2EDP02 000053030 911A 00000120210205 DFUE
E2EDP02 3000000001017945375000059E2EDP02 000053030 912PP 00000120210205 DFUE
E2EDP02 3000000001017945375000060E2EDP02 000053030 91300 00000120210205 DFUE
E2EDP02 3000000001017945375000061E2EDP02 000053030 914CONTACT ABCABCABC 00000120210205 DFUE
E2EDP02 3000000001017945375000062E2EDP02 000053030 963 00000120210205 DFUE
E2EDP02 3000000001017945375000063E2EDP02 000053030 965 00000120210205 DFUE
E2EDP02 3000000001017945375000064E2EDP02 000053030 9666336270425 00000120210205 DFUE
E2EDP02 3000000001017945375000065E2EDP02 000053030 9078026580537 00001020210205 DFUE
E2EDP03 3000000001017945375000066E2EDP03 000053030 02920210217
E2EDP03 3000000001017945375000067E2EDP03 000053030 00120210224
E2EDP03 3000000001017945375000068E2EDP03 000053030 01120210217
E2EDP03 3000000001017945375000069E2EDP03 000053030 02520210217
E2EDP03 3000000001017945375000070E2EDP03 000053030 02720210217
E2EDP03 3000000001017945375000071E2EDP03 000053030 02320210217
E2EDP03 3000000001017945375000072E2EDP03 000053030 02220210205
E2EDP19 3000000001017945375000073E2EDP19 000053030 001418VVZ
E2EDP19 3000000001017945375000074E2EDP19 000053030 002RJR-00001 AB ABCABCABC Mouse FORBUS BLUETOOTH
E2EDP19 3000000001017945375000075E2EDP19 000053030 0078471609000
E2EDP19 3000000001017945375000076E2EDP19 000053030 003889842532685
E2EDP19 3000000001017945375000077E2EDP19 000053030 011CN
E2EDP26 3000000001017945375000078E2EDP26 000053030 00459064.20
E2EDP26 3000000001017945375000079E2EDP26 000053030 00352269.20
E2EDP26 3000000001017945375000080E2EDP26 000053030 01052269.20
E2EDP26 3000000001017945375000081E2EDP26 000053030 01152269.20
E2EDP26 3000000001017945375000082E2EDP26 000053030 0126795.00
E2EDP26 3000000001017945375000083E2EDP26 000053030 01552269.20
E2EDP26 3000000001017945375000084E2EDP26 000053030 00117.54
E2EDP26 3000000001017945375000085E2EDP26 000053030 00252269.20
E2EDP26 3000000001017945375000086E2EDP26 000053030 940 2980.000
E2EDP26 3000000001017945375000087E2EDP26 000053030 939 2980.000
E2EDP05 3000000001017945375000088E2EDP05 000053030 + Z400MS List Price 52269.20 17.54 1 EA CAD 2980
E2EDP05 3000000001017945375000089E2EDP05 000053030 + XR1 Tax Jur Code Level 6795.00 13.000 52269.20
E2EDP05 3000000001017945375000090E2EDP05 000053030 + Tax Subtotal1 6795.00 2.28 1 EA CAD 2980
E2EDP05 3000000001017945375000091E2EDP05 000053030 + Taxable Amount + TaxSubtotal1 59064.20 19.82 1 EA CAD 2980
E2EDP04 3000000001017945375000092E2EDP04 000053030 CX 13.000 6795.00 7000000000
E2EDP04 3000000001017945375000093E2EDP04 000053030 CX 0 0 7001500000
E2EDP04 3000000001017945375000094E2EDP04 000053030 CX 0 0 7001505690
E2EDP28 3000000001017945375000095E2EDP28 000053030 00648489440000108471609000 CN CN ABCAB ZZ 298.000 298.000 LB US 400 United Stat KY
E2EDPT1 3000000001017945375000096E2EDPT1 000053030 0001E EN
E2EDPT2 3000000001017945375000097E2EDPT2 000096040 AB ABCABCABC Mouse forBus Bluetooth EN/XC/XD/XX Hdwr Black For Bsnss *
E2EDS01 3000000001017945375000098E2EDS01 000000020 0011
E2EDS01 3000000001017945375000099E2EDS01 000000020 01259064.20 CAD
E2EDS01 3000000001017945375000100E2EDS01 000000020 0056795.00 CAD
E2EDS01 3000000001017945375000101E2EDS01 000000020 01159064.20 CAD
E2EDS01 3000000001017945375000102E2EDS01 000000020 01052269.20 CAD
E2EDS01 3000000001017945375000103E2EDS01 000000020 94200000 CAD
E2EDS01 3000000001017945375000104E2EDS01 000000020 9440.00 CAD
E2EDS01 3000000001017945375000105E2EDS01 000000020 9450.00 CAD
E2EDS01 3000000001017945375000106E2EDS01 000000020 94659064.20 CAD
E2EDS01 3000000001017945375000107E2EDS01 000000020 94752269.20 CAD
E2EDS01 3000000001017945375000108E2EDS01 000000020 EXT
Z2XSK010003000000001017945375000109Z2XSK01000000108030 Z400 52269.20
Z2XSK010003000000001017945375000110Z2XSK01000000108030 XR1 13.000 6795.00 CX
</idocData>
</SendIdoc>

Aggiungere un'azione di risposta

Configurare ora il flusso di lavoro per restituire i risultati dal server SAP al richiedente originale. Per eseguire questa attività, seguire questa procedura:

Creare un criterio di richiesta-risposta Remote Function Call (RFC)

Per i flussi di lavoro A consumo che usano il connettore gestito SAP, se è necessario ricevere risposte usando una Remote Function Call (RFC) ad App per la logica di Azure da ABAP SAP, è necessario implementare un criterio di richiesta e risposta. Per ricevere IDoc nel flusso di lavoro quando si usa il trigger Richiesta, assicurarsi che la prima azione del flusso di lavoro sia un'azione di risposta che usa il codice di stato 200 OK senza alcun contenuto. Questo passaggio consigliato completa immediatamente il trasferimento asincrono di Logical Unit of Work (LUW) SAP su tRFC, che lascia nuovamente disponibile la conversazione CPIC SAP. È quindi possibile aggiungere altre azioni al flusso di lavoro per l'elaborazione dell'IDoc ricevuto senza bloccare i trasferimenti successivi.

Per implementare un criterio di richiesta e risposta, è prima necessario individuare lo schema RFC usando il comando generate schema. Lo schema generato ha due possibili nodi radice:

• Il nodo della richiesta, ovvero la chiamata ricevuta da SAP
• Il nodo della risposta, che corrisponde alla risposta a SAP

Nell'esempio seguente il modulo RFC STFC_CONNECTION genera un criterio di richiesta e risposta. Il codice XML della richiesta viene analizzato per estrarre un valore del nodo in cui SAP richiede <ECHOTEXT>. La risposta inserisce il timestamp corrente come valore dinamico. Si riceve una risposta simile quando si invia un RFC STFC_CONNECTION da un flusso di lavoro dell'app per la logica a SAP.

<STFC_CONNECTIONResponse xmlns="http://Microsoft.LobServices.Sap/2007/03/Rfc/">
  <ECHOTEXT>@{first(xpath(xml(triggerBody()?['Content']), '/*[local-name()="STFC_CONNECTION"]/*[local-name()="REQUTEXT"]/text()'))}</ECHOTEXT>
  <RESPTEXT>Azure Logic Apps @{utcNow()}</RESPTEXT>
</STFC_CONNECTIONResponse>

Testare il flusso di lavoro

È stato creato un flusso di lavoro che può inviare IDocs e comunicare con il server SAP. Ora che è stata configurata una connessione SAP per il flusso di lavoro, è possibile provare a sperimentare con BAPI e RFC.

Problemi di timeout del flusso di lavoro

Si verifica il timeout del flusso di lavoro in uno degli scenari seguenti:

• Tutti i passaggi necessari per la risposta non terminano entro il limite di timeout della richiesta. Se si verifica questa condizione, le richieste potrebbero venire bloccate. Per diagnosticare i problemi, vedere le informazioni su come controllare e monitorare i flussi di lavoro delle app per la logica.

• La modalità di elaborazione del sistema SAP è impostata sull'impostazione predefinita Trigger immediatamente , che fa sì che il sistema SAP blocchi la chiamata in ingresso per la trasmissione IDoc fino al termine dell'elaborazione di un IDoc.

  Se il sistema SAP è in fase di caricamento, ad esempio quando il flusso di lavoro invia un batch di IDocs contemporaneamente a SAP, il IDoc in coda chiama il timeout. La modalità di elaborazione predefinita fa sì che il sistema SAP blocchi la chiamata in ingresso per la trasmissione IDoc fino al termine dell'elaborazione di un IDoc. In App per la logica di Azure, per impostazione predefinita, le azioni del flusso di lavoro hanno un timeout di 2 minuti.

  Per risolvere questo problema, seguire la procedura descritta nella sezione Prerequisiti che modificano l'impostazione su Trigger by background program.

Tipizzazione sicura

Per impostazione predefinita, quando si crea una connessione per l'operazione gestita SAP, viene usata la tipizzazione forte per verificare la presenza di valori non validi eseguendo la convalida XML sullo schema. Questo comportamento consente di rilevare i problemi tempestivamente. L'opzione Tipizzazione sicura è disponibile per la compatibilità con le versioni precedenti e controlla solo la lunghezza della stringa. Se si sceglie Tipizzazione sicura, il tipo DATS e il tipo TIMS in SAP vengono considerati come stringhe anziché come i loro equivalenti XML, xs:date e xs:time, dove xmlns:xs="http://www.w3.org/2001/XMLSchema". La tipizzazione sicura influisce sul comportamento di tutta la generazione dello schema, sul messaggio di invio sia per il payload "inviato" che per la risposta "ricevuta" e sul trigger.

Quando viene usata la tipizzazione forte (la tipizzazione sicura non è abilitata), lo schema esegue il mapping dei tipi DATS e TIMS a tipi XML più semplici:

<xs:element minOccurs="0" maxOccurs="1" name="UPDDAT" nillable="true" type="xs:date"/>
<xs:element minOccurs="0" maxOccurs="1" name="UPDTIM" nillable="true" type="xs:time"/>

Quando si inviano messaggi con tipizzazione forte, la risposta DATS e TIMS è conforme al formato del tipo XML corrispondente:

<DATE>9999-12-31</DATE>
<TIME>23:59:59</TIME>

Quando la tipizzazione forte è abilitata, lo schema esegue il mapping dei tipi DATS e TIMS ai campi stringa XML solo con restrizioni di lunghezza, ad esempio:

<xs:element minOccurs="0" maxOccurs="1" name="UPDDAT" nillable="true">
  <xs:simpleType>
    <xs:restriction base="xs:string">
      <xs:maxLength value="8" />
    </xs:restriction>
  </xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="UPDTIM" nillable="true">
  <xs:simpleType>
    <xs:restriction base="xs:string">
      <xs:maxLength value="6" />
    </xs:restriction>
  </xs:simpleType>
</xs:element>

Quando i messaggi vengono inviati con la tipizzazione forte abilitata, la risposta DATS e TIMS è simile all'esempio seguente:

<DATE>99991231</DATE>
<TIME>235959</TIME>

Scenari avanzati

Modificare le intestazioni della lingua per l'invio di dati a SAP

Quando ci si connette a SAP da App per la logica di Azure, l'inglese è la lingua predefinita usata dalla connessione SAP per l'invio di dati al server SAP. Tuttavia, il connettore gestito SAP e il connettore predefinito SAP gestiscono in modi differenti la modifica e il salvataggio della lingua usata.

• Quando si crea una connessione con il connettore predefinito SAP, i parametri di connessione consentono di specificare e salvare il valore del parametro lingua come parte dei parametri di connessione SAP.

• Quando si crea una connessione con il connettore gestito SAP, i parametri di connessione non hanno il parametro lingua. Pertanto, durante questo periodo, non è possibile specificare la lingua da usare per l'invio di dati al server SAP. Al contrario, sia in fase di progettazione del flusso di lavoro che in fase di esecuzione, il connettore usa la lingua locale del Web browser di ogni richiesta inviata al server. Ad esempio, se il browser è impostato su portoghese, App per la logica di Azure crea e testa la connessione SAP con il portoghese, ma non salva la connessione con tale lingua.

  Tuttavia, è possibile impostare la lingua per la connessione usando l'intestazione HTTP standard Accept-Language con le richieste in ingresso. La maggior parte dei Web browser aggiunge un'intestazione Accept-Language in base alle impostazioni locali. Il Web browser applica questa intestazione quando si crea una nuova connessione SAP nella finestra di progettazione del flusso di lavoro. È quindi possibile aggiornare le impostazioni del Web browser per usare la lingua preferita oppure creare la connessione SAP usando Azure Resource Manager anziché la finestra di progettazione flussi di lavoro.

  Ad esempio, è possibile inviare una richiesta con l'intestazione Accept-Language al flusso di lavoro dell'app per la logica usando il trigger Richiesta denominato Quando viene ricevuta una richiesta HTTP. Tutte le azioni del flusso di lavoro ricevono l'intestazione. SAP usa quindi le lingue specificate nei messaggi di sistema, ad esempio i messaggi di errore BAPI. Se non si passa un'intestazione Accept-Language in fase di esecuzione, per impostazione predefinita viene usato l'inglese.

  Se si usa l'intestazione Accept-Language, è possibile che venga visualizzato l'errore seguente: Controllare le informazioni sull'account e/o le autorizzazioni e riprovare. In questo caso, controllare invece i log di errore del componente SAP. L'errore si verifica effettivamente nel componente SAP che usa l'intestazione, quindi è possibile che venga visualizzato uno di questi messaggi di errore:

  • "SAP. Middleware.Connector.RfcLogonException: selezionare una delle lingue installate"

  • "SAP. Middleware.Connector.RfcAbapMessageException: selezionare una delle lingue installate"

Confermare la transazione separatamente e in modo esplicito

Quando si inviano transazioni a SAP da App per la logica di Azure, questo scambio avviene in due passaggi, come descritto nel documento SAP Programmi server RFC transazionali.

Per impostazione predefinita, l'azione del connettore gestito SAP denominata Invia messaggio a SAP gestisce entrambi i passaggi per trasferire la funzione e confermare la transazione in una singola chiamata. È possibile anche separare questi passaggi. La possibilità di separare i passaggi di trasferimento e conferma è utile per gli scenari in cui non si desidera duplicare le transazioni in SAP. Questi scenari includono errori che si verificano per via di cause come i problemi di rete.

È possibile inviare un IDoc senza confermare automaticamente la transazione usando l'azione del connettore gestito SAP denominata [IDOC] Invia documento a SAP. È quindi possibile confermare in modo esplicito la transazione usando l'azione del connettore gestito SAP denominata [IDOC - RFC] Conferma ID transazione. Quando il flusso di lavoro conferma separatamente la transazione in un passaggio differente, il sistema SAP completa la transazione una sola volta.

Nei flussi di lavoro Standard, il connettore predefinito SAP include anche azioni che gestiscono separatamente i passaggi di trasferimento e conferma, in particolare [IDoc] Invia il documento a SAP e [IDOC - RFC] Conferma ID transazione.

Il flusso di lavoro di esempio seguente illustra questo criterio:

1. Creare e aprire un'app per la logica A consumo o Standard con un flusso di lavoro vuoto nella finestra di progettazione. Aggiungere il trigger Richiesta.

2. Per evitare l'invio di IDoc duplicati a SAP, seguire questa procedura alternativa per creare e usare un ID transazione IDoc nelle azioni SAP.

3. Aggiungere l'azione SAP denominata [IDOC] Invia documento a SAP al flusso di lavoro. Specificare le informazioni relative all'IDoc inviato al sistema SAP più i valori seguenti:

   Parametro	valore	Descrizione
   Conferma TID	No	Non confermare automaticamente l'ID transazione, che avviene in modo esplicito in un passaggio separato.
   GUID ID transazione	<IDoc-transaction-ID>	Se questo parametro non viene visualizzato automaticamente, aprire l'elenco Aggiungi nuovi parametri e selezionare il parametro. È possibile specificare manualmente questo valore, oppure il connettore può generare automaticamente questo GUID come output dall'azione [IDOC] Invia documento a SAP. In questo esempio viene lasciato vuoto questo parametro per generare automaticamente il GUID.

   Flusso di lavoro A consumo

   

   Flusso di lavoro Standard

   

4. Nell'azione SAP denominata [IDOC] Invia documento a SAP aprire Impostazioni per esaminare i criteri di ripetizione.

   L'opzione Predefinita è il criterio consigliato, ma è possibile selezionare un criterio personalizzato per le esigenze specifiche. Se si sceglie di usare un criterio personalizzato, configurare almeno un tentativo per superare le interruzioni temporanee della rete.

5. Aggiungere ora l'azione SAP denominata [IDOC - RFC] Conferma ID transazione.

   1. Nel parametro ID transazione selezionare all'interno della casella di modifica per aprire l'elenco dei contenuti dinamici.

   2. Nell'elenco, in [IDOC] Invia documento a SAP, selezionare il valore ID transazione, ovvero l'output dell'azione SAP precedente.

      Flusso di lavoro A consumo

      

      Flusso di lavoro Standard

      

   Dopo l'esecuzione di questo passaggio, la transazione corrente viene contrassegnata come completa su entrambi i lati, lato connettore SAP e lato sistema SAP.

Evitare l'invio di IDoc duplicati con una variabile ID transazione

Se si verifica un problema con il flusso di lavoro che invia IDoc duplicati a SAP, è possibile creare una variabile stringa che funge da identificatore della transazione IDoc. È quindi possibile usare questo identificatore per evitare trasmissioni di rete duplicate in condizioni quali interruzioni temporanee, problemi di rete o riconoscimenti persi.

1. Nella finestra di progettazione, dopo aver aggiunto il trigger Richiesta e prima di aggiungere l'azione SAP denominata [IDOC] Invia documento a SAP, aggiungere al flusso di lavoro l'azione denominata Inizializza variabile.

2. Rinominare l'azione in Crea ID transazione IDoc.

3. Nella casella delle informazioni sull'azione specificare i valori dei parametri seguenti:

   Parametro	valore	Descrizione
   Nome	<variable-name>	Un nome per la variabile, ad esempio IDocTransactionID
   Type	Stringa	Il tipo di variabile
   valore	guid()	Selezionare all'interno della casella di modifica, aprire l'editor della funzione o dell'espressione e immettere guid(). Salva le modifiche. Il parametro Valore è ora impostato sulla funzione guid(), che genera un GUID.

   Flusso di lavoro A consumo

   

   Flusso di lavoro Standard

   

   Nota

   I sistemi SAP per impostazione predefinita dimenticano un identificatore di transazione dopo un'ora specificata, o dopo 24 ore. Di conseguenza, SAP non riesce mai a confermare un identificatore di transazione se l'ID o il GUID è sconosciuto. Se la conferma di un identificatore di transazione ha esito negativo, questo errore indica che la comunicazione con il sistema SAP ha avuto esito negativo prima che SAP fosse in grado di confermare.

4. Aggiungere l'azione SAP denominata [IDOC] Invia documento a SAP al flusso di lavoro. Specificare le informazioni relative all'IDoc inviato al sistema SAP più i valori seguenti:

   Parametro	valore	Descrizione
   Conferma TID	No	Non confermare automaticamente l'ID transazione, che avviene in modo esplicito in un passaggio separato.
   GUID ID transazione	<IDoc-transaction-ID>	Se questo parametro non viene visualizzato automaticamente, aprire l'elenco Aggiungi nuovi parametri e selezionare il parametro. Per selezionare la variabile ID transazione creata, seguire questa procedura: 1. Nel parametro GUID ID transazione selezionare all'interno della casella di modifica per aprire l'elenco dei contenuti dinamici. 2. Nell'elenco, in Variabili selezionare la variabile creata in precedenza, ovvero IDocTransactionID in questo esempio.

   Flusso di lavoro A consumo

   

   Flusso di lavoro Standard

   

5. Nell'azione gestita SAP denominata [IDOC] Invia documento a SAP aprire Impostazioni per esaminare i criteri di ripetizione.

   L'opzione Predefinita è il criterio consigliato, ma è possibile selezionare un criterio personalizzato per le esigenze specifiche. Se si sceglie di usare un criterio personalizzato, configurare almeno un tentativo per superare le interruzioni temporanee della rete.

   Nota

   Attualmente solo le azioni del connettore gestito hanno l'impostazione Criteri di ripetizione, non quelle dei connettori predefiniti basati sul provider di servizi.

6. Aggiungere ora l'azione SAP denominata [IDOC - RFC] Conferma ID transazione.

   1. Nel parametro ID transazione selezionare all'interno della casella di modifica per aprire l'elenco dei contenuti dinamici.

   2. Nell'elenco, in Variabili immettere il nome della variabile creata, ovvero IDocTransactionID in questo esempio.

      Flusso di lavoro A consumo

      

      Flusso di lavoro Standard

      

7. Facoltativamente, convalidare la deduplicazione nell'ambiente di testing.

   1. Aggiungere un'altra azione SAP denominata [IDOC] Invia documento a SAP. Nel parametro ID transazione selezionare il GUID ID transazione usato nel passaggio precedente.

   2. Per convalidare il numero IDoc assegnato dopo ogni chiamata all'azione [IDOC] Invia documento a SAP, aggiungere al flusso di lavoro l'azione [IDOC] Ottieni elenco IDOC per la transazione con lo stesso ID transazione e la direzione Ricevere.

      Se viene restituito lo stesso numero IDoc per entrambe le chiamate, l'IDoc è stato deduplicato.

Se si invia due volte lo stesso IDoc, è possibile verificare che SAP possa identificare la duplicazione della chiamata tRFC e risolvere le due chiamate a un singolo messaggio IDoc in ingresso.

Risoluzione dei problemi

Problemi di connessione

Durante la creazione della connessione, se viene visualizzato l'errore seguente, è presente problema con l'installazione della libreria client NCo SAP:

Il test della connessione non è riuscito. Errore: "Non è stato possibile elaborare la richiesta. Dettagli dell'errore: "non è possibile caricare file o assembly "sapnco, Version=3.0.0.42, Culture=neutral, PublicKeyToken 50436dca5c7f7d23" o una delle relative dipendenze. Il sistema non è in grado di trovare il file specificato."."

Assicurarsi di installare la versione richiesta della libreria client NCo SAP e soddisfare tutti gli altri prerequisiti.

500 Gateway non valido o errore 400 Richiesta non valida

Se viene visualizzato un errore 500 Gateway non valido o 400 Richiesta non valida con un messaggio simile a servizio "sapgw00" sconosciuto, la risoluzione del nome del servizio di rete sul numero di porta ha esito negativo, ad esempio:

{
   "body": {
      "error": {
         "code": 500,
         "source": "EXAMPLE-FLOW-NAME.eastus.environments.microsoftazurelogicapps.net",
         "clientRequestId": "00000000-0000-0000-0000-000000000000",
         "message": "BadGateway",
         "innerError": {
            "error": {
               "code": "UnhandledException",
               "message": "\nERROR service 'sapgw00' unknown\nTIME Wed Nov 11 19:37:50 2020\nRELEASE 721\nCOMPONENT NI (network interface)\nVERSION 40\nRC -3\nMODULE ninti.c\nLINE 933\nDETAIL NiPGetServByName: 'sapgw00' not found\nSYSTEM CALL getaddrinfo\nCOUNTER 1\n\nRETURN CODE: 20"
            }
         }
      }
   }
}

• Opzione 1: nella configurazione della connessione API e del trigger, sostituire il nome del servizio gateway con il relativo numero di porta. Nell'errore di esempio, sapgw00 deve essere sostituito da un numero di porta reale, ad esempio 3300.

• Opzione 2: se si usa il gateway dati locale, è possibile aggiungere il nome del servizio gateway al mapping delle porte in %windir%\System32\drivers\etc\servicese riavviare il servizio gateway dati locale, ad esempio:

  sapgw00  3300/tcp
  

È possibile che venga visualizzato un errore simile quando il server applicazioni SAP o il nome del server messaggi viene risolto nell'indirizzo IP. Per il gateway dati locale, è invece possibile aggiungere il nome al mapping degli indirizzi IP in %windir%\System32\drivers\etc\hosts, ad esempio:

10.0.1.9 SAPDBSERVER01 # SAP System Server VPN IP by computer name
10.0.1.9 SAPDBSERVER01.someguid.xx.xxxxxxx.cloudapp.net # SAP System Server VPN IP by fully qualified computer name

Errori durante l'invio di pacchetti IDoc da SAP al trigger

Se non è possibile inviare pacchetti IDoc da SAP al trigger, esaminare il messaggio di rifiuto della chiamata tRFC (Transactional RFC) nella finestra di dialogo tRFC (T-Code SM58) SAP. Nell'interfaccia SAP è possibile che vengano visualizzati i messaggi di errore seguenti, che vengono tagliati a causa dei limiti di substring nel campo Testo stato.

La definizione di segmento o gruppo E2EDK36001 non è stata trovata nel meta IDoc

Questo messaggio di errore indica che si verificano errori previsti con altri errori. Ad esempio, l'errore nel generare un payload XML IDoc perché i relativi segmenti non vengono rilasciati da SAP. Di conseguenza, mancano i metadati del tipo di segmento necessari per la conversione.

Per ottenere questi segmenti rilasciati da SAP, contattare il tecnico ABAP per il sistema SAP.

RequestContext nell'interfaccia IReplyChannel è stato chiuso senza l'invio di una risposta

Per il connettore gestito SAP, questo messaggio di errore indica errori imprevisti che si verificano quando il gestore catch-all del canale termina il canale a causa di un errore e ricompila il canale per elaborare altri messaggi.

• Per confermare che il flusso di lavoro ha ricevuto l'IDoc, aggiungere un'azione Risposta che restituisce un codice di stato 200 OK. Lasciare vuoto il corpo e non modificare o aggiungere alle intestazioni. L'IDoc viene trasportato tramite tRFC, che non consente un payload di risposta.

• Per rifiutare invece IDoc, rispondere con qualsiasi codice di stato HTTP differente da 200 OK. L'adapter SAP restituisce quindi un'eccezione a SAP per conto dell'utente. È consigliabile rifiutare IDoc solo per segnalare gli errori di trasporto verso SAP, ad esempio un IDoc instradato in modo errato che l'applicazione non può elaborare. Non è consigliabile rifiutare un IDoc per gli errori a livello di applicazione, ad esempio problemi con i dati contenuti nell'IDoc. Se si ritarda l'accettazione del trasporto per la convalida a livello di applicazione, potrebbero verificarsi prestazioni negative a causa del blocco della connessione dal trasporto di altri IDoc.

• Se viene visualizzato questo messaggio di errore e si verificano errori sistemici che chiamano App per la logica di Azure, verificare di aver configurato le impostazioni di rete per il servizio gateway dati locale per l'ambiente specifico. Ad esempio, se l'ambiente di rete richiede l'uso di un proxy per chiamare gli endpoint di Azure, è necessario configurare il servizio gateway dati locale per l'uso del proxy. Per altre informazioni, vedere Configurazione proxy.

• Se viene visualizzato questo messaggio di errore e si verificano errori intermittenti che chiamano App per la logica di Azure, potrebbe essere necessario aumentare il numero di tentativi o ripetere l'intervallo tra tentativi seguendo questa procedura:

  1. Controllare le impostazioni SAP nel file di configurazione del servizio gateway dati locale denominato Microsoft.PowerBI.EnterpriseGateway.exe.config.

     1. Nel nodo radice configuration aggiungere un elemento configSections, se non esiste.

     2. Nel nodo configSections aggiungere un elemento section con gli attributi seguenti, se non esiste alcun elemento: name="SapAdapterSection" type="Microsoft.Adapters.SAP.Common.SapAdapterSection, Microsoft.Adapters.SAP.Common"

        Importante

        Non modificare gli attributi negli elementi section esistenti, se tali elementi esistono già.

        L'elemento configSections è simile alla versione seguente, se nella configurazione del servizio gateway non sono dichiarate altre sezioni o gruppi di sezioni:

        <configSections>
          <section name="SapAdapterSection" type="Microsoft.Adapters.SAP.Common.SapAdapterSection, Microsoft.Adapters.SAP.Common"/>
        </configSections>
        

     3. Nel nodo radice configuration aggiungere un elemento SapAdapterSection, se non esiste.

     4. Nel nodo SapAdapterSection aggiungere un elemento Broker con gli attributi seguenti, se non esiste alcun elemento: WebhookRetryDefaultDelay="00:00:00.10" WebhookRetryMaximumCount="2"

        Importante

        Modificare gli attributi dell'elemento Broker, anche se l'elemento esiste già.

        L'elemento SapAdapterSection è simile alla versione seguente, se non viene dichiarato alcun altro elemento o attributo nella configurazione dell'adapter SAP:

        <SapAdapterSection>
          <Broker WebhookRetryDefaultDelay="00:00:00.10" WebhookRetryMaximumCount="2" />
        </SapAdapterSection>
        

        L'impostazione relativa al numero di tentativi è simile a WebhookRetryMaximumCount="2". L'impostazione relativa all'intervallo tra tentativi è simile a WebhookRetryDefaultDelay="00:00:00.10", dove il formato timespan è HH:mm:ss.ff.

     Nota

     Per altre informazioni sul file di configurazione, vedere Schema del file di configurazione per .NET Framework.

  2. Salva le modifiche.

  3. Se si usa il gateway dati locale, riavviare il gateway.

Passaggi successivi

• Generare gli schemi per gli artefatti in SAP