Installa e configura qualsiasi versione on-premise o cloud dell'SDK ABAP per Google Cloud

Questo documento mostra come installare e configurare le versioni on-premise o cloud dell'SDK ABAP per Google Cloud sul tuo sistema host SAP e sulle istanze VM di Compute Engine, on-premise su un altro cloud provider o in un altro ambiente esterno a Google Cloud.

Questo documento è rivolto agli amministratori SAP, agli amministratori di Google Cloud, e altri professionisti della sicurezza SAP e Google Cloud.

Panoramica

L'SDK ABAP per Google Cloud fornisce librerie client per consentire agli sviluppatori usare ABAP per accedere in modo programmatico alle API Google Cloud. Mediante l'incapsulamento funzioni essenziali come componenti riutilizzabili, queste librerie client riducono la quantità di codice che gli sviluppatori devono scrivere. Per un elenco completo librerie client fornite dall'SDK ABAP per Google Cloud, consulta Librerie client dell'SDK ABAP per Google Cloud.

In qualità di sviluppatore ABAP, puoi creare ed eseguire il deployment di soluzioni ML e basate su AI di Google Cloud con un'ampia gamma come Vertex AI, Document AI Warehouse, BigQuery, Dataproc, Pub/Sub, API Google Workspace e Google Maps Platform.

Per la comunicazione tra le API SAP e Google Cloud, L'SDK ABAP per Google Cloud utilizza il protocollo HTTPS con SSL.

Prima di iniziare

Prima di installare l'SDK ABAP per Google Cloud, segui questi passaggi:

  1. Se non hai mai utilizzato Google Cloud, crea un account su https://cloud.google.com.

  2. Se non hai ancora un progetto Google Cloud, creane uno:

    Vai al selettore progetti

  3. Assicurati che la fatturazione sia abilitata per il tuo progetto. Per ulteriori informazioni, consulta Verificare lo stato di fatturazione del progetto.

  4. Assicurati che le versioni del software SAP che stai utilizzando siano supportate dal SDK ABAP per Google Cloud. Per ulteriori informazioni, consulta i requisiti relativi alla versione software SAP.

Requisiti della versione software SAP

L'SDK ABAP per Google Cloud utilizza il componente aggiuntivo SAP User Interface (UI) per serializzare i dati ABAP in formato JSON. Assicurati che per il corso /UI2/CL_JSON siano state implementate le ultime correzioni.

La tabella seguente spiega la versione minima dei componenti richiesti per: installare l'SDK:

SAP SAP NetWeaver Componente aggiuntivo della UI SAP
SAP ERP 6.0 (ECC) SAP_BASIS 702 o versioni successive

/UI2/CL_JSON: PL12 o versioni successive.

Per ulteriori informazioni, consulta la nota SAP 22798102 - /UI2/CL_JSON correzioni - PL12

Il componente aggiuntivo della UI di SAP deve essere compatibile con il tuo SAP Netweaver completamente gestita. Per informazioni sulla compatibilità dei componenti aggiuntivi dell'interfaccia utente di SAP, consulta:
S/4HANA 1909 o versioni successive SAP_BASIS 752 o versioni successive

Stabilisci una connessione di rete a Google Cloud

Se il carico di lavoro SAP non è in esecuzione su Google Cloud, l’amministratore di rete deve stabilire un protocollo sicuro, a bassa latenza e a elevata larghezza di banda a Google Cloud.

Puoi accedere alle API Google Cloud tramite la rete internet pubblica. Per ulteriori informazioni, vedi Informazioni sulle API Cloud. Se i server SAP non dispongono di una connessione internet pubblica e l'accesso ai dati, poi connetterli a Google Cloud tramite uno seguenti metodi:

Per configurare una connessione, segui le istruzioni fornite dalla il prodotto per la connettività di rete di Google Cloud appropriato. Ogni prodotto ha un set di istruzioni diverso per scenari diversi, pertanto consulta la documentazione e segui le istruzioni per il tuo scenario.

Se il carico di lavoro SAP è in esecuzione su Google Cloud, L'SDK ABAP per Google Cloud utilizza la rete VPC sottostante.

Installa l'SDK ABAP per Google Cloud

