SAP ERP

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

Versioni supportate

Il connettore SAP ERP può comunicare con i sistemi SAP R/3 utilizzando i seguenti metodi:

  • Business Application Programming Interface (BAPI)
  • Chiamate di funzioni remote (RFC)
  • Tabelle SAP
  • Query SAP
  • Messaggi IDoc
Sono supportate le connessioni ai seguenti elementi:
  • SAP ECC
  • SAP ERP
  • SAP R/3
  • SAP S/4HANA on-premise
  • Versione JCo di SAP.

    Questo connettore richiede che vengano forniti due file JCo durante la creazione della connessione: sapjco3.jar e libsapjco3.so (per Unix). Puoi scaricare la versione JCo 3.1.5 dal sito di SAP Connectors.

    • Se il sistema SAP supporta una connessione RFC e le RFC richieste sono disponibili, la connessione al sistema SAP funziona. Potrebbero essere supportate anche altre versioni che supportano le connessioni RFC.

I seguenti contenuti SAP sono accessibili dal connettore SAP ERP:

Tabelle SAP:le tabelle SAP vengono esposte automaticamente come viste tramite la proprietà di connessione TableMode. Specifica le tabelle SAP con cui vuoi lavorare utilizzando la proprietà di connessione delle visualizzazioni, che sostituisce TableMode. SAP sconsiglia di modificare direttamente le tabelle. È invece consigliabile utilizzare le BAPI per modificare i dati tabulari. La modifica diretta delle tabelle SAP non è supportata.

BAPI e RFC:le BAPI e le RFC vengono esposte direttamente come procedure memorizzate. Per impostazione predefinita, tutte le RFC che iniziano con la parola chiave BAPI vengono visualizzate come procedure memorizzate disponibili.

IDoc:i file di documenti intermedi (IDoc) sono oggetti SAP che trasferiscono i dati delle transazioni aziendali da un sistema all'altro sotto forma di messaggio elettronico. Gli IDoc trasferiscono i dati da SAP a sistemi non SAP tramite sistemi EDI (Electronic Data Interchange).

Per ulteriori informazioni su questi termini, consulta il glossario SAP.

Prima di iniziare

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

  • Nel tuo progetto Google Cloud:
    • Assicurati che la connettività di rete sia configurata. Per informazioni sui pattern di rete, consulta Connettività di rete.
    • Concedi il ruolo IAM roles/connectors.admin all'utente che configura il 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 un utente "non umano" che deve eseguire l'autenticazione ed essere autorizzato ad accedere ai dati nelle API Google. Se non hai un account di servizio, devi crearne uno. Per maggiori informazioni, consulta Creare un account di servizio.

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

      Per informazioni su come attivare i servizi, consulta Abilitazione dei servizi.

    Se questi servizi o autorizzazioni non sono stati attivati in precedenza per il tuo progetto, ti verrà chiesto di attivarli durante la configurazione del connettore.

Configura il connettore

