SAP Ariba Procurement

Il connettore SAP Ariba Procurement ti consente di eseguire operazioni di inserimento, aggiornamento e lettura sui dati SAP Ariba Procurement.

Versioni supportate

Questo connettore supporta le API REST di SAP Ariba Procurement.

Prima di iniziare

Nel tuo progetto Google Cloud, esegui le seguenti attività:

  • Assicurati che la connettività di rete sia configurata. Per informazioni, consulta Connettività di rete.
  • Concedi il ruolo IAM roles/connectors.admin all'utente che configura il connettore.
  • Concedi i ruoli IAM roles/secretmanager.viewer e roles/secretmanager.secretAccessor al service account che vuoi utilizzare per il connettore.
  • Abilita secretmanager.googleapis.com (API Secret Manager) e connectors.googleapis.com (API Connectors). Per saperne di più, consulta Attivazione dei servizi.

Configura il connettore

Una connessione è specifica per un'origine dati. Ciò significa che se hai molte origini dati, devi creare una connessione separata per ciascuna. Per creare una connessione:

  1. Nella console Cloud, vai alla pagina Integration Connectors > Connessioni e poi seleziona o crea un progetto Google Cloud.

    Vai alla pagina Connessioni

  2. Fai clic su + CREA NUOVA per aprire la pagina Crea connessione.
  3. Nella sezione Località, completa quanto segue:
    1. Regione: seleziona una località dall'elenco a discesa.

      Per l'elenco di tutte le regioni supportate, consulta Località.

    2. Fai clic su Avanti.
  4. Nella sezione Dettagli connessione, completa quanto segue:
    1. Connettore: seleziona SAP Ariba Procurement dall'elenco dei connettori disponibili.
    2. Versione del connettore: seleziona la versione del connettore dall'elenco delle versioni disponibili.
    3. Nel campo Nome connessione, inserisci un nome per l'istanza di connessione. Il nome della connessione può contenere lettere minuscole, numeri o trattini. Il nome deve iniziare con una lettera e terminare con una lettera o un numero e non deve superare i 49 caratteri.
    4. Descrizione: inserisci una descrizione per l'istanza di connessione.
    5. (Facoltativo) Abilita Cloud Logging, quindi seleziona un livello di log. Per impostazione predefinita, il livello di log è impostato su Error.
    6. Service Account: seleziona un account di servizio con i ruoli richiesti.
    7. ANID: specifica l'ID rete SAP Ariba.
    8. Chiave API: inserisci la chiave dell'applicazione OAuth per l'autenticazione.
    9. Realm: inserisci il realm SAP Ariba per la connessione.
    10. API: inserisci l'API SAP Ariba da cui recuperare i dati.
    11. Data Center: inserisci la posizione geografica in cui sono ospitati i dati del tuo account.
    12. Environment (Ambiente): inserisci l'ambiente SAP Ariba a cui vuoi connetterti.
    13. (Facoltativo) Configura le impostazioni del nodo di connessione:

      • Numero minimo di nodi: inserisci il numero minimo di nodi di connessione.
      • Numero massimo di nodi: inserisci il numero massimo di nodi di connessione.

      Un nodo è un'unità (o una replica) di una connessione che elabora le transazioni. Sono necessari più nodi per elaborare più transazioni per una connessione e, viceversa, sono necessari meno nodi per elaborare meno transazioni. Per capire in che modo i nodi influiscono sui prezzi dei connettori, consulta la sezione Prezzi dei nodi di connessione. Se non inserisci alcun valore, per impostazione predefinita i nodi minimi sono impostati su 2 (per una migliore disponibilità) e i nodi massimi sono impostati su 50.

    14. + AGGIUNGI ETICHETTA: fai clic qui per aggiungere un'etichetta alla connessione sotto forma di coppia chiave/valore.
    15. Fai clic su Avanti.
  5. Nella sezione Autenticazione, inserisci i dettagli di autenticazione.
    1. Seleziona un Tipo di autenticazione e inserisci i dettagli pertinenti.

      La connessione SAP Ariba Procurement supporta i seguenti tipi di autenticazione:

      • OAuth 2.0 - Credenziali client

      Per capire come configurare questi tipi di autenticazione, consulta Configurare l'autenticazione.

    2. Fai clic su Avanti.
  6. Rivedi: rivedi i dettagli di connessione e autenticazione.
  7. Fai clic su Crea.

Configura l'autenticazione