L'SDK ABAP per Google Cloud viene fornito sotto forma di trasportare i file installati in SAP NetWeaver.

  1. Scarica il pacchetto di installazione che contiene i file di trasporto da il portale di download.

  2. Copia l'SDK ABAP per i file di trasporto Google Cloud in SAP Directory di importazione del trasporto del server.

    L'SDK ABAP per Google Cloud offre due set di dati file:

    • Per le API Google Cloud supportate e l'autenticazione mediante token o chiavi API, copia i seguenti file di trasporto nella cartella di trasporto del server SAP importa directory:

      • /usr/sap/trans/cofiles/K900271.GM1
      • /usr/sap/trans/data/R900271.GM1

    • Per l'autenticazione basata su credenziali client OAuth 2.0, copia i seguenti file di trasporto importa directory:

      • /usr/sap/trans/cofiles/K900275.GM1

      • /usr/sap/trans/data/R900275.GM1

        Questi file di trasporto non forniscono funzionalità aggiuntive, diversa dall'autenticazione basata su credenziali client OAuth 2.0. Per Prima l'autenticazione basata su credenziali client OAuth 2.0 importare i file di trasporto per le API Google Cloud supportate, e importare i file di trasporto per le credenziali del client OAuth 2.0.

        Per utilizzare le credenziali client OAuth 2.0, il sistema SAP devono supportare OAuth 2.0. Per informazioni sui sistemi SAP che supportano OAuth 2.0, consulta la nota SAP 3041322 - Client OAuth 2.0: downport delle credenziali client con tipo di concessione.

    • Se aggiorni l'SDK da una versione precedente alla versione 1.7, quindi copia i seguenti file di trasporto importa directory:

      • /usr/sap/trans/cofiles/K900279.GM1

      • /usr/sap/trans/data/R900279.GM1

        Questi file di trasporto rimuovono gli artefatti associati ai file deprecati nell'SDK ABAP per Google Cloud. Per informazioni sui aggiunte, miglioramenti e funzionalità deprecate, consulta Novità dell'SDK ABAP per Google Cloud (on-premise o cloud). Se stai installando l'SDK per la prima volta, non sarà necessario copiare questi file di trasporto.

  3. Nella GUI di SAP, utilizza il codice transazione STMS_IMPORT o STMS per importare nel sistema SAP.

  4. Assicurati che tutti gli oggetti nel pacchetto /GOOG/ABAP_SDK siano attivi e coerenti:

    1. Nella GUI di SAP, inserisci il codice della transazione SE80.
    2. Nel selettore di pacchetti, seleziona /GOOG/ABAP_SDK.
    3. Nel campo Nome oggetto, fai clic con il tasto destro del mouse sul pacchetto /GOOG/ABAP_SDK, e seleziona Seleziona > Controllo pacchetti > Oggetti pacchetto (inclusi i sottopacchetti).

    4. Fai clic sull'icona Passa a visualizzazione elenco.

      Visualizzazione elenco

      Un segno di spunta verde nella colonna Risultato del controllo della spedizione indica che tutti hanno superato il controllo del pacchetto.

Configura le impostazioni di sicurezza SAP

Segui questi passaggi per connettere in modo sicuro l'SDK ABAP per Google Cloud alle API di Google Cloud.

Configurazione dei certificati SSL

Scarica e importa i certificati Google richiesti in STRUST.

  1. Scarica i seguenti certificati dal repository di Google Trust Services:

    • Radice GTS R1
    • GTS CA 1C3

    PEM e DER sono formati di certificato di uso comune. Puoi scaricare in un formato compatibile con il sistema SAP. Se il formato richiesto non è disponibile, consulta la nota SAP 2755238 - How to convert a certificate in the appropriate format with OpenSSL. per convertire i certificati nel formato richiesto.

  2. Nella GUI di SAP, inserisci il codice della transazione STRUST.

  3. Passa a Cambia modalità.

  4. Fai doppio clic su Client SSL Client SSL (Standard).

  5. Fai clic su Certificato > Importa, quindi importa i certificati. scaricato dal repository di Google Trust Services.

  6. Fai clic sul pulsante con il segno di spunta verde.

  7. Fai clic su Modifica > Aggiungi all'elenco di certificati. Assicurati che le informazioni del certificato è visibile nell'area Certificato del riquadro in basso a destra.

  8. Salva la voce.

Per ulteriori informazioni da SAP sull'importazione di certificati in STRUST, consulta la nota SAP 3238733 - Come importare un certificato in un elenco di certificati di STRUST PSE in un NetWeaver AS ABAP.

Convalida le porte HTTP e HTTPS in Internet Communication Manager (ICM)

Per i sistemi SAP ospitati su Google Cloud, i metadati della VM viene archiviata su un server metadati accessibile solo attraverso una porta HTTP. Per l'autenticazione è richiesta l'attivazione della porta HTTP. Pertanto, quando il sistema SAP è ospitato su una di Compute Engine, devi assicurarti su una porta HTTP sia attiva per accedere ai metadati della VM e abilitare l'autenticazione. Devi per verificare che sia attiva una porta HTTPS per le chiamate API successive.

Se il sistema SAP è ospitato all'esterno di Google Cloud, l'attivazione del La porta HTTP non è obbligatoria.

Per convalidare le porte HTTP e HTTPS, segui questi passaggi:

  1. Nella GUI di SAP, inserisci il codice della transazione SMICM.
  2. Nella barra dei menu, fai clic su Vai a > Servizi. Un segno di spunta verde nella colonna Actv indica che Le porte HTTP e HTTPS sono attive.

Per informazioni sulla configurazione delle porte HTTP e HTTPS, consulta: Impostazioni HTTP(S) in ICM.

Assicurati che il traffico in uscita dalla rete sia in uscita

Il server di applicazioni SAP deve connettersi a Google Cloud tramite HTTPS.

  • Per il sistema host SAP, verifica che le regole firewall e i proxy consentano Connessione HTTPS da server esterni alle istanze VM di Compute Engine. Per saperne di più, consulta Creare e avviare un'istanza VM.
  • Assicurati che l'accesso per raggiungere Google Cloud Le API non sono limitate dal punto di vista del networking.

