Intégration CPQ à des outils de visualisation
Découvrez comment CPQ se connecte à des moteurs de visualisation tiers (CDS, kBridge et Threekit) pour afficher des vues de produits 2D/3D qui répondent aux entrées de configuration en temps réel.
Vous pouvez effectuer les actions suivantes :
- Affichez des visuels en direct pendant la configuration des utilisateurs : les couleurs, les dimensions, les options et les lots peuvent informer le spectateur instantanément.
- Coordonner l’interface utilisateur + les états visuels : publier des valeurs de champ, définir des lignes et des produits sélectionnés dans le rendu.
- (Facultatif) Réécrire à partir de la visionneuse : pour les fournisseurs pris en charge, les actions de l’utilisateur dans le canevas peuvent mettre à jour les champs.
Fournisseurs pris en charge en un coup d’œil
| Fournisseur | Direction | Ce que vous pouvez envoyer | Ce qui peut être réécrit | Notes |
|---|---|---|---|---|
| CDS (en anglais seulement) | 1 sens et 2 sens | Champs, Ensembles (25 premières lignes), Sélecteurs de produits (25 premières options), Index d’ensemble actif | Champs ; Ensembles via le champ d’écouteur JSON + analyse de règle | Bon pour CAD/2D/3D ; Objets de mappage flexibles |
| kBridge | 1 sens et 2 sens | Champs, Ensembles (25 premières lignes), Sélecteurs de produits (25 premières options), Index d’ensemble actif | Champs ; Ensembles via le champ d’écouteur JSON + analyse de règle | 3D en temps réel avec un modèle riche d’événements et d’auditeurs |
| Kit de trois | 1 sens | Champs, ID d’actif (statique ou via champ), Index d’ensemble actif (focus visuel uniquement) | Non pris en charge (visionneuse → Logik) | Utilisation pour les visuels haute fidélité ; Mapper les champs et la sélection des actifs |
Remarque :
Lors de l’envoi d’ensembles ou de sélecteurs de produits, CPQ publie jusqu’à 25 lignes/options. Les indices et les options au-delà de 25 ne sont pas transmis. Lorsque vous utilisez des répéteurs ensemble, vous pouvez publier un déclencheur Active Set Index afin que la visionneuse affiche la ligne que l’utilisateur modifie.
Mode de fonctionnement de l’intégration
- Le composant de mise en page dans le plan définit la position et la taille du panneau de visualisation.
- Les réglages de connexion autorisent et acheminent le trafic (par exemple, l’URL du script ou de l’application, le jeton d’authentification et le sous-domaine).
- Le bloc de mappage sélectionne les CPQ données à envoyer :
eventFields: noms des variables de champ et leurs clés de visionneuse.eventSets: définit les noms de variables (25 premières lignes publiées sous forme de tableau d’objets).eventProductPickers: options sélectionnées (25 premières) sous forme de tableau d’objetssetActiveTriggers— Champs booléens qui indiquent l’index actif dans un répéteur défini
- (Bidirectionnel uniquement) Un champ d’écoute (CPQ champ de texte) reçoit le JSON de la visionneuse.
- Ajoutez une règle de détermination (ou un enrichissement) pour analyser ce JSON et mettre à jour les champs ou définir les lignes.
- Si un champ d’écoute est présent, seuls les mappages explicitement configurés pour les écritures bidirectionnelles réécrivent.
Données échangées
- Champs : valeurs scalaires (texte, nombre, booléen, sélection de la liste déroulante).
- Jeux : tableau d’objets de ligne (25 premiers). Utilisez l’index d’ensemble actif pour maintenir le visuel synchronisé avec la ligne en cours de modification dans un répéteur.
- Sélectionneurs de produits : tableau des objets d’option sélectionnés (25 premiers).
- Assets (Threekit) : Fournissez un
assetIdstatique ou un champ asset-ID dans Logik pour permettre la sélection dynamique des actifs.
Sécurité et environnements
- Authentification et origine : utilisez des jetons de fournisseur et des URL appropriées pour la production par rapport à la non-production. Assurez-vous que les CPQ origines du client d’exécution correspondent aux domaines d’appel.
- CSP (Politique de sécurité du contenu) : autorisez le script du fournisseur ou les hôtes d’applications pour l’intégration et la messagerie. Coordonnez-vous avec votre équipe de sécurité et CPQ votre assistance pour ajouter des domaines.
- Séparation des préoccupations : conservez les informations d’identification et les jetons du fournisseur en dehors des mises en page partagées entre les environnements. Échanger des jetons lors de la promotion.
Quand choisir l’outil
- Si vous avez besoin de modifications bidirectionnelles dans le canevas, choisissez kBridge ou CDS et implémentez un champ d’écoute et des règles d’analyse.
- Si vous avez besoin d’une 3D haute fidélité avec gestion des ressources et mises à jour unidirectionnelles, choisissez Threekit avec une stratégie de champ assetId ou assetId.
- Si vous disposez d’une expérience utilisateur lourde, préférez CDS ou kBridge pour la gestion bidirectionnelle de JSON et la synchronisation Active Set Index.
Directives générales
- Mappez uniquement ce dont vous avez besoin : limitez
les eventFields,eventSetseteventProductPickersaux données essentielles pour les performances. - Conception pour la limite de 25 éléments : si les utilisateurs dépassent 25 lignes définies ou sélections de sélecteur de produit, ajoutez des garde-fous (tels que la validation, la pagination ou la synthèse).
- Normaliser dans les deux sens : définissez un schéma JSON stable pour les charges utiles de l’écouteur et centralisez la logique d’analyse dans une règle gérée ou un enrichissement.
- Promouvoir en toute sécurité : externaliser les valeurs spécifiques à l’environnement telles que les jetons et les URL. Vérifiez les visuels en test avant la promotion de la production.
- Dépannage systématique :
- Vérifiez les journaux d’administration pour les erreurs d’exécution ou de script.
- Vérifiez l’accès CSP et réseau aux domaines du fournisseur.
- Utilisez la console/les outils de développement de la visionneuse et CPQ les entrées du débogueur pour reproduire les états.