Per configurare il connettore devi creare una connessione all'origine dati (sistema di backend). Una connessione è specifica per un'origine dati. Ciò significa che se hai molte origini dati, devi creare una connessione distinta per ciascuna. Per creare una connessione:

  1. Nella console Cloud, vai alla pagina Connettori di integrazione > Connessioni, quindi seleziona o crea un progetto Google Cloud.

    Vai alla pagina Connessioni

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

      Per l'elenco di tutte le regioni supportate, consulta Località.

    2. Fai clic su Avanti.
  4. Nella sezione Dettagli connessione, completa quanto segue:
    1. Connettore: seleziona SAP ERP dall'elenco a discesa dei connettori disponibili.
    2. Versione del 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 49 caratteri.
      • Per i connettori che supportano la sottoscrizione agli eventi, i nomi delle connessioni non possono iniziare con il prefisso "goog".
    4. (Facoltativo) Inserisci una Descrizione per la connessione.
    5. Se vuoi, attiva Cloud Logging e poi seleziona un livello di log. Per impostazione predefinita, il livello di log è impostato su Error.
    6. Account di servizio: seleziona un account di servizio con i ruoli richiesti.
    7. Per utilizzare la connessione per le sottoscrizioni agli eventi, seleziona Attiva sottoscrizione eventi. Se la selezioni, vengono visualizzate le seguenti opzioni:
      • Attiva sottoscrizione eventi con entità e azioni: seleziona questa opzione per utilizzare la connessione sia per le sottoscrizioni agli eventi sia per le operazioni del connettore (entità e azioni).
      • Attiva solo la sottoscrizione agli eventi: seleziona questa opzione per utilizzare la connessione solo per la sottoscrizione agli eventi. Se selezioni questa opzione, fai clic su Avanti, quindi su configura l'iscrizione agli eventi.
    8. Client: il client che si autentica nel sistema SAP.
    9. ID sistema: l'ID 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 sistema: il numero con cui è definito il sistema di destinazione. Utilizzato per impostare la proprietà Connessione host.
    11. ID progetto: l'ID del progetto Google Cloud in cui si trova il bucket GCS contenente il file jar SAP JCo.
    12. Bucket: il nome del bucket contenente i file sapjco3.jar e libsapjco3.so.
    13. ID oggetto del file jar di Jaco: ID oggetto del file jar di JCo.
    14. ID oggetto libsapjco3: ID oggetto del file jar libsapjco3.
    15. Modalità tabella: seleziona la tabella SAP da visualizzare 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 memorizza 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 valore viene normalmente 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: il nome della funzione da utilizzare per leggere le tabelle. Per ulteriori informazioni, consulta Utilizzare una funzione di lettura della tabella personalizzata.
    21. Schema di connessione: seleziona uno schema di connessione da utilizzare per la connessione al sistema SAP.
    22. ID sistema: l'ID sistema o il nome R3 del sistema SAP. Puoi inserire un massimo di 3 caratteri.
    23. Passcode SNC: seleziona il segreto Secret Manager del passcode della libreria SNC.
    24. Versione del secret: seleziona la versione del secret.
    25. Modalità SNC: seleziona questa opzione per attivare 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 dell'SNC del server delle applicazioni.
    29. Modalità query: seleziona le tabelle SAP da visualizzare come visualizzazioni.
    30. Viste sfogliabili: inserisci un elenco separato da virgole delle viste da visualizzare. Ad esempio, ViewA,ViewB,ViewC.
    31. Livello di dettaglio: inserisci il livello di dettaglio per il logging. I valori supportati vanno da 1 a 5. Un valore più alto indica che nei log saranno disponibili più dettagli.
    32. (Facoltativo) 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, al contrario, sono necessari meno nodi per elaborare meno transazioni. Per capire 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 maggiore disponibilità) e il numero massimo di nodi è impostato su 50.

    33. Se vuoi, fai clic su + AGGIUNGI ETIQUETTA 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 Allegato endpoint dall'elenco, quindi seleziona l'allegato endpoint richiesto dall'elenco Allegato endpoint.

      Se vuoi stabilire una connessione pubblica ai tuoi sistemi di backend con una maggiore sicurezza, puoi configurare indirizzi IP di uscita statici per le connessioni e poi configurare le regole del firewall in modo da 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 capire come configurare questi tipi di autenticazione, consulta Configurare l'autenticazione.

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

Configura autenticazione

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

  • Nome utente e password
    • Nome utente: nome utente per il connettore
    • Password: il segreto Secret Manager contenente la password associata al connettore.

Configurazione per l'iscrizione agli eventi

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

  1. Seleziona uno dei seguenti tipi di autenticazione per l'ascoltatore di eventi.
  2. Inserisci il nome del campo del tipo di evento. Questo campo identifica il tipo di evento associato alla richiesta di evento in arrivo. 
    {
"event_type": "user.created",
...
// other request fields
...
}
  3. Seleziona Attiva la connettività privata per la connettività sicura tra l'applicazione di backend e la connessione. Se selezioni questa opzione, devi eseguire alcuni passaggi di configurazione aggiuntivi dopo aver creato la connessione. Per ulteriori informazioni, consulta Connettività privata per l'iscrizione agli eventi.
  4. Inserisci la configurazione dei messaggi non recapitabili. Se configuri la posta in arrivo, 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 delle connessioni

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à voci 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.
  • Server di messaggi: imposta questa proprietà sul valore ottenuto dalla proprietà MessageServer. Se nella casella SAProuter è specificato un valore, anteponilo al valore della proprietà della stringa di connessione MessageServer. La proprietà MessageServer deve essere specificata quando ci si connette a un sistema SAP utilizzando il bilanciamento del carico.
  • Gruppo: imposta questa proprietà sul valore ottenuto dalla proprietà Gruppo/Server. La proprietà Gruppo 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 del nome R3 del sistema SAP. L'ID sistema è una stringa con un massimo di tre caratteri.
  • Host: specifica il valore ottenuto dal server di applicazioni.

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

  • Numero 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à voci di sistema.

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

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

  • SNC PartnerName: SNC PartnerName specifica il nome SNC del server di 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 per la connessione venga utilizzato il nome SNC corretto.
  • 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à) della 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 del file della libreria SNC. Specifica il percorso completo della libreria di sicurezza in uso, ad esempio C:\Secude\secude.xll.

Tipo di connessione ApplicationServer

Per la connettività del server di 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 istanza del sistema SAP utilizzato. La seguente tabella elenca i valori di configurazione di esempio per il tipo di connessione ApplicationServer. Per conoscere i campi obbligatori e facoltativi, consulta l'interfaccia di creazione della connessione nella console.

Nome campo Valore di esempio
Regione us-central1
Connettore SAP ERP
Versione del connettore 1
Nome connettore saperp-applicationserver-conn
Descrizione NA
Account di servizio xxxxxxxxx-compute@developer.gserviceaccount.com
Client 800
Numero di sistema 00
ID progetto xxxx-gcp-project
Bucket sap-erp-bucket
ID oggetto JCO Jar sapjco3.jar
ID oggetto libsapjco3 libsapjco3.so
Modalità da tavolo TransparentApplication/TransparentCustomer/TransparentSystem/Pooled/Cluster/None
Leggi funzione tabella Z_CUSTOM_READ_TABLE
Schema di connessione ApplicationServer
ID sistema SA1
Modalità query NA
Visualizzazioni sfogliabili NA
Livello di verbosità 5
Numero minimo di nodi 2
Numero massimo di nodi 50
Indirizzo host 10.30.X.XX o stringa del router di un sistema SAP esterno.
Autenticazione Password utente
Nome utente 12345
Password xyz@12345
versioni 1

Tipo di connessione GroupServer

Per la connettività del bilanciamento del carico/del server di gruppo, 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 istanza del sistema SAP utilizzato. La seguente tabella elenca i valori di configurazione di esempio per il tipo di connessione GroupServer. Fai riferimento all'interfaccia di creazione della connessione nella console per conoscere i campi obbligatori e facoltativi.

Nome campo Valore di esempio
Regione us-central1
Connettore SAP ERP
Versione del connettore 1
Nome connettore saperp-GroupServer-conn
Descrizione NA
Account di servizio xxxxxxxxx-compute@developer.gserviceaccount.com
Client 800
Numero di sistema 00
ID progetto xxxx-gcp-project
Bucket sap-erp-bucket
ID oggetto JCO Jar sapjco3.jar
ID oggetto libsapjco3 libsapjco3.so
Modalità da tavolo TransparentApplication/TransparentCustomer/TransparentSystem/Pooled/Cluster/None
Gruppo PUBBLICO
Server di messaggistica 10.30.X.XX
Leggi funzione tabella Z_CUSTOM_READ_TABLE
Schema di connessione GroupServer
ID sistema SA1
Modalità query NA
Visualizzazioni sfogliabili NA
Livello di verbosità 5
Numero minimo di nodi 2
Numero massimo di nodi 50
Indirizzo host 10.30.X.XX o stringa del router del sistema SAP esterno.
Autenticazione Password utente
Nome utente 12345
Password xyz@12345
versioni 1

Tipo di connessione del certificato X509