Gestisci autorizzazioni

Per accedere all'SDK ABAP per transazioni specifiche di Google Cloud, devi concedere l'accesso degli utenti all'oggetto di autorizzazione dell'SDK. I file di trasporto dell'SDK Includono l'oggetto autorizzazione SDK ZGOOG_SDK e il gruppo di autorizzazione ZSGC.

Per concedere l'accesso alle transazioni dell'SDK:

  1. Nella GUI di SAP, inserisci il codice della transazione PFCG.
  2. Definisci un ruolo per l'SDK.
  3. Per l'oggetto autorizzazione ZGOOG_SDK, concedi al ruolo l'accesso all'oggetto autorizzazione Activity 16.

Per limitare l'accesso alle tabelle di configurazione dell'SDK, segui questi passaggi:

  1. Nella GUI di SAP, inserisci il codice della transazione PFCG.
  2. Definisci un ruolo per limitare l'accesso alle tabelle di configurazione dell'SDK.
  3. Per limitare l'accesso all'oggetto di autorizzazione S_TABU_DIS, escludi il gruppo di autorizzazione ZSGC.

Configura la sicurezza di Google Cloud

Se il tuo sistema SAP è ospitato su Google Cloud, configura quanto segue sull'istanza VM di Compute Engine host:

Configura l'autenticazione

Per utilizzare le API Google Cloud, devi confermare la tua identità mediante l'autenticazione. Per informazioni sulle opzioni di autenticazione in Google Cloud e sulla configurazione consulta la sezione Autenticazione.

Dopo aver completato la configurazione dell'autenticazione, puoi iniziare a utilizzare il metodo Guide rapide per creare programmi di esempio.

Configura l'SDK ABAP per Google Cloud

Questa sezione illustra le configurazioni dei SDK ABAP per Google Cloud.

Specifica l'endpoint di Google Cloud

L'SDK ABAP per Google Cloud fornisce le seguenti opzioni per specificare Endpoint API quando si chiama un'API Google Cloud utilizzando la libreria client API classe:

Endpoint predefiniti

Per impostazione predefinita, il metodo costruttore della classe della libreria client API contiene Endpoint HTTP per le API Google Cloud supportate. La libreria client utilizza questi endpoint quando viene chiamato un metodo per eseguire un'operazione sulle risorse API.

Utilizza destinazioni RFC per gli endpoint

Se devi utilizzare una delle seguenti funzionalità, utilizza le destinazioni RFC per stabilire la connessione a Google Cloud:

  • Se utilizzi un server proxy nel tuo panorama SAP e vuoi usare lo stesso per inviare le richieste HTTP a Google Cloud.
  • Se vuoi che l'SDK acceda alle API Google Cloud tramite Endpoint Private Service Connect nella tua rete VPC.
  • Se vuoi utilizzare la compressione HTTP.
  • Se vuoi accedere all'endpoint specifico per regione di un'API.

I file di trasporto dell'SDK ABAP per Google Cloud contengono il seguente esempio Destinazioni RFC per gli endpoint API Google Cloud:

Nome destinazione RFC di esempio Note
GOOG_IAMCREDENTIALS Questa destinazione RFC ha come target l'API IAM.
GOOG_OAUTH2_TOKEN Questa destinazione RFC ha come target l'endpoint Google Cloud per il token basata sull'autenticazione basata su cloud.
GOOG_PUBSUB_V1 Questa destinazione RFC ha come target l'API Pub/Sub.
GOOG_TRANSLATION_EU_V3 Questa destinazione RFC ha come target l'API Cloud Translation v3.

Per creare una destinazione RFC, segui questi passaggi:

  1. Nella GUI di SAP, inserisci il codice della transazione SM59.

  2. Crea nuove destinazioni RFC copiando la RFC di esempio destinazioni.

  3. Per le destinazioni RFC che hai creato, assicurati che il valore Connection Type (Tipo di connessione) è impostato come segue: G - HTTP connection to external server.

  4. Vai alla scheda Impostazioni tecniche e inserisci i seguenti dettagli:

    • Target Host (Host di destinazione): inserisci il nome host dell'API Google Cloud. Ad esempio, puoi utilizzare translation.googleapis.com.
    • Prefisso del percorso: inserisci il percorso della risorsa. Ad esempio, puoi utilizzare /language/translate/.

    • Numero di servizio: inserisci 443. Questo numero di porta è utilizzato per le comunicazioni sicure.

      Per raccogliere i dettagli specifici dell'API Google Cloud di cui hai bisogno Per creare una destinazione RFC, consulta Raccogliere dettagli per la creazione di una destinazione RFC.

  5. Vai alla pagina Logon & Sicurezza e assicurati che il Certificato SSL viene impostato con l'opzione DFAULT SSL Client (Standard).

  6. Facoltativo: puoi configurare le impostazioni del proxy, attivare la compressione HTTP e Specifica gli endpoint di Private Service Connect.

  7. Salva le modifiche.

