Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Integrazioni di carichi di lavoro SAP
Con le integrazioni dei carichi di lavoro SAP, puoi eseguire azioni all'interno di vari sistemi SAP. Gestisci dati aziendali, inventario, materiali e processi aziendali. Queste integrazioni supportano solo l'esecuzione delle azioni e richiedono il livello Amazon Quick Pro o superiore.
## Cosa puoi fare
Le integrazioni di carichi di lavoro SAP forniscono una connettività di livello aziendale per aiutarti a lavorare con i tuoi sistemi SAP.
**Connettore d'azione**
Esegui azioni all'interno dei sistemi SAP. Crea, aggiorna e gestisci dati aziendali, registri di inventario, informazioni sui materiali e altre operazioni aziendali tramite APIs SAP.
**Moduli SAP multipli**
Support per cinque diversi tipi di integrazione: Bill of Materials, Business Partner, Material Stock, Physical Inventory Documents e Product Master.
## Prima di iniziare
Prima di configurare le integrazioni dei carichi di lavoro SAP, assicurati di disporre di quanto segue:
+ Sistema SAP con moduli appropriati installati e configurati.
+ Account utente SAP con le autorizzazioni e le autorizzazioni necessarie.
+ Amazon Quick Author o versione successiva.
+ Connettività di rete tra Amazon Quick e il tuo sistema SAP.
## Prepara la configurazione e l'autenticazione del sistema SAP
Prima di configurare l'integrazione in Amazon Quick, prepara la configurazione del sistema SAP e l'autenticazione degli utenti. Le integrazioni dei carichi di lavoro SAP supportano diversi metodi di autenticazione e richiedono una corretta configurazione del sistema.
### Metodi di autenticazione
Le integrazioni dei carichi di lavoro SAP supportano due metodi di autenticazione:
**OAuth 2.0 (consigliato)**
Metodo di autenticazione sicuro per flussi di lavoro automatizzati. Richiede OAuth la configurazione nel sistema SAP.
**Parametri richiesti:**
+ **ID cliente: ID** OAuth client SAP
+ **Segreto del cliente: segreto** del cliente SAP OAuth
+ **URL del token**: endpoint OAuth del token (ad es.) `https://hostname:port/sap/bc/sec/oauth2/token?sap-client=100`
+ **URL del dominio**: endpoint dell'API del sistema SAP (ad es.) `https://hostname:port/sap/opu/odata/sap/API_BUSINESS_PARTNER`
**Autenticazione di base**
Autenticazione con nome utente e password per l'accesso diretto al sistema SAP.
**Parametri richiesti:**
+ **Nome utente: nome utente** del sistema SAP
+ **Password: password** del sistema SAP
+ **URL del dominio: endpoint dell'**API del sistema SAP
### Requisiti di configurazione del sistema SAP
Prima di utilizzare le integrazioni dei carichi di lavoro SAP, assicurati che il sistema SAP sia configurato correttamente:
#### OAuth configurazione 2.0
Per l'autenticazione OAuth 2.0:
+ Configurare il server di OAuth autorizzazione con gli ambiti appropriati
+ Verify OAuth è abilitato per il servizio utilizzando il codice di transazione `/IWFND/MAINT_SERVICE`
+ Consulta la documentazione SAP per la configurazione OAuth 2.0 dettagliata: Guida alla [configurazione OAuth 2.0](https://help.sap.com/docs/ABAP_PLATFORM_NEW/fd0fc52fd22b45f29d274a7f8236e768/cdb122d5b0784c77bf1bcce17f730e74.html)
#### Attivazione dell'API SAP
Assicurati che i servizi API SAP richiesti siano attivi:
+ Attiva il servizio API specifico per il connettore SAP scelto
+ Verifica lo stato del servizio API nel tuo sistema SAP
+ Consulta la documentazione SAP per l'attivazione delle API: [SAP API](https://help.sap.com/doc/saphelp_nw75/7.5.5/en-US/1b/023c1cad774eeb8b85b25c86d94f87/frameset.htm) Service Activation Guide
### Tipi di integrazione dei carichi di lavoro SAP disponibili
Scegli il tipo di integrazione SAP più adatto alle tue esigenze aziendali e assicurati che il modulo SAP corrispondente sia disponibile nel tuo sistema.
**Distinta base SAP**
Gestisci i dati della distinta base, inclusi gli elenchi dei componenti, le quantità e le specifiche di produzione.
**Ambito richiesto:** `ZAPI_BILL_OF_MATERIAL_SRV_0002`
**Partner commerciale SAP**
Gestisci le informazioni sui partner commerciali, inclusi i dati di clienti e fornitori, i dettagli di contatto e la gestione delle relazioni.
**Ambito richiesto:** `ZAPI_BUSINESS_PARTNER_0001`
**Stock di materiali SAP**
Accedi e gestisci i livelli delle scorte di materiale, i movimenti di inventario e le informazioni di magazzino.
**Ambito richiesto:** `ZAPI_MATERIAL_STOCK_SRV_0001`
**Documenti di inventario fisico SAP**
Crea e gestisci documenti di inventario fisico, conteggi delle scorte e processi di riconciliazione dell'inventario.
**Ambito richiesto:** `ZAPI_MATERIAL_STOCK_SRV_0001`
**Master del prodotto SAP**
Conserva i dati anagrafici del prodotto, comprese le specifiche dei materiali, le classificazioni e le gerarchie dei prodotti.
**Ambito richiesto:** `ZAPI_PRODUCT_SRV_0001`
### Configurazione dell'autenticazione del carico di lavoro SAP
Prepara le credenziali di autenticazione degli utenti SAP e assicurati le autorizzazioni di accesso al sistema adeguate.
+ **URL del sistema SAP: ottieni l'URL** di base o l'indirizzo del server per il tuo sistema SAP.
+ **Credenziali utente**: crea o identifica un account utente SAP con le autorizzazioni appropriate.
+ **Autorizzazioni di sistema**: assicurati che l'account utente disponga delle autorizzazioni SAP e dei codici di transazione necessari per i moduli SAP specifici che intendi integrare.
+ **Accesso alla rete**: verifica che il sistema SAP sia accessibile da connessioni esterne e che le regole del firewall consentano l'integrazione.
## Configura le integrazioni SAP
Dopo aver preparato la configurazione del sistema SAP e le credenziali di autenticazione, il processo di configurazione è simile per tutti i tipi di integrazione SAP. Scegli tra OAuth 2.0 o Basic Authentication in base ai tuoi requisiti di sicurezza.
1. Nella console Amazon Quick, scegli **Integrazioni.**
1. Seleziona uno dei connettori SAP disponibili:
+ **Distinta base SAP**
+ **Partner commerciale SAP**
+ **Stock di materiali SAP**
+ **Documenti di inventario fisico SAP**
+ **Master del prodotto SAP**
1. Fai clic su **Aggiungi** (più il pulsante «\$1»).
1. Inserisci il nome e la descrizione della tua integrazione SAP.
1. Scegli il tipo di connessione per la tua integrazione.
1. Configura l'autenticazione utilizzando uno dei metodi supportati:
1. **OAuth configurazione 2.0**
Per l'autenticazione OAuth 2.0, fornisci:
+ **ID cliente**: il tuo ID OAuth client SAP
+ **Client Secret**: il segreto del tuo client SAP OAuth
+ **URL del token: URL dell'**endpoint OAuth del token
+ **URL del dominio: URL dell'**endpoint dell'API del sistema SAP
1. **Configurazione di autenticazione di base**
Per l'autenticazione di base, fornisci:
+ **Nome utente**: il nome utente del sistema SAP
+ **Password**: la password del sistema SAP
+ **URL del dominio: URL dell'**endpoint dell'API del sistema SAP
1. Seleziona **Crea e continua.**
1. Scegli gli utenti con cui condividere l'integrazione.
1. Fare clic su **Avanti**.
### Risultato previsto
Dopo una corretta configurazione, l'integrazione del carico di lavoro SAP viene visualizzata nell'elenco delle integrazioni ed è disponibile per l'uso nei flussi di lavoro, nelle automazioni e negli agenti AI di Amazon Quick. Puoi eseguire azioni specifiche di SAP direttamente da Amazon Quick utilizzando le credenziali di autenticazione configurate.
## Operazioni disponibili per tipo di connettore
Ogni connettore per carichi di lavoro SAP fornisce operazioni specifiche personalizzate in base al relativo dominio aziendale. Esamina le operazioni disponibili per il tipo di connettore scelto.
### Operazioni SAP Bill of Materials
Operazioni disponibili per la gestione dei dati della distinta base:
+ **Get Material BOM Item**: recupera i dettagli della distinta base per materiali specifici
**ID dell'operazione:** `getMaterialBOMItem`
**Punto finale:** `GET /MaterialBOMItem`
### Operazioni SAP Business Partner
Operazioni disponibili per la gestione dei dati dei partner commerciali:
+ **Get Business Partner**: recupera i dati generali dei partner commerciali
**ID dell'operazione:** `getBusinessPartner`
+ **Ottieni gli indirizzi dei partner commerciali** - Recupera i dati degli indirizzi dei partner commerciali
**ID dell'operazione:** `getBusinessPartnerAddress`
+ **Ottieni ruoli da partner commerciale**: recupera i dati relativi ai ruoli dei partner commerciali
**ID dell'operazione:** `getBusinessPartnerRole`
+ **Get Business Partner by ID**: recupera i dati del partner commerciale in base al numero del partner commerciale
**ID dell'operazione:** `getBusinessPartnerByID`
**Parametro richiesto:** `BusinessPartner` (stringa, max 10 caratteri)
+ **Get Business Partner Role by ID**: recupera i dati relativi al ruolo di business partner utilizzando i campi chiave
**ID dell'operazione:** `getBusinessPartnerRoleByID`
**Parametri richiesti:** `BusinessPartner` (stringa, massimo 10 caratteri), `BusinessPartnerRole` (stringa, massimo 6 caratteri)
### Operazioni SAP Material Stock
Operazioni disponibili per la gestione dei dati sulle scorte di materiale:
+ **Ottieni scorte di materiale nell'account**: recupera le informazioni sulle scorte di materiale pubblicate nel modello di account
**ID dell'operazione:** `getMaterialStockInAccount`
### Operazioni relative ai documenti di inventario fisico SAP
Operazioni disponibili per la gestione dei documenti di inventario fisico:
+ **Get PhysInventory Doc Item**: legge le informazioni sugli articoli dell'inventario fisico
**ID dell'operazione:** `getPhysInventoryDocItem`
### Operazioni SAP Product Master
Operazioni disponibili per la gestione dei dati anagrafici dei prodotti:
+ **Ottieni l'articolo principale del prodotto**: restituisce i record anagrafici del prodotto
**ID dell'operazione:** `getProductMaster`
+ **Ottieni i dati dell'impianto per materiale**: restituisce i dati dell'impianto contenuti nella scheda principale del prodotto
**ID dell'operazione:** `getPlantDataByMaterial`
**Parametro richiesto:** `Product` (stringa, max 40 caratteri)
+ **Ottieni i dati di pianificazione della fornitura per materiale**: restituisce i dati di pianificazione della fornitura per numero di prodotto e impianto
**ID dell'operazione:** `getSupplyPlanningDataByMaterial`
**Parametri richiesti:** `Product` (stringa, max 40 caratteri), `Plant` (stringa, massimo 4 caratteri)
## Parametri di query
I connettori SAP supportano i parametri di query standard per filtrare, ordinare e formattare le risposte API. Utilizza questi parametri per ottimizzare il recupero e l'elaborazione dei dati.
**Parametri di interrogazione supportati**
| \$1 | Parametro | Description | Tipo |
| --- | --- | --- | --- |
| 1 | \$1top | Limita il numero di articoli restituiti | intero |
| 2 | \$1skip | Ignora il numero di articoli specificato | intero |
| 3 | \$1filter | Filtra i risultati in base a criteri specificati | stringa |
| 4 | \$1orderby | Ordina i risultati in base ai campi specificati | array |
| 5 | \$1select | Seleziona proprietà specifiche da restituire | array |
| 6 | \$1expand | Espande le entità correlate | array |
| 7 | \$1inlinecount | Include il numero di elementi in risposta | stringa |
## Gestisci le integrazioni dei carichi di lavoro SAP
Dopo aver creato l'integrazione dei carichi di lavoro SAP, puoi gestirla tramite diverse opzioni.
### Modifica le impostazioni di integrazione
Segui questi passaggi per modificare le impostazioni di integrazione del carico di lavoro SAP.
1. Nella console Amazon Quick, scegli **Integrazioni.**
1. Scegli il tipo di integrazione del carico di lavoro SAP dalla griglia di integrazione.
1. **Seleziona la tua integrazione dall'elenco e scegli Modifica.**
1. Modifica le impostazioni di integrazione:
+ Aggiorna le credenziali di autenticazione (nome utente e password).
+ Modifica l'URL o le impostazioni di connessione del sistema SAP.
+ Modifica il nome o la descrizione dell'integrazione.
1. Scegli **Salva modifiche** per applicare le modifiche.
### Condividi l'integrazione
Puoi condividere i connettori SAP Workload Action con altri utenti della tua organizzazione.
1. **Dalla pagina dei dettagli dell'integrazione SAP, scegli Condividi.**
1. Configura le opzioni di condivisione:
+ **Condividi con utenti specifici**: inserisci nomi utente o indirizzi e-mail.
+ **Condividi con l'organizzazione**: rendilo disponibile a tutti gli utenti dell'organizzazione.
1. Imposta i livelli di autorizzazione per l'accesso condiviso.
1. Scegli **Condividi integrazione** per applicare le impostazioni di condivisione.
### Elimina l'integrazione
Segui questi passaggi per rimuovere definitivamente l'integrazione SAP.
1. **Dalla pagina dei dettagli dell'integrazione del carico di lavoro SAP, scegli Elimina.**
1. Verifica l'impatto dell'eliminazione, inclusi eventuali flussi di lavoro o automazioni che utilizzano questa integrazione.
1. Digita il nome dell'integrazione per confermare l'eliminazione.
1. Scegli **Elimina integrazione** per rimuoverla definitivamente.
## Risolvi i problemi relativi alle integrazioni dei carichi di lavoro SAP
Utilizza questi suggerimenti per la risoluzione dei problemi più comuni di integrazione dei carichi di lavoro SAP.
### Problemi di autenticazione
OAuth errori di autenticazione 2.0
**Sintomi:** la generazione di token non riesce, credenziali client non valide o OAuth errori di ambito.
**Risoluzione:**
+ Verifica che l'ID e OAuth il segreto del client siano corretti
+ Verifica che OAuth sia configurato correttamente in SAP utilizzando la transazione `/IWFND/MAINT_SERVICE`
+ Assicurati che gli ambiti richiesti siano configurati correttamente per il tipo di connettore per il carico di lavoro SAP
+ Verifica che il formato dell'URL del token corrisponda alla configurazione del tuo sistema SAP
Errori di autenticazione di base
**Sintomi:** errori di accesso, credenziali non valide o errori di accesso negato.
**Risoluzione:**
+ Verifica che il nome utente e la password SAP siano corretti
+ Verifica che l'account utente disponga delle autorizzazioni SAP necessarie
+ Assicurati che l'account utente non sia bloccato o scaduto
+ Verifica che l'URL del dominio sia accessibile e formattato correttamente
### Problemi di configurazione del sistema SAP
Servizio API non attivato
**Sintomi:** errori del servizio non disponibile, endpoint API non trovato o risposte HTTP 404.
**Risoluzione:**
+ Verifica che il servizio API SAP richiesto sia attivato nel tuo sistema
+ Verifica lo stato del servizio API utilizzando i codici di transazione SAP
+ Assicurati che il servizio API corrisponda al tipo di connettore SAP scelto
+ Contatta il tuo amministratore SAP per attivare i servizi API mancanti
Timeout di connessione.
**Sintomi:** timeout delle richieste, errori di connettività di rete o tempi di risposta lenti.
**Risoluzione:**
+ Verifica che l'URL del tuo sistema SAP sia corretto e accessibile
+ Verifica che la connettività di rete consenta le connessioni al sistema SAP
+ Assicurati che le regole del firewall consentano il traffico di integrazione
+ Verifica le prestazioni e la disponibilità del sistema SAP
### Errori di autorizzazione e autorizzazione
Autorizzazioni SAP insufficienti
**Sintomi:** errori di accesso negato, messaggi di autorizzazione mancanti o errori operativi limitati.
**Risoluzione:**
+ Assicurati che l'utente autenticato disponga delle autorizzazioni SAP richieste per il modulo specifico
+ Verifica che l'utente abbia accesso ai codici di transazione necessari
+ Verifica che l'account utente abbia le assegnazioni di ruolo appropriate
+ Contatta il tuo amministratore SAP per concedere le autorizzazioni mancanti
Errori di autorizzazione dell'ambito
**Sintomi:** errori di OAuth ambito, autorizzazioni insufficienti per le operazioni API o messaggi con accesso limitato.
**Risoluzione:**
+ Verifica che la OAuth configurazione includa l'ambito richiesto per il tipo di connettore
+ Verifica che le autorizzazioni dell'ambito siano concesse correttamente nel sistema SAP
+ Assicurati che al OAuth client siano stati concessi i diritti di accesso all'API necessari
### Errori nel formato dei dati e nei parametri
Formati di parametri non validi
**Sintomi:** errori di convalida dei dati, messaggi di lunghezza dei campi non validi o eccezioni nel formato dei parametri.
**Risoluzione:**
+ Rivedi i parametri di azione e assicurati che corrispondano ai formati di dati SAP previsti
+ Verifica che la lunghezza dei campi corrisponda ai requisiti del sistema SAP (ad esempio, BusinessPartner massimo 10 caratteri)
+ Verifica che i tipi di dati siano corretti per il modulo SAP specifico
+ Assicurati che tutti i campi obbligatori siano forniti per l'operazione
Errori nei parametri di interrogazione
**Sintomi:** errori di sintassi delle query, messaggi con parametri non supportati o errori di richiesta in formato errato.
**Risoluzione:**
+ Verifica che i parametri utilizzino la sintassi corretta (ad esempio,,) `$filter` `$top` `$skip`
+ Verificate che i valori dei parametri siano formattati correttamente
+ Assicurati che l'API SAP supporti i parametri specifici utilizzati
+ Consulta la documentazione dell'API SAP per le opzioni di query supportate
### Problemi di disponibilità del sistema SAP
Indisponibilità del sistema SAP
**Sintomi:** errori di connessione rifiutata, sistema non risponde o messaggi di servizio non disponibile.
**Risoluzione:**
+ Verifica lo stato e la disponibilità del sistema SAP con il tuo amministratore SAP
+ Verifica se ci sono finestre di manutenzione programmata che influiscono sul sistema
+ Verifica la presenza di eventuali avvisi o problemi noti del sistema SAP
+ Riprova l'operazione dopo aver confermato la disponibilità del sistema