Inserisci i dettagli in base all'autenticazione che vuoi utilizzare.

  • OAuth 2.0 - Credenziali client
    • ID client: inserisci l'ID client dell'applicazione che hai creato.
    • Client secret: inserisci il secret di Secret Manager contenente il client secret per l'app connessa che hai creato.
    • Versione del secret: seleziona la versione del secret per il secret client.
    • Enable Authentication Override (Attiva override autenticazione): attiva questa opzione per l'override dell'autenticazione.

Esempi di configurazione della connessione

Questa sezione elenca i valori di esempio per i vari campi che configuri durante la creazione della connessione.

OAuth 2.0 - Tipo di connessione con credenziali client

Nome campo Dettagli
Località europe-west1
Connettore SAP Ariba Procurement
Versione del connettore 1
Nome collegamento gcp-sapariba-procurement-po-supplier
Abilita Cloud Logging Sì
Service account my-service-account@my-project.iam.gserviceaccount.com
Livello di log Debug
ANID AN11234322444-T
Chiave API gaTawAf8m3gtAs8gPyUbU9Be1eLXbvFq
Realm 745628447-T
API PurchaseOrdersSupplierAPI-V1
Data center US
Ambiente TEST
Numero minimo di nodi 2
Numero massimo di nodi 50
Autenticazione OAuth 2.0 - Credenziali client
ID client 4c71c4d4-d7e9-494e-807f-9dead41abc6f
Client secret projects/617888503870/secrets/AribaProcurement/versions/10
Versione secret 10

Limitazioni di sistema

Il connettore SAP Ariba Procurement può elaborare un massimo di 3 transazioni al secondo, per nodo e limita le transazioni oltre questo limite. Per impostazione predefinita, Integration Connectors alloca due nodi (per una migliore disponibilità) per una connessione.

Per informazioni sui limiti applicabili a Integration Connectors, vedi Limiti.

Utilizzare la connessione SAP Ariba Procurement in un'integrazione

Una volta creata la connessione, questa diventa disponibile sia in Apigee Integration che in Application Integration. Puoi utilizzare la connessione in un'integrazione tramite l'attività Connettori.

  • Per capire come creare e utilizzare l'attività Connettori in Apigee Integration, consulta Attività Connettori.
  • Per capire come creare e utilizzare l'attività Connettori in Application Integration, consulta Attività Connettori.

Azioni

Questa sezione mostra come eseguire alcune delle azioni in questo connettore.

Azione CreateChildElementSchema

Questa azione crea un file schema per un array di documenti nel modello di visualizzazione.

Parametri di input dell'azione CreateChildElementSchema

Nome parametro Tipo Accetta flussi di output Descrizione
ViewTemplateName Stringa Falso Il nome di un modello di visualizzazione esistente.
ChildElement Stringa Falso Un elemento secondario o un array di documenti nel modello di visualizzazione in notazione puntata, ad esempio LineItems.SplitAccountings.
TableName Stringa Falso Il nome della nuova tabella, ad esempio View_LineItems_SplitAccountings.
FileName Stringa Falso Il nome file dello schema generato. Può trattarsi di un percorso relativo o assoluto alla posizione di salvataggio desiderata.
FileStream Stringa Vero Un'istanza di un flusso di output in cui vengono scritti i dati dei file.

Per un esempio su come configurare l'azione CreateChildElementSchema, consulta Esempi.

Azione CreateSchema

Crea un file di schema per la tabella o la vista specificata.

Parametri di input dell'azione CreateSchema

Nome parametro Tipo Accetta flussi di output Descrizione
TableName Stringa Falso Il nome della nuova tabella.
FileName Stringa Falso Il nome file dello schema generato. Può trattarsi di un percorso relativo o assoluto alla posizione di salvataggio desiderata.
FileStream Stringa Falso Un'istanza di un flusso di output in cui vengono scritti i dati dei file.

Per un esempio su come configurare l'azione CreateSchema, consulta Esempi.

Esempi di azioni

Questa sezione mostra come eseguire alcuni degli esempi di azioni in questo connettore.

Esempio: crea uno schema di elementi secondari

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione CreateChildElementSchema, quindi fai clic su Fine.
  3. Nella sezione Input attività dell'attività connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value: 
    {
  "ViewTemplateName": "InvoiceReconciliation_SAP_createdRange",
  "ChildElement": "Payments",
  "TableName": "View_LineItems_SplitAccountings"
}

    4. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

    [
  {
    "FileData": "",
    "Result": "success"
  }
]