Per utilizzare le destinazioni RFC per connetterti alle API Google Cloud, devi configurare le destinazioni RFC nella tabella di mappatura dei servizi che di destinazione RFC a una chiave client. Per ulteriori informazioni sui per la mappatura dei servizi, vedi la Tabella /GOOG/SERVIC_MAP.

Raccogliere dettagli per creare una destinazione RFC

Per ottenere i dettagli necessari per creare una destinazione RFC, segui questi passaggi:

  1. Nella GUI di SAP, esegui il codice della transazione /GOOG/SDK_IMG.

    In alternativa, esegui il codice transazione SPRO e fai clic su IMG riferimento SAP.

  2. Fai clic su ABAP SDK for Google Cloud > Utilità > Ottieni impostazioni RFC per i servizi Google Cloud.
  3. Specifica il nome del servizio Google Cloud.
  4. Fai clic su Esegui per visualizzare i dettagli.
Configura le impostazioni del proxy

Quando utilizzi le destinazioni RFC per connetterti a Google Cloud, puoi instradare la comunicazione per l'SDK tramite il server proxy che usi in SAP in un paesaggio.

Se non vuoi utilizzare un server proxy o non ne hai uno in SAP orizzontale, quindi puoi saltare questo passaggio.

Per configurare le impostazioni del server proxy, segui questi passaggi:

  1. Nella GUI di SAP, inserisci il codice della transazione SM59.

  2. Seleziona la destinazione RFC che ha come target l'API richiesta.

  3. Vai alla scheda Impostazioni tecniche e inserisci i valori per i campi in nella sezione Opzioni proxy HTTP.

Devi configurare le impostazioni del server proxy per ogni API a cui prevedi di accedere utilizzando l'SDK.

Attiva la compressione HTTP

Quando utilizzi le destinazioni RFC per connetterti a Google Cloud, puoi abilitare la compressione HTTP.

Ti consigliamo di abilitare la compressione HTTP se il sistema SAP non è in esecuzione su in Google Cloud. Prima di abilitare la compressione HTTP nell'ambiente di produzione dell'ambiente di analisi, testare e confrontare vantaggi in base alla configurazione orizzontale, poiché la compressione HTTP può comportare overhead di compressione e decompressione. Per maggiori informazioni su SAP, consulta Nota SAP 1037677: la compressione HTTP comprime solo alcuni documenti.

Se non vuoi attivare questa funzionalità, puoi saltare questo passaggio.

Per attivare la compressione HTTP, procedi nel seguente modo:

  1. Nella GUI di SAP, inserisci il codice della transazione SM59.

  2. Seleziona la destinazione RFC che ha come target l'API richiesta.

  3. Vai alla scheda Opzioni speciali.

  4. Nel campo Versione HTTP, seleziona HTTP 1.1.

  5. Per il campo Compressione, seleziona un valore appropriato.

Specifica gli endpoint di Private Service Connect

Se vuoi che l'SDK ABAP per Google Cloud utilizzi Private Service Connect per consentire il consumo privato delle API Google Cloud IAM, devi creare questi endpoint nel tuo progetto Google Cloud e specificarli nelle rispettive destinazioni RFC.

Se vuoi che l'SDK continui a utilizzare il valore pubblico predefinito Endpoint API per la connessione alle API Google Cloud e a IAM, quindi salta questo passaggio.

Per configurare l'SDK in modo che utilizzi Endpoint Private Service Connect, esegui queste operazioni passaggi:

  1. Nella GUI di SAP, inserisci il codice della transazione SM59.

  2. Verifica di aver creato nuove destinazioni RFC per le API Google Cloud e i ruoli IAM richiesti. Per istruzioni su Creare destinazioni RFC, consulta Creare destinazioni RFC.

  3. Seleziona la destinazione RFC che ha come target l'API Google Cloud specifica, quindi completa i seguenti passaggi:

    1. Vai alla scheda Impostazioni tecniche.

    2. Nel campo Target Host (Host di destinazione), inserisci il nome del Endpoint Private Service Connect creato in accedere all'API.

    3. Per il campo N.servizio, assicurati che sia specificato il valore 443.

    4. Vai alla scheda Accesso e sicurezza.

    5. Per il campo Certificato SSL, assicurati che l'opzione L'opzione Client SSLDFAULT (standard) è selezionata.

  4. Seleziona la destinazione RFC che ha come target IAM e quindi completa i seguenti passaggi:

    1. Vai alla scheda Impostazioni tecniche.

    2. Nel campo Target Host (Host di destinazione), inserisci il nome del Endpoint Private Service Connect creato in per accedere a IAM.

    3. Per il campo N.servizio, assicurati che sia specificato il valore 443.

    4. Vai alla scheda Accesso e sicurezza.

    5. Per il campo Certificato SSL, assicurati che l'opzione L'opzione Client SSLDFAULT (standard) è selezionata.

  5. Configura la tabella di mappatura dei servizi per l'API IAM e altre API che prevedi di utilizzare con l'SDK ABAP per Google Cloud.

    1. Nella GUI di SAP, esegui il codice della transazione /GOOG/SDK_IMG.

      In alternativa, esegui il codice transazione SPRO e fai clic su IMG riferimento SAP.

    2. Fai clic su SDK ABAP per Google Cloud > Impostazioni di base > Configura mappa servizi.

    3. Fai clic su Nuove voci.

    4. Specifica le destinazioni RFC per l'API IAM e altre API. ad esempio Cloud Pub/Sub API v1.

