Prérequis

Ce guide suppose que votre CPQ environnement est intégré à une organisation Salesforce et que Transaction Manager est activé. Si votre organisation Salesforce n’a pas CPQ de packages installés, installez la version 2.7 ou ultérieure CPQ du package géré. Pour obtenir des instructions, consultez Guide d’installation et de configuration pour les environnements liés aux organisations Salesforce.

Soumettez un ticket d’assistance en demandant l’activation du Gestionnaire de transactions dans votre CPQ environnement.

À propos de l’extension CPQ Transaction Manager

L’extension CPQ Transaction Manager est un package de composants que les administrateurs Salesforce installent sur leur environnement Salesforce pour faciliter l’intégration entre Salesforce et CPQ Transaction Manager.

Contactez l’assistance clientèle ServiceNow pour obtenir des informations sur la dernière version et sur la façon d’accéder au package géré pour l’installation.

Les administrateurs peuvent installer le package pour les administrateurs uniquement, pour tous les utilisateurs ou pour des profils spécifiques. Le package comprend des ensembles d’autorisations pour Transaction Manager qui peuvent être attribués à des personnes ou répliqués sur des profils. Pour afficher les ensembles d’autorisations, dans Configuration, accédez à Utilisateurs, puis consultez l’option Logik.ai Accès complet dans Ensembles d’autorisations.

Après l’installation, vous pouvez afficher la version du package dans la section Packages installés du programme d’installation de Salesforce.

Salesforce : activer les champs d’adresse personnalisés

Les champs d’adresse personnalisée doivent être activés dans l’environnement Salesforce. Si cette fonctionnalité n’est pas activée, consultez cet article pour plus d’informations : Activer les champs d’adresse personnalisés

Salesforce : autoriser des exceptions de sécurité pour CPQ

Ajouter des URL fiables :

1. Depuis l’accueil de la configuration de Salesforce, accédez à Paramètres > Sécurité > URL approuvées. Créez une URL approuvée.
2. Fournissez un nom d’API.
3. Entrez l’URL de l’environnement CPQ , comme indiqué ci-dessous.

   

4. Sous Directives CSP, assurez-vous qu’au moins frame-src (contenu iframe) est activé, puis cliquez sur Enregistrer.

   

Configurer les paramètres du site distant :

1. Depuis l’accueil de la configuration de Salesforce, accédez à Paramètres > Sécurité > Paramètres du site distant. Créez un site distant.
2. Fournissez un nom.
3. Entrez l’URL de l’environnement comme indiqué dans l’image CPQ ci-dessous, puis cliquez sur Enregistrer.

   

En option, autorisez l’accès au microphone pour Cosmo Converse (actuellement en version bêta). Cosmo Converse permet à l’utilisateur de communiquer vocalement avec Transaction Manager. Par défaut, cette fonctionnalité n’est pas activée. Pour utiliser Cosmo Converse, soumettez un ticket d’assistance qui décrit votre cas d’utilisation. Pour vous préparer à Cosmo Converse, mettez à jour les paramètres Salesforce pour autoriser l’accès au microphone.

1. Depuis l’accueil de la configuration, accédez à Paramètres > Sécurité > Paramètres de la session.
2. Sous Autorisations de la fonctionnalité du navigateur, assurez-vous que la case à cocher pour l’en-tête HTTP Inclure les autorisations - Politique est désactivée.
3. Si nécessaire, cliquez sur Enregistrer.

CPQ: configurer le jeton client d’exécution

Le jeton client d’exécution facilite l’authentification CPQ des communications de Salesforce à CPQ. Pour connaître les étapes de création d’un jeton client d’exécution dans , reportez-vous à CPQ la section Configurer un client d’exécution. Pour ce cas d’utilisation de Transaction Manager, assurez-vous d’activer les autorisations sur ce client d’exécution pour TRANSACTION et ajoutez un ID utilisateur valide reconnu par l’environnement Salesforce correspondant.

Notez que dans CPQ Admin, le jeton du client d’exécution doit être mis à jour pour inclure TRANSACTION dans ses autorisations et lui-même comme origine. (Par exemple, le jeton du client d’exécution pour https://test-txn.test02.logik.io doit avoir une origine de https://test-txn.test02.logik.io.) En outre, lorsqu’un jeton client d’exécution inclut TRANSACTION, un utilisateur doit être inclus. Assurez-vous que l’utilisateur a l’autorisation d’effectuer l’événement Créer une transaction.

Lorsque vous avez configuré le jeton client d’exécution, copiez-le dans votre presse-papiers local pour l’utiliser dans la procédure suivante.

Installer le jeton d’exécution de la CPQ transaction dans Salesforce

1. Dans le lanceur d’applications Salesforce, recherchez et ouvrez Logik.io Paramètres personnalisés de l’administrateur.
2. Appuyez sur le bouton Set (Définir ) à côté du champ Runtime Client Token (Jeton client d’exécution ) pour l’activer.
3. Collez le jeton CPQ dans le champ modifiable, puis cliquez sur Enregistrer.

Salesforce : mettre à jour la mise en page de l’opportunité sur Ouvrir le gestionnaire de transactions

1. Dans Salesforce, cliquez sur l’icône d’engrenage dans le coin supérieur droit.
2. Accédez à la Configuration > Gestionnaire d’objets > Opportunité > Mises en page.
3. Sélectionnez la mise en page à modifier. (Si vous avez plusieurs mises en page, choisissez celle associée au type d’enregistrement ou aux profils d’utilisateur appropriés.)

   

4. Faites défiler vers le bas dans l’éditeur de mise en page jusqu’à ce que la section Listes connexes s’affiche.

   

5. Faites glisser l’objet Transactions de la liste des listes connexes disponibles dans la palette supérieure vers la position souhaitée dans la section Listes connexes .

   

6. Cliquez sur l’icône en forme de clé de l’objet Transaction pour ouvrir les propriétés de la liste connexe.

   

7. Dans la section Champs sélectionnés , sélectionnez le champ Modifier la transaction dans la colonne Champs disponibles . Cliquez sur Ajouter pour le déplacer dans la colonne Champs sélectionnés . Réorganisez les champs selon vos besoins, puis cliquez sur OK pour enregistrer les modifications. Après avoir effectué les modifications, cliquez sur Enregistrer dans le coin supérieur gauche.

   

8. Testez la mise en page mise à jour.

   • En tant qu’utilisateur final (du côté des acheteurs de Salesforce), accédez à un enregistrement d’opportunité.

   • Assurez-vous que la liste connexe des transactions apparaît sur la page et que le lien Modifier la transaction est visible et fonctionnel.

Dépannage : si le bouton Transaction est manquant

Si le bouton de transaction est manquant sur la page détaillée des opportunités buyside, procédez comme suit.

1. Dans le coin supérieur droit de la page, cliquez sur l’icône d’engrenage, puis sur Modifier la page. Cela ouvre la page d’enregistrement Lightning App Builder for the Opportunity.

   

2. Sélectionnez le composant Listes connexes de la page. Dans la section Affecter des mises en page , recherchez le nom de la mise en page actuellement affectée. (Dans l’image, la mise en page correcte est indiquée par le mot « (prévisualisé) ».)

   

3. Cliquez sur la mise en page prévisualisée et répétez les étapes 4 à 7 dans la section « Salesforce : mettre à jour la mise en page de l’opportunité pour ouvrir le gestionnaire de transactions » (ci-dessus). Ensuite, du côté de l’achat, accédez à un enregistrement d’opportunité. Consultez la section Listes connexes pour confirmer que l’objet de transaction s’affiche. Cliquez sur la flèche et créez une transaction pour valider que le champ Modifier la transaction (EditLink__c) est disponible.

   

   

Salesforce : configurer des mappages de champs personnalisés

Lorsqu’un nouvel CPQ enregistrement de transaction est lancé dans CPQ, il peut être utile de transférer les données essentielles à partir de l’enregistrement de transaction Salesforce. Cette section configure des mappages de champs qui copient (ou « jumentent ») les informations d’un champ dans Salesforce vers un champ dans CPQ, ou vice versa, pendant le flux de création de transaction. Par exemple, il est courant que l’administrateur double la valeur détenue dans LGK__OpportunityId__c le champ de transaction correspondant CPQ , txn.opportunity.id.

1. Dans Salesforce, allez dans Configuration.
2. Dans la barre de recherche rapide, recherchez Types de métadonnées personnalisées.
3. Dans les résultats de la recherche, sous Code personnalisé, cliquez sur Métadonnées personnalisées.

   

4. Pour accéder aux mappages de champs existants, recherchez Logik.io mappage de champs de transaction dans la liste des types de métadonnées personnalisées, puis cliquez sur le lien Gérer les enregistrements à côté de celui-ci.

   

5. Cliquez sur Nouveau, renseignez les détails requis, puis cliquez sur Enregistrer.

   Champs sources :

   • Environnement : choisissez la source de la valeur du champ :

     • Sélectionnez Salesforce pour les champs provenant de Salesforce.

     • Sélectionnez Logik pour les champs provenant de CPQ.

   • Objet : Entrez la transaction.
   • Champ : spécifiez le nom du champ.

     • Pour les champs Salesforce, incluez le suffixe __c (par exemple, CustomField__c). Examiner les noms de champs exacts à partir de Salesforce > Configuration > Gestionnaire d’objets > Transaction > Champs et relations.

       

     • Pour CPQ les champs, incluez des préfixes tels que txn. ou txn.line. pour désigner le champ (par exemple, txn. TotalAmount). Assurez-vous d’utiliser les noms de variables de champ exacts à partir de Administrateur > Transaction > Champs associés.

       

   Champs cibles :

   • Environnement : indiquez où la valeur du champ doit être mise à jour (Salesforce ou CPQ).
   • Champ : saisissez le nom du champ de la cible au même format (par exemple, champs Salesforce avec __c ou CPQ champs avec des préfixes txn).

     

Salesforce : activer la synchronisation de la ligne de transaction vers la ligne d’opportunité et les flux d’actifs

1. Dans l’accueil de la configuration de Salesforce, recherchez « Flux ». Cliquer sur Automatisation des processus > Flux.

2. Recherchez les éléments suivants. Vous effectuerez l’étape 3 pour chacun :

   • Logik.io synchronisation de ligne d’opportunité (mise à niveau)
   • Logik.io synchronisation de ligne d’opportunité (supprimer)
   • Logik.io changement de transaction primaire
3. Pour chacun des trois flux identifiés à l’étape 2, activez l’une des options suivantes :
   • Option 1 : Utilisation du menu déroulant :
     • Cliquez sur la flèche à droite du nom du flux.

       

     • Sélectionnez Afficher les détails et les versions.
     • Cliquez sur Activer pour obtenir la version la plus récente du flux.

       

   • Option 2 : Ouvrez le flux :
     • Cliquez sur le nom du flux pour l’ouvrir dans le générateur de flux.

       

     • Cliquez sur Activer en haut à droite du générateur de flux.

       

Assurez-vous que tous les flux ont un état actif.

Flux de l’utilisateur final : lancement d’une CPQ transaction à partir de Salesforce

• Créer un enregistrement de transaction dans Salesforce

  Il existe plusieurs façons pour l’utilisateur final d’initier une CPQ transaction dans Salesforce. Le flux le plus courant commence sur l’enregistrement d’opportunité.

  1. À partir d’un enregistrement d’opportunité, cliquez sur la flèche dans la liste connexe de la transaction, puis cliquez sur Nouveau.

     

  2. Une nouvelle transaction s’ouvre avec le champ Opportunité renseigné. Renseignez les champs Compte, Contact principal et tous les champs facultatifs. Cliquez sur Enregistrer.

     

  3. Un flux déclenché par l’enregistrement dans le package géré crée une nouvelle transaction dans CPQ. L’UUID du nouvel CPQ enregistrement de transaction est mis à jour dans Salesforce (LGK__TransactionUUID__c). Si l’ID de transaction n’apparaît pas immédiatement, l’actualisation du navigateur corrige généralement l’anomalie.

     

     Si le champ ID de transaction n’est toujours pas renseigné après une actualisation du navigateur, reportez-vous à la section Dépannage ci-dessous.

• Modifier une transaction

  À partir d’une transaction Salesforce (ou d’une liste connexe de transactions), Transaction Manager peut être lancé à l’aide du bouton Modifier la transaction sur la page détaillée de la transaction ou du lien disponible via le champ Modifier la transaction . Cette opération charge une CPQ transaction en fonction du champ ID de transaction dans l’enregistrement Salesforce.

  Transaction Manager se charge dans un iFrame, remplaçant le sous-onglet actuel dans Salesforce.

  Remarque :

  L’interface utilisateur classique de Salesforce n’est pas prise en charge.
• Copier la transaction

  En cliquant sur le bouton Cloner sur l’enregistrement de transaction Salesforce, les utilisateurs peuvent appeler un CPQ événement de copie pour recréer la transaction et les lignes dans le gestionnaire de transactions. Cette action est basée sur l’ID de transaction figurant sur l’enregistrement d’en-tête dans Salesforce et génère un enregistrement de transaction cloné.

  Remarque :

  Le clonage d’une transaction à partir de Salesforce ne fait pas automatiquement des copies des enregistrements de lignes affiliées dans les nouvelles transactions. Pour cloner les lignes vers la nouvelle transaction, lancez le nouvel enregistrement de transaction (cloné) dans le Gestionnaire des transactions et lancez une synchronisation Salesforce.

Dépannage : CPQ échec du lancement avec une erreur « La transaction avec l’ID 'null' n’a pas pu être trouvée »

Cette erreur se produit lorsque la création d’un nouvel CPQ enregistrement de transaction est lancée via un appel d’API à partir de Salesforce et échoue. Cette défaillance se produit généralement pour l’une des deux raisons suivantes :

• Le jeton d’exécution de la transaction est mal configuré ou a expiré. Passez en revue les étapes de la section «CPQ : Configurer le jeton client d’exécution » ci-dessus.
• L’utilisateur qui crée l’enregistrement de transaction à partir de l’interface utilisateur Salesforce n’a CPQ pas l’autorisation de le faire.

Pour résoudre les erreurs d’autorisation, procédez comme suit.

1. Dans Administration des transactions, cliquez sur Profils.
2. Dans la liste des profils, observez quel profil est étiqueté PAR DÉFAUT. La capture d’écran ci-dessous montre que « Commercial » est le profil par défaut. Par défaut, tous les nouveaux utilisateurs se voient affecter ce profil.

   

3. Ouvrez chaque enregistrement de profil. Recherchez votre nom d’utilisateur. L’utilisateur que vous déboguez ne doit être visible que dans un seul profil. Une fois que vous avez trouvé le profil approprié, notez la vue qui gère l’accès à ce profil. Dans l’exemple, l’utilisateur figure parmi les noms d’utilisateur répertoriés dans le profil du représentant commercial. L’accès à ce profil est géré par la vue « ventes ».

   

4. Ouvrez la vue qui gère l’accès au profil. Dans notre exemple, la vue s’appelle « ventes ». Pour ouvrir la vue, dans CPQ la page d’accueil de Transaction Admin, accédez à Vues, puis cliquez sur la vue de gestion.

   

5. Sur la page détaillée de la vue, cliquez sur Accéder, cliquez sur Événements et recherchez createTransaction. Dans un premier temps, l’événement créer une transaction (varname : createTransaction) doit être défini sur Actif.

   

En résumé : pour un utilisateur donné, l’administrateur doit gérer les éléments dans la table suivante.