Cet article explique comment récupérer l’ID d’opportunité Salesforce, ainsi que les détails de la transaction, y compris le nom du compte, le nom de l’opportunité, l’adresse de livraison et l’adresse de facturation, et les écrire dans CPQ les champs de transaction. Ce modèle est pertinent pour toute intégration qui nécessite CPQ de demander des données à un tiers.

Objectif : flux de l’utilisateur final (buyside)

Nous commençons par ouvrir une transaction de gestionnaire de transactions dans Salesforce. Ensuite, en cliquant sur Obtenir les données SF dans l’interface utilisateur buyside, nous déclenchons l’événement Obtenir les données SF. Cet événement lance plusieurs intégrations qui se connectent à Salesforce, en extrayant les données de transaction pertinentes (ID d’opportunité, nom de l’opportunité, adresse d’expédition, adresse de facturation, ID de compte et nom de compte) et en remplissant les champs correspondants dans l’interface utilisateur buyside.

Dans l’interface utilisateur des transactions côté achat, cliquez sur Obtenir les données SF.

Notez que les détails sont tous renseignés.

Le reste de cet article énumère les étapes de CPQ création des intégrations qui permettent d’obtenir les données de Salesforce.

Configuration de l’administration : prérequis

Ce guide suppose un CPQ environnement avec les fonctionnalités de Transaction Manager activées, ainsi que l’installation de l’extension d’intégration Logik Transaction Manager sur un environnement Salesforce correspondant. Pour consulter les instructions d’installation, reportez-vous à la section Installation de l’extension du package d’intégration Salesforce Transaction Manager.

CPQ: ajouter une connexion

Un enregistrement de connexion contient les données requises pour initier une intégration à un gestionnaire de transactions. Cela inclut les détails de l’authentification, l’URL d’hôte, le chemin d’accès et les en-têtes. Pour afficher un enregistrement de connexion, dans CPQ Admin, accédez à Utilitaires, puis cliquez sur Connexions.

Pour plus d’informations sur l’ajout d’une connexion, reportez-vous à la section « Création d’une connexion » dans Gestionnaire de transaction : intégrations. Pour les besoins de cet article, nous utilisons une connexion à un environnement Salesforce.

CPQ: ajouter l’intégration

1. Ouvrez CPQ Admin et accédez à la section Intégrations.
2. Cliquez sur Ajouter une intégration. Créez une intégration en utilisant un nom approprié. Dans cet exemple, nous utilisons le nom « Get Oppty ID ».

   

   

   La page des détails de l’intégration illustrée ci-dessus comprend les sections suivantes :

   • Paramètres d’intégration
   • Demander une transformation
   • Connexion au point de terminaison
   • Transformation de réponse

   Des détails sur ces sections suivent.

• Paramètres d’intégration :
  • Méthode HTTP : GET
  • Chemin : /services/data/vXX.X/query/ ?q=SELECT+Name,+LGK__OpportunityId__c FROM+LGK__Transaction__c+WHERE+LGK__ID__c='{{txn.id}}'

    La demande GET récupère les Name champs et LGK__OpportunityId__c à partir de l’objet LGK__Transaction__c dans Salesforce, en filtrant par l’ID de transaction « txn.id » dans le LGK__ID__c champ.

    Dans le chemin, <vXX.X> correspond à la dernière version du graphe composite. Vous pouvez vérifier la dernière version ici.

  • Détails de l’élément de ligne à inclure : Lignes sélectionnées
  • Délai d’expiration : 2000 ms

  

  Cliquez sur Suivant.

• Transformation de la demande : non requise lorsque nous créons une intégration GET.
• Connexion au point de terminaison : pour cet exemple, nous interrogeons Salesforce. Si vous configurez une intégration avec un autre système, sélectionnez la connexion appropriée.

  

  Cliquez sur Suivant.

• Transformation de réponse : consultez cet exemple de modèle de transformation de réponse.

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

Nouvelle intégration : récupérer les détails de l’opportunité

Créez une autre intégration pour obtenir des détails supplémentaires via txn.opportunity.id.

Maintenant que nous disposons de l’ID de l’opportunité, l’étape suivante de l’intégration consiste à l’utiliser comme référence pour récupérer des détails supplémentaires sur l’opportunité et remplir les champs de transaction LGK pertinents.

• Paramètres d’intégration :
  • Méthode HTTP : GET
  • Chemin d’accès : GET /services/data/vXX.X/query ?q=SELECT id,Name,Owner.Username,AccountId,Account.Name,Account.BillingAddress,Account.ShippingAddress FROM Opportunity WHERE id='{{txn.opportunity.id}}'

    Cette requête récupère les champs d’un enregistrement d’opportunité dans Salesforce, en fonction de l’ID unique de l’opportunité. Il récupère également les détails connexes du compte, tels que le nom du compte, l’adresse de facturation et l’adresse d’expédition. La requête renvoie les données d’une opportunité spécifique identifiée par {{txn.opportunity.id}}.

    Pour obtenir les détails du champ à partir de Salesforce, cliquez sur Configuration > Gestionnaire d’objets > Opportunité > Champs et relations.

    

  • Détails de l’élément de ligne à inclure : Lignes sélectionnées
  • Délai d’expiration : 2000 ms

    

  Cliquez sur Suivant.

• Transformation de demande : non requise lors de la création d’une intégration GET.
• Connexion au point de terminaison :

  Sélectionnez Connexion au point de terminaison. Pour cet exemple, nous interrogeons Salesforce. Si vous configurez une intégration avec un autre système, sélectionnez la connexion appropriée.

  

  Cliquez sur Suivant.

• Transformation de réponse : L’extrait JSON suivant définit comment renseigner les variables définies dans le chemin d’accès supplémentaire en itérant sur une collection d’enregistrements.

  Pour txn.custom.opportunity, il extrait le Name champ de chaque enregistrement, tandis que pour txn.custom.billToAddress, il extrait et concatène le Account.BillingAddress.street,Account.BillingAddress.city,Account.BillingAddress.state,Account.BillingAddress.postalCode champ. La boucle Handlebars {{#each}} est utilisée pour traiter chaque enregistrement, et les valeurs résultantes dépendent de la gestion du système, que ce soit sous forme de chaînes concaténées ou de tableaux de valeurs.

  {
    "fields": [
      {
        "variableName": "txn.custom.opportunity",
        "value": "{{#each records}}{{Name}}{{/each}}"
      },
      {
        "variableName": "txn.account.id",
        "value": "{{#each records}}{{AccountId}}{{/each}}"
      },
      {
        "variableName": "txn.custom.accountName",
        "value": "{{#each records}}{{Account.Name}}{{/each}}"
      },
      {
        "variableName": "txn.custom.quoteNumber",
        "value": "{{#each records}}{{QuoteNumber}}{{/each}}"
      },
      {
        "variableName": "txn.custom.billToAddress",
        "value": "{{records.[0].Account.BillingAddress.street}}{{records.[0].Account.BillingAddress.city}}{{records.[0].Account.BillingAddress.state}}{{records.[0].Account.BillingAddress.postalCode}}"
      },
      {
        "variableName": "txn.custom.shipToAddress",
        "value": "{{records.[0].Account.ShippingAddress.street}}{{records.[0].Account.ShippingAddress.city}}{{records.[0].Account.ShippingAddress.state}}{{records.[0].Account.ShippingAddress.postalCode}}"
      }
    ]
  }

Déclenchez l’intégration lorsque l’utilisateur final clique sur un bouton. Vous pouvez maintenant cliquer sur Événements pour créer un nouvel événement ou pour en sélectionner un existant. Dans ce cas, nous utilisons l’événement Get SF Data (un bouton dans l’interface utilisateur) pour nous connecter aux intégrations que nous avons créées précédemment.

Cliquez sur Ajouter une nouvelle action.

Cliquez sur Intégrations.

Recherchez et ajoutez l’intégration « Get Oppty ID ».

Cliquez sur Enregistrer. Ensuite, cliquez sur Ajouter une nouvelle action et ajoutez « retrieveSFOptyData ».

Cliquez sur les flèches haut et bas près des éléments d’action pour les organiser dans l’ordre souhaité. (Ici, nous sélectionnons « Obtenir l’ID d’opportunité », suivi de « Récupérer les données d’opportunité SF » pour extraire l’ID d’opportunité et récupérer les données pertinentes.)

Cliquez sur Enregistrer et déployez les modifications.

Nous avons vu comment les intégrations peuvent être ajoutées à des événements. Les intégrations peuvent également être configurées au niveau de l’étape. Pour ce faire, accédez à Étapes > Modifier les paramètres > Ajouter une nouvelle action > Intégration.

Dépannage

Lors de la configuration des intégrations, il est essentiel de s’assurer que la séquence des intégrations est configurée correctement pour récupérer des détails précis. L’ordre d’exécution joue un rôle important dans le maintien de la cohérence et de l’alignement des données.

Pour ce faire, procédez comme suit :

1. Extraire l’ID d’opportunité : l’ID d’opportunité sert de référence clé pour lier les données connexes. Cette étape est essentielle, car les détails de la transaction que vous récupérez ultérieurement sont directement associés à une opportunité spécifique.
2. Extraire l’ID de transaction via les détails de l’opportunité : utilisez l’ID d’opportunité pour extraire l’ID de transaction. Étant donné que chaque transaction est liée à une opportunité particulière, cette approche garantit que vous associez avec précision la transaction correcte à l’opportunité correspondante.

En suivant cet ordre, vous pouvez préserver l’intégrité de l’intégration et vous assurer que le flux de données reste transparent et fiable.