Campo Descrizione
Nome chiave Google Cloud Specifica il nome della configurazione della chiave client.
Nome servizio Google Specifica il servizio Google Cloud per cui stai eseguendo la mappatura una destinazione RFC.
Destinazione RFC Specifica il nome della destinazione RFC.

La destinazione RFC specificata nella tabella di mappatura dei servizi viene utilizzata da l'SDK quando viene creata e utilizzata un'istanza di una classe della libreria client dal codice sorgente ABAP per chiamare un'API Google Cloud.

Logging delle applicazioni

Per scrivere i log delle applicazioni, l'SDK ABAP per Google Cloud è dotato di di logging. Oggetto log ZGOOG e oggetto secondario ZABAP_SDK vengono forniti con i file di trasporto dell'SDK che puoi utilizzare come oggetti predefiniti per le configurazioni dei log. Puoi anche aggiungere oggetti di log personalizzati e sottooggetti al framework di logging dell'SDK.

Puoi visualizzare i log delle applicazioni SAP standard utilizzando la transazione SLG1. Per ulteriori informazioni, consulta Logging.

Configura il logging utilizzando l'oggetto log e l'oggetto secondario forniti con l'SDK

Puoi utilizzare l'oggetto log ZGOOG e l'oggetto secondario ZABAP_SDK forniti con l'SDK come oggetti predefiniti per le configurazioni dei log.

Per configurare il logging, segui questi passaggi:

  1. Nella GUI di SAP, esegui il codice della transazione /GOOG/SDK_IMG.

    In alternativa, esegui il codice transazione SPRO e fai clic su IMG riferimento SAP.

  2. Fai clic su SDK ABAP per Google Cloud > Impostazioni di base > Configura framework di Logging.

  3. Fai clic su Nuove voci.

  4. Inserisci i valori nei seguenti campi:

    Campo Descrizione
    Oggetto Inserisci ZGOOG.
    Oggetto secondario Inserisci ZABAP_SDK.
    Livello di log

    Specifica il livello minimo di log. I valori supportati sono:

    • I: informazioni, avvisi ed errori
    • W: avvisi ed errori
    • E: solo errori

    Ti consigliamo di impostare il livello di log su I, in modo che la maggior parte dei messaggi di log venga registrata.
    Fidelizzazione Specifica il numero di giorni di conservazione dei log.
    Termina alle Specifica la data di fine entro la quale questa configurazione del log sarà attiva. La data di fine predefinita è 9999/12/31.
    È predefinita Per impostare questa configurazione di log come predefinita, seleziona la casella di controllo.

Aggiungi oggetti di log personalizzati

Puoi anche aggiungere oggetti di log e oggetti secondari personalizzati al logging dell'SDK il modello di machine learning.

Per aggiungere un oggetto log e un oggetto secondario personalizzati:

  1. Nella GUI di SAP, esegui il codice della transazione /GOOG/SDK_IMG.

    In alternativa, esegui il codice transazione SPRO e fai clic su IMG riferimento SAP.

  2. Fai clic su SDK ABAP per Google Cloud > Impostazioni di base > Configura framework di Logging.

  3. Fai clic su Nuove voci.

  4. Inserisci i valori nei seguenti campi:

    Campo Descrizione
    Oggetto Inserisci un nome per l'oggetto log.
    Oggetto secondario Inserisci un nome per l'oggetto secondario di log.
    Livello di log

    Specifica il livello minimo di log. I valori possibili sono:

    • I: informazioni, avvisi ed errori
    • W: avvisi ed errori
    • E: solo errori

    Ti consigliamo di impostare il livello di log su I, in modo che la maggior parte dei messaggi di log venga registrata.
    Conservazione Specifica il numero di giorni di conservazione dei log.
    Termina a Data di fine fino alla quale sarà attiva questa configurazione del log. La data di fine predefinita è 9999/12/31.
    Predefinita Specifica se questa è la tua configurazione predefinita dei log.

Se devi impostare un oggetto log e un oggetto secondario personalizzati come dati di logging predefiniti configurazione, quindi cancella il campo Is Default (È predefinito) per la voce predefinita corrente, e seleziona il campo È predefinito per la nuova voce da impostare come predefinito.

Puoi mantenere una sola configurazione di log come voce predefinita alla volta.

Puoi utilizzare gli oggetti log e i sottooggetti personalizzati anche senza per renderli predefiniti. Per farlo, dopo aver creato gli oggetti log e i sottooggetti personalizzati nel framework di logging, devi passare gli oggetti log e i sottooggetti quando creare un'istanza degli stub del client API. Per ulteriori informazioni, consulta Logging.

Se non è più necessaria una configurazione del log, puoi disabilitarla.

