Integrazioni di carichi di lavoro SAP - Amazon Quick Suite
Cosa puoi farePrima di iniziarePrepara la configurazione e l'autenticazione del sistema SAPConfigura le integrazioni SAPOperazioni disponibili per tipo di connettoreParametri di queryGestisci le integrazioni dei carichi di lavoro SAPRisolvi i problemi relativi alle integrazioni dei carichi di lavoro SAP

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 Suite 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 Suite Author o versione successiva.

  • Connettività di rete tra Amazon Quick Suite e il tuo sistema SAP.

Prepara la configurazione e l'autenticazione del sistema SAP

Prima di configurare l'integrazione in Amazon Quick Suite, prepara la configurazione del sistema SAP e l'autenticazione degli utenti. Le integrazioni di 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

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 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 Suite, scegli Integrazioni.

  2. 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

  3. Fai clic su Aggiungi (più il pulsante «+»).

  4. Inserisci il nome e la descrizione della tua integrazione SAP.

  5. Scegli il tipo di connessione per la tua integrazione.

  6. Configura l'autenticazione utilizzando uno dei metodi supportati:

    1. OAuth Configurazione 2.0

      Per l'autenticazione OAuth 2.0, fornisci:

      • Client ID: 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

    2. 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

  7. Seleziona Crea e continua.

  8. Scegli gli utenti con cui condividere l'integrazione.

  9. 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 Suite. Puoi eseguire azioni specifiche di SAP direttamente da Amazon Quick Suite 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
# Parametro Description Tipo
1 $top Limita il numero di articoli restituiti integer
2 $skip Ignora il numero di articoli specificato integer
3 $filter Filtra i risultati in base a criteri specificati string
4 $orderby Ordina i risultati in base ai campi specificati array
5 $select Seleziona proprietà specifiche da restituire array
6 $expand Espande le entità correlate array
7 $inlinecount Include il numero di elementi in risposta string

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 Suite, scegli Integrazioni.

  2. Scegli il tipo di integrazione del carico di lavoro SAP dalla griglia di integrazione.

  3. Seleziona la tua integrazione dall'elenco e scegli Modifica.

  4. 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.

  5. 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.

  2. 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.

  3. Imposta i livelli di autorizzazione per l'accesso condiviso.

  4. 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.

  2. Verifica l'impatto dell'eliminazione, inclusi eventuali flussi di lavoro o automazioni che utilizzano questa integrazione.

  3. Digita il nome dell'integrazione per confermare l'eliminazione.

  4. 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