ERP SAP

Il connettore SAP ERP 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:

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

    Questo connettore richiede 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 dei connettori SAP.

  • Se il sistema SAP supporta una connessione RFC e sono disponibili gli RFC richiesti, 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 su cui vuoi lavorare utilizzando la proprietà di connessione 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 stored procedure disponibile.

IDoc: i file Intermediate Document (IDoc) sono oggetti SAP che trasportano dati sulle 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:
    • 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 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 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 attivati in precedenza per il tuo progetto, ti verrà chiesto di attivarli 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. 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 nuova 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. Facoltativamente, abilita 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. 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 agli eventi: seleziona questa opzione per utilizzare la connessione solo per la sottoscrizione agli eventi. 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. 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 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 contenente 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 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 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: 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. System ID (ID sistema): l'ID di sistema o il valore R3Name 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 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 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. I valori supportati vanno da 1 a 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, al contrario, meno nodi 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. 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 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 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.

    3. 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. 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 secret di Secret Manager contenente la password associata alla proprietà di rete.

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 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. Seleziona Abilita connettività privata per una connettività sicura tra la tua 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 i 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 delle connessioni

Le seguenti sezioni elencano i valori di esempio per le varie 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. L'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 di 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.
  • Group: imposta questa proprietà sul valore ottenuto dalla proprietà Group/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 del nome R3 del sistema SAP. L'ID sistema è una stringa con un massimo di tre caratteri.
  • Host: specifica il valore ottenuto dal server delle applicazioni.

    Questo specifica il nome host del sistema di destinazione. Questo valore può essere un normale nome host, un indirizzo IP o un indirizzo 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 Secure Network Communication (SNC), è necessario impostare le seguenti proprietà aggiuntive. Dal sistema SAP, puoi ottenere le seguenti proprietà della stringa di connessione SNC nella scheda Network della finestra di dialogo Proprietà voce 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.

  • Nome partner SNC: Nome partner SNC 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 Secure Network Settings (Impostazioni 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, per questa proprietà viene impostato il numero 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 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 di 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 ERP SAP
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à Tabella TransparentApplication/TransparentCustomer/TransparentSystem/Pooled/Cluster/None
Leggi funzione tabella Z_CUSTOM_READ_TABLE
Schema di connessione ApplicationServer
ID sistema SA1
Modalità di query NA
Visualizzazioni sfogliabili NA
Livello di dettaglio 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 di 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 ERP SAP
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à Tabella TransparentApplication/TransparentCustomer/TransparentSystem/Pooled/Cluster/None
Gruppo PUBBLICO
Server di messaggi 10.30.X.XX
Leggi funzione tabella Z_CUSTOM_READ_TABLE
Schema di connessione GroupServer
ID sistema SA1
Modalità di query NA
Visualizzazioni sfogliabili NA
Livello di dettaglio 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 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 del sistema SAP e la porta 48XX nel gruppo di endpoint di rete (NEG) e il 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. 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 ERP SAP
Versione del connettore 1
Nome connettore saperp-X509Certificato-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à Tabella TransparentApplication/TransparentCustomer/TransparentSystem/Pooled/Cluster/None
ID oggetto SNC_LIB libsapcrypto.so
Nome PSE per creare il file cred_v2 EHP8_GCP_SA1.pse
Lettura 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 stai utilizzando SNC. Imposta il valore true per utilizzare SNC.
Nome SNC p:CN=EHP8_GCP_SA1, OU=IT, O=CSW, C=DE
SNC Qop 3
Nome partner SNC p:CN=SA1, OU=I0020070395, OU=SAP Web AS, O=SAP Trust Community, C=DE
Modalità di query NA
Visualizzazioni sfogliabili NA
Livello di dettaglio 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 rimanda a un file contenente un certificato X509 in formato PEM, un blob PEM che inizia con "-----BEGIN ..." o un blob PEM senza "-----BEGIN ..." intestazione.
versioni 1

Limitazioni di sistema

Il connettore SAP ERP può elaborare 7 transazioni al secondo, per nodo, e limita qualsiasi transazione oltre questo limite. Per impostazione predefinita, Integration Connectors alloca due nodi (per una migliore 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'integrazione Apigee sia nell'integrazione delle applicazioni. Puoi utilizzare 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.

Entità, operazioni e azioni

Tutti i connettori di integrazione forniscono un livello di astrazione per gli oggetti l'applicazione connessa. Puoi accedere agli oggetti di un'applicazione solo tramite questa astrazione. L'astrazione ti viene esposta sotto forma di 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à differisce da un connettore di rete. Ad esempio, in un connettore di database, le tabelle sono le entità, connettore 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 disponga di entità. In questo 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 operazioni di entity. Tuttavia, se un connettore non supporta nessuna delle operazioni relative all'entità, come quelle non supportate operazioni 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 consente di apportare modifiche a una o più entità variano da connettore a connettore. Normalmente, un'azione ha alcuni parametri di input e un output . Tuttavia, è possibile che un connettore non supporta 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 di RFC

Questa sezione fornisce informazioni sugli RFC richiesti e sull'utilizzo di questi ultimi.

RFC obbligatori

Se uno degli RFCS richiesti non è disponibile, alcune o tutte le funzionalità potrebbero non funzionare. È possibile utilizzare T-Code SE37 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

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 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, verrà generata 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 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 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 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. In questo modo la paginazione è molto più efficiente e migliorano le prestazioni quando si lavora con tabelle di grandi dimensioni. È consigliabile 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 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 riportati alcuni limiti tecnici 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 principali del materiale in SAP ERP.

Parametri di input dell'azione BAPI_MATERIAL_SAVEDATA

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

Parametri di output dell'azione BAPI_MATERIAL_SAVEDATA

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

Per informazioni su 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 multi-tipo di dati in SAP ERP.

Parametri di input dell'azione ZFM_GCP_MULTIDATA_TAB

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

Parametri di output dell'azione ZFM_GCP_MULTIDATA_TAB

Se l'azione è riuscita, questa azione restituisce lo stato 200 (OK).

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 Il tipo di file.I valori consentiti sono XML e IDoc.
Modalità Stringa La modalità di trasferimento.I valori consentiti sono Sync e ASync.
Contenuti Stringa Contenuti del file.

Parametri di output dell'azione PushIDoc

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

Ad esempio su come configurare l'azione PushIDoc consulta gli esempi di azioni.

azione RunCustomQuery

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 esegui-query-personalizzata immagine che mostra l'esecuzione di una query personalizzata

  4. Espandi la sezione Input attività e 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. Viene visualizzata 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 dei parametri di query. 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 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

In questo esempio viene aggiornato 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 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 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 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 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: 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 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 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 IDoc

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 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 relative alle 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. Facoltativamente, nella sezione Input attività dell'attività Connettori, puoi filtra 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 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.

    In questo caso, 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 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 STRING Vero Il client che si autentica nel sistema SAP.
gruppo STRING 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 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 R3Name 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 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 libreria SNC
snc_mode BOOLEANO Falso Un valore booleano che determina se utilizzi SNC. Imposta questo valore su 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 le tabelle SAP da visualizzare come visualizzazioni, se presenti. I valori supportati sono: Global, Local, All, None
table_mode ENUM Falso Determina le tabelle SAP da visualizzare come visualizzazioni, se presenti. I valori supportati sono: TransparentApplication, TransparentCustomer, TransparentSystem, Pooled, Cluster, Tutti, None
livello di dettaglio STRING 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).

Risoluzione dei problemi di configurazione on-premise di SAP

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 il bilanciamento del carico di subnet e subnet proxy nei firewall on-premise.
  3. Aggiungi tutte le porte necessarie, ad esempio 33XX per la connessione al server delle applicazioni, 36XX per la connessione del server di messaggi/server LB e la connessione 48XX SNC-X509. Dove XX è il numero di sistema o di 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 NEG ibrido. Per maggiori informazioni, consulta Bilanciatore di rete proxy interno regionale con connettività NEG ibrida.

Se si verifica un errore simile al seguente dopo aver configurato la connettività di rete,utilizza la soluzione seguente per inserire nella lista consentita l'IP del collegamento dell'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: aggiungi l'IP del collegamento dell'endpoint di rete del connettore che hai creato in Google Cloud in gw/alternative_hostnames nel livello del profilo SAP.

Glossario SAP

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

Modulo di funzione: un modulo di 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 TCode 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 che sono installate sul server SAP e che possono anche essere scaricate da sap.com. RFM specifici possono essere o meno gestiti negli upgrade SAP. Esistono RFM standard forniti da SAP e quindi potrebbero presentare differenze o potrebbero non esistere nelle versioni precedenti. I 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 Business (BAPI) è un metodo API di un oggetto aziendale. Il tirocinio è un modulo di funzione abilitato per RFC di SAP per dare accesso alle operazioni lociche aziendali. Ad esempio, esistono circa 60 BAPI correlate esclusivamente all'oggetto Cliente. In pratica, in genere ne vengono utilizzati solo alcuni.

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

Query SAP: una query SAP è un oggetto salvato in SAP che descrive in dettaglio le informazioni 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 in Google Cloud nei forum di Cloud.

Passaggi successivi