SAP Ariba Procurement

Le connecteur SAP Ariba Procurement vous permet d'effectuer des opérations d'insertion, de mise à jour et de lecture sur les données SAP Ariba Procurement.

Versions compatibles

Ce connecteur est compatible avec les API REST SAP Ariba Procurement.

Avant de commencer

Dans votre projet Google Cloud, effectuez les tâches suivantes :

  • Assurez-vous que la connectivité réseau est configurée. Pour en savoir plus, consultez Connectivité réseau.
  • Attribuez le rôle IAM roles/connectors.admin à l'utilisateur qui configure le connecteur.
  • Attribuez les rôles IAM roles/secretmanager.viewer et roles/secretmanager.secretAccessor au compte de service que vous souhaitez utiliser pour le connecteur.
  • Activez secretmanager.googleapis.com (API Secret Manager) et connectors.googleapis.com (API Connectors). Pour en savoir plus, consultez Activer des services.

Configurer le connecteur

Une connexion est propre à une source de données. Cela signifie que si vous disposez de nombreuses sources de données, vous devez créer une connexion distincte pour chacune d'elles. Pour créer une connexion, procédez comme suit :

  1. Dans la console Cloud, accédez à la page Integration Connectors > Connexions, puis sélectionnez ou créez un projet Google Cloud.

    Accéder à la page "Connexions"

  2. Cliquez sur + CRÉER pour ouvrir la page Créer une connexion.
  3. Dans la section Emplacement, procédez comme suit :
    1. Région : sélectionnez un emplacement dans la liste déroulante.

      Pour obtenir la liste de toutes les régions disponibles, consultez Emplacements.

    2. Cliquez sur Suivant.
  4. Dans la section Détails de la connexion, procédez comme suit :
    1. Connecteur : sélectionnez SAP Ariba Procurement dans la liste des connecteurs disponibles.
    2. Version du connecteur : sélectionnez la version du connecteur dans la liste des versions disponibles.
    3. Dans le champ Nom de connexion, indiquez le nom de l'instance de connexion. Le nom de la connexion peut contenir des lettres minuscules, des chiffres ou des traits d'union. Il doit commencer par une lettre et se terminer par une lettre ou un chiffre. Il ne doit pas dépasser 49 caractères.
    4. Description : saisissez une description de l'instance de connexion.
    5. (Facultatif) Activez Cloud Logging, puis sélectionnez un niveau de journalisation. Par défaut, le niveau de journalisation est défini sur Error.
    6. Compte de service : sélectionnez un compte de service disposant des rôles requis.
    7. ANID : spécifiez votre ID SAP Ariba Network.
    8. Clé API : saisissez la clé de l'application OAuth pour l'authentification.
    9. Domaine : saisissez le domaine SAP Ariba pour la connexion.
    10. API : saisissez l'API SAP Ariba à partir de laquelle récupérer les données.
    11. Centre de données : saisissez l'emplacement géographique où sont hébergées les données de votre compte.
    12. Environnement : saisissez l'environnement SAP Ariba auquel vous souhaitez vous connecter.
    13. (Facultatif) Configurez les paramètres des nœuds de connexion :

      • Nombre minimal de nœuds : saisissez le nombre minimal de nœuds de connexion.
      • Nombre maximal de nœuds : saisissez le nombre maximal de nœuds de connexion.

      Un nœud est une unité (ou instance répliquée) de connexion qui traite des transactions. Pour traiter davantage de transactions pour une connexion, vous devez disposer de plus de nœuds. À l'inverse, moins de nœuds sont nécessaires si une connexion traite moins de transactions. Pour comprendre comment les nœuds affectent la tarification de votre connecteur, consultez Tarifs des nœuds de connexion. Si vous ne saisissez aucune valeur, le nombre minimal de nœuds est défini par défaut sur 2 (pour améliorer la disponibilité) et le nombre maximal de nœuds sur 50.

    14. + AJOUTER UNE ÉTIQUETTE : cliquez sur cette option pour ajouter une étiquette à la connexion sous la forme d'une paire clé/valeur.
    15. Cliquez sur Suivant.
  5. Dans la section Authentification, saisissez les informations d'authentification.
    1. Sélectionnez un type d'authentification, puis saisissez les informations appropriées.

      Les types d'authentification suivants sont compatibles avec la connexion SAP Ariba Procurement :

      • Identifiants client OAuth 2.0

      Pour savoir comment configurer ces types d'authentification, consultez Configurer l'authentification.

    2. Cliquez sur Suivant.
  6. Vérifier : vérifiez vos informations de connexion et d'authentification.
  7. Cliquez sur Créer.

Configurer l'authentification

Saisissez les informations en fonction de l'authentification que vous souhaitez utiliser.

  • OAuth 2.0 – Identifiants client
    • ID client : saisissez l'ID client de l'application que vous avez créée.
    • Code secret du client : saisissez le secret Secret Manager contenant le code secret du client pour l'application connectée que vous avez créée.
    • Version du secret : sélectionnez la version du secret pour le code secret du client.
    • Enable Authentication Override (Activer le remplacement de l'authentification) : activez cette option pour remplacer l'authentification.

Exemples de configuration de connexion

Cette section présente des exemples de valeurs pour les différents champs que vous configurez lorsque vous créez la connexion.

Type de connexion avec des identifiants client OAuth 2.0

Nom du champ Détails
Emplacement europe-west1
Connecteur SAP Ariba Procurement
Version du connecteur 1
Nom de connexion gcp-sapariba-procurement-po-supplier
Activer Cloud Logging Oui
Compte de service mon-compte-service@mon-projet.iam.gserviceaccount.com
Niveau de journalisation Déboguer
ANID AN11234322444-T
Clé API gaTawAf8m3gtAs8gPyUbU9Be1eLXbvFq
Domaine 745628447-T
API PurchaseOrdersSupplierAPI-V1
Centre de données États-Unis
Environnement TEST
Nombre minimal de nœuds 2
Nombre maximal de nœuds 50
Authentification Identifiants client OAuth 2.0
ID client 4c71c4d4-d7e9-494e-807f-9dead41abc6f
Code secret du client projects/617888503870/secrets/AribaProcurement/versions/10
Version du secret 10

Limites du système

Le connecteur SAP Ariba Procurement peut traiter au maximum trois transactions par seconde et par nœud, et limite les transactions au-delà de ce seuil. Par défaut, Integration Connectors alloue deux nœuds (pour améliorer la disponibilité) à une connexion.

Pour en savoir plus sur les limites applicables à Integration Connectors, consultez Limites.

Utiliser la connexion SAP Ariba Procurement dans une intégration

Une fois la connexion créée, elle devient disponible dans Apigee Integration et Application Integration. Vous pouvez utiliser la connexion dans une intégration au moyen de la tâche "Connecteurs".

  • Pour savoir comment créer et utiliser la tâche de connecteurs dans Apigee Integration, consultez Tâche "Connecteurs".
  • Pour savoir comment créer et utiliser la tâche "Connecteurs" dans Application Integration, consultez Tâche "Connecteurs".

Actions

Cette section explique comment effectuer certaines actions dans ce connecteur.

Action CreateChildElementSchema

Cette action crée un fichier de schéma pour un tableau de documents dans le modèle de vue.

Paramètres d'entrée de l'action CreateChildElementSchema

Nom du paramètre Type Accepte les flux de sortie Description
ViewTemplateName Chaîne Faux Nom d'un modèle de vue existant.
ChildElement Chaîne Faux Élément enfant ou tableau de documents dans le modèle de vue en notation par points, comme LineItems.SplitAccountings.
TableName Chaîne Faux Nom de la nouvelle table, par exemple View_LineItems_SplitAccountings.
FileName Chaîne Faux Nom de fichier du schéma généré. Il peut s'agir d'un chemin relatif ou absolu vers l'emplacement d'enregistrement souhaité.
FileStream STRING Vrai Instance d'un flux de sortie dans lequel les données de fichier sont écrites.

Pour obtenir un exemple de configuration de l'action CreateChildElementSchema, consultez Exemples.

Action CreateSchema

Cette action crée un fichier de schéma pour la table ou la vue spécifiée.

Paramètres d'entrée de l'action CreateSchema

Nom du paramètre Type Accepte les flux de sortie Description
TableName Chaîne Faux Nom de la nouvelle table.
FileName Chaîne Faux Nom de fichier du schéma généré. Il peut s'agir d'un chemin relatif ou absolu vers l'emplacement d'enregistrement souhaité.
FileStream Chaîne Faux Instance d'un flux de sortie dans lequel les données de fichier sont écrites.

Pour obtenir un exemple de configuration de l'action CreateSchema, consultez Exemples.

Exemples d'actions

Cette section explique comment effectuer certaines actions dans ce connecteur.

Exemple : Créer un schéma d'élément enfant

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action CreateChildElementSchema, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value : 
    {
  "ViewTemplateName": "InvoiceReconciliation_SAP_createdRange",
  "ChildElement": "Payments",
  "TableName": "View_LineItems_SplitAccountings"
}

    4. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

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

Exemple : Créer un schéma

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action CreateSchema, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value : 
    {
  "TableName": "Views"
}

    4. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

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

Exemples d'opérations d'entité

Cette section explique comment effectuer certaines opérations d'entité dans ce connecteur.

Exemple : Lister toutes les commandes

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Orders dans la liste Entity.
  3. Sélectionnez l'opération List, puis cliquez sur OK.
  4. Dans la section Entrée de la tâche de la tâche Connecteurs, vous pouvez définir la filterClause en fonction des exigences du client.

    5. Vous devez placer la valeur d'une clause de filtre entre des guillemets simples ('). Vous pouvez utiliser la clause de filtre pour filtrer les enregistrements en fonction des colonnes.

Exemple : Lister tous les éléments de ligne

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez LineItems dans la liste Entity.
  3. Sélectionnez l'opération List, puis cliquez sur OK.
  4. Dans la section Entrée de la tâche de la tâche Connecteurs, vous pouvez définir la filterClause en fonction des exigences du client.

Exemple : Obtenir les détails d'une commande

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Orders dans la liste Entity.
  3. Sélectionnez l'opération Get, puis cliquez sur OK.
  4. Définissez entityId sur "DO240", qui est la clé à transmettre. Pour définir l'entityId, dans la section Data Mapper de la tâche Mappage de données, cliquez sur Ouvrir l'éditeur de mappage de données, puis saisissez "DO240" dans le champ Valeur d'entrée et choisissez "entityId" comme variable locale.

    5. Vous devez transmettre directement la valeur de entityId, par exemple "DO240". Ici, "DO240" est la valeur de clé primaire unique.

    Si la transmission d'un seul entityId génère une erreur en raison de la présence de deux clés composites, vous pouvez utiliser filterClause pour transmettre la valeur, par exemple DocumentNumber='DO240'.

Exemple : Obtenir les détails d'un élément de campagne

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez LineItems dans la liste Entity.
  3. Sélectionnez l'opération Get, puis cliquez sur OK.
  4. Définissez filterClause sur LineNumber='1' AND DocumentNumber='DO240', qui sont les clés composites à transmettre. Pour définir la filterClause, dans la section Data Mapper de la tâche Mappage de données, cliquez sur Ouvrir l'éditeur de mappage de données, puis saisissez "LineNumber='1' AND DocumentNumber='DO240'" dans le champ Valeur d'entrée et choisissez la filterClause comme variable locale.

Exemple : Créer une vue

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Views dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "entityId", "connectorInputPayload" ou "filterClause" comme variable locale. 
    {
  "ViewTemplateName": "TestView1754629881645",
  "Status": "published",
  "FilterExpressions": "[{\"name\":\"ExampleFilter\",\"field\":\"UniqueName\",\"op\":\"IN\",\"defaultValue\":[\"P011\"]}]",
  "DocumentType": "DirectOrder",
  "SelectAttributes": "[\"SubmitDate\"]"
}

    L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie connectorOutputPayload de la tâche "Connecteurs" :

    {
  "Success": true
}

Exemple : Mettre à jour une vue

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Views dans la liste Entity.
  3. Sélectionnez l'opération Update, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value. 
    {
  "Status": "published"
}
  5. Définissez entityId dans Data Mapper sur l'ID des vues. Pour définir l'entityId, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez entityId, connectorInputPayload ou filterClause comme variable locale.

    Au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur TestView = '1754629881645'.

    L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie connectorOutputPayload de la tâche "Connecteurs" :

    {
}

    Un objet JSON vide {} dans la réponse indique que l'opération de mise à jour a réussi.

Demander de l'aide à la communauté Google Cloud

Vous pouvez publier vos questions et discuter de ce connecteur sur les forums Cloud de la communauté Google Cloud.

Étapes suivantes