Gestionnaire de transaction : intégrations

Utilisez les intégrations pour échanger des données avec des sources tierces, y compris Salesforce.

Pour collecter des informations à partir de sources de données externes telles que Salesforce dans Transaction Manager, l’administrateur crée des intégrations. Les intégrations de Transaction Manager définissent les informations nécessaires pour se connecter à une source de données, extraire des informations et mapper les données dans Transaction Manager. Les intégrations permettent également d’extraire des informations de Transaction Manager et de les envoyer pour qu’elles soient mappées dans un environnement tiers.

Avant de pouvoir définir une intégration pour Transaction Manager, l’administrateur doit d’abord créer une connexion à l’environnement tiers, tout comme une connexion externe dans l’environnement de configuration. Les connexions sont définies dans la section Utilitaires de l’interface utilisateur de l’administrateur.

Création d’une connexion

Avant de définir une intégration, l’administrateur doit définir une connexion à la source tierce pour les données utilisées par l’intégration.

Pour créer une nouvelle connexion, dans la zone Utilitaires de l’interface utilisateur d’administration, cliquez sur Connexions. Cliquez ensuite sur + Nouveau pour afficher la page Nouvelle connexion.

Sur la page Nouvelle connexion, nommez la nouvelle connexion et affectez-lui un nom de variable. Ensuite, choisissez le type d’intégration : Salesforce ou Externe.

Si vous créez une connexion à Salesforce, aucun des autres champs n’est requis. CPQ sait comment s’authentifier et connaît les points de terminaison requis à utiliser lors de la communication avec Salesforce.

Si vous créez une intégration externe, choisissez le type d’authentification. Les méthodes d’authentification prises en charge sont Aucune, Jeton de porteur et OAuth. Si vous choisissez Jeton de porteur, utilisez le champ Jeton d’authentification pour fournir le jeton de porteur pour le site avec lequel vous communiquez. Si vous choisissez OAuth, utilisez les champs ID client, Secret client et URL du jeton pour fournir les informations OAuth requises.

Dans le champ Hôte, saisissez l’URL du site tiers avec lequel vous allez communiquer.

Dans le champ Chemin d’accès, saisissez le chemin d’accès au point de terminaison auquel vous essayez d’accéder sur le site tiers.

Utilisez le champ En-têtes supplémentaires pour ajouter toutes les informations d’en-tête supplémentaires requises par le site tiers afin d’exécuter le point de terminaison souhaité.

Création d’une intégration

Pour créer une intégration, cliquez sur + Ajouter une intégration. La fenêtre New Integration (Nouvelle intégration) s’affiche. Attribuez un nom et un nom de variable à la nouvelle intégration, puis cliquez sur Enregistrer.

La page Éditeur d’intégration s’ouvre. Poursuivez la définition de la nouvelle intégration en configurant les paramètres suivants :

• Méthode HTTP : Vous pouvez effectuer une opération GET, POST, PATCH, PUT ou DELETE, en fonction du point de terminaison que vous utilisez sur le site tiers.
• Détails des éléments de ligne à inclure : définissez le type d’éléments de ligne avec lesquels vous travaillerez dans l’intégration. Les options sont Lignes sélectionnées, Lignes modifiées et Lignes supprimées.
• Chemin d’accès supplémentaire : entrez la commande de requête à exécuter sur le site tiers. Si vous vous connectez à Salesforce, il s’agira probablement d’une requête SOQL. Sur d’autres plateformes, il peut s’agir d’une requête SQL standard.
• Délai d’expiration : définit la durée (en millisecondes) pendant laquelle la demande attendra une réponse avant de déclarer une erreur.
• Async : ce commutateur vous permet d’exécuter la requête de manière asynchrone en arrière-plan afin que l’utilisateur puisse continuer à travailler.
• En-têtes : vous pouvez utiliser du texte statique dans les champs du Gestionnaire de transactions au niveau de l’en-tête à l’aide d’une syntaxe simple en guidon, vous pouvez définir des paires clé-valeur pour les en-têtes ou combiner ces deux méthodes. {{txn.fieldname}}

Vous devez ensuite définir la connexion au point de terminaison. Ici, vous choisissez parmi une liste des connexions que vous avez créées précédemment dans la zone Utilitaires pour définir le site tiers auquel vous connecter pour cette intégration.

Enfin, vous devez définir le modèle de transformation, qui vous permet de mapper des données tierces à CPQ des champs ou de mapper CPQ des données à des champs de sources de données tierces.

JSON est utilisé pour définir le mappage, comme dans l’exemple suivant.

{
  "fields": [
    {
      "variableName": "txn.custom.tXNNumber",
      "value": "{{#each records}}{{Name}}{{/each}}"
    },
    {
      "variableName": "txn.opportunity.id",
      "value": "{{#eachrecords}}{{LGK__OpportunityId__c}} {{/each}}"
    },
    {
      "variableName": "txn.custom.primaryContact",
      "value": "{{#eachrecords}}{{Contact.FirstName}}{{/each}}"
    }
  ]
}

Cet exemple utilise la syntaxe Mustache pour les données Salesforce qui ont été extraites du site Salesforce. Chaque mappage de champs inclut le nom de variable du CPQ champ qui reçoit les données extraites, suivi de la valeur qui identifie le champ Salesforce où les données ont été extraites. La nomenclature #eachredords et /each indiquent que chaque enregistrement de la réponse à la requête est recherché pour chacune des trois valeurs de champ du modèle.

Vous pouvez utiliser la zone Données de retour d’échantillon et la zone Résultat de transformation pour résoudre les problèmes d’intégration qui ne fonctionnent pas. Si vous effectuez la requête dans un outil tel que Postman, où vous pouvez voir et copier la réponse à la requête, vous pouvez coller la réponse à la requête dans la zone Données d’exemple de réponse, puis cliquer sur Exécuter la transformation sous la zone Modèle de transformation. Les données de réponse à la requête passent par le modèle de transformation défini et les résultats de la transformation sont affichés dans la zone Résultat de la transformation.