SAP ERP

Configurare la sottoscrizione agli eventi

Se abiliti la sottoscrizione agli eventi, devi configurare l'SDK ABAP. Per informazioni sulla configurazione di ABAP SDK, consulta la panoramica di ABAP SDK for Google Cloud.

Inserisci i seguenti valori nella sezione Dettagli abbonamento agli eventi:

1. Seleziona uno dei seguenti tipi di autenticazione per il listener di eventi.
   • Autenticazione Google. Se attivi questa opzione, segui i passaggi descritti in Autenticarsi utilizzando i token web JSON per configurare l'autenticazione per l'SDK ABAP. Inoltre, assicurati che il account di servizio disponga del ruolo roles/connectors.listener il cui token di accesso viene utilizzato per l'autenticazione.
   • Autenticazione con chiave API. Se selezioni questa opzione, devi aver creato una chiave API e poi averla salvata come secret di Secret Manager. Per ulteriori informazioni, vedi Creare una chiave API.
2. Inserisci il nome del campo del tipo di evento. Questo campo identifica il tipo di evento associato alla richiesta di evento in entrata.

   {
   "event_type": "user.created",
   ...
   // other request fields
   ...
   }

3. Seleziona Attiva connettività privata per una connettività sicura tra l'applicazione di backend e la connessione. Se selezioni questa opzione, devi eseguire passaggi di configurazione aggiuntivi dopo aver creato la connessione. Per saperne di più, consulta Connettività privata per la sottoscrizione di eventi.
4. Inserisci la configurazione della coda di messaggi non recapitabili. Se configuri la coda dei messaggi non recapitabili, la connessione scrive gli eventi non elaborati nell'argomento Pub/Sub specificato. Inserisci i seguenti dettagli:
   1. ID progetto messaggi non recapitabili : l'ID progetto Google Cloud in cui hai configurato l'argomento Pub/Sub messaggi non recapitabili.
   2. Argomento messaggi non recapitabili : l'argomento Pub/Sub in cui vuoi scrivere i dettagli dell'evento non elaborato.

Esempi di configurazione della connessione

Le sezioni seguenti elencano i valori di esempio per i vari campi quando crei la connessione SAP ERP e i parametri richiesti per i diversi tipi di connessione.

Connessione a un sistema SAP distribuito

Se ti connetti a un sistema SAP distribuito, ad esempio un sistema che utilizza il bilanciamento del carico, devi specificare le seguenti proprietà di connessione aggiuntive. Un amministratore può ottenere queste proprietà di connessione nella scheda Connessione della finestra di dialogo Proprietà voce di sistema nel sistema SAP.

• ID sistema: specifica il valore ottenuto dalla proprietà SystemId. L'ID sistema è l'ID sistema/R3Name del sistema SAP. L'ID sistema è una stringa con un massimo di tre caratteri.
• Message Server: quando ti connetti a un sistema SAP che utilizza il bilanciamento del carico, devi specificare il campo Message Server. Imposta questa proprietà sul valore ottenuto dalla proprietà MessageServer nel sistema SAP. Inoltre, anteponi al valore del campo Server di messaggi il valore della casella SAProuter.
• Gruppo: imposta questa proprietà sul valore ottenuto dalla proprietà Gruppo/Server. La proprietà Group specifica il gruppo di accesso utilizzato. Il valore predefinito è PUBLIC.

Connessione a un server applicazioni personalizzato

Se ti connetti a un sistema SAP con un server applicazioni dedicato o un server applicazioni personalizzato, devi specificare le seguenti proprietà di connessione aggiuntive. Un amministratore può ottenere queste proprietà di connessione dal sistema SAP.

• ID sistema: specifica il valore ottenuto dalla proprietà SystemId. Si tratta dell'ID sistema o di R3Name del sistema SAP. L'ID sistema è una stringa con un massimo di tre caratteri.
• Host: specifica il valore ottenuto dal server delle applicazioni.

  Specifica il nome host del sistema di destinazione. Questo valore può essere un nome host, un indirizzo IP o un indirizzo router SAP normale.

• Numero di sistema: specifica il valore ottenuto dalla proprietà SystemNumber.

  La proprietà SystemNumber definisce il sistema di destinazione.

Configurazione di connessioni di rete sicure

Se l'amministratore ha configurato la comunicazione di rete sicura (SNC), devi impostare le seguenti proprietà aggiuntive. Dal sistema SAP, puoi ottenere le seguenti proprietà della stringa di connessione SNC nella scheda Rete della finestra di dialogo Proprietà voce di sistema.

• Modalità SNC: se la casella di controllo "Attiva connessioni di rete sicure" è selezionata in SAP, imposta la proprietà di connessione Modalità SNC su True. In caso contrario, imposta la proprietà di connessione SNC Mode su False.

  La proprietà di connessione SNCMode è un valore booleano che determina se stai utilizzando SNC. Il valore predefinito è False.

• SNC PartnerName: specifica il nome SNC del server delle applicazioni. Ad esempio: p:CN=IDS, OU=IT, O=CSW, C=DE
• Nome SNC: facoltativo. La proprietà SNCName specifica il nome della connessione SNC. Imposta questa proprietà per assicurarti che venga utilizzato il nome SNC corretto per la connessione.
• SNC Qop: imposta questa proprietà sull'opzione selezionata nella sezione Impostazioni di rete sicura. Ad esempio, se è selezionata l'opzione Integrità, imposta la proprietà SNCQop su 3.

  La proprietà SNCQop specifica il livello (o la qualità) di protezione dei dati. Se questa proprietà non viene specificata, viene impostato l'intero -1. I valori validi sono 1, 2, 3, 8 o 9, che corrispondono ai livelli di protezione.

• ID oggetto SNC_Lib: imposta questa proprietà sul percorso e sul nome file della libreria SNC. Specifica il percorso completo della libreria di sicurezza che stai utilizzando, ad esempio C:\Secude\secude.xll.

Tipo di connessione ApplicationServer

Per la connettività del server delle applicazioni, Private Service Connect e il bilanciatore del carico devono essere configurati con l'IP e la porta 33XX del sistema SAP nel gruppo di endpoint di rete (NEG) e nel controllo di integrità. Dove XX è il numero di sistema o di istanza del sistema SAP utilizzato. La seguente tabella elenca i valori di configurazione di esempio per il tipo di connessione ApplicationServer. Consulta l'interfaccia di creazione della connessione nella console per conoscere i campi obbligatori e facoltativi.

Tipo di connessione del server di messaggistica (server di gruppo)

• Private Service Connect e il bilanciatore del carico devono essere configurati con l'IP del sistema SAP sulle porte 33XX e 36XX nel gruppo di endpoint di rete (NEG) e nel controllo di integrità. Dove XX è il numero di sistema o di istanza del sistema SAP utilizzato.
• Devi creare una zona DNS su Cloud DNS e mappare l'allegato dell'endpoint del server delle applicazioni, configurato sulla porta 33XX con il nome host del sistema SAP.
• Puoi connetterti a un sistema SAP con un server di messaggi (server di gruppo) solo se il server di messaggi restituisce l'indirizzo del nome di dominio completo (FQDN) del server delle applicazioni. Non puoi connetterti a un sistema SAP con un server di messaggi (server di gruppo) se il server di messaggi restituisce l'indirizzo IP.
• Quando l'applicazione lo richiede, il server di messaggi deve rispondere con il DNS dei server delle applicazioni a cui l'applicazione deve connettersi.
• Il DNS dei server delle applicazioni deve essere univoco e non deve essere utilizzato da altri sistemi SAP.
• Nell'applicazione SAP, gli IP degli allegati degli endpoint per i server delle applicazioni e i server di messaggistica devono essere mantenuti nei parametri gw/alternative_hostnames.
  1. Vai al codice di transazione RZ10 e crea una voce per il parametro "gw/alternative_hostname" nel profilo dell'istanza.
  2. Imposta il parametro ms/lg\_with\_hostname su 1 per configurare le versioni del server di messaggi SAP precedenti alla 7.53 in modo che restituiscano i nomi host. Le versioni 7.53 e successive restituiscono i nomi host per impostazione predefinita.
  3. Riavvia l'applicazione SAP per rendere effettivi i parametri.

La seguente tabella elenca i valori di configurazione di esempio per il tipo di connessione Group Server:

Tipo di connessione del certificato X509

Per Secure Network Communications (SNC) con connettività X509, Private Service Connect e il bilanciatore del carico devono essere configurati con l'IP e la porta 48XX del sistema SAP nel gruppo di endpoint di rete (NEG) e nel controllo di integrità. Dove XX è il numero di sistema o di istanza del sistema SAP utilizzato. La seguente tabella elenca i valori di configurazione di esempio per il tipo di connessione X509 certificate. Consulta l'interfaccia di creazione della connessione nella console per conoscere i campi obbligatori e facoltativi.

Entità, operazioni e azioni

Tutti i connettori di integrazione forniscono un livello di astrazione per gli oggetti dell'applicazione connessa. Puoi accedere agli oggetti di un'applicazione solo tramite questa astrazione. L'astrazione ti viene mostrata come entità, operazioni e azioni.

• Entità : un'entità può essere considerata un oggetto o una raccolta di proprietà nell'applicazione o nel servizio connesso. La definizione di un'entità varia da un connettore all'altro. Ad esempio, in un connettore di database, le tabelle sono le entità, in un connettore del file server, le cartelle sono le entità e in un connettore del sistema di messaggistica, le code sono le entità.

  Tuttavia, è possibile che un connettore non supporti o non abbia entità, nel qual caso l'elenco Entities sarà vuoto.

• Operazione : un'operazione è l'attività che puoi eseguire su un'entità. Puoi eseguire una delle seguenti operazioni su un'entità:
  • Elenca
  • Scarica
  • Crea
  • Aggiorna
  • Elimina

  Selezionando un'entità dall'elenco disponibile, viene generato un elenco di operazioni disponibili per l'entità. Per una descrizione dettagliata delle operazioni, consulta le operazioni sulle entità dell'attività Connettori. Tuttavia, se un connettore non supporta alcuna delle operazioni sulle entità, queste operazioni non supportate non sono elencate nell'elenco Operations.

• Azione: un'azione è una funzione di prima classe resa disponibile per l'integrazione tramite l'interfaccia del connettore. Un'azione ti consente di apportare modifiche a una o più entità e varia da connettore a connettore. In genere, un'azione ha alcuni parametri di input e un parametro di output. Tuttavia, è possibile che un connettore non supporti alcuna azione, nel qual caso l'elenco Actions sarà vuoto.

Azioni

Questa sezione fornisce informazioni sulle RFC ed elenca le azioni supportate dal connettore. Per capire come configurare le azioni, consulta Esempi di azioni.

Utilizzo delle RFC

Questa sezione fornisce informazioni sulle RFC richieste e sul loro utilizzo.

RFC richieste

Se uno qualsiasi degli RFC richiesti non è disponibile, alcune o tutte le funzionalità potrebbero non funzionare. Il codice T SE37 può essere utilizzato per visualizzare i moduli di funzione disponibili in SAP.

Il connettore SAP ERP utilizza i seguenti RFC.

• DDIF_FIELDINFO_GET
• RFC_GET_FUNCTION_INTERFACE
• RFC_GET_STRUCTURE_DEFINITION
• RFC_GET_SYSTEM_INFO
• RFC_GET_UNICODE_STRUCTURE
• RFC_READ_TABLE
• SLDAG_CHECK_FOR_UNICODE

Lettura di grandi quantità di dati

Questa sezione descrive l'approccio da seguire per leggere grandi quantità di dati dal backend SAP.

Il connettore SAP ERP utilizza la funzione SAP RFC_READ_TABLE per recuperare i dati dalle tabelle SAP, e questa funzione ha una dimensione fissa di 512 byte. Può memorizzare nel buffer ogni riga di dati, quindi non puoi selezionare più colonne di quelle che potrebbero essere contenute in questo buffer. Se selezioni più di 512 byte, si verificherà l'eccezione DATA_BUFFER_EXCEEDED durante l'esecuzione dell'integrazione, a indicare che hai superato la dimensione massima del buffer consentita per riga e devi selezionare meno colonne.

Per risolvere questo problema, puoi includere il codice per un Custom RFC_READ_TABLE, simile al SAP RFC_READ_TABLE, ma con un buffer più grande per risolvere il problema DATA_BUFFER_EXCEEDED.

Utilizzo di una funzione di lettura della tabella personalizzata

Il connettore supporta un Custom RFC_READ_TABLE simile a SAP RFC_READ_TABLE, ma con un buffer più grande in modo da poter risolvere il problema DATA_BUFFER_EXCEEDED.

Crea una RFC_READ_TABLE personalizzata nel backend SAP

Segui i passaggi riportati di seguito per utilizzare la RFC_READ_TABLE personalizzata di esempio.

1. Utilizza la funzione RFC_READ_TABLE come modello per la nuova funzione: seleziona il codice transazione SE37 e il gruppo di funzioni SDTX e copia RFC_READ_TABLE in un nuovo gruppo di funzioni o nel tuo gruppo di funzioni di lavoro. In questo esempio, RFC_READ_TABLE viene copiato in Z_CUSTOM_RFC_TABLE.
2. Nella scheda Attributi della pagina SAP, seleziona Modulo abilitato da remoto.
3. Nella scheda Tabelle, imposta il parametro DATA su CHAR8000 (potresti dover fare clic con il tasto destro del mouse e poi su Visualizza -> Modifica).
4. Nella scheda Codice sorgente, inserisci il codice RFC della tabella di lettura personalizzata. Per riferimento, vedi sample Z_CUSTOM_RFC_TABLE_function.txt.
5. Fai clic su Salva.
6. Definisci le importazioni, le tabelle e le eccezioni come documentato nella tabella di lettura personalizzata fornita.
7. Attiva il modulo della funzione.

Tabella di lettura personalizzata per ABAP 7.52

Se utilizzi ABAP 7.52 o versioni successive, consulta l'esempio Z_CUSTOM_RFC_TABLE_function_ABAP752.txt. La funzione di esempio è progettata per ABAP versione 7.52 e successive. È simile alla funzione Z_CUSTOM_RFC_TABLE, ma sfrutta le parole chiave appena disponibili in ABAP 7.52 per eseguire la paginazione all'interno del database anziché nello script ABAP stesso. In questo modo la paginazione è molto più efficiente e le prestazioni migliorano quando si lavora con tabelle di grandi dimensioni. Ti consigliamo di utilizzare Z_CUSTOM_RFC_TABLE_752 RFC quando possibile.

Accesso alla funzione RFC_READ_TABLE

Questa sezione fornisce informazioni sul ruolo da assegnare a un utente SAP per accedere alla funzione RFC_READ_TABLE. Questa funzione è un modulo funzionale abilitato da remoto che consente l'accesso in lettura generico a tabelle arbitrarie.

Affinché le tabelle vengano elencate in Entità durante la configurazione dell'attività Connettori SAP ERP, devi utilizzare la funzione RFC_READ_TABLE a livello di connessione SAP ERP e autorizzata ad accedere alla funzione R/3 RFC_READ_TABLE

Aggiungi l'autorizzazione S_TABU_DIS per l'attività 03 (visualizzazione) e il gruppo di autorizzazioni "SC" per la funzione RFC_READ_TABLE.

Di seguito sono riportate alcune limitazioni tecniche di RFC_READ_TABLE:

• Possono essere lette solo le tabelle con tipi di dati semplici. Non è previsto il supporto per i campi STRING o XSTRING.
• La larghezza massima della riga è di 512 caratteri.
• Il numero di record restituiti è limitato dalle soglie di memoria.

Azione BAPI_MATERIAL_SAVEDATA

Questa azione ti consente di eseguire attività specifiche. Ad esempio, puoi utilizzarlo per creare o modificare i dati anagrafici dei materiali in SAP ERP.

Parametri di input dell'azione BAPI_MATERIAL_SAVEDATA

Parametri di output dell'azione BAPI_MATERIAL_SAVEDATA

Se l'azione ha esito positivo, viene restituito lo stato 200 (OK).

Per un esempio di come configurare l'azione BAPI_MATERIAL_SAVEDATA, consulta Esempi di azioni.

Azione ZFM_GCP_MULTIDATA_TAB

Questa azione consente agli utenti di svolgere attività specifiche. Ad esempio, puoi creare dati con più tipi di dati in SAP ERP.

Parametri di input dell'azione ZFM_GCP_MULTIDATA_TAB

Parametri di output dell'azione ZFM_GCP_MULTIDATA_TAB

Se l'azione ha esito positivo, viene restituito lo stato 200 (OK).

Per un esempio di come configurare l'azione ZFM_GCP_MULTIDATA_TAB, consulta Esempi di azioni.

Azione PushIDoc

Questa azione ti consente di eseguire attività specifiche. Ad esempio, puoi trasferire i dati da SAP a un sistema esterno.

Parametri di input dell'azione PushIDoc

Parametri di output dell'azione PushIDoc

Se l'azione ha esito positivo, viene restituito lo stato 200 (OK).

Per un esempio di come configurare l'azione PushIDoc, consulta Esempi di azioni.

Azione ExecuteCustomQuery

Questa azione ti consente di eseguire una query personalizzata.

Per creare una query personalizzata:

1. Segui le istruzioni dettagliate per aggiungere un'attività di connettori.
2. Quando configuri l'attività del connettore, seleziona Azioni nel tipo di azione che vuoi eseguire.
3. Nell'elenco Azione, seleziona Esegui query personalizzata, quindi fai clic su Fine.

   

4. Espandi la sezione Input attività e poi segui questi passaggi:
   1. Nel campo Timeout dopo, inserisci il numero di secondi di attesa prima dell'esecuzione della query.

      Valore predefinito: 180 secondi.

   2. Nel campo Numero massimo di righe, inserisci il numero massimo di righe da restituire dal database.

      Valore predefinito: 25.

   3. Per aggiornare la query personalizzata, fai clic su Modifica script personalizzato. Si apre la finestra di dialogo Editor di script.

      

   4. Nella finestra di dialogo Editor di script, inserisci la query SQL e fai clic su Salva.

      Puoi utilizzare un punto interrogativo (?) in un'istruzione SQL per rappresentare un singolo parametro che deve essere specificato nell'elenco parametri di ricerca. Ad esempio, la seguente query SQL seleziona tutte le righe della tabella Employees che corrispondono ai valori specificati per la colonna LastName:

      SELECT * FROM Employees where LastName=?

   5. Se hai utilizzato punti interrogativi nella query SQL, devi aggiungere il parametro facendo clic su + Aggiungi nome parametro per ogni punto interrogativo. Durante l'esecuzione dell'integrazione, questi parametri sostituiscono in sequenza i punti interrogativi (?) nella query SQL. Ad esempio, se hai aggiunto tre punti interrogativi (?), devi aggiungere tre parametri in ordine di sequenza.

      

      Per aggiungere parametri di ricerca:

      1. Nell'elenco Tipo, seleziona il tipo di dati del parametro.
      2. Nel campo Valore, inserisci il valore del parametro.
      3. Per aggiungere più parametri, fai clic su + Aggiungi parametro di query.

Se l'esecuzione va a buon fine, questa azione restituisce lo stato 200 (OK) con un corpo della risposta contenente i risultati della query.

Esempi di azioni

Esempio: creare un record

Questo esempio crea un record di materiale utilizzando l'azione BAPI_MATERIAL_SAVEDATA.

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione BAPI_MATERIAL_SAVEDATA, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
   "HEADDATA": "{\"MATERIAL\":\"000000000000009001\",\"IND_SECTOR\":\"M\",\"MATL_TYPE\":\"HALB\",\"BASIC_VIEW\":\"X\"}",
   "CLIENTDATA" : "{\"MATL_GROUP\":\"00107\",\"BASE_UOM\":\"KG\"}",
   "CLIENTDATAX" : "{\"MATL_GROUP\":\"X\",\"BASE_UOM\":\"X\"}",
   "MATERIALDESCRIPTION" : "{\"LANGU\":\"E\",\"MATL_DESC\":\"Classification Google\"}"
   }

Se l'azione ha esito positivo, il parametro connectorOutputPayload della risposta BAPI_MATERIAL_SAVEDATA dell'attività avrà un valore simile al seguente:

[{
"RETURN_TYPE": "S",
"RETURN_ID": "MM",
"RETURN_NUMBER": 356,
"RETURN_MESSAGE": "The material 9001 has been created or extended",
"RETURN_LOG_NO": "",
"RETURN_LOG_MSG_NO": 0,
"RETURN_MESSAGE_V1": "9001",
"RETURN_FIELD": "",
"RETURN_SYSTEM": "T90CLNT090",
"RESULT_TABLE": null
}]

Esempio: aggiornare un record

Questo esempio aggiorna un record materiale utilizzando l'azione BAPI_MATERIAL_SAVEDATA.

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione BAPI_MATERIAL_SAVEDATA, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
   "HEADDATA": "{\"MATERIAL\":\"000000000000009000\",\"IND_SECTOR\":\"A\",\"MATL_TYPE\":\"FHMI\",\"BASIC_VIEW\":\"X\"}",
   "CLIENTDATA": "{\"MATL_GROUP\":\"013\",\"BASE_UOM\":\"ST\"}",
   "CLIENTDATAX": "{\"MATL_GROUP\":\"X\",\"BASE_UOM\":\"X\"}",
   "MATERIALDESCRIPTION": "{\"LANGU\":\"E\",\"MATL_DESC\":\"Classification Googlecloud\"}"
   }

Se l'azione ha esito positivo, il parametro BAPI_MATERIAL_SAVEDATA della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

[{
"RETURN_TYPE": "S",
"RETURN_ID": "MM",
"RETURN_NUMBER": 356,
"RETURN_MESSAGE": "The material 9000 has been created or extended",
"RETURN_LOG_NO": "",
"RETURN_LOG_MSG_NO": 0,
"RETURN_MESSAGE_V1": "9000",
"RETURN_PARAMETER": "",
"RETURN_ROW": 0,
"RETURN_FIELD": "",
"RETURN_SYSTEM": "T90CLNT090",
"RESULT_TABLE": null
}]

Esempio: elimina un record

Questo esempio elimina un record materiale utilizzando l'azione BAPI_MATERIAL_SAVEDATA.

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione BAPI_MATERIAL_SAVEDATA, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
   "HEADDATA": "{\"MATERIAL\":\"000000000000009000\",\"BASIC_VIEW\":\"X\"}",
   "CLIENTDATA": "{\"DEL_FLAG\":\"X\"}",
   "CLIENTDATAX": "{\"DEL_FLAG\":\"X\"}"
   }

Se l'azione ha esito positivo, il parametro BAPI_MATERIAL_SAVEDATA della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

[{
"RETURN_TYPE": "S",
"RETURN_ID": "MM",
"RETURN_NUMBER": 356,
"RETURN_LOG_NO": "",
"RETURN_LOG_MSG_NO": 0,
"RETURN_MESSAGE_V1": "9000",
"RETURN_PARAMETER": "",
"RETURN_ROW": 0,
"RETURN_FIELD": "",
"RETURN_SYSTEM": "T90CLNT090",
"RESULT_TABLE": null
}]

Esempio: crea dati di più tipi

Questo esempio crea dati di tipo multidata utilizzando l'azione ZFM_GCP_MULTIDATA_TAB.

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione ZFM_GCP_MULTIDATA_TAB, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
   "T_TABLE": "{\"ZACCP\":\"111\",\"ZCHAR\":\"CHARACTER1\",\"ZCLNT\":\"100\",\"ZCUKY\":\"INR\",\"ZCURR\": 200,\"ZDATS\": \"20231213\",\"ZINT1\": 45,\"ZINT2\":54,\"ZDEC\": 0.12,\"ZFLTP\": 1234,\"ZLANG\":\"E\",\"ZNUMC\":\"110\",\"ZPREC\": 3,\"ZQUAN\": 188.0,\"ZRAW\":\"01010008010101050401\",\"ZTIMS\": \"103056\",\"ZUNIT\":\"11\",\"ZINT4P\": 45,\"ZINT4\": 54,\"ZLRAW\":\"0101000801010105040100030101010300040000\"}",
   "IM_INPUT_1": "{\"ZACCP\":\"222\",\"ZCHAR\":\"CHARACTER1\",\"ZCLNT\":\"100\",\"ZCUKY\":\"INR\",\"ZCURR\": 200,\"ZDATS\": \"20231213\",\"ZINT1\": 45,\"ZINT2\":54,\"ZDEC\": 0.12,\"ZFLTP\": 1234,\"ZLANG\":\"E\",\"ZNUMC\":\"110\",\"ZPREC\": 3,\"ZQUAN\": 188.0,\"ZRAW\":\"01010008010101050401\",\"ZTIMS\": \"103056\",\"ZUNIT\":\"11\",\"ZINT4P\": 45,\"ZINT4\": 54,\"ZLRAW\":\"0101000801010105040100030101010300040000\"}",
   "IM_INPUT_2": "{\"ZSTRING\": \"HI Google\",\"ZSSTRING\": \"HI Google How are you\"}"
   }

Se l'azione ha esito positivo, il parametro ZFM_GCP_MULTIDATA_TAB della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

[{
"EX_OUTPUT_1_ZACCP": 222,
"EX_OUTPUT_1_ZCHAR": "CHARACTER1",
"EX_OUTPUT_1_ZCLNT": "100",
"EX_OUTPUT_1_ZCUKY": "INR",
"EX_OUTPUT_1_ZCURR": 200,
"EX_OUTPUT_1_ZDATS": "2023-12-13",
"EX_OUTPUT_1_ZRAW": "01010008010101050401",
"EX_OUTPUT_1_ZTIMS": "10:30:56",
"EX_OUTPUT_1_ZUNIT": "11",
"EX_OUTPUT_1_ZINT4P": 45,
"EX_OUTPUT_1_ZINT4": 54,
"EX_OUTPUT_1_ZLRAW": "0101000801010105040100030101010300040000\u0000",
"EX_OUTPUT_2_ZSTRING": null,
"EX_OUTPUT_2_ZSSTRING": null,
"RESULT_TABLE": null,
"T_TABLE_ZACCP": null,
"T_TABLE_ZCHAR": null,
"T_TABLE_ZCLNT": null,
"T_TABLE_ZQUAN": null,
"T_TABLE_ZRAW": null,
"T_TABLE_ZTIMS": null,
"T_TABLE_ZUNIT": null
},{
"EX_OUTPUT_1_ZACCP": null,
"EX_OUTPUT_1_ZCHAR": null,
"EX_OUTPUT_1_ZCLNT": null,
"EX_OUTPUT_1_ZCUKY": null,
"EX_OUTPUT_1_ZRAW": null,
"T_TABLE_ZLANG": null,
"T_TABLE_ZNUMC": null,
"T_TABLE_ZPREC": null,
"T_TABLE_ZQUAN": null,
"T_TABLE_ZRAW": null,
"T_TABLE_ZTIMS": null,
"T_TABLE_ZUNIT": null
},{
"EX_OUTPUT_1_ZACCP": null,
"EX_OUTPUT_1_ZCHAR": null,
"EX_OUTPUT_1_ZCLNT": null,
"EX_OUTPUT_1_ZCUKY": null,
"EX_OUTPUT_1_ZCURR": null,
"EX_OUTPUT_1_ZDATS": null,
"EX_OUTPUT_1_ZDEC": null,
"EX_OUTPUT_1_ZQUAN": null,
"T_TABLE_ZNUMC": 110,
"T_TABLE_ZPREC": 3,
"T_TABLE_ZQUAN": 188,
"T_TABLE_ZRAW": "01010008010101050401",
"T_TABLE_ZTIMS": "10:30:56",
"T_TABLE_ZUNIT": "11"
}]

Esempio: invio di un IDoc

Questo esempio esegue il push di un IDoc in SAP ERP.

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione PushIDoc, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
   "Content": "\n\n\n EDI_DC40\n 800\n 0000000008604824\n 740\n 53\n 2\n \n MATMAS05\n MATMAS\n ZLS_QA23\n LS\n ZLS_QA23\n SAPSA1\n LS\n SA1CLNT800\n 20230218\n 232556\n\n\n 005\n 000000000000000012\n 20170328\n 42039\n 20170727\n 42039\n KLVC\n FERT\n M\n 02\n BG\n 000\n 002\n 0.000\n 0.000\n KGM\n 0.000\n 0001\n 0.000\n 0.000\n 0.000\n 0.000\n 0.000\n",
   "FileType": "XML",
   "Mode": "ASync"
   }

. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività PushIDoc avrà un valore simile al seguente:

[{
"Result": "Success",
"Message": "Push IDoc success"
}]

Esempi di operazioni sulle entità

Questa sezione mostra come eseguire alcune delle operazioni sulle entità in questo connettore.

Esempio: elencare tutti i record

Questo esempio elenca tutti i record nell'entità T001.

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona T001 dall'elenco Entity.
3. Seleziona l'operazione List, quindi fai clic su Fine.
4. (Facoltativo) Nella sezione Input attività dell'attività Connettori, puoi filtrare il set di risultati specificando una clausola di filtro. Specifica il valore della clausola di filtro sempre tra virgolette singole (').

Esempio: recuperare un record da un'entità

Questo esempio recupera un record con l'ID specificato dall'entità T001.

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona T001 dall'elenco Entity.
3. Seleziona l'operazione Get, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, fai clic su EntityId e poi inserisci 0001 nel campo Valore predefinito.

   In questo caso, 0001 è un ID record univoco nell'entità T001.