Esempio: crea uno schema

  1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
  2. Seleziona l'azione CreateSchema, quindi fai clic su Fine.
  3. Nella sezione Input attività dell'attività connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value: 
    {
  "TableName": "Views"
}

    4. Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

    [
  {
    "FileData": "",
    "Result": "success"
  }
]

Esempi di operazioni sulle entità

Questa sezione mostra come eseguire alcune delle operazioni sulle entità in questo connettore.

Esempio: elenca tutti gli ordini

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona Orders dall'elenco Entity.
  3. Seleziona l'operazione List, poi fai clic su Fine.
  4. Nella sezione Input attività dell'attività Connettori, puoi impostare filterClause in base ai requisiti del cliente.

    5. Devi utilizzare gli apici singoli ("'") per racchiudere il valore di una filterClause. Puoi utilizzare filterClause per filtrare i record in base alle colonne.

Esempio: elenca tutti gli elementi pubblicitari

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona LineItems dall'elenco Entity.
  3. Seleziona l'operazione List, poi fai clic su Fine.
  4. Nella sezione Input attività dell'attività Connettori, puoi impostare la filterClause in base ai requisiti del cliente.

Esempio: ottieni i dettagli di un ordine

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona Orders dall'elenco Entity.
  3. Seleziona l'operazione Get, poi fai clic su Fine.
  4. Imposta entityId su "DO240", ovvero la chiave da trasferire. Per impostare l'entityId, nella sezione Data Mapper di Data Mapping, fai clic su Open Data Mapping Editor, inserisci "DO240" nel campo Input Value e scegli entityId come variabile locale.

    5. Devi trasmettere direttamente il valore per entityId, ad esempio "DO240". In questo caso, "DO240" è il valore univoco della chiave primaria.

    Se il passaggio di un singolo entityId genera un errore a causa della presenza di due chiavi composite, puoi utilizzare filterClause per passare il valore, ad esempio DocumentNumber='DO240'.

Esempio: recuperare i dettagli di un elemento pubblicitario

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona LineItems dall'elenco Entity.
  3. Seleziona l'operazione Get, poi fai clic su Fine.
  4. Imposta filterClause su LineNumber='1' AND DocumentNumber='DO240', ovvero le chiavi composite da passare. Per impostare filterClause, nella sezione Data Mapper di Data Mapping, fai clic su Apri editor di Data Mapping, inserisci "LineNumber='1' AND DocumentNumber='DO240'" nel campo Valore di input e scegli filterClause come variabile locale.

Esempio: creare una vista

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona Views dall'elenco Entity.
  3. Seleziona l'operazione Create, quindi fai clic su Fine.
  4. Nella sezione Data Mapper dell'attività Mappatura dei dati, fai clic su Open Data Mapping Editor e poi inserisci un valore simile al seguente nel campo Input Value e scegli entityId, connectorInputPayload o filterClause come variabile locale. 
    {
  "ViewTemplateName": "TestView1754629881645",
  "Status": "published",
  "FilterExpressions": "[{\"name\":\"ExampleFilter\",\"field\":\"UniqueName\",\"op\":\"IN\",\"defaultValue\":[\"P011\"]}]",
  "DocumentType": "DirectOrder",
  "SelectAttributes": "[\"SubmitDate\"]"
}

    L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività del connettore:

    {
  "Success": true
}

Esempio: aggiornare una visualizzazione

  1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
  2. Seleziona Views dall'elenco Entity.
  3. Seleziona l'operazione Update, quindi fai clic su Fine.
  4. Nella sezione Data Mapper dell'attività Mappatura dei dati, fai clic su Open Data Mapping Editor e poi inserisci un valore simile al seguente nel campo Input Value. 
    {
  "Status": "published"
}
  5. Imposta entityId in Data Mapper sull'ID delle visualizzazioni. Per impostare entityId, fai clic su Open Data Mapping Editor, quindi inserisci un valore simile al seguente nel campo Input Value e scegli entityId, connectorInputPayload o filterClause come variabile locale.

    Anziché specificare entityId, puoi anche impostare filterClause su TestView = '1754629881645'.

    L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività del connettore:

    {
}

    Un oggetto JSON vuoto {} nella risposta indica che l'operazione di aggiornamento è stata eseguita correttamente.

Ricevere assistenza dalla community di Google Cloud

Puoi pubblicare le tue domande e discutere di questo connettore nella community di Google Cloud nei forum di Cloud.

Passaggi successivi