Per disabilitare una configurazione di log, segui questi passaggi:

  1. Nella GUI di SAP, esegui il codice della transazione /GOOG/SDK_IMG.

    In alternativa, esegui il codice transazione SPRO e fai clic su IMG riferimento SAP.

  2. Fai clic su SDK ABAP per Google Cloud > Impostazioni di base > Configura framework di Logging.

  3. Imposta il campo Fine alle su una data nel passato.

Tabelle di configurazione chiave nell'SDK ABAP per Google Cloud

Tabella /GOOG/CLIENT_KEY

Per la configurazione di autenticazione e connettività, l'SDK ABAP per Google Cloud utilizza la tabella /GOOG/CLIENT_KEY. Nella tabella /GOOG/CLIENT_KEY, devi configurare le chiavi client utilizzando i dettagli specifici del metodo di autenticazione in uso. Per ulteriori informazioni informazioni sui metodi di autenticazione e sulla configurazione della chiave client correlata, consulta Autenticazione.

Per visualizzare la tabella /GOOG/CLIENT_KEY:

  1. Nella GUI di SAP, esegui il codice della transazione /GOOG/SDK_IMG.

    In alternativa, esegui il codice transazione SPRO e fai clic su IMG riferimento SAP.

  2. Fai clic su SDK ABAP per Google Cloud > Impostazioni di base > Configura chiave client.

La seguente tabella illustra i campi della tabella delle chiavi client:

Campo Tipo di dati Descrizione
Nome chiave Google Cloud Stringa Il nome della configurazione della chiave client. Ad esempio, CLIENT_KEY_API_KEY
Nome dell'account di servizio Google Cloud Stringa Il nome dell'account di servizio, in formato indirizzo email.
Ambito Google Cloud Stringa L'ambito di accesso all'API, https://www.googleapis.com/auth/cloud-platform. Questo ambito di accesso corrisponde all'impostazione Consenti l'accesso completo a tutte le API Cloud sulla VM host.
ID progetto Stringa L'ID del progetto Google Cloud che contiene le API di destinazione.
Nome comando Stringa Nome comando del sistema operativo. In genere, questo campo viene lasciato vuoto.
Classe di autorizzazione Stringa La classe di autorizzazione da utilizzare per la comunicazione con Google Cloud.
Memorizzazione nella cache dei token Booleano Il flag che determina se i token di accesso sono stati recuperati o meno di Google Cloud vengono memorizzate nella cache. Ti consigliamo di attivare la memorizzazione nella cache dei token al termine dell'operazione configurando e testando la connessione a Google Cloud. Per ulteriori informazioni sulla memorizzazione nella cache dei token, consulta Abilitare la memorizzazione nella cache dei token.
Secondi di aggiornamento del token Stringa La quantità di tempo, in secondi, prima della scadenza di un token di accesso e devono essere aggiornati. Specificare un valore compreso tra 1 e 3599 esegue l'override la scadenza predefinita di 3500 secondi. Se specifichi 0, l'SDK utilizza il valore predefinito. Il valore predefinito è 3500.
Parametro di autorizzazione 1 Stringa Si tratta di parametri di autorizzazione aggiuntivi che richiedono la configurazione in situazioni specifiche. In genere, questo campo viene lasciato vuoto.
Parametro di autorizzazione 2 Stringa Si tratta di parametri di autorizzazione aggiuntivi che richiedono la configurazione in situazioni specifiche. In genere, questo campo viene lasciato vuoto.

Tabella /GOOG/SERVIC_MAP

Per mappare la configurazione del servizio alla specifica RFC destinazioni, l'SDK ABAP per Google Cloud utilizza la tabella /GOOG/SERVIC_MAP.

A seconda dei metodi di autenticazione, questa tabella contiene alcuni campi obbligatori le voci consigliate.

Per visualizzare la tabella /GOOG/SERVIC_MAP:

  1. Nella GUI di SAP, esegui il codice della transazione /GOOG/SDK_IMG.

    In alternativa, esegui il codice transazione SPRO e fai clic su IMG riferimento SAP.

  2. Fai clic su SDK ABAP per Google Cloud > Impostazioni di base > Configura mappatura servizi.

La seguente tabella spiega i campi della tabella di mappatura dei servizi:

Campo Tipo di dati Descrizione
Nome Stringa Il nome della configurazione della chiave client.
Nome servizio Google Stringa Il nome del servizio Google Cloud. Per trovare un servizio, utilizza la guida della ricerca.
Destinazione RFC Stringa Il nome della destinazione RFC. Per trovare una destinazione RFC pertinente, utilizza la guida per la ricerca.

Cerca nella Guida

Per trovare i valori disponibili per un campo, fai clic sull'icona come mostrato nello screenshot seguente:

Cerca nella Guida

Tabella /GOOG/LOG_CONFIG

Per scrivere i log delle applicazioni, l'SDK ABAP per Google Cloud utilizza la tabella /GOOG/LOG_CONFIG.

Per visualizzare la tabella /GOOG/LOG_CONFIG:

  1. Nella GUI di SAP, esegui il codice della transazione /GOOG/SDK_IMG.

    In alternativa, esegui il codice transazione SPRO e fai clic su IMG riferimento SAP.

  2. Fai clic su SDK ABAP per Google Cloud > Impostazioni di base > Configura framework di Logging.

La tabella seguente spiega i campi della tabella di configurazione del logging:

Campo Descrizione
Oggetto Il nome dell'oggetto log.
Oggetto secondario Il nome del sottooggetto log.
Livello di log

Mostra il livello minimo di log. I valori possibili sono:

  • I: informazioni, avvisi ed errori
  • W: avvisi ed errori
  • E: solo errori
Conservazione

Numero di giorni che verranno conservati i log.

Al termine del periodo di conservazione, puoi prendere in considerazione l'eliminazione dei log utilizzando la transazione SLG2.
Termina a Data di fine fino alla quale sarà attiva questa configurazione del log. La data di fine predefinita è 9999/12/31.
Predefinita Indica se questa è la configurazione predefinita dei log.
Autore modifica Nome utente che ha modificato la configurazione del log.
Modificate il giorno Data di modifica della configurazione del log.
Data/ora modifica Ora in cui la configurazione del log è stata modificata.

Memorizzazione nella cache dei token

Se l'SDK viene utilizzato in un caso d'uso di volume di chiamate elevato in cui più chiamate di metodi API vengono eseguite per un breve periodo, quindi abilita la memorizzazione nella cache per il token di accesso o chiave API ottenuta dalla configurazione della chiave client per accedere a Google Cloud su quelle di livello inferiore.

L'attivazione della memorizzazione nella cache dei token assicura che un token di accesso o una chiave API vengano riutilizzati scade o viene revocato, il che a sua volta riduce il numero di chiamate HTTP effettuate per recuperare nuovi token di accesso o chiavi API.

Per abilitare la memorizzazione nella cache dei token, seleziona il flag Memorizzazione nella cache dei token nella tabella delle chiavi client.

Quando attivi la memorizzazione nella cache dei token, il token di accesso viene memorizzato nella cache del server delle applicazioni per la durata impostata nel campo Token Update Seconds (Secondi di aggiornamento token) nella tabella delle chiavi client. Se l'opzione Token Refresh Seconds non è specificata o è impostata su 0, l'accesso il token viene memorizzato nella cache per il valore specificato nel parametro CMD_SECS_DEFLT nelle impostazioni avanzate.

Cancella il token di accesso memorizzato nella cache

Quando la memorizzazione nella cache dei token è abilitata e si aggiornano i ruoli assegnati l'account di servizio che l'SDK ABAP per Google Cloud utilizza per accedere alle API pertinenti, viene recuperato il nuovo token di accesso corrispondente ai ruoli aggiornati solo dopo la scadenza del token memorizzato nella cache esistente. In questi casi, puoi cancellare il token di accesso manualmente.

Per cancellare il token di accesso memorizzato nella cache, svolgi i seguenti passaggi:

  1. Nella GUI di SAP, esegui il codice della transazione /GOOG/SDK_IMG.

    In alternativa, esegui il codice transazione SPRO e fai clic su IMG riferimento SAP.

  2. Fai clic su SDK ABAP per Google Cloud > Utilità > Svuota cache.

  3. Seleziona l'opzione appropriata:

    • Cancella area di memoria condivisa: per svuotare l'intera cache.
    • Cancella istanza dalla memoria: per cancellare il token di accesso memorizzato nella cache per uno specifico in esecuzione in un'istanza Compute Engine. Con questa opzione, specifichi anche un nome istanza.

  4. Crea il report.

Trova i ruoli IAM per le API Google Cloud

Per implementare il principio del privilegio minimo, è essenziale conoscere i ruoli IAM appropriati Le API Google Cloud che prevedi di utilizzare nel tuo programma ABAP. Concedendo solo per i ruoli necessari, puoi limitare l'accesso per un account di servizio. L'utilità Ricerca ruoli, integrata nell'SDK, ti consente di identificare i ruoli IAM associati alle varie API Google Cloud.

Per trovare i ruoli IAM, segui questi passaggi:

  1. Nella GUI di SAP, esegui il codice della transazione /GOOG/SDK_IMG.

    In alternativa, esegui il codice transazione SPRO e fai clic su IMG riferimento SAP.

  2. Fai clic su SDK ABAP per Google Cloud > Utilità > Ruoli pertinenti dell'API Fetch.

    In alternativa, puoi accedere all'utilità Ricerca ruoli eseguendo il codice transazione /GOOG/ROLE_FINDER.

  3. Nel campo Chiave client, inserisci un nome valido configurato per la chiave client nella tabella /GOOG/CLIENT_KEY.

  4. Nel campo Google Service Name (Nome servizio Google), specifica l'API Google Cloud di cui devi controllare i ruoli IAM.

  5. Facoltativamente, per visualizzare le autorizzazioni IAM associate all'interno Ruolo IAM, seleziona il campo Dettagli completi.

  6. Fai clic su Execute (Esegui). Vengono visualizzati i ruoli IAM.

Impostazioni avanzate

Facoltativamente, puoi modificare i parametri delle impostazioni avanzate per l'SDK in Tabella /GOOG/SDK_PARAM. Questi valori parametro vengono applicati a livello di sistema e sono comuni a tutti i componenti dell'SDK.

L'SDK applica internamente i valori predefiniti per questi parametri. Usa impostazioni avanzate impostazioni solo se vuoi eseguire l'override dei valori predefiniti.

Ti consigliamo di modificare i parametri delle impostazioni avanzate solo dopo un'analisi completa e l'impatto dei nuovi valori sulle prestazioni degli SDK. È tua responsabilità assicurarti che le nuove impostazioni avanzate non causino errori e problemi di prestazioni.

Per modificare i parametri delle impostazioni avanzate:

  1. Nella GUI di SAP, esegui il codice della transazione /GOOG/SDK_IMG.

    In alternativa, esegui il codice transazione SPRO e fai clic su IMG riferimento SAP.

  2. Fai clic su SDK ABAP per Google Cloud > Impostazioni di base > Configura parametri.

  3. Fai clic su Nuove voci.

  4. Nella riga visualizzata specifica le seguenti impostazioni:

    1. Nel campo Nome parametro, inserisci il nome del parametro. La descrizione del parametro viene compilata automaticamente.
    2. Nel campo Valore parametro, inserisci un valore.

    Per conoscere i parametri delle impostazioni avanzate, consulta Parametri delle impostazioni avanzate.

  5. Salva la nuova voce.

Parametri delle impostazioni avanzate

La tabella seguente mostra i parametri delle impostazioni avanzate per l'SDK ABAP per Google Cloud.

Nome parametro Descrizione Valore predefinito Valore valido
CMD_SECS_DEFLT Se hai abilitato la memorizzazione nella cache dei token, questa è la durata secondi dopo i quali scade il token memorizzato nella cache. 3500 Il valore deve essere compreso tra 1 e 3599.

Aggiorna l'SDK ABAP per Google Cloud

Google Cloud offre le nuove release SDK ABAP per Google Cloud per il trasporto SAP.

Gli amministratori SAP possono aggiornare l'SDK ABAP per Google Cloud seguendo questa procedura:

  1. Arresta i job in background che utilizzano eventuali stub client API esistenti dell'SDK ABAP per Google Cloud.
  2. Importa la nuova richiesta di trasporto SAP. Per ulteriori informazioni sui passaggi, consulta Installare l'SDK ABAP per Google Cloud.
  3. Dopo aver convalidato l'importazione e l'attivazione degli oggetti, riprendi job in background.

Metriche di utilizzo

L'edizione on-premise o cloud dell'SDK ABAP per Google Cloud raccoglie le metriche di utilizzo e le invia a Google per finalità di assistenza, in conformità con Informativa sulla privacy di Google Cloud (Dati di servizio che raccogliamo). Queste metriche di utilizzo vengono raccolte ogni volta che un'API Google Cloud viene chiamato dall'SDK ABAP per Google Cloud.

L'SDK raccoglie le seguenti metriche di utilizzo:

  • Metodo di autenticazione: informazioni sul metodo di autenticazione utilizzato per chiamare i servizi Google Cloud.
  • Versione SDK ABAP: n. di versione dell'SDK ABAP on-premise o di qualsiasi edizione cloud per Google Cloud.
  • Release SAP_ABA: versione del componente software SAP_ABA.

Licenze

L'edizione on-premise o cloud dell'SDK ABAP per Google Cloud viene resa disponibile come "Software" nel contratto che regola l'utilizzo della Google Cloud Platform, tra cui i Termini specifici del servizio disponibili all'indirizzo https://cloud.google.com/terms/service-terms. Senza alcuna limitazione ai generalità dei termini di cui sopra, l'utente non può modificare o distribuire SDK ABAP per Google Cloud senza l'esplicita autorizzazione scritta di Google.

L'SDK ABAP per Google Cloud è offerto senza costi. Per chiarezza, l'uso da parte dell'utente di altro "Software" e "Servizi" ai sensi del contratto che disciplina l'utilizzo della Google Cloud Platform, ad esempio L'API Cloud Translation e l'API Pub/Sub potrebbero comportare dei costi.

L'SDK ABAP per Google Cloud non include alcuna licenza per il software SAP. acquista separatamente una licenza appropriata per il software SAP.

Supporto dei linguaggi

L'SDK ABAP per Google Cloud supporta solo l'inglese (EN).

Per impostazione predefinita, l'SDK è in inglese (EN) per le seguenti lingue di accesso a SAP: Cinese (CH), francese (FR), tedesco (DE), giapponese (JA), portoghese (PT), e russo (RU).

Gli eventuali messaggi di errore che potresti visualizzare quando utilizzi Gli SDK vengono generati in inglese, indipendentemente dalla lingua di sistema corrente.

Ciclo di vita dell'assistenza

Google Cloud supporta e gestisce le principali versione dell'SDK ABAP per Google Cloud per un periodo di almeno 12 mesi dopo la pubblicazione di un avviso di ritiro per i alla versione principale Pagina delle note di rilascio per SAP su Google Cloud.

Assistenza

Se hai bisogno di aiuto per risolvere i problemi con l'SDK ABAP per Google Cloud, procedi le seguenti: