ERP SAP

Il connettore SAP ERP consente di eseguire operazioni di inserimento, eliminazione, aggiornamento e lettura sui dati SAP ERP.

Prima di iniziare

Prima di utilizzare il connettore SAP ERP, esegui le seguenti attività:

  • Nel tuo progetto Google Cloud:
    • Concedi il ruolo IAM roles/connectors.admin all'utente. configurazione del connettore.
    • Concedi i seguenti ruoli IAM all'account di servizio che vuoi utilizzare per il connettore:
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor
      • roles/storage.objectViewer

      Un account di servizio è un tipo speciale di Account Google destinato a rappresentare una persona non umana utente che deve autenticarsi e avere l'autorizzazione ad accedere ai dati nelle API di Google. Se non hai un account di servizio, devi crearne uno. Per maggiori informazioni le informazioni, vedi Creazione di un account di servizio.

    • Attiva i seguenti servizi:
      • secretmanager.googleapis.com (API Secret Manager)
      • connectors.googleapis.com (API Connectors)

      Per informazioni su come abilitare i servizi, vedi Attivazione dei servizi.

    Se questi servizi o autorizzazioni non sono stati abilitati in precedenza per il tuo progetto, ti viene chiesto di abilitarli durante la configurazione del connettore.

Configura il connettore

Per configurare il connettore è necessario creare una connessione al tuo origine dati (sistema di backend). Una connessione è specifica per un'origine dati. it significa che se hai molte origini dati, devi creare una connessione separata per ogni origine dati. Per creare una connessione:

  1. Nella console Cloud, vai a Connettori di integrazione > Pagina Connessioni e poi selezionare o creare un progetto Google Cloud.

    Vai alla pagina Connessioni

  2. Fai clic su + Crea nuova per aprire la pagina Crea connessione.
  3. Nella sezione Posizione, scegli la località per la connessione.
    1. Regione: seleziona una località dall'elenco a discesa.

      Per l'elenco di tutte le aree geografiche supportate, consulta la sezione Località.

    2. Fai clic su Avanti.
  4. Nella sezione Dettagli connessione, completa i seguenti passaggi:
      .
    1. Connettore: seleziona SAP ERP dall'elenco a discesa dei connettori disponibili.
    2. Versione connettore: seleziona la versione del connettore dall'elenco a discesa delle versioni disponibili.
    3. Nel campo Nome connessione, inserisci un nome per l'istanza di connessione.

      I nomi delle connessioni devono soddisfare i seguenti criteri:

      • I nomi delle connessioni possono contenere lettere, numeri o trattini.
      • Le lettere devono essere minuscole.
      • I nomi delle connessioni devono iniziare con una lettera e terminare con una lettera o un numero.
      • I nomi delle connessioni non possono contenere più di 63 caratteri.
    4. Facoltativamente, inserisci una descrizione per la connessione.
    5. Facoltativamente, abilita Cloud Logging.
    6. Account di servizio: seleziona un account di servizio con i ruoli richiesti.
    7. Per utilizzare la connessione per le iscrizioni agli eventi, seleziona Attiva la sottoscrizione agli eventi. Selezione vengono visualizzate le seguenti opzioni:
      • Abilita la sottoscrizione agli eventi con entità e azioni: seleziona questa opzione per utilizzare la connessione sia per la sottoscrizione agli eventi sia per le operazioni del connettore (entità e azioni).
      • Attiva solo la sottoscrizione all'evento: seleziona questa opzione per utilizzare la connessione. solo per la sottoscrizione all'evento. Se selezioni questa opzione, fai clic su Avanti e poi configurare la sottoscrizione agli eventi.
    8. Client: il client che esegue l'autenticazione nel sistema SAP.
    9. System Id (ID sistema): l'ID di sistema o R3Name del sistema SAP è una stringa con un massimo di tre caratteri. Viene spesso utilizzato nelle connessioni di bilanciamento del carico.
    10. Numero di sistema: il numero tramite il quale viene definito il sistema di destinazione. Utilizzato quando si imposta la proprietà Connessione all'host.
    11. ID progetto: l'ID del progetto Google Cloud in cui si trova il bucket GCS contenente il jar SAP JCo.
    12. Bucket: il nome del bucket che contiene i file sapjco3.jar e libsapjco3.so.
    13. ID oggetto jar Jaco: ID oggetto del jar JCo.
    14. ID oggetto libsapjco3: ID oggetto del jar libsapjco3.
    15. Modalità tabella: seleziona la tabella SAP da mostrare come visualizzazione.
    16. ID oggetto SNC_LIB: ID oggetto della libreria SNC.
    17. Nome PSE: nome del file PSE (Personal Security Environment) applicabile per il bucket. Un file PSE archivia la coppia di chiavi pubblica e privata, nonché i certificati X.509 in una struttura ASN.1.
    18. Gruppo: il nome del gruppo per l'accesso. Questo viene solitamente specificato quando il sistema SAP utilizza bilanciatori del carico.
    19. Server di messaggi: nome del server di messaggi da utilizzare per la connessione al sistema SAP che utilizza i bilanciatori del carico.
    20. Funzione di lettura della tabella: nome della funzione da utilizzare per la lettura delle tabelle. Per maggiori informazioni informazioni, consulta Utilizzare una funzione di tabella di lettura personalizzata.
    21. Schema di connessione: seleziona uno schema di connessione da utilizzare per la connessione al sistema SAP.
    22. System ID (ID sistema): l'ID di sistema o il nome R3Name del sistema SAP. Puoi inserire un massimo di 3 caratteri.
    23. Passcode SNC: seleziona il secret di Secret Manager del passcode della libreria SNC.
    24. Versione secret: seleziona la versione del secret.
    25. Modalità SNC: seleziona questa opzione per abilitare SNC per l'autenticazione tra Integration Connectors e il sistema SAP.
    26. Nome SNC: inserisci un nome per la connessione SNC.
    27. SNC qop: seleziona un livello di protezione. Di seguito sono riportati i livelli supportati:
      • 1 - Applica solo l'autenticazione.
      • 2 - Applica la protezione dell'integrità. È inclusa anche la protezione dell'autenticazione.
      • 3 - Applica la protezione della privacy. Sono incluse anche la protezione dell'integrità e dell'autenticazione.
      • 8 - Applica la protezione predefinita.
      • 9 - Applica la massima protezione.
    28. Nome partner SNC: inserisci il nome SNC del server di applicazioni.
    29. Modalità query: seleziona le tabelle SAP da mostrare come viste.
    30. Visualizzazioni sfogliabili: inserisci un elenco separato da virgole di viste da mostrare. Ad esempio, ViewA,ViewB,ViewC.
    31. Livello di dettaglio: inserisci il livello di dettaglio per il logging. Lo strumento sono compresi tra 1 e 5. Un valore più alto indica che saranno disponibili più dettagli nei log.
    32. Facoltativamente, configura le impostazioni del nodo di connessione:

      • Numero minimo di nodi: inserisci il numero minimo di nodi di connessione.
      • Numero massimo di nodi: inserisci il numero massimo di nodi di connessione.

      Un nodo è un'unità (o una replica) di una connessione che elabora le transazioni. Sono necessari più nodi per elaborare più transazioni per una connessione e, per elaborare meno transazioni. Per comprendere in che modo i nodi influiscono sui prezzi dei connettori, consulta Prezzi per i nodi di connessione. Se non inserisci alcun valore, per impostazione predefinita il numero minimo di nodi è impostato su 2 (per una migliore disponibilità) e il numero massimo di nodi è impostato su 50.

    33. Facoltativamente, fai clic su + AGGIUNGI ETICHETTA per aggiungere un'etichetta alla connessione sotto forma di coppia chiave/valore.
    34. Fai clic su Avanti.
  5. Nella sezione Destinazioni, inserisci i dettagli dell'host remoto (sistema di backend) a cui vuoi connetterti.
    1. Tipo di destinazione: seleziona un Tipo di destinazione.
      • Seleziona Indirizzo host dall'elenco per specificare il nome host o l'indirizzo IP della destinazione.
      • Se vuoi stabilire una connessione privata ai tuoi sistemi di backend, seleziona Collegamento endpoint dall'elenco, quindi seleziona il collegamento dell'endpoint richiesto. dall'elenco Allegato endpoint.

      Se vuoi stabilire una connessione pubblica ai tuoi sistemi di backend con maggiore sicurezza, puoi valuta la possibilità di configurare una rete statico in uscita indirizzi IP per le tue connessioni, quindi configura le regole del firewall per inserire nella lista consentita solo gli indirizzi IP statici specifici.

      Per inserire altre destinazioni, fai clic su + Aggiungi destinazione.

    2. Fai clic su Avanti.
  6. Nella sezione Autenticazione, inserisci i dettagli di autenticazione.
    1. Seleziona un Tipo di autenticazione e inserisci i dettagli pertinenti.

      La connessione SAP ERP supporta i seguenti tipi di autenticazione:

      • Nome utente e password

      2. Per informazioni su come configurare questi tipi di autenticazione, consulta l'articolo Configurare l'autenticazione.

    2. Fai clic su Avanti.
  7. Se hai attivato l'iscrizione all'evento, nella pagina di creazione della connessione viene visualizzata la sezione Dettagli abbonamento all'evento. Per comprendere come configurare i dettagli della sottoscrizione agli eventi, consulta Configurare la sottoscrizione all'evento.
  8. Verifica: controlla i dettagli della connessione e dell'autenticazione.
  9. Fai clic su Crea.

Configura l'autenticazione

Inserisci i dettagli in base all'autenticazione che vuoi utilizzare.

  • Nome utente e password
      .
    • Nome utente: nome utente del connettore
    • Password: il secret di Secret Manager contenente la password associata alla proprietà di rete.

Configura per la sottoscrizione agli eventi

Se hai attivato la sottoscrizione all'evento, inserisci i seguenti valori nella Sezione Dettagli abbonamento all'evento:

  1. Seleziona uno dei seguenti tipi di autenticazione per il listener di eventi.
  2. Inserisci il nome del campo del tipo di evento. Questo campo identifica il tipo di evento associato al richiesta di evento in arrivo. 
    {
"event_type": "user.created",
...
// other request fields
...
}
  3. Select Enable private connectivity for secured connectivity between your backend application and your connection. If you select this option, you must perform additional configuration steps after creating the connection. For more information, see Private connectivity for event subscription.
  4. Enter the dead-letter configuration. If you configure dead-letter, the connection writes the unprocessed events to the specified Pub/Sub topic. Enter the following details:
    1. Dead-letter project ID: The Google Cloud project ID where you have configured the dead-letter Pub/Sub topic.
    2. Dead-letter topic: The Pub/Sub topic where you want to write the details of the unprocessed event.

Entities, operations, and actions

All the Integration Connectors provide a layer of abstraction for the objects of the connected application. You can access an application's objects only through this abstraction. The abstraction is exposed to you as entities, operations, and actions.

  • Entity: An entity can be thought of as an object, or a collection of properties, in the connected application or service. The definition of an entity differs from a connector to a connector. For example, in a database connector, tables are the entities, in a file server connector, folders are the entities, and in a messaging system connector, queues are the entities.

    However, it is possible that a connector doesn't support or have any entities, in which case the Entities list will be empty.

  • Operation: An operation is the activity that you can perform on an entity. You can perform any of the following operations on an entity:

    Selecting an entity from the available list, generates a list of operations available for the entity. For a detailed description of the operations, see the Connectors task's entity operations. However, if a connector doesn't support any of the entity operations, such unsupported operations aren't listed in the Operations list.

  • Action: An action is a first class function that is made available to the integration through the connector interface. An action lets you make changes to an entity or entities, and vary from connector to connector. Normally, an action will have some input parameters, and an output parameter. However, it is possible that a connector doesn't support any action, in which case the Actions list will be empty.

System limitations

The SAP ERP connector can process 7 transactions per second, per node, and throttles any transactions beyond this limit. By default, Integration Connectors allocates 2 nodes (for better availability) for a connection.

For information on the limits applicable to Integration Connectors, see Limits.

Connection configuration samples

This section lists the sample values for the various fields that you would configure when creating the connection.

ApplicationServer connection type

The following table lists the sample configuration values for the ApplicationServer connection type. Refer to the connection creation interface in the console to know the mandatory and optional fields.

Field name Sample value
Region us-central1
Connector SAP ERP
Connector Version 1
Connector Name saperp-applicationserver-conn
Description NA
Service Account xxxxxxxxx-compute@developer.gserviceaccount.com
Client 800
System Number 00
Project ID xxxx-gcp-project
Bucket sap-erp-bucket
Jco Jar object ID sapjco3.jar
libsapjco3 object ID libsapjco3.so
Table Mode TransparentApplication/TransparentCustomer/TransparentSystem/Pooled/Cluster/None
Read Table Function Z_CUSTOM_READ_TABLE
Connection Scheme ApplicationServer
System Id SA1
Query Mode NA
Browsable Views NA
Verbosity Level 5
Minimum number of nodes 2
Maximum number of nodes 50
Host Address 10.30.X.XX or Router string of an external SAP system.
Authentication User Password
Username 12345
Password xyz@12345
versions 1

GroupServer connection type

The following table lists the sample configuration values for the GroupServer connection type. Refer to the connection creation interface in the console to know the mandatory and optional fields.

Field name Sample value
Region us-central1
Connector SAP ERP
Connector Version 1
Connector Name saperp-GroupServer-conn
Description NA
Service Account xxxxxxxxx-compute@developer.gserviceaccount.com
Client 800
System Number 00
Project ID xxxx-gcp-project
Bucket sap-erp-bucket
Jco Jar object ID sapjco3.jar
libsapjco3 object ID libsapjco3.so
Table Mode TransparentApplication/TransparentCustomer/TransparentSystem/Pooled/Cluster/None
Group PUBLIC
Message Server 10.30.X.XX
Read Table Function Z_CUSTOM_READ_TABLE
Connection Scheme GroupServer
System Id SA1
Query Mode NA
Browsable Views NA
Verbosity Level 5
Minimum number of nodes 2
Maximum number of nodes 50
Host Address 10.30.X.XX or Router String of External SAP System.
Authentication User Password
Username 12345
Password xyz@12345
versions 1

X509 certificate connection type

The following table lists the sample configuration values for the X509 certificate connection type. Refer to the connection creation interface in the console to know the mandatory and optional fields.

Field name Sample value
Region us-central1
Connector SAP ERP
Connector Version 1
Connector Name saperp-X509Certificate-conn
Description NA
Service Account xxxxxxxxx-compute@developer.gserviceaccount.com
Client 800
System Number 00
Project ID xxxx-gcp-project
Bucket sap-erp-bucket
Jco Jar object ID sapjco3.jar
libsapjco3 object ID libsapjco3.so
Table Mode TransparentApplication/TransparentCustomer/TransparentSystem/Pooled/Cluster/None
SNC_LIB object ID libsapcrypto.so
PSE Name to create cred_v2 file EHP8_GCP_SA1.pse
Read Table Function Z_CUSTOM_READ_TABLE
Connection Scheme ApplicationServer
System Id SA1
SNC passcode xyz@gcp
SNC Mode A boolean determining if you are using SNC. Set this to true to use SNC.
SNC Name p:CN=EHP8_GCP_SA1, OU=IT, O=CSW, C=DE
SNC Qop 3
SNC PartnerName p:CN=SA1, OU=I0020070395, OU=SAP Web AS, O=SAP Trust Community, C=DE
Query Mode NA
Browsable Views NA
Verbosity Level 5
Minimum number of nodes 2
Maximum number of nodes 50
Host Address 10.30.X.XX or Router String of External SAP System.
Authentication X509Certificate Based Authentication
X509Certificate The X509 certificate may be specified using a file path pointing to a file containing an X509 certificate in PEM format, a PEM blob beginning with the "-----BEGIN ..." header, or a PEM blob without the "-----BEGIN ..." header.
versions 1

Actions

This section lists the actions supported by the connector. To understand how to configure the actions, see Action examples.

BAPI_MATERIAL_SAVEDATA action

This action let you perform specific tasks. For example, you can use it to create or change material master data in SAP ERP.

Input parameters of the BAPI_MATERIAL_SAVEDATA action

Parameter Name Data Type Required Description
HEADDATA String Yes The input parameter HEADDATA.
CLIENTDATA String Yes The input parameter CLIENTDATA.
CLIENTDATAX String Yes The input parameter CLIENTDATAX.
MATERIALDESCRIPTION String Yes The table MATERIALDESCRIPTION.

Output parameters of the BAPI_MATERIAL_SAVEDATA action

This action returns the status 200 (OK) if the action is successful.

For example on how to configure the BAPI_MATERIAL_SAVEDATA action, see Action examples.

ZFM_GCP_MULTIDATA_TAB action

This action let users perform specific tasks. For example, you can create multi datatype data in SAP ERP.

Input parameters of the ZFM_GCP_MULTIDATA_TAB action

Parameter Name Data Type Required Description
ReturnTables String Yes A comma separated list that specifies which tables in the function module should be output. If not specified, all returned tables will be output.
T_TABLE String Yes The table T_TABLE.
IM_INPUT_1 String Yes The input parameter IM_INPUT_1.
IM_INPUT_2 String Yes The input parameter IM_INPUT_2.

Output parameters of the ZFM_GCP_MULTIDATA_TAB action

This action returns the status 200 (OK) if the action is successful.

For example on how to configure the ZFM_GCP_MULTIDATA_TAB action, see Action examples.

PushIDoc Action

This action let you perform specific tasks. For example, you can transfer data from SAP to an external system.

Input parameters of the PushIDoc action

Parameter Name Data Type Required Description
FileType String Yes The file type.The allowed values are XML, IDoc.
Mode String Yes The transfer mode.The allowed values are Sync, ASync.
Content String Yes Content of the file.

Output parameters of the PushIDoc action

This action returns the status 200 (OK) if the action is successful.

For example on how to configure the PushIDoc action, see Action examples.

ExecuteCustomQuery action

This action lets you execute a custom query.

To create a custom query, follow these steps:

  1. Follow the detailed instructions to add a connectors task.
  2. When you configure the connector task, in the type of action you want to perform, select Actions.
  3. In the Action list, select Execute custom query, and then click Done.

    image showing execute-custom-query-action image showing execute-custom-query-action

  4. Expand the Task input section, and then do the following:
    1. In the Timeout after field, enter the number of seconds to wait till the query executes.

      Default value: 180 seconds.

    2. In the Maximum number of rows field, enter the maximum number of rows to be returned from the database.

      Default value: 25.

    3. To update the custom query, click Edit Custom Script. The Script editor dialog opens.

      image showing custom-sql-query image showing custom-sql-query

    4. In the Script editor dialog, enter the SQL query and click Save.

      You can use a question mark (?) in a SQL statement to represent a single parameter that must be specified in the query parameters list. For example, the following SQL query selects all rows from the Employees table that matches the values specified for the LastName column: 

      SELECT * FROM Employees where LastName=?

    5. Se hai utilizzato dei punti interrogativi nella query SQL, devi aggiungere il parametro facendo clic su + Aggiungi nome parametro per ciascun punto. 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 sequenziale.

      immagine che mostra add-query-param immagine che mostra add-query-param

      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 è riuscita, questa azione restituisce lo stato 200 (OK) con un corpo della risposta contenente i risultati della query.

    Esempi di azioni

    Esempio: creare un record

    In questo esempio viene creato un record metriale 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 e fai clic su Fine.
    3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload, quindi inserisci un valore simile al seguente nella 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\"}"
}

      4. Se l'azione viene eseguita correttamente, Risposta connectorOutputPayload dell'attività BAPI_MATERIAL_SAVEDATA 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

    In questo esempio viene aggiornato un record metriale 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 e fai clic su Fine.
    3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload, quindi inserisci un valore simile al seguente nella 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\"}"
}

      4. Se l'azione viene eseguita correttamente, Risposta connectorOutputPayload dell'attività BAPI_MATERIAL_SAVEDATA 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: eliminare un record

    In questo esempio viene eliminato un record metriale 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 e fai clic su Fine.
    3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload, quindi inserisci un valore simile al seguente nella Campo Default Value: 
      {
"HEADDATA": "{\"MATERIAL\":\"000000000000009000\",\"BASIC_VIEW\":\"X\"}",
"CLIENTDATA": "{\"DEL_FLAG\":\"X\"}",
"CLIENTDATAX": "{\"DEL_FLAG\":\"X\"}"
}

      4. Se l'azione viene eseguita correttamente, Risposta connectorOutputPayload dell'attività BAPI_MATERIAL_SAVEDATA 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: creare dati di tipi multidati

    Questo esempio crea dati di tipi multidati 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 e fai clic su Fine.
    3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload, quindi inserisci un valore simile al seguente nella 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\"}"
}

      4. Se l'azione viene eseguita correttamente, Risposta connectorOutputPayload dell'attività ZFM_GCP_MULTIDATA_TAB 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: eseguire il push di un documento

    Questo esempio esegue il push di un documento IDoc all'ERP SAP.

    1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
    2. Seleziona l'azione PushIDoc e fai clic su Fine.
    3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload, quindi inserisci un valore simile al seguente nella 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"
}

      4. di Google. Se l'azione viene eseguita correttamente, Risposta connectorOutputPayload dell'attività PushIDoc avrà un valore simile al seguente:

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

    Esempi di operazioni con entità

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

    Esempio: elenca tutti i record

    In questo esempio sono elencati 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 e fai clic su Fine.
    4. Facoltativamente, nella sezione Input attività dell'attività Connettori, puoi filtra il set di risultati specificando una clausola di filtro. Specifica il valore della clausola di filtro sempre tra virgolette singole (').

    Esempio: recupero di un record da un'entità

    Questo esempio ottiene 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 e fai clic su Fine.
    4. Nella sezione Input attività dell'attività Connettori, fai clic su EntityId e quindi inserisci 0001 nel campo Valore predefinito.

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

    Leggere grandi quantità di dati

    Molte volte, il connettore SAP ERP potrebbe dover leggere dati di grandi dimensioni dal backend SAP. Questo descrive l'approccio da seguire per leggere dati di grandi dimensioni.

    Il connettore SAP ERP utilizza la funzione SAP RFC_READ_TABLE per recuperare dati da tabelle SAP, e questa funzione ha una dimensione fissa di 512 byte. Può eseguire il buffering per ogni riga di dati non puoi selezionare un numero di colonne maggiore di quello che rientrerebbe nel buffer. Se selezioni più di 512 byte, si verificherà l'eccezione DATA_BUFFER_EXCEEDED quando esegui l'integrazione; che indica che hai superato il limite massimo dimensione del buffer consentita per riga ed è necessario selezionare meno colonne.

    Per risolvere il problema, puoi includere il codice per una Custom RFC_READ_TABLE, che è simile a SAP RFC_READ_TABLE, ma con un buffer più grande per gestire il DATA_BUFFER_EXCEEDED problema.

    Utilizzo di una funzione di tabella di lettura personalizzata

    Il connettore supporta un elemento Custom RFC_READ_TABLE simile al SAP RFC_READ_TABLE ma ha un buffer più grande può risolvere il problema di DATA_BUFFER_EXCEEDED.

    Crea un oggetto RFC_READ_TABLE personalizzato 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 gruppo di funzioni di lavoro. In questo esempio, il valore RFC_READ_TABLE viene copiato in Z_CUSTOM_RFC_TABLE.
    2. Nella scheda Attributes (Attributi) della pagina SAP, seleziona Remote Enabled Module.
    3. Nella scheda Tabelle, imposta il parametro DATA su CHAR8000 (potrebbe essere necessario fare clic con il tasto destro del mouse e poi fare clic su Display -> Modifica).
    4. Nella scheda Codice sorgente, inserisci il codice RFC della tabella di lettura personalizzata. Come riferimento, vedi l'esempio di funzione 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. Attivare il modulo della funzione.

    Tabella di lettura personalizzata per ABAP 7.52

    Se utilizzi ABAP 7.52 o versioni successive, fai riferimento all'esempio di funzione Z_CUSTOM_RFC_TABLE_function_ABAP752.txt. La funzione di esempio è progettata per ABAP 7.52 e versioni successive. È simile alla funzione Z_CUSTOM_RFC_TABLE, ma sfrutta le nuove parole chiave disponibili in ABAP 7.52 per eseguire l'impaginazione all'interno nel database anziché nello script ABAP stesso. Ciò rende l'impaginazione molto più efficiente e migliora le prestazioni quando si lavora con tabelle di grandi dimensioni. È consigliabile utilizzare Z_CUSTOM_RFC_TABLE_752 RFC quando possibile.

    Utilizzare Terraform per creare connessioni

    Puoi utilizzare il comando Terraform risorsa per creare una nuova connessione.

    Per scoprire come applicare o rimuovere una configurazione Terraform, consulta: Comandi Terraform di base.

    Per visualizzare un modello Terraform di esempio per la creazione di connessioni, vedi il modello di esempio.

    Quando crei questa connessione utilizzando Terraform, devi impostare le seguenti variabili nel file di configurazione di Terraform:

    Nome parametro Tipo di dati Obbligatorio Descrizione
    client STRINGA Vero Il client che esegue l'autenticazione nel sistema SAP.
    gruppo STRINGA Falso Il gruppo di accesso in uso. In genere questo deve essere specificato solo durante la connessione a un sistema SAP che utilizza il bilanciamento del carico.
    message_server STRINGA Falso Il server di messaggi deve essere specificato durante la connessione a un sistema SAP che utilizza il bilanciamento del carico.
    read_table_function STRINGA Falso La funzione da utilizzare per leggere i dati della tabella.
    connection_scheme ENUM Falso Specifica se ti stai connettendo a un sistema SAP con un server di messaggi (GroupServer) o senza (ApplicationServer). I valori supportati sono: ApplicationServer, GroupServer
    system_id STRINGA Falso L'ID sistema o R3Name del sistema SAP è una stringa di massimo tre caratteri. Viene spesso utilizzato nelle connessioni di bilanciamento del carico.
    system_number STRINGA Vero Il numero tramite il quale viene definito il sistema di destinazione. Utilizzato quando si imposta la proprietà Connessione all'host.
    project_id STRINGA Vero L'ID del progetto Google Cloud in cui si trova il bucket Cloud Storage contenente il jar SAP JCo.
    bucket STRINGA Vero Il nome del bucket contenente i file sapjco3.jar e libsapjco3.so
    sapjco3_jar STRINGA Vero L'ID oggetto per sapjco3.jar
    libsapjco3_so STRINGA Vero L'ID oggetto per libsapjco3.so
    snc_lib STRINGA Falso L'ID oggetto per la libreria SNC
    snc_mode BOOLEANO Falso Un valore booleano che determina se stai utilizzando SNC. Imposta questo valore su true per utilizzare SNC.
    snc_name STRINGA Falso Un ingresso facoltativo con il nome della connessione SNC.
    snc_qop ENUM Falso La qualità della protezione per la connessione SNC.I valori validi sono 1, 2, 3, 8 o 9, che corrispondono ai seguenti livelli di protezione: 1 Applica solo l'autenticazione. 2 Applica la protezione dell'integrità (autenticazione). 3 Applica la protezione della privacy (integrità e autenticazione). 8 Applica la protezione predefinita. 9 Applica la massima protezione. I valori supportati sono: 1, 2, 3, 8, 9
    snc_partner_name STRINGA Falso Il nome SNC del server delle applicazioni. Questo è un input obbligatorio quando si utilizza SNC.
    query_mode ENUM Falso Determina quali tabelle SAP verranno visualizzate come viste, se presenti. I valori supportati sono: Globale, Locale, Tutti, Nessuno
    table_mode ENUM Falso Determina quali tabelle SAP verranno visualizzate come viste, se presenti. I valori supportati sono: TransparentApplication, TransparentCustomer, TransparentSystem, Pooled, Cluster, Tutti, None
    livello di dettaglio STRINGA Falso Il livello di dettaglio per la connessione varia da 1 a 5. Con un livello di dettaglio più elevato, verranno registrati tutti i dettagli della comunicazione (certificati di richiesta, risposta e SSL).

    Utilizzare la connessione SAP ERP in un'integrazione

    Dopo aver creato la connessione, questa diventa disponibile in Apigee Integration e Application Integration. Puoi usare la connessione in un'integrazione tramite l'attività Connettori.

    • Per capire come creare e utilizzare l'attività Connectors in Apigee Integration, vedi Attività connettori.
    • Per capire come creare e utilizzare l'attività Connettori in Application Integration, vedi Attività connettori.

    Ricevi assistenza dalla community Google Cloud

    Puoi pubblicare le tue domande e discutere di questo connettore in Google Cloud community presso i forum Cloud.

    Passaggi successivi