Per le comunicazioni di rete sicure (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 controllo di integrità. dove XX è il numero di sistema o 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.

Nome campo Valore di esempio
Regione us-central1
Connettore SAP ERP
Versione del connettore 1
Nome connettore saperp-X509Certificate-conn
Descrizione NA
Account di servizio xxxxxxxxx-compute@developer.gserviceaccount.com
Client 800
Numero di sistema 00
ID progetto xxxx-gcp-project
Bucket sap-erp-bucket
ID oggetto JCO Jar sapjco3.jar
ID oggetto libsapjco3 libsapjco3.so
Modalità da tavolo TransparentApplication/TransparentCustomer/TransparentSystem/Pooled/Cluster/None
ID oggetto SNC_LIB libsapcrypto.so
Nome PSE per creare il file cred_v2 EHP8_GCP_SA1.pse
Leggi funzione tabella Z_CUSTOM_READ_TABLE
Schema di connessione ApplicationServer
ID sistema SA1
Passcode SNC xyz@gcp
Modalità SNC Un valore booleano che determina se utilizzi SNC. Imposta il valore true per utilizzare SNC.
Nome SNC 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
Modalità query NA
Visualizzazioni sfogliabili NA
Livello di verbosità 5
Numero minimo di nodi 2
Numero massimo di nodi 50
Indirizzo host 10.30.X.XX o stringa del router del sistema SAP esterno.
Autenticazione Autenticazione basata su certificati X509
X509Certificate Il certificato X509 può essere specificato utilizzando un percorso file che rimandi a un file contenente un certificato X509 in formato PEM, un blob PEM che inizia con l'intestazione "-----BEGIN ..." o un blob PEM senza l'intestazione "-----BEGIN ...".
versioni 1

Limitazioni del sistema

Il connettore SAP ERP può elaborare 7 transazioni al secondo per nodo e limita le transazioni che superano questo limite. Per impostazione predefinita, Integration Connectors alloca 2 nodi (per una maggiore disponibilità) per una connessione.

Per informazioni sui limiti applicabili a Integration Connectors, vedi Limiti.

Utilizzare la connessione SAP ERP in un'integrazione

Una volta creata, la connessione diventa disponibile sia nell'Apigee Integration sia nell'Application Integration. Puoi utilizzare la connessione in un'integrazione tramite l'attività Connettori.

  • Per informazioni su come creare e utilizzare l'attività Connectors in Apigee Integration, consulta Attività Connectors.
  • Per informazioni su come creare e utilizzare l'attività Connettori in Application Integration, consulta Attività Connettori.

Entità, operazioni e azioni

Tutti gli Integration Connectors forniscono un livello di astrazione per gli oggetti dell'applicazione collegata. Puoi accedere agli oggetti di un'applicazione solo tramite questa astrazione. L'astrazione 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 collegato. 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 di file server le cartelle sono le entità e in un connettore di 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 su un'entità una delle seguenti operazioni:

    La selezione di un'entità dall'elenco disponibile genera 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 nessuna delle operazioni sulle entità, queste operazioni non supportate non sono elencate nell'elenco Operations.

  • Azione : un'azione è una funzione di prima classe resa disponibile all'integrazione tramite l'interfaccia del connettore. Un'azione ti consente di apportare modifiche a una o più entità e varia da un connettore all'altro. In genere, un'azione avrà 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 e 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 obbligatori

Se uno degli RFCS 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.

Le seguenti RFC vengono utilizzate dal connettore SAP ERP.

  • 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

Leggere dati di grandi dimensioni

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

Il connettore SAP ERP utilizza la funzione SAP RFC_READ_TABLE per recuperare i dati dalle tabelle SAP. Questa funzione ha una dimensione fissa di 512 byte. Può creare un buffer per ogni riga di dati, pertanto non puoi selezionare più colonne di quelle che possono essere inserite in questo buffer. Se selezioni più di 512 byte, verrà visualizzata l'eccezione DATA_BUFFER_EXCEEDED durante l'esecuzione dell'integrazione. Ciò indica che hai superato la dimensione massima del buffer consentita per riga e devi selezionare meno colonne.

Per risolvere il 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 al SAP RFC_READ_TABLE, ma con un buffer più grande in modo da risolvere il problema DATA_BUFFER_EXCEEDED.

Crea una tabella RFC_READ_TABLE personalizzata nel backend SAP

Segui i passaggi riportati di seguito per utilizzare l' RFC_READ_TABLE personalizzato 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, RFC_READ_TABLE viene copiato in Z_CUSTOM_RFC_TABLE.
  2. Nella scheda Attributi della pagina SAP, seleziona Modulo abilitato per il controllo remoto.
  3. Nella scheda Tables (Tabelle), imposta il parametro DATA su CHAR8000 (potrebbe essere necessario fare clic con il tasto destro del mouse e poi su Display -> Modifica).
  4. Nella scheda Codice sorgente, inserisci il codice RFC della tabella di lettura personalizzata. Come riferimento, consulta sample Z_CUSTOM_RFC_TABLE_function.txt.
  5. Fai clic su Salva.
  6. Definisci le importazioni, le tabelle e le eccezioni come descritto 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 7.52 e versioni successive. È simile alla funzione Z_CUSTOM_RFC_TABLE, ma sfrutta le parole chiave di nuova disponibilità 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 migliorano le prestazioni quando si lavora con tabelle di grandi dimensioni. Ti consigliamo di utilizzare Z_CUSTOM_RFC_TABLE_752 RFC, se 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 di funzione abilitato da remoto che consente l'accesso generico in lettura 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 disporre dell'autorizzazione per accedere alla funzione R/3 RFC_READ_TABLE

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

Di seguito sono riportate alcune delle limitazioni tecniche di RFC_READ_TABLE:

  • È possibile leggere solo le tabelle con tipi di dati semplici. I campi FORSTRING o XSTRING non sono supportati.
  • 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 di master dei materiali in SAP ERP.

Parametri di input dell'azione BAPI_MATERIAL_SAVEDATA

Nome parametro Tipo di dati Obbligatorio Descrizione
HEADDATA Stringa Sì Il parametro di input HEADDATA.
CLIENTDATA Stringa Sì Il parametro di input CLIENTDATA.
CLIENTDATAX Stringa Sì Il parametro di input CLIENTDATAX.
MATERIALDESCRIPTION Stringa Sì La tabella MATERIALDESCRIPTION.

Parametri di output dell'azione BAPI_MATERIAL_SAVEDATA

Questa azione restituisce lo stato 200 (OK) se l'azione è riuscita.

Ad esempio, per scoprire come configurare l'azione BAPI_MATERIAL_SAVEDATA, consulta Esempi di azioni.

Azione ZFM_GCP_MULTIDATA_TAB

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

Parametri di input dell'azione ZFM_GCP_MULTIDATA_TAB

Nome parametro Tipo di dati Obbligatorio Descrizione
ReturnTables Stringa Sì Un elenco separato da virgole che specifica le tabelle del modulo della funzione da output. Se non specificato, verranno stampate tutte le tabelle restituite.
T_TABLE Stringa Sì La tabella T_TABLE.
IM_INPUT_1 Stringa Sì Il parametro di input IM_INPUT_1.
IM_INPUT_2 Stringa Sì Il parametro di input IM_INPUT_2.

Parametri di output dell'azione ZFM_GCP_MULTIDATA_TAB

Questa azione restituisce lo stato 200 (OK) se l'azione è riuscita.

Ad esempio, per scoprire 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

Nome parametro Tipo di dati Obbligatorio Descrizione
FileType Stringa Sì Il tipo di file.I valori consentiti sono XML, IDoc.
Modalità Stringa Sì La modalità di trasferimento.I valori consentiti sono Sync, ASync.
Contenuti Stringa Sì Contenuti del file.

Parametri di output dell'azione PushIDoc

Questa azione restituisce lo stato 200 (OK) se l'azione è riuscita.

Ad esempio, per scoprire 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 e poi fai clic su Fine.

    immagine che mostra l'azione di esecuzione di query personalizzate immagine che mostra l'azione di esecuzione di query personalizzate

  4. Espandi la sezione Input attività ed esegui i seguenti 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.

      immagine che mostra la query SQL personalizzata immagine che mostra la query SQL personalizzata

    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 modo sequenziale i punti interrogativi (?) nella query SQL. Ad esempio, se hai aggiunto tre punti di domanda (?), devi aggiungere tre parametri in ordine di sequenza.

      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.

In caso di esecuzione riuscita, questa azione restituisce lo stato 200 (OK) con un corpo di risposta contenente i risultati della query.

Esempi di azioni

Esempio: crea un record

Questo esempio crea un record del 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 e poi 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\"}"
}

    4. Se l'azione ha esito positivo, il parametro risposta connectorOutputPayload della task 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: aggiorna un record

Questo esempio aggiorna un record del 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 e poi 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\"}"
}

    4. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task 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

Questo esempio elimina un record del 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 e poi 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\"}"
}

    4. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task 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: crea dati con più tipi di dati

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 e poi 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\"}"
}

    4. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task 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: invia un IDoc

Questo esempio spinge un IDoc in SAP ERP.

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione PushIDoc e poi 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"
}

    4. . Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task 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: elenca 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 e poi fai clic su Fine.
  4. Se vuoi, nella sezione Input dell'attività dell'attività Connettori, puoi filtrare il set di risultati specificando una clausola di filtro. Specifica sempre il valore della clausola di filtro tra virgolette singole (').

Esempio: ottieni 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 e poi fai clic su Fine.
  4. Nella sezione Input dell'attività dell'attività Connettori, fai clic su EntityId e poi inserisci 0001 nel campo Valore predefinito.

    Qui, 0001 è un ID record univoco nell'entità T001.

Utilizzare Terraform per creare connessioni

Puoi utilizzare la risorsa Terraform 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 una connessione, consulta il modello di esempio.

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

Nome parametro Tipo di dati Obbligatorio Descrizione
client STRING Vero Il client che si autentica nel sistema SAP.
gruppo STRING Falso Il gruppo di accesso utilizzato. In genere, questo valore deve essere specificato solo quando ci si connette a un sistema SAP che utilizza il bilanciamento del carico.
message_server STRING Falso Il server di messaggi deve essere specificato quando ci si connette a un sistema SAP che utilizza il bilanciamento del carico.
read_table_function STRING 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 STRING Falso L'ID sistema o il nome R3 del sistema SAP è una stringa con un massimo di tre caratteri. Viene spesso utilizzato nelle connessioni di bilanciamento del carico.
system_number STRING Vero Il numero con cui è definito il sistema di destinazione. Utilizzato per impostare la proprietà Connessione host.
project_id STRING Vero L'ID del progetto Google Cloud in cui si trova il bucket Cloud Storage contenente il file jar SAP JCo.
bucket STRING Vero Il nome del bucket contenente i file sapjco3.jar e libsapjco3.so
sapjco3_jar STRING Vero L'ID oggetto per sapjco3.jar
libsapjco3_so STRING Vero L'ID oggetto per libsapjco3.so
snc_lib STRING Falso L'ID oggetto per la raccolta SNC
snc_mode BOOLEANO Falso Un valore booleano che determina se utilizzi SNC. Imposta il valore true per utilizzare SNC.
snc_name STRING Falso Un input 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 STRING Falso Il nome SNC del server delle applicazioni. Si tratta di un input obbligatorio quando si utilizza SNC.
query_mode ENUM Falso Determina quali tabelle SAP verranno visualizzate come visualizzazioni, se presenti. I valori supportati sono: Global, Local, All, None
table_mode ENUM Falso Determina quali tabelle SAP verranno visualizzate come visualizzazioni, se presenti. I valori supportati sono: TransparentApplication, TransparentCustomer, TransparentSystem, Pooled, Cluster, All, None
livello di dettaglio STRING Falso Il livello di dettaglio per la connessione varia da 1 a 5. Un livello di dettagli più elevato registrerà tutti i dettagli della comunicazione (richiesta,risposta e certificati SSL).

Risoluzione dei problemi di configurazione di SAP on-premise

Se il sistema SAP è on-premise, devi creare un bilanciatore del carico del proxy con NEG ibrida.

  1. Crea un tunnel IPSec tra il sistema on-premise e Google Cloud con sottoreti consentite.
  2. Consenti la subnet di bilanciamento del carico e la subnet proxy nei firewall on-premise.
  3. Aggiungi tutte le porte richieste, ad esempio 33XX per la connessione al server di applicazioni, 36XX per la connessione al server di messaggi/server LB e 48XX per la connessione SNC-X509. dove XX è il numero di sistema o istanza del sistema SAP. Aggiungi l'IP richiesto per il firewall nell'elenco consentiti per l'ingresso del progetto Google Cloud, ad esempio l'IP e la porta del bilanciatore del carico, l'IP e la porta del sistema SAP.
  4. Configura il bilanciatore del carico di rete proxy interno regionale utilizzando un NEG ibrido. Per ulteriori informazioni, consulta Proxy interno regionale LB di rete con connettività NEG ibrida.

Se dopo aver configurato la connettività di rete riscontri un errore simile al seguente,utilizza la soluzione alternativa riportata di seguito per inserire nella lista consentita l'IP dell'attacco all'endpoint.

Initialization of destination SAP--1910584855 failed: Connect from SAP gateway to RFC server failed
connection parameters: TYPE=A DESTINATION=SAP--1910584855 ASHOST=10.128.0.43 SYSNR=00 PCS=1 
LOCATION    SAP-Gateway on host DELVM05S15.bcone.com / sapgw00
ERROR       timeout during allocate
TIME        Wed Apr  3 17:24:40 2024
RELEASE     754
COMPONENT   SAP-Gateway
VERSION     2
RC          242
MODULE      D:/depot/bas/754_REL/src/krn/si/gw/gwr3cpic.c
LINE        2208
DETAIL      no connect of TP sapdp00 from host 10.128.0.43 after 20 sec

COUNTER     2
Soluzione alternativa: aggiungi l'IP dell'attacco dell'endpoint di rete del connettore che hai creato in Google Cloud in gw/alternative_hostnames a livello di profilo SAP.

Glossario SAP

SAP: il termine SAP è un termine generico per tutte le versioni SAP supportate. In genere, indica la versione SAP ECC 6 o successive. Affinché il connettore SAP ERP funzioni, è necessaria una connessione a una versione di SAP che supporti l'SDK RFC.

Modulo funzione:un modulo funzione è un tipo di programma o funzione in SAP che può essere utilizzato per eseguire quasi qualsiasi operazione. Questi moduli possono essere testati e scritti in SAP tramite il codice T SE37.

RFC: una chiamata di funzione remota (RFC) è una chiamata a un determinato RFM/FM che può essere eseguita da applicazioni esterne. Ciò include l'utilizzo di librerie distribuite da SAP installate sul server SAP e che possono essere scaricate anche da sap.com. È possibile o meno mantenere RFM specifici durante gli upgrade di SAP. Esistono modelli RFM standard forniti da SAP, che potrebbero avere differenze o non essere presenti nelle versioni precedenti. I modelli RFM personalizzati possono (e spesso vengono) creati per supportare le integrazioni e devono essere gestiti dal cliente SAP. Per convenzione, i valori RFM personalizzati iniziano con la lettera Z.

BAPI: un'API aziendale (BAPI) è un metodo API di un oggetto aziendale che a sua volta è un modulo funzionale abilitato per RFC di SAP per fornire l'accesso alle operazioni di logica aziendale. Ad esempio, esistono circa 60 BAPI correlate esclusivamente all'oggetto Cliente. In pratica, di solito ne vengono utilizzati solo alcuni.

Tabella SAP: una tabella SAP è una tabella che memorizza i dati in SAP. Non sono gli stessi oggetti aziendali. Ad esempio, in SAP non esiste una tabella Ordine di acquisto. Esistono invece molte tabelle che includono i dati degli ordini di acquisto, ad esempio EBAN, EBKN, EINA, EKPO e così via. Per convenzione, le tabelle personalizzate iniziano con la lettera Z.

Query SAP:una query SAP è un oggetto salvato in SAP che fornisce informazioni dettagliate da recuperare da una o più tabelle. In genere vengono utilizzati per la generazione di report.

Ricevere assistenza dalla community Google Cloud

Puoi pubblicare le tue domande e discutere di questo connettore nella community Google Cloud ai forum di Cloud.

Passaggi successivi