Questo documento mostra come installare e configurare la versione on-premise o qualsiasi versione cloud di ABAP SDK per Google Cloud sul sistema host SAP su istanze VM Compute Engine, on-premise, su un altro provider cloud o in un altro ambiente esterno a Google Cloud.
Questo documento è rivolto agli amministratori SAP, agli amministratori Google Cloud e ad altri professionisti della sicurezza SAP e Google Cloud.
Panoramica
L'ABAP SDK for Google Cloud fornisce librerie client per consentire agli sviluppatori di utilizzare ABAP per accedere in modo programmatico alle API Google Cloud. Incapsulando le funzioni essenziali come componenti riutilizzabili, queste librerie client riducono la quantità di codice che gli sviluppatori devono scrivere. Per un elenco completo delle librerie client fornite dall'ABAP SDK for Google Cloud, consulta Librerie client ABAP SDK for Google Cloud.
In qualità di sviluppatore ABAP, puoi creare ed eseguire il deployment di soluzioni basate su ML e AI utilizzando un'ampia gamma di servizi Google Cloud, come Vertex AI, Document AI Warehouse, BigQuery, Dataproc, Pub/Sub, API Google Workspace e Google Maps Platform.
Dalla versione 1.8, l'edizione on-premise o qualsiasi versione cloud di ABAP SDK for Google Cloud offre un'interazione senza problemi con la piattaforma Vertex AI di Google Cloud grazie a uno strumento dedicato, Vertex AI SDK for ABAP. Per informazioni sull'SDK Vertex AI per ABAP, consulta la Panoramica dell'SDK Vertex AI per ABAP.
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:
Se non hai mai utilizzato Google Cloud, crea un account all'indirizzo https://cloud.google.com.
Se non hai ancora un progetto Google Cloud, creane uno:
Assicurati che la fatturazione sia attivata per il tuo progetto. Per ulteriori informazioni, vedi Verificare lo stato di fatturazione del progetto.
Assicurati che le versioni del software SAP in uso siano supportate dall'SDK ABAP per Google Cloud. Per ulteriori informazioni, consulta i requisiti relativi alle versioni del software SAP.
Requisiti della versione del software SAP
L'SDK ABAP per Google Cloud utilizza il componente aggiuntivo dell'interfaccia utente (UI) SAP per serializzare i dati ABAP in formato JSON.
Assicurati che le correzioni più recenti siano implementate per la classe /UI2/CL_JSON.
La tabella seguente illustra la versione minima dei componenti richiesta per l'installazione dell'SDK:
| SAP | SAP NetWeaver | Componente aggiuntivo dell'interfaccia utente 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 - Correzioni /UI2/CL_JSON - PL12 Il componente aggiuntivo dell'interfaccia utente SAP deve essere compatibile con la versione di SAP Netweaver. Per informazioni sulla compatibilità dei componenti aggiuntivi dell'interfaccia utente SAP, consulta: |
| S/4HANA 1909 o versioni successive | SAP_BASIS 752 o versioni successive |
Stabilisci una connessione di rete a Google Cloud
Se il tuo carico di lavoro SAP non è in esecuzione su Google Cloud, tu o un amministratore di rete dovete stabilire una connessione sicura, ad alta larghezza di banda e a bassa latenza a Google Cloud.
Puoi accedere alle API di Google Cloud tramite la rete internet pubblica. Per saperne di più, consulta Informazioni sulle API Cloud. Se i tuoi server SAP non hanno accesso a internet pubblico, connettili a Google Cloud utilizzando uno dei seguenti metodi:
- Cloud Interconnect (opzione consigliata)
- Cloud VPN
Per configurare una connessione, segui le istruzioni fornite dal prodotto per la connettività di rete Google Cloud appropriato. Ogni prodotto ha un insieme diverso di istruzioni per scenari diversi, quindi consulta la documentazione e segui le istruzioni per il tuo scenario.
Se il tuo 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 file di trasporto da installare in SAP NetWeaver.
Se riscontri problemi durante l'importazione dei file di trasporto dell'SDK ABAP per Google Cloud nel tuo ambiente SAP, ad esempio problemi con la revisione del trasporto da parte di SAP o con la gestione della coda di importazione, contatta l'assistenza clienti Google Cloud per ricevere assistenza. Per informazioni su come contattare l'assistenza clienti, consulta Assistenza per SAP su Google Cloud.
Se hai già installato l'ABAP SDK per Google Cloud e devi eseguire l'aggiornamento alla versione più recente dell'SDK, consulta Aggiornare l'ABAP SDK per Google Cloud.
Scarica il pacchetto di installazione contenente i file di trasporto dal portale di download.
Copia i file di trasporto dell'SDK ABAP per Google Cloud nelle directory di importazione del trasporto del server SAP.
L'ABAP SDK per Google Cloud fornisce due set di file di trasporto:
Per stabilire la connessione con le API Google Cloud supportate e autenticarti con token o chiavi API, copia i seguenti file di trasporto nelle directory di importazione del trasporto del server SAP:
/usr/sap/trans/cofiles/K900319.GM1/usr/sap/trans/data/R900319.GM1
Per l'autenticazione con le credenziali client OAuth 2.0, copia i seguenti file di trasporto nelle directory di importazione del trasporto del server SAP:
/usr/sap/trans/cofiles/K900321.GM1/usr/sap/trans/data/R900321.GM1Questi file di trasporto non forniscono funzionalità aggiuntive, diversa dall'autenticazione basata sulle credenziali client OAuth 2.0. Per l'autenticazione basata sulle credenziali client OAuth 2.0, prima importa i file di trasporto per le API Google Cloud supportate, poi importa i file di trasporto per le credenziali client OAuth 2.0.
Per utilizzare le credenziali client OAuth 2.0, il sistema SAP deve supportare OAuth 2.0. Per informazioni sui sistemi SAP che supportano OAuth 2.0, consulta la nota SAP 3041322 - OAuth 2.0 Client: Downport of grant type Client Credentials.
Nella GUI di SAP, utilizza il codice transazione
STMS_IMPORToSTMSper importare i file nel sistema SAP.Assicurati che tutti gli oggetti nel pacchetto
/GOOG/ABAP_SDKsiano attivi e coerenti:- In SAP GUI, inserisci il codice transazione
SE80. - Nel selettore dei pacchetti, seleziona
/GOOG/ABAP_SDK. - Nel campo Nome oggetto, fai clic con il tasto destro del mouse sul pacchetto
/GOOG/ABAP_SDK, poi scegli Controlla > Controllo pacchetto > Oggetti pacchetto (inclusi sottopacchetti). Fai clic sull'icona Passa alla visualizzazione elenco.
Un segno di spunta verde nella colonna Risultato del controllo del pacchetto indica che tutti gli oggetti hanno superato il controllo del pacchetto.
- In SAP GUI, inserisci il codice transazione
Configura le impostazioni di sicurezza SAP
Segui questi passaggi per connettere in sicurezza l'SDK ABAP per Google Cloud alle API Google Cloud.
Configura i certificati SSL
Scarica e importa i certificati Google richiesti in STRUST.
Scarica i seguenti certificati dal repository di Google Trust Services:
- GTS Root R1
- GTS CA 1C3
PEMeDERsono formati di certificati di uso comune. Puoi scaricare i certificati in un formato compatibile con il tuo sistema SAP. Se il formato richiesto non è disponibile, consulta la nota SAP 2755238 - Come convertire un certificato nel formato appropriato con OpenSSL per convertire i certificati nel formato richiesto.In SAP GUI, inserisci il codice transazione
STRUST.Passa alla modalità di modifica.
Fai doppio clic su Client SSL (standard).
Fai clic su Certificato > Importa e poi importa i certificati scaricati dal repository di Google Trust Services.
Fai clic sul pulsante con il segno di spunta verde.
Fai clic su Modifica > Aggiungi all'elenco dei certificati. Assicurati che le informazioni sul certificato siano visibili nell'area Certificato del riquadro in basso a destra.
Salva la voce.
Per ulteriori informazioni di SAP sull'importazione dei certificati in STRUST, consulta la nota SAP 3238733 - Come importare un certificato nell'elenco dei certificati di un PSE STRUST 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 vengono archiviati su un server di metadati a cui è possibile accedere solo tramite una porta HTTP. L'attivazione della porta HTTP è necessaria per l'autenticazione. Pertanto, quando il sistema SAP è ospitato su un'istanza VM Compute Engine, devi assicurarti che sia attiva una porta HTTP per accedere ai metadati della VM e abilitare l'autenticazione. Devi anche assicurarti che una porta HTTPS sia attiva per le chiamate API successive.
Se il sistema SAP è ospitato al di fuori di Google Cloud, l'attivazione della porta HTTP non è necessaria.
Per convalidare le porte HTTP e HTTPS, segui questi passaggi:
- In SAP GUI, inserisci il codice transazione
SMICM. - Nella barra dei menu, fai clic su Vai > 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.
Garantire il traffico in uscita dalla rete
Il server delle applicazioni SAP deve connettersi alle API Google Cloud tramite HTTPS.
- Per il sistema host SAP, verifica che le regole del firewall e i proxy consentano la connessione HTTPS da server esterni alle istanze VM di Compute Engine. Per ulteriori informazioni, consulta Creare e avviare un'istanza VM.
- Assicurati che l'accesso alle API Google Cloud non sia limitato dal punto di vista della rete.
Gestire le autorizzazioni
Per accedere a transazioni specifiche dell'SDK ABAP per Google Cloud, devi concedere agli utenti l'accesso all'oggetto di autorizzazione dell'SDK. I file di trasporto dell'SDK includono l'oggetto di autorizzazione dell'SDK ZGOOG_SDK e il gruppo di autorizzazione ZSGC.
Per concedere l'accesso alle transazioni dell'SDK:
- In SAP GUI, inserisci il codice transazione
PFCG. - Definisci un ruolo per l'SDK.
- Per l'oggetto autorizzazione
ZGOOG_SDK, concedi al ruolo l'accesso all'autorizzazioneActivity 16.
Per limitare l'accesso alle tabelle di configurazione dell'SDK:
- In SAP GUI, inserisci il codice transazione
PFCG. - Definisci un ruolo per limitare l'accesso alle tabelle di configurazione dell'SDK.
- Per limitare l'accesso all'oggetto di autorizzazione
S_TABU_DIS, escludi il gruppo di autorizzazioneZSGC.
Configurare la sicurezza di Google Cloud
Se il sistema SAP è ospitato su Google Cloud, configura quanto segue sull'istanza VM Compute Engine host:
Crea un account di servizio IAM per l'istanza VM host. Per le istruzioni, vedi Creare un account di servizio.
Concedi il ruolo
Service Account Token Creatorall'account di servizio. Per istruzioni, vedi Concedere un singolo ruolo.Collega l'account di servizio all'istanza VM. Imposta inoltre l'ambito di accesso della VM su
cloud-platformin modo che le autorizzazioni IAM della VM siano completamente determinate dai ruoli IAM che concedi all'account di servizio della VM. Per le istruzioni, vedi Creare una VM e collegare l'account di servizio.Crea un account di servizio IAM dedicato per accedere alle API Google Cloud. Per le istruzioni, vedi Creare un account di servizio.
Concedi all'account di servizio i ruoli IAM richiesti per accedere alla funzionalità dell'API. Per comprendere il requisito del ruolo per le API Google Cloud, consulta la documentazione delle singole API e segui il principio del privilegio minimo. Per ulteriori informazioni sui ruoli predefiniti specifici dell'API, consulta la sezione Documentazione di riferimento sui ruoli di base e predefiniti IAM.
Configura l'autenticazione
Per utilizzare le API Google Cloud, devi confermare la tua identità tramite autenticazione. Per informazioni sulle opzioni di autenticazione per Google Cloud e sulla procedura di configurazione, consulta Autenticazione.
Dopo aver completato la configurazione dell'autenticazione, puoi iniziare a utilizzare le guide rapide per creare programmi di esempio.
Configurare l'SDK ABAP per Google Cloud
Questa sezione illustra le configurazioni per l'SDK ABAP per Google Cloud.
Specifica l'endpoint Google Cloud
L'ABAP SDK for Google Cloud fornisce le seguenti opzioni per specificare l'endpoint API quando chiami un'API Google Cloud utilizzando la classe della libreria client dell'API:
Endpoint predefiniti
Per impostazione predefinita, il metodo di costruzione della classe della libreria client dell'API contiene gli 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 dell'API.
Utilizzare le 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 utilizzarlo anche per inviare le richieste HTTP a Google Cloud.
- Se vuoi che l'SDK acceda alle API di Google Cloud tramite gli 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 le seguenti destinazioni RFC di esempio per gli endpoint dell'API Google Cloud:
| Nome della 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 l'autenticazione basata su token. |
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:
In SAP GUI, inserisci il codice transazione
SM59.Crea nuove destinazioni RFC copiando le destinazioni RFC di esempio.
Per le destinazioni RFC che hai creato, assicurati che il Tipo di connessione sia impostato come segue:
G - HTTP connection to external server.Vai alla scheda Impostazioni tecniche e inserisci i seguenti dettagli:
- Host target: inserisci il nome host dell'API Google Cloud.
Ad esempio, puoi utilizzare
translation.googleapis.com. - Prefisso percorso: inserisci il percorso della risorsa. Ad esempio, puoi utilizzare
/language/translate/. N.servizio: inserisci
443. Questo numero di porta viene utilizzato per la comunicazione sicura.Per raccogliere i dettagli specifici dell'API Google Cloud di cui hai bisogno per creare una destinazione RFC, consulta Raccogliere i dettagli per la creazione di una destinazione RFC.
- Host target: inserisci il nome host dell'API Google Cloud.
Ad esempio, puoi utilizzare
Vai alla scheda Accesso e sicurezza e assicurati che il campo Certificato SSL sia impostato sull'opzione Client SSL predefinito (standard).
(Facoltativo) Puoi configurare le impostazioni del proxy, abilitare la compressione HTTP e specificare gli endpoint Private Service Connect.
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 mappano
le destinazioni RFC a una chiave client. Per ulteriori informazioni sulla tabella di mappatura dei servizi, consulta la Tabella /GOOG/SERVIC_MAP.
Raccogliere i dettagli per creare una destinazione RFC
Per ottenere i dettagli necessari per creare una destinazione RFC, segui questi passaggi:
-
In SAP GUI, esegui il codice transazione
/GOOG/SDK_IMG.In alternativa, esegui il codice transazione
SPROe poi fai clic su Immagine di riferimento SAP. - Fai clic su ABAP SDK for Google Cloud > Utilità > Recupera le impostazioni RFC per i servizi Google Cloud.
- Specifica il nome del servizio Google Cloud.
- 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 dall'SDK tramite il server proxy che utilizzi nel tuo panorama SAP.
Se non vuoi utilizzare un server proxy o non ne hai uno nel tuo panorama SAP, puoi saltare questo passaggio.
Per configurare le impostazioni del server proxy, svolgi i seguenti passaggi:
In SAP GUI, inserisci il codice transazione
SM59.Seleziona la destinazione RFC che ha come target l'API richiesta.
Vai alla scheda Impostazioni tecniche, quindi inserisci i valori per i campi 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 attivare la compressione HTTP.
Ti consigliamo di attivare la compressione HTTP se il tuo sistema SAP non è in esecuzione su Google Cloud. Prima di attivare la compressione HTTP nell'ambiente di produzione, testa e confronta i vantaggi in base alla configurazione del tuo panorama, poiché la compressione HTTP potrebbe comportare un overhead di compressione e decompressione. Per ulteriori informazioni di SAP, consulta la 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:
In SAP GUI, inserisci il codice transazione
SM59.Seleziona la destinazione RFC che ha come target l'API richiesta.
Vai alla scheda Opzioni speciali.
Per il campo Versione HTTP, seleziona HTTP 1.1.
Per il campo Compressione, seleziona un valore appropriato.
Specificare gli endpoint di Private Service Connect
Se vuoi che l'SDK ABAP per Google Cloud utilizzi gli endpoint di Private Service Connect per consentire il consumo privato delle API e dell'IAM di Google Cloud, devi creare questi endpoint nel tuo progetto Google Cloud e specificarli nelle rispettive destinazioni RFC.
Se vuoi che l'SDK continui a utilizzare gli endpoint API pubblici predefiniti per connettersi alle API e a IAM di Google Cloud, salta questo passaggio.
Per configurare l'SDK in modo da utilizzare gli endpoint Private Service Connect, svolgi i seguenti passaggi:
In SAP GUI, inserisci il codice transazione
SM59.Verifica di aver creato nuove destinazioni RFC per le API Google Cloud e IAM richieste. Per istruzioni su come creare queste destinazioni RFC, consulta Creare destinazioni RFC.
Seleziona la destinazione RFC che ha come target API Google Cloud specifiche e poi completa i seguenti passaggi:
Vai alla scheda Impostazioni tecniche.
Per il campo Target Host (Host di destinazione), inserisci il nome dell'endpoint Private Service Connect che hai creato per accedere all'API.
Per il campo N.servizio, assicurati che sia specificato il valore
443.Vai alla scheda Accesso e sicurezza.
Per il campo Certificato SSL, assicurati che sia selezionata l'opzione Client SSL predefinito (standard).
Seleziona la destinazione RFC che ha come target IAM e poi completa i seguenti passaggi:
Vai alla scheda Impostazioni tecniche.
Per il campo Host target, inserisci il nome dell'endpoint Private Service Connect che hai creato per accedere a IAM.
Per il campo N.servizio, assicurati che sia specificato il valore
443.Vai alla scheda Accesso e sicurezza.
Per il campo Certificato SSL, assicurati che sia selezionata l'opzione Client SSL predefinito (standard).
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.
In SAP GUI, esegui il codice transazione
/GOOG/SDK_IMG.In alternativa, esegui il codice transazione
SPROe poi fai clic su Immagine di riferimento SAP.Fai clic su ABAP SDK for Google Cloud > Impostazioni di base > Configura mappa dei servizi.
Fai clic su Nuove voci.
Specifica le destinazioni RFC per l'API IAM e altre API, ad esempio
Cloud Pub/Sub API v1.
| Campo | Descrizione |
|---|---|
| Nome della chiave Google Cloud | Specifica il nome della configurazione della chiave client. |
| Nome del servizio Google | Specifica il servizio Google Cloud per cui stai mappando una destinazione RFC. |
| Destinazione RFC | Specifica il nome della destinazione RFC. |
La destinazione RFC specificata nella tabella di mappatura dei servizi viene utilizzata dall'SDK quando viene creata un'istanza di una classe della libreria client e utilizzata dal codice sorgente ABAP per chiamare un'API Google Cloud.
Logging delle applicazioni
Per scrivere i log delle applicazioni, l'ABAP SDK per Google Cloud è dotato di un framework di logging incorporato. L'oggetto log ZGOOG e l'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 e sottooggetti di log personalizzati al framework di registrazione dell'SDK.
Puoi visualizzare i log delle applicazioni SAP standard utilizzando la transazione SLG1.
Per ulteriori informazioni, consulta la sezione Registrazione.
Configura il logging utilizzando l'oggetto e il sottooggetto log 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:
In SAP GUI, esegui il codice transazione
/GOOG/SDK_IMG.In alternativa, esegui il codice transazione
SPROe poi fai clic su Immagine di riferimento SAP.Fai clic su ABAP SDK for Google Cloud > Impostazioni di base > Configura il framework di logging.
Fai clic su Nuove voci.
Inserisci i valori per i seguenti campi:
Campo Descrizione Oggetto Inserisci ZGOOG.Oggetto secondario Inserisci ZABAP_SDK.Livello log Specifica il livello minimo di log. I valori supportati sono:
I: informazioni, avvisi ed erroriW: avvisi ed erroriE: 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 per cui i log verranno conservati. Fine Specifica la data di fine fino alla quale questa configurazione del log sarà attiva. La data di fine predefinita è 9999/12/31.È predefinito Per impostare questa configurazione di log come predefinita, seleziona la casella di controllo.
Aggiungere oggetti di log personalizzati
Puoi anche aggiungere oggetti e sottooggetti di log personalizzati al framework di logging dell'SDK.
Per aggiungere un oggetto e un sottooggetto del log personalizzati:
In SAP GUI, esegui il codice transazione
/GOOG/SDK_IMG.In alternativa, esegui il codice transazione
SPROe poi fai clic su Immagine di riferimento SAP.Fai clic su ABAP SDK for Google Cloud > Impostazioni di base > Configura il framework di logging.
Fai clic su Nuove voci.
Inserisci i valori per i seguenti campi:
Campo Descrizione Oggetto Inserisci un nome per l'oggetto log. Oggetto secondario Inserisci un nome per il sottooggetto del log. Livello di log Specifica il livello minimo di log. I valori possibili sono:
I: informazioni, avvisi ed erroriW: avvisi ed erroriE: 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 per cui i log verranno conservati. Fine Data di fine fino alla quale questa configurazione del log sarà attiva. La data di fine predefinita è 9999/12/31.È predefinito Specifica se questa è la configurazione predefinita dei log.
Se devi impostare qualsiasi oggetto e sottooggetto del log personalizzato come configurazione di logging predefinita, cancella il campo È predefinito per la voce predefinita corrente, quindi seleziona il campo È predefinito per la nuova voce che devi impostare come predefinita.
Puoi mantenere una sola configurazione di log come voce predefinita in un determinato momento.
Puoi anche utilizzare gli oggetti e i sottooggetti di log personalizzati anche senza impostarli come predefiniti. Per farlo, dopo aver creato gli oggetti e i sottooggetti di log personalizzati nel framework di logging, devi passarli quando inizializzi gli stub del client API. Per ulteriori informazioni, consulta la sezione Registrazione.
Se una configurazione dei log non è più necessaria, puoi disattivarla.
Per disattivare una configurazione dei log, segui questi passaggi:
In SAP GUI, esegui il codice transazione
/GOOG/SDK_IMG.In alternativa, esegui il codice transazione
SPROe poi fai clic su Immagine di riferimento SAP.Fai clic su ABAP SDK for Google Cloud > Impostazioni di base > Configura il framework di logging.
Imposta il campo Fine su una data passata.
Tabelle di configurazione principali nell'SDK ABAP per Google Cloud
Tabella /GOOG/CLIENT_KEY
Per la configurazione relativa all'autenticazione e alla connettività,
l'ABAP SDK per Google Cloud utilizza la tabella /GOOG/CLIENT_KEY. Nella tabella/GOOG/CLIENT_KEY, configuri le chiavi client utilizzando i dettagli specifici del tuo metodo di autenticazione. Per ulteriori informazioni sui metodi di autenticazione e sulla configurazione delle chiavi client correlate, consulta Autenticazione.
Per visualizzare la tabella /GOOG/CLIENT_KEY:
In SAP GUI, esegui il codice transazione
/GOOG/SDK_IMG.In alternativa, esegui il codice transazione
SPROe poi fai clic su Immagine di riferimento SAP.Fai clic su ABAP SDK for Google Cloud > Impostazioni di base > Configura chiave client.
La tabella seguente illustra i campi della tabella delle chiavi client:
| Campo | Tipo di dati | Descrizione |
|---|---|---|
| Nome della 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 nella VM host.
|
| ID progetto | Stringa | L'ID del progetto Google Cloud contenente le API di destinazione. |
| Nome comando | Stringa | Nome del 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 memorizzare o meno nella cache i token di accesso recuperati da Google Cloud. Ti consigliamo di attivare la memorizzazione nella cache dei token al termine della configurazione e del test della connessione a Google Cloud. Per ulteriori informazioni sulla memorizzazione nella cache dei token, consulta Attivare la memorizzazione nella cache dei token. |
| Secondi di aggiornamento token | Stringa | Il periodo di tempo, in secondi, prima che un token di accesso scada e
debba essere aggiornato.
La specifica di un valore compreso tra 1 e 3599 ha la precedenza sul tempo di scadenza predefinito di 3500 secondi. Se specifichi 0,
l'SDK utilizza il valore predefinito.
Il valore predefinito è 3500. |
| Parametro di autorizzazione 1 | Stringa | Si tratta di un parametro di autorizzazione aggiuntivo che richiede la configurazione in situazioni specifiche. In genere, questo campo viene lasciato vuoto. |
| Parametro di autorizzazione 2 | Stringa | Si tratta di un parametro di autorizzazione aggiuntivo che richiede la configurazione in situazioni specifiche. In genere, questo campo viene lasciato vuoto. |
Tabella /GOOG/SERVIC_MAP
Per mappare la configurazione del servizio alle destinazioni RFC, l'SDK ABAP per Google Cloud utilizza la tabella /GOOG/SERVIC_MAP.
A seconda dei metodi di autenticazione, questa tabella contiene alcune voci obbligatorie e consigliate.
Per visualizzare la tabella /GOOG/SERVIC_MAP:
In SAP GUI, esegui il codice transazione
/GOOG/SDK_IMG.In alternativa, esegui il codice transazione
SPROe poi fai clic su Immagine di riferimento SAP.Fai clic su ABAP SDK for Google Cloud > Impostazioni di base > Configura mappatura dei servizi.
La tabella seguente illustra i campi della tabella di mappatura dei servizi:
| Campo | Tipo di dati | Descrizione |
|---|---|---|
| Nome | Stringa | Il nome della configurazione della chiave client. |
| Nome del servizio Google | Stringa | Il nome del servizio Google Cloud. Per trovare un servizio, utilizza la guida alla ricerca. |
| Destinazione RFC | Stringa | Il nome della destinazione RFC. Per trovare una destinazione RFC pertinente, utilizza la guida alla ricerca. |
Guida alla Ricerca
Per trovare i valori disponibili per un campo, fai clic sull'icona come mostrato nello screenshot seguente:
Tabella /GOOG/LOG_CONFIG
Per scrivere i log delle applicazioni, l'ABAP SDK per Google Cloud
utilizza la tabella /GOOG/LOG_CONFIG.
Per visualizzare la tabella /GOOG/LOG_CONFIG:
In SAP GUI, esegui il codice transazione
/GOOG/SDK_IMG.In alternativa, esegui il codice transazione
SPROe poi fai clic su Immagine di riferimento SAP.Fai clic su ABAP SDK for Google Cloud > Impostazioni di base > Configura il framework di logging.
La tabella seguente descrive i campi della tabella di configurazione del logging:
| Campo | Descrizione |
|---|---|
| Oggetto | Il nome dell'oggetto log. |
| Oggetto secondario | Il nome del sottooggetto del log. |
| Livello di log | Mostra il livello minimo di log. I valori possibili sono:
|
| Conservazione | Il numero di giorni di conservazione dei log. Dopo il periodo di conservazione, puoi prendere in considerazione l'eliminazione dei log utilizzando la transazione |
| Fine | Data di fine fino alla quale questa configurazione del log sarà attiva.
La data di fine predefinita è 9999/12/31.
|
| È predefinito | Indica se si tratta della configurazione predefinita dei log. |
| Autore modifica | Nome utente che ha modificato la configurazione dei log. |
| Modificate il giorno | Data di modifica della configurazione del log. |
| Modificato il giorno | Ora in cui è stata modificata la configurazione del log. |
Memorizzazione nella cache dei token
Se l'SDK viene utilizzato in un caso d'uso con un volume elevato di chiamate in cui vengono eseguite più chiamate ai metodi API in un breve periodo di tempo, abilita la memorizzazione nella cache per il token di accesso o la chiave API ottenuta dalla configurazione della chiave client per accedere alle API Google Cloud.
L'attivazione della memorizzazione nella cache dei token garantisce che un token di accesso o una chiave API venga riutilizzato fino alla scadenza o alla revoca, il che a sua volta riduce il numero di chiamate HTTP effettuate per recuperare nuovi token di accesso o nuove chiavi API.
Per attivare la memorizzazione nella cache dei token, seleziona l'indicatore 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 memoria condivisa del server di applicazioni per la durata impostata per il campo Secondi di aggiornamento token nella tabella delle chiavi client.
Se Token Refresh Seconds non è specificato o è impostato su 0, il token di accesso viene memorizzato nella cache per il valore specificato nel parametro CMD_SECS_DEFLT nelle impostazioni avanzate.
Cancellare il token di accesso memorizzato nella cache
Quando la memorizzazione nella cache dei token è attivata e aggiorni i ruoli assegnati all'account di servizio utilizzato dall'SDK ABAP per Google Cloud per accedere alle API pertinenti, il nuovo token di accesso corrispondente ai ruoli aggiornati viene recuperato 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 passaggi che seguono:
In SAP GUI, esegui il codice transazione
/GOOG/SDK_IMG.In alternativa, esegui il codice transazione
SPROe poi fai clic su Immagine di riferimento SAP.Fai clic su ABAP SDK for Google Cloud > Utilità > Svuota cache.
Seleziona un'opzione, a seconda dei casi:
- Cancella area memoria condivisa: per svuotare l'intera cache.
- Cancella istanza dalla memoria: per cancellare il token di accesso memorizzato nella cache per una determinata istanza. Con questa opzione, specifichi anche un nome dell'istanza.
Esegui il report.
Trovare i ruoli IAM per le API Google Cloud
Per implementare il principio del privilegio minimo, è essenziale conoscere i ruoli IAM appropriati per le API Google Cloud che prevedi di utilizzare nel tuo programma ABAP. Concedendo solo i ruoli necessari, puoi limitare l'accesso per un account di servizio. L'utilità Ricerca ruoli, integrata nell'SDK, ti consente di identificare facilmente i ruoli IAM associati a varie API Google Cloud.
Per trovare i ruoli IAM:
In SAP GUI, esegui il codice transazione
/GOOG/SDK_IMG.In alternativa, esegui il codice transazione
SPROe poi fai clic su Immagine di riferimento SAP.Fai clic su ABAP SDK for Google Cloud > Utilità > Recupera i ruoli pertinenti dell'API.
In alternativa, puoi accedere all'utilità Ricerca ruoli eseguendo il codice transazione
/GOOG/ROLE_FINDER.Nel campo Chiave client, inserisci un nome della chiave client valido configurato nella tabella
/GOOG/CLIENT_KEY.Nel campo Nome servizio Google, specifica l'API Google Cloud per la quale devi controllare i ruoli IAM.
Se vuoi, per visualizzare le autorizzazioni IAM associate nel ruolo IAM, seleziona il campo Dettagli completi.
Fai clic su Execute (Esegui). Vengono visualizzati i ruoli IAM.
Impostazioni avanzate
Se vuoi, puoi modificare i parametri delle impostazioni avanzate per l'SDK nella tabella /GOOG/SDK_PARAM. Questi valori del 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. Utilizza le impostazioni avanzate solo se vuoi sostituire i valori predefiniti.
Ti consigliamo di modificare i parametri delle impostazioni avanzate solo dopo un'analisi completa e l'impatto dei nuovi valori sul rendimento dell'SDK. È tua responsabilità assicurarti che le nuove impostazioni avanzate non causino errori e problemi di prestazioni.
Per modificare i parametri delle impostazioni avanzate:
In SAP GUI, esegui il codice transazione
/GOOG/SDK_IMG.In alternativa, esegui il codice transazione
SPROe poi fai clic su Immagine di riferimento SAP.Fai clic su ABAP SDK for Google Cloud > Impostazioni di base > Configura parametri.
Fai clic su Nuove voci.
Nella riga visualizzata, specifica le seguenti impostazioni:
- Nel campo Nome parametro, inserisci il nome del parametro. La descrizione del parametro viene compilata automaticamente.
- Nel campo Valore parametro, inserisci un valore.
Per informazioni sui parametri delle impostazioni avanzate, consulta Parametri delle impostazioni avanzate.
Salva la nuova voce.
Parametri delle impostazioni avanzate
La tabella seguente mostra i parametri delle impostazioni avanzate per ABAP SDK for Google Cloud.
| Nome parametro | Descrizione | Valore predefinito | Valore valido |
|---|---|---|---|
CMD_SECS_DEFLT |
Se hai attivato la memorizzazione nella cache dei token, questo è il tempo in secondi dopo il quale il token memorizzato nella cache scade. | 3500 | Il valore deve essere compreso tra 1 e 3599. |
Aggiornare l'SDK ABAP per Google Cloud
Google Cloud rilascia nuove release dell'SDK ABAP per Google Cloud come trasporti SAP.
Se riscontri problemi durante l'importazione dei file di trasporto dell'SDK ABAP per Google Cloud nel tuo ambiente SAP, ad esempio problemi con la revisione del trasporto da parte di SAP o con la gestione della coda di importazione, contatta l'assistenza clienti Google Cloud per ricevere assistenza. Per informazioni su come contattare l'assistenza clienti, consulta Assistenza per SAP su Google Cloud.
Gli amministratori SAP possono aggiornare ABAP SDK for Google Cloud seguendo questa procedura:
Nell'ambiente SAP, interrompi i job in background che utilizzano gli eventuali stub client dell'API esistenti dell'SDK ABAP per Google Cloud.
Scarica il pacchetto di installazione contenente i file di trasporto dal portale di download.
Importa le seguenti richieste di trasporto SAP:
Se stai aggiornando l'SDK dalla versione
1,1.5o1.6alla versione più recente, copia i seguenti file di trasporto nelle directory di importazione del trasporto del server SAP:/usr/sap/trans/cofiles/K900323.GM1/usr/sap/trans/data/R900323.GM1Questi file di trasporto rimuovono gli elementi associati alle funzionalità ritirate nell'SDK ABAP per Google Cloud. Per informazioni su aggiunte, miglioramenti e funzionalità ritirate, consulta Novità dell'edizione on-premise o cloud di ABAP SDK for Google Cloud.
Se stai aggiornando l'SDK dalla versione
1.7o successive alla versione più recente, puoi saltare la copia di questi file di trasporto.
Per stabilire la connessione con le API Google Cloud supportate e autenticarti con token o chiavi API, copia i seguenti file di trasporto nelle directory di importazione del trasporto del server SAP:
/usr/sap/trans/cofiles/K900319.GM1/usr/sap/trans/data/R900319.GM1
Per l'autenticazione con le credenziali client OAuth 2.0, copia i seguenti file di trasporto nelle directory di importazione del trasporto del server SAP:
/usr/sap/trans/cofiles/K900321.GM1/usr/sap/trans/data/R900321.GM1Questi file di trasporto non forniscono funzionalità aggiuntive, diversa dall'autenticazione basata sulle credenziali client OAuth 2.0. Per l'autenticazione basata sulle credenziali client OAuth 2.0, prima importa i file di trasporto per le API Google Cloud supportate, poi importa i file di trasporto per le credenziali client OAuth 2.0.
Per utilizzare le credenziali client OAuth 2.0, il sistema SAP deve supportare OAuth 2.0. Per informazioni sui sistemi SAP che supportano OAuth 2.0, consulta la nota SAP 3041322 - OAuth 2.0 Client: Downport of grant type Client Credentials.
Dopo aver convalidato l'importazione e l'attivazione degli oggetti, riprendi i lavori in background.
Metriche di utilizzo
La versione on-premise o qualsiasi versione cloud di ABAP SDK for Google Cloud raccoglie le metriche di utilizzo e le invia a Google per finalità di assistenza, in conformità con l'Informativa sulla privacy di Google Cloud (Dati di servizio raccolti da Google). Queste metriche di utilizzo vengono raccolte ogni volta che viene invocata un'API Google Cloud dall'ABAP SDK 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 dell'SDK ABAP: numero di versione dell'edizione on-premise o cloud dell'SDK ABAP per Google Cloud.
- Release SAP_ABA: versione del componente software SAP_ABA.
- Identificatore del modulo (raccolto solo per l'SDK Vertex AI per ABAP): nome del modulo o della funzionalità utilizzata all'interno dell'SDK, ad esempio Ricerca vettoriale.
Licenze
La versione on-premise o qualsiasi versione cloud di ABAP SDK per Google Cloud viene resa disponibile come "Software" ai sensi del contratto che regola il tuo utilizzo della Google Cloud Platform, inclusi i Termini di servizio specifici disponibili all'indirizzo https://cloud.google.com/terms/service-terms. Senza limitare la generalità dei termini di cui sopra, non puoi modificare o distribuire l'SDK ABAP per Google Cloud senza l'autorizzazione scritta espressa di Google.
Il software ABAP SDK for Google Cloud è offerto senza costi. Per chiarire, l'utilizzo di altro "Software" e "Servizi" ai sensi del contratto che regola l'utilizzo della Google Cloud Platform, come l'API Cloud Translation e l'API Pub/Sub, potrebbe comportare un costo.
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'ABAP SDK for Google Cloud supporta solo l'inglese (EN).
L'SDK utilizza per impostazione predefinita l'inglese (EN) per le seguenti lingue di accesso SAP:
cinese (CH), francese (FR), tedesco (DE), giapponese (JA), portoghese (PT)
e russo (RU).
Eventuali messaggi di errore che potresti riscontrare durante l'utilizzo dell'SDK vengono generati in inglese, indipendentemente dalla lingua di sistema corrente.
Ciclo di vita dell'assistenza
Google Cloud supporta e gestisce l'attuale versione principale dell'SDK ABAP per Google Cloud per un periodo di almeno 12 mesi dalla pubblicazione di una notifica di ritiro della versione principale precedente nella pagina delle note di rilascio per SAP su Google Cloud.
Assistenza
Se hai bisogno di aiuto per risolvere i problemi relativi all'SDK ABAP per Google Cloud, segui questi passaggi:
Fai riferimento alla guida alla risoluzione dei problemi di ABAP SDK for Google Cloud.
Poni le tue domande e discuti dell'ABAP SDK per Google Cloud con la community nei forum di Cloud.
Raccogli tutte le informazioni di diagnostica disponibili e contatta l'assistenza clienti Google Cloud. Per informazioni su come contattare il team dell'assistenza clienti, consulta Assistenza per SAP su Google Cloud.