Generare schemi per gli artefatti SAP 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 un flusso di lavoro di app per la logica di esempio che genera schemi per gli artefatti SAP. Il flusso di lavoro inizia con un trigger di richiesta che può ricevere richieste HTTP POST dal server SAP. Il flusso di lavoro genera quindi schemi per i valori IDoc e BAPI specificati usando l'azione SAP denominata Genera schemi che invia una richiesta al server SAP. Per inviare questa richiesta, è possibile usare l'azione generica del connettore gestito SAP denominata Invia messaggio a SAP oppure usare l'azione predefinita o SAP gestito specifico denominata [BAPI] Chiama in SAP. Questa azione SAP restituisce un XML Schema, non i contenuto o i dati del documento XML stesso. Gli schemi restituiti nella risposta vengono caricati in un account di integrazione tramite il connettore Azure Resource Manager. Gli schemi contengono le parti seguenti:

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 predefinito SAP in anteprima, ospitato ed eseguito in App per la logica di Azure a tenant singolo, ma questo connettore è attualmente in anteprima e soggetto alle Condizioni per l'utilizzo supplementari per le anteprime di Microsoft Azure. 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.

• Se si vogliono caricare gli schemi generati in un repository, ad esempio un account di integrazione, assicurarsi che il repository esista già.

• 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.

Generare schemi per un artefatto SAP

Il flusso di lavoro dell'app per la logica di esempio seguente viene attivato quando il trigger SAP del flusso di lavoro riceve una richiesta da un server SAP. Il flusso di lavoro esegue quindi un'azione SAP che genera schemi per l'artefatto SAP specificato.

Aggiungere il trigger Request

Per fare in modo che il flusso di lavoro riceva le richieste dal server SAP tramite HTTP, è 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.

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 generare schemi

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:

Testare il flusso di lavoro per la generazione dello schema

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:

Caricare gli schemi in un account di integrazione

Facoltativamente, è possibile scaricare o archiviare gli schemi generati nei repository, ad esempio un account di integrazione o un account di archiviazione di Azure, in un contenitore BLOB. Gli account di integrazione offrono un'esperienza ottimale con azioni XML per i flussi di lavoro in App per la logica di Azure. È possibile caricare schemi generati in un account di integrazione esistente all'interno dello stesso flusso di lavoro che genera tali schemi usando l'azione di Azure Resource Manager denominata Crea o aggiorna una risorsa.

"properties": {
   "Content": "@base64ToString(items('For_each')?['Content'])",
   "ContentType": "application/xml",
   "SchemaType": "Xml"
}

Per questa attività, è necessario un account di integrazione, nel caso in cui non se sia già disponibile uno. 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 per caricare gli schemi in un account di integrazione dal flusso di lavoro dopo la generazione dello schema.

Testare il flusso di lavoro

1. In base al fatto che si disponga di un flusso di lavoro di app per la logica a consumo o standard, seguire la procedura generale per testare ed eseguire manualmente il flusso di lavoro.

2. Dopo una corretta esecuzione, passare all'account di integrazione e verificare che esistano gli schemi generati.

XML Schema di esempio

Se si sta imparando a generare un XML Schema da usare per la creazione di un documento di esempio, esaminare gli esempi seguenti. Questi esempi illustrano le modalità di utilizzo di molti tipi di payload, tra cui:

• Richieste RFC
• Richieste BAPI
• Richieste IDoc
• Tipi di dati di XML Schema semplici o complessi
• Parametri di tabella
• Comportamenti XML facoltativi

È possibile iniziare l'XML Schema con un prologo XML facoltativo. Il connettore SAP funziona con o senza il prologo XML.

<?xml version="1.0" encoding="utf-8">

Esempi XML per richieste RFC

Nell'esempio seguente viene illustrata una chiamata RFC di base in cui il nome RFC è STFC_CONNECTION. In questa richiesta viene usato lo spazio dei nomi predefinito denominato xmlns=. Tuttavia, è possibile assegnare e usare alias dello spazio dei nomi, ad esempio xmmlns:exampleAlias=. Il valore dello spazio dei nomi è lo spazio dei nomi di tutti gli RFC in SAP per i servizi Microsoft. La richiesta ha un semplice parametro di input denominato <REQUTEXT>.

<STFC_CONNECTION xmlns="http://Microsoft.LobServices.Sap/2007/03/Rfc/">
   <REQUTEXT>exampleInput</REQUTEXT>
</STFC_CONNECTION>

Nell'esempio seguente viene illustrata una chiamata RFC con un parametro di tabella. Questa chiamata di esempio e il gruppo di RFC di test sono disponibili in tutti i sistemi SAP. Il parametro tabella è denominato TCPICDAT. Il tipo di riga della tabella è ABAPTEXT e questo elemento viene ripetuto per ogni riga della tabella. Questo esempio contiene una singola riga, denominata LINE. Le richieste con un parametro di tabella possono contenere un numero qualsiasi di campi, dove il numero è un numero intero positivo (n).

<STFC_WRITE_TO_TCPIC xmlns="http://Microsoft.LobServices.Sap/2007/03/Rfc/">
   <RESTART_QNAME>exampleQName</RESTART_QNAME>
   <TCPICDAT>
      <ABAPTEXT xmlns="http://Microsoft.LobServices.Sap/2007/03/Types/Rfc/">
         <LINE>exampleFieldInput1</LINE>
      </ABAPTEXT>
      <ABAPTEXT xmlns="http://Microsoft.LobServices.Sap/2007/03/Types/Rfc/">
         <LINE>exampleFieldInput2</LINE>
      </ABAPTEXT>
      <ABAPTEXT xmlns="http://Microsoft.LobServices.Sap/2007/03/Types/Rfc/">
         <LINE>exampleFieldInput3</LINE>
      </ABAPTEXT>
   </TCPICDAT>
</STFC_WRITE_TO_TCPIC>

Nell'esempio seguente viene illustrata una chiamata RFC con un parametro di tabella con un campo anonimo, ovvero un campo senza un nome assegnato. I tipi complessi vengono dichiarati in uno spazio dei nomi separato, in cui la dichiarazione imposta un nuovo valore predefinito per il nodo corrente e tutti i relativi elementi figlio. Nell'esempio viene usato il codice hex x002F come carattere di escape per il simbolo / perché questo simbolo è riservato nel nome del campo SAP.

<RFC_XML_TEST_1 xmlns="http://Microsoft.LobServices.Sap/2007/03/Rfc/">
   <IM_XML_TABLE>
      <RFC_XMLCNT xmlns="http://Microsoft.LobServices.Sap/2007/03/Rfc/">
         <_x002F_AnonymousField>AQIDBAU=</_x002F_AnonymousField>
      </RFC_XMLCNT>
   </IM_XML_TABLE>
</RFC_XML_TEST_1>

L'esempio precedente illustra anche come codificare matrici binarie per i tipi di dati SAP byte e XString. Le matrici binarie sono codificate in base64 in XML (tipo di dati binari XSD xs:base64Binary). Nell'esempio il valore della stringa base64 di esempio AQIDBAU= decodifica come matrice binaria [01][02][03][04]. Questa codifica è diversa ed è più efficiente a livello di spazio rispetto alla codifica hex del connettore SAP .NET sottostante. Con la codifica hex, lo stesso valore viene codificato come stringa 01020304.

L'esempio seguente include prefissi per gli spazi dei nomi. È possibile dichiarare tutti i prefissi contemporaneamente oppure dichiarare un numero qualsiasi di prefissi come attributi di un nodo. L'alias dello spazio dei nomi RFC denominato ns0 viene usato come radice e parametri per il tipo di base.

<ns0:BBP_RFC_READ_TABLE xmlns:ns0="http://Microsoft.LobServices.Sap/2007/03/Rfc/" xmlns:ns3="http://Microsoft.LobServices.Sap/2007/03/Types/Rfc/">
   <ns0:DELIMITER>0</ns0:DELIMITER>
   <ns0:QUERY_TABLE>KNA1</ns0:QUERY_TABLE>
   <ns0:ROWCOUNT>250</ns0:ROWCOUNT>
   <ns0:ROWSKIPS>0</ns0:ROWSKIPS>
   <ns0:FIELDS>
      <ns3:RFC_DB_FLD>
         <ns3:FIELDNAME>KUNNR</ns3:FIELDNAME>
      </ns3:RFC_DB_FLD>
   </ns0:FIELDS>
</ns0:BBP_RFC_READ_TABLE>

Esempi XML per richieste BAPI

Gli esempi XML seguenti sono richieste di esempio per chiamare il metodo BAPI.

Nell'esempio seguente viene restituito un elenco di banche che usano il metodo BAPI GETLIST. Questo esempio contiene l'oggetto business di una banca denominata BUS1011.

<GETLIST xmlns="http://Microsoft.LobServices.Sap/2007/03/Bapi/BUS1011">
   <BANK_CTRY>US</BANK_CTRY>
   <MAX_ROWS>10</MAX_ROWS>
</GETLIST>

Nell'esempio seguente viene creato un oggetto banca usando il metodo CREATE. In questo esempio viene usato lo stesso oggetto business denominato BUS1011, come nell'esempio precedente. Quando si usa il metodo CREATE per creare una banca, assicurarsi di eseguire il commit delle modifiche perché questo metodo non viene eseguito per impostazione predefinita.

<CREATE xmlns="http://Microsoft.LobServices.Sap/2007/03/Bapi/BUS1011">
   <BANK_ADDRESS>
      <BANK_NAME xmlns="http://Microsoft.LobServices.Sap/2007/03/Types/Rfc">ExampleBankName</BANK_NAME>
      <REGION xmlns="http://Microsoft.LobServices.Sap/2007/03/Types/Rfc">ExampleRegionName</REGION>
      <STREET xmlns="http://Microsoft.LobServices.Sap/2007/03/Types/Rfc">ExampleStreetAddress</STREET>
      <CITY xmlns="http://Microsoft.LobServices.Sap/2007/03/Types/Rfc">Redmond</CITY>
   </BANK_ADDRESS>
   <BANK_CTRY>US</BANK_CTRY>
   <BANK_KEY>123456789</BANK_KEY>
</CREATE>

Nell'esempio seguente vengono visualizzati i dettagli di una banca usando il numero di registrazione banca, ovvero il valore di <BANK_KEY>.

<GETDETAIL xmlns="http://Microsoft.LobServices.Sap/2007/03/Bapi/BUS1011">
   <BANKCOUNTRY>US</BANKCOUNTRY>
   <BANKKEY>123456789</BANKKEY>
</GETDETAIL>

Esempi XML per richieste IDoc

Per generare uno schema XML IDoc SAP normale, usare l'applicazione di accesso SAP e il T-Code WE60. Accedere alla documentazione SAP tramite l'interfaccia utente e generare XML Schema in formato XSD per i tipi e le estensioni IDoc. Per altre informazioni sui formati e i payload SAP generici e sulle finestre di dialogo predefinite, vedere la documentazione SAP.

In questo esempio vengono dichiarati il nodo radice e gli spazi dei nomi. L'URI nel codice di esempio, http://Microsoft.LobServices.Sap/2007/03/Idoc/3/ORDERS05//700/Send, dichiara la configurazione seguente:

• /IDoc è il nodo radice per tutti i IDocs.

• /3 è la versione dei tipi di record per le definizioni di segmento comuni.

• /ORDERS05 è il tipo IDoc.

• // è un segmento vuoto perché non esiste alcuna estensione IDoc.

• /700 è la versione SAP.

• /Send è l'azione con cui inviare le informazioni a SAP.

<ns0:Send xmlns:ns0="http://Microsoft.LobServices.Sap/2007/03/Idoc/3/ORDERS05//700/Send" xmlns:ns3="http://schemas.microsoft.com/2003/10/Serialization" xmlns:ns1="http://Microsoft.LobServices.Sap/2007/03/Types/Idoc/Common/" xmlns:ns2="http://Microsoft.LobServices.Sap/2007/03/Idoc/3/ORDERS05//700">
   <ns0:idocData>

È possibile ripetere il nodo idocData per inviare un batch di IDocs in una singola chiamata. Nell'esempio seguente è presente un record di controllo denominato EDI_DC40 e più record di dati.

<...>
   <ns0:idocData>
      <ns2:EDI_DC40>
         <ns1:TABNAM>EDI_DC40</ns1:TABNAM>
         <...>
         <ns1:ARCKEY>Cor1908207-5</ns1:ARCKEY>
      </ns2:EDI_DC40>
      <ns2:E2EDK01005>
         <ns2:DATAHEADERCOLUMN_SEGNAM>E23DK01005</ns2:DATAHEADERCOLUMN_SEGNAM>
         <ns2:CURCY>USD</ns2:CURCY>
      </ns2:E2EDK01005>
      <ns2:E2EDK03>
      <...>
   </ns0:idocData>

Nell'esempio seguente viene illustrato un record di controllo IDoc di esempio, che usa un prefisso denominato EDI_DC. È necessario aggiornare i valori in modo che corrispondano all'installazione SAP e al tipo IDoc. Ad esempio, il codice client IDoc potrebbe non essere 800. Contattare il team SAP per assicurarsi di usare i valori corretti per l'installazione di SAP.

<ns2:EDI_DC40>
   <ns:TABNAM>EDI_DC40</ns1:TABNAM>
   <ns:MANDT>800</ns1:MANDT>
   <ns:DIRECT>2</ns1:DIRECT>
   <ns:IDOCTYP>ORDERS05</ns1:IDOCTYP>
   <ns:CIMTYP></ns1:CIMTYP>
   <ns:MESTYP>ORDERS</ns1:MESTYP>
   <ns:STD>X</ns1:STD>
   <ns:STDVRS>004010</ns1:STDVRS>
   <ns:STDMES></ns1:STDMES>
   <ns:SNDPOR>SAPENI</ns1:SNDPOR>
   <ns:SNDPRT>LS</ns1:SNDPRT>
   <ns:SNDPFC>AG</ns1:SNDPFC>
   <ns:SNDPRN>ABAP1PXP1</ns1:SNDPRN>
   <ns:SNDLAD></ns1:SNDLAD>
   <ns:RCVPOR>BTSFILE</ns1:RCVPOR>
   <ns:RCVPRT>LI</ns1:RCVPRT>

L'esempio seguente mostra un record di dati di esempio con segmenti semplici. In questo esempio viene usato il formato data SAP. I documenti con tipizzazione forte possono usare formati data XML nativi, ad esempio 2020-12-31 23:59:59.

<ns2:E2EDK01005>
   <ns2:DATAHEADERCOLUMN_SEGNAM>E2EDK01005</ns2:DATAHEADERCOLUMN_SEGNAM>
      <ns2:CURCY>USD</ns2:CURCY>
      <ns2:BSART>OR</ns2:BSART>
      <ns2:BELNR>1908207-5</ns2:BELNR>
      <ns2:ABLAD>CC</ns2:ABLAD>
   </ns2>
   <ns2:E2EDK03>
      <ns2:DATAHEADERCOLUMN_SEGNAM>E2EDK03</ns2:DATAHEADERCOLUMN_SEGNAM>
      <ns2:IDDAT>002</ns2:IDDAT>
      <ns2:DATUM>20160611</ns2:DATUM>
   </ns2:E2EDK03>

Nell'esempio seguente viene illustrato un record di dati con segmenti raggruppati. Il record include un nodo padre del gruppo denominato E2EDKT1002GRP e più nodi figlio, tra cui E2EDKT1002 e E2EDKT2001.

<ns2:E2EDKT1002GRP>
   <ns2:E2EDKT1002>
      <ns2:DATAHEADERCOLUMN_SEGNAM>E2EDKT1002</ns2:DATAHEADERCOLUMN_SEGNAM>
         <ns2:TDID>ZONE</ns2:TDID>
   </ns2:E2EDKT1002>
   <ns2:E2EDKT2001>
      <ns2:DATAHEADERCOLUMN_SEGNAM>E2EDKT2001</ns2:DATAHEADERCOLUMN_SEGNAM>
         <ns2:TDLINE>CRSD</ns2:TDLINE>
   </ns2:E2EDKT2001>
</ns2:E2EDKT1002GRP>

Il metodo consigliato consiste nel creare un identificatore IDoc da usare con tRFC. È possibile impostare questo identificatore di transazione denominato tid usando l'operazione Send IDoc nel connettore gestito SAP.

Nell'esempio seguente viene illustrato un metodo alternativo per impostare l'identificatore della transazione, o tid. In questo esempio, l'ultimo nodo del segmento di record di dati e il nodo dati IDoc vengono chiusi. Il GUID, guid, viene quindi usato come identificatore tRFC per rilevare i duplicati.

     </E2STZUM002GRP>
  </idocData>
  <guid>8820ea40-5825-4b2f-ac3c-b83adc34321c</guid>
</Send>

Passaggi successivi

• Creare flussi di lavoro di esempio per scenari SAP comuni