Problèmes courants d’intégration de Salesforce
Découvrez comment résoudre les problèmes que vous pourriez rencontrer lors de l’intégration de CPQ à Salesforce.
Lorsque Salesforce CPQ est un hébergeur de CPQ configurations, l’intégration des deux sites peut conduire à des erreurs courantes. Voici une liste des problèmes connus avec leurs solutions et ce qu’il faut vérifier.
En général, lorsqu’une erreur est générée par Salesforce, vous pouvez utiliser les journaux de débogage Salesforce pour trouver où cette erreur est déclenchée.
Salesforce : « SBQQ : trop de requêtes SOQL : 101 »
Cette erreur se produit généralement lorsqu’un utilisateur crée une nomenclature contenant plus de 100 éléments, clique sur Devis dans CPQ et qu’il y a trop de lignes de devis créées pour que le comportement par défaut de Salesforce CPQ puisse être géré.
Solution : vérifiez que l’option Activer les grandes configurations est définie dans les paramètres du package Salesforce CPQ.
Ce paramètre réduit la probabilité d’atteindre les limites du gouverneur lorsque vos commerciaux configurent un lot volumineux, mais les performances globales sont globalement plus lentes. Pour en savoir plus sur ce paramètre, consultez Activer les grandes configurations.
Salesforce : « Tentative de déréférencement d’un objet nul »
Cette erreur se produit généralement lorsqu’un utilisateur final enregistre le devis dans CPQ le QLE et avant qu’il ne revienne au QLE. Il s’agit soit d’une entrée de catalogue de prix manquante ou inactive pour les éléments affectés, soit d’un problème de regroupement imbriqué.
Solution (pas de regroupement imbriqué) : L’entrée du catalogue de prix pour le produit est manquante ou inactive.
Vérifiez toutes les entrées du livre des prix du produit. Cette erreur se produit si l’une des conditions suivantes est vraie :
- Un produit retourné n’a pas d’entrée dans le catalogue des prix
- Un produit retourné a une entrée de livre de prix inactive
- Le catalogue de prix associé à un produit retourné est inactif
- Le catalogue de prix standard est utilisé par défaut mais est inactif
Solution (regroupement imbriqué) : si vous avez activé le regroupement imbriqué et que votre configuration comporte des configurations de produits qui correspondent à la structure suivante, il n’y a pas de solution directe. Vous pouvez soit concevoir vos configurations pour ne pas rencontrer ce problème Salesforce, soit désactiver le regroupement imbriqué.
Parent product
Nested child 1
Product X
Nested child 2
Product X
Pour en savoir plus sur ce problème, consultez la rubrique Salesforce.com suivante :
Si vous décidez de désactiver le regroupement imbriqué, vous pouvez le faire dans SFDC via Configuration > packages installés > Salesforce CPQ > Paramètres supplémentaires > Bundles imbriqués pour le configurateur externe.
Veuillez également soumettre un ticket d’assistance afin que nous puissions envoyer cette demande à notre équipe DevOps pour désactiver cette fonctionnalité sur le CPQ côté. Le problème persistera jusqu’à ce que nous désactivions cette fonctionnalité.
Pas de génération d’éléments de ligne de configuration ou d’ensembles de données de champ de configuration
Cette fonctionnalité n’est pas utilisée par de nombreuses implémentations, mais lorsqu’elle l’est, il est primordial que les objets Salesforce attendus soient créés. Les éléments de ligne de configuration (CLI) et les ensembles de données de champ de configuration (CFDS) sont des objets Salesforce gérés par notre package géré de base, et leur création est asynchrone avec les données qui sont poussées vers la ligne de devis.
Au moment où un utilisateur enregistre la configuration à partir de , le processus de CPQ création de ces objets commence, que vous enregistriez ou non les lignes de devis finales créées dans le QLE. Lorsque cela se produit, il n’y a généralement qu’un seul endroit à vérifier.
Solution : La création de ces objets dépend de l’activation des paramètres suivants.
- (Pour les CLI) Le paramètre Transmettre les données BOM à l’administrateur d’objets CPQCPQ Salesforce
- (Pour les SDCD) Paramètre Transmettre les données de configuration à Salesforce à l’administrateur d’objets CPQCPQ Salesforce
- Les autorisations SFDC du nom d’utilisateur du jeton d’actualisation
Si ces paramètres ne sont pas activés, ces objets ne seront pas créés lorsque l’utilisateur cliquera sur Enregistrer.
Si ces paramètres sont activés et que vous ne voyez toujours pas de CLI ou de CFDS (ou que le mappage de champs d’informations étendues ne fonctionne pas), essayez ce qui suit :
- Vérifiez les journaux pour voir si l’erreur « La synchronisation Salesforce de LGK__ConfigurationLineItem__c’objet pour la configuration [******] ne s’est pas terminée avec succès » s’affiche. Vous trouverez peut-être plus d’informations sur la page « Entretiens de flux suspendus et échoués » de votre configuration Salesforce.
- Vérifiez les autorisations de l’utilisateur d’intégration par rapport à la liste dans Autorisations requises pour l’utilisateur d’intégration.
L’enregistrement ne crée pas de lignes de devis enfant
CPQ BOM a l’environnement produit CPQ .
L’enregistrement dans Salesforce n’a que le produit configurable parent, pas l’environnement CPQ .
Nous créons des éléments de ligne de devis uniquement lorsqu’un élément BOM remplit ces conditions :
- Le type de nomenclature de l’élément est spécifié dans le paramètre « Types de nomenclature à inclure dans la demande d’enregistrement »
- Le produit existe dans notre base de données à partir de notre synchronisation de produit avec Salesforce
Ce problème se produit lorsque l’utilisateur clique sur Enregistrer à partir de CPQ et qu’il ne rencontre que le produit configurable parent à partir duquel il a lancé la configuration, ainsi qu’aucune ligne de devis enfant créée dans le CPQ configurateur. Cela signifie généralement qu’il y a une déconnexion entre l’objet produit dans Salesforce et l’élément BOM créé dans CPQ.
-
Vérifiez si les produits existent sur votre site Salesforce avec les mêmes ID de produits que ceux déterminés par vos règles produit. Si les produits existent, essayez de mettre à jour un champ dans l’enregistrement du produit (tel que « Actif »), de l’enregistrer, de le rétablir, d’attendre 30 minutes, puis de réessayer.
La synchronisation de nos enregistrements de produits s’appuie sur la date de dernière modification des enregistrements product2 pour accélérer les performances. Si votre environnement a été repointé à partir d’un autre, des produits qui n’existaient pas dans votre dernier environnement peuvent maintenant exister ici et avoir une date antérieure à celle de la reconnexion. Attendez la fin de la synchronisation du produit toutes les 30 minutes et essayez d’enregistrer à nouveau la configuration.
-
Vérifiez que les éléments BOM ont les types de nomenclature corrects, tels que définis dans CPQ Admin :
Si votre élément BOM était de type Fabrication et que votre CPQ administrateur n’avait défini que Sales and Installation dans l’onglet Paramètres, cet article ne serait pas renvoyé au QLE.
-
Vérifiez si la fonctionnalité dynamique associée est définie pour le produit configurable parent :
Si c’est le cas, vérifiez également que la méthode de sélection des options est également dynamique :
Cette fonctionnalité connexe devrait être automatiquement créée lorsque vous cliquez sur Logik activé sur le produit configurable, mais certains déclencheurs de produits personnalisés dans votre organisation Salesforce peuvent perturber cette automatisation. Pour déclencher à nouveau la création de la fonctionnalité, essayez de désactiver Logik Enabled, de l’enregistrer, puis de la réactiver. Ensuite, essayez de configurer avec ce produit.
(En cas de regroupement imbriqué, chaque produit auquel des éléments de ligne de devis enfants sont associés doit avoir cette fonctionnalité dynamique liée à son produit, et pas seulement au produit configurable parent de niveau supérieur.)
L’enregistrement ne crée pas de lignes de devis comme prévu
Cela se produit généralement lorsque l’un des champs des lignes de devis enfants est renseigné d’une manière qui n’est pas reflétée dans la CPQ configuration. Il s’agit d’un problème délicat à suivre car il n’y a pas d’erreur claire.
Solution : Vérifiez si l’environnement SFDC dispose de scripts, de flux ou de déclencheurs Apex agissant sur les lignes de devis.
Pour QCP spécifiquement, recherchez des scripts personnalisés. Vérifiez également s’il existe un script dans le champ Module d’extension Calculateur de devis (Configuration > packages installés > le module d’extension Salesforce CPQ >).
Examinez ce script personnalisé pour voir s’il se comporte comme prévu.
CPQ: « La chaîne JSON dépasse la limite de taille de tas »
Cela se produit si le champ LGK__BomData__c contient trop de données (par exemple, beaucoup de lignes de devis ou des informations étendues) et que l’utilisateur tente de reconfigurer le devis.
Solution : Contrôlez le nombre d’éléments écrits avec la fonction Limite d’élément BOM. Pour résoudre le problème, comptez les éléments dans la nomenclature de la configuration à l’origine de l’erreur. (Le nombre d’éléments est le nombre de lignes dans la nomenclature. Les éléments sont séparés par « {} » dans le champ BomData.) Créez ensuite un ticket de support pour définir le paramètre de locataire sur la moitié de ce nombre. Si vous n’utilisez pas ce champ Salesforce, définissez-le sur zéro.
Reconfigurer n’enregistre pas les sélections dans CPQ
Un utilisateur final peut enregistrer une configuration correctement et il écrit dans le QLE sans problème. Toutefois, lorsque l’utilisateur tente de reconfigurer, toutes les sélections ne sont pas conservées.
Les solutions :
- Vérifiez si ce problème se produit uniquement avec un utilisateur ou un profil spécifique. Leurs autorisations peuvent être mal définies.
- Vérifiez si le produit a le nom de la fonctionnalité, les attributs de configuration et les livres de prix connexes définis.
- Vérifiez si le plan utilise un jumelage, ce qui pourrait déclencher une règle pour effacer certaines sélections, ou si l’enrichissement Configurer/Reconfigurer est mal configuré. Pour en savoir plus sur ce problème, reportez-vous à la section Scripting : vérification de la première configuration et des configurations suivantes.
L’enregistrement ne crée pas de lignes de devis enfants
Le produit configurable avec lequel vous tentez de configurer peut avoir rencontré un problème avec l’automatisation CPQ activée et n’a pas créé les attributs de configuration nécessaires à la reconfiguration. Pour reconfigurer, l’attribut ID de configuration doit être présent, car c’est là que la ligne de devis fait référence à l’UUID de la configuration précédente.
Sur la page des détails du produit configurable, décochez Logik.io Activé, enregistrez, puis revérifiez et vérifiez si l’attribut de configuration a été créé.
Impossible d’accéder à CPQ l’administrateur à partir de SFDC
Ce problème peut empêcher les administrateurs de travailler sur la conception et l’implémentation de CPQ. Les causes de ce problème sont multiples.
La solution :
- Si cela se produit pour un seul utilisateur :
- Confirmez qu’il dispose d’un accès administrateur. Consultez Accès utilisateur.
- Vérifiez s’ils rencontrent des problèmes de navigateur. Consultez Problèmes courants de navigateur lors de l’utilisation de CPQ.
- Si cela se produit pour un groupe d’utilisateurs :
- Vérifiez que leur profil et leur groupe d’autorisations disposent des autorisations SFDC appropriées. Voir Que faire si vous recevez des privilèges insuffisants ou un écran vide lors du lancement d’une configuration Logik.
- Confirmez que CPQ a été ajouté aux URL de confiance dans la section Configuration, avec iFrame activé. Bien que cela ne soit pas nécessaire dans tous les cas, nous avons vu cet ajout aider les organisations avec CPQ des utilisateurs de plusieurs pays différents, ou si elles utilisent Subscription Manager/RLM.
- Si cela se produit pour chaque utilisateur, vérifiez si l’URL est correctement saisie dans les paramètres personnalisés.
C’est généralement l’une des premières étapes de l’intégration d’un CPQ environnement à une organisation SFDC. Parfois, l’utilisateur qui le configure définira involontairement l’URL comme un remplacement pour un profil (la case du bas) au lieu d’être accessible à tous les utilisateurs (la case du milieu).
Impossible de lancer une configuration
Le message d’erreur « Privilèges insuffisants » de Salesforce n’est qu’un des nombreux écrans qu’un utilisateur peut rencontrer lorsqu’il clique sur l’icône de la clé dans le QLE ou lorsqu’il sélectionne un produit après avoir cliqué sur Modifier les lignes du devis.
Lorsque ce problème se produit, d’autres problèmes peuvent inclure l’affichage de l’écran Contenu bloqué (comme dans le problème Impossible d’accéder CPQ à l’administrateur à partir du SFDC), l’affichage d’un écran vide ou l’affichage d’un message d’erreur.
Cela peut se produire pour diverses raisons, y compris des problèmes avec les mêmes autorisations que celles nécessaires pour accéder à l’administrateur CPQ . Toutefois, ce problème n’affecte que les utilisateurs finaux du configurateur (c’est-à-dire les utilisateurs commerciaux/partenaires).
Les solutions :
- Si cela se produit uniquement pour un plan ou lors du lancement à partir d’un devis, vérifiez s’il y a des erreurs dans l’onglet Journaux de l’administrateur CPQ .
Si vous ne trouvez pas d’erreurs dans les journaux, examinez Messages d’erreur courants et causes. Cela peut être dû à un problème avec le script On Configure/Reconfigure du plan, ou avec un champ jumelé attendu dans le devis.
- Si cela se produit pour un seul utilisateur, vérifiez s’il rencontre des problèmes de navigateur. Consultez Problèmes courants de navigateur lors de l’utilisation de CPQ.
- Si cela se produit pour un groupe d’utilisateurs, vérifiez si leur profil et leur groupe d’autorisations disposent des autorisations SFDC appropriées. Voir Que faire si vous recevez un privilège insuffisant ou un écran vide lors du lancement d’une configuration Logik .
- Si cela se produit pour tous les utilisateurs, vérifiez que l’URL est correcte dans Salesforce CPQ. Accédez à Configurer > packages installés > Salesforce CPQ > configurez > paramètres supplémentaires > l’URL du configurateur externe et le configurateur tiers.
C’est généralement l’une des premières étapes de l’intégration d’un CPQ environnement à une organisation SFDC. L’URL prend généralement la forme
https://<nom de domaine>.<secteur>.logik.io/ui/configure,mais elle peut varier selon que vous utilisez ou non les pages VisualForce pour lancer le configurateur.Si votre URL ne se trouve pas dans le formulaire ci-dessus, votre organisation doit disposer d’une documentation pour la configuration personnalisée effectuée afin de le lancer dans le CPQ configurateur.
Paramètres de partage des utilisateurs partenaires/de l’API de RFQ
- Livre de prix
- Fonctionnalité du produit
- Estimation
- Ligne de devis
- Attribut de configuration
- Élément de ligne de configuration
Salesforce CPQ a besoin d’accéder à ces objets pour une partie de notre intégration de reconfiguration.
En règle générale, vous n’avez pas besoin de modifier les paramètres de partage de cet objet puisqu’il est créé par l’utilisateur d’intégration, mais dans de nombreux cas, les utilisateurs partenaires peuvent essayer de référencer ces enregistrements pendant la RFQ, ils devront donc le définir sur Public en lecture seule ou en lecture/écriture publique.
Problèmes de la plateforme Salesforce
Vous pouvez recevoir un message « Erreur lors de l’enregistrement » :
Erreur lors de la sauvegarde de l’enregistrement : nous n’avons pas pu convertir le produit configurable en produit statique. Assurez-vous que les composants enfants répondent aux exigences et réessayez.
Cette erreur peut se produire lorsque vous essayez de décocher le LGK__IsConfigurable__c champ sur un enregistrement Product2. Pour résoudre le problème, à partir du lanceur d’applications Salesforce, visitez la page Paramètres personnalisés de l’administrateur Logik.io et activez le paramètre Ignorer le déclencheur de configuration du produit configurable .