CPQ champs

Un CPQ champ est un champ défini par l’utilisateur et personnalisé dans l’environnement CPQ . Son type peut être un nombre, un texte, une liste déroulante, un ensemble ou un sélecteur de produit. Lorsque les utilisateurs créent des champs dans CPQ, ils peuvent affecter manuellement des valeurs par défaut dans la définition de champ ou définir des valeurs via des actions de détermination.

L’exemple suivant montre comment un utilisateur définit un CPQ champ dans un enrichissement On Configurer/Reconfigurer :

cfgRequest.testField.set("value", "Hello World"); 

Pour une description plus complète des CPQ champs, reportez-vous à la section Configurer les champs.

Champs système

Les champs système sont prédéfinis. Impossible d’affecter une valeur par défaut aux champs système, car ils exploitent le cache de produit SFDC (ou la date et l’heure actuelles) pour générer leurs valeurs.

L’exemple suivant montre comment un utilisateur appelle un champ système dans un enrichissement On Configure/Reconfigure :

let pC = {"input2":cfgRequest.sys.productCode.value};

Les champs système peuvent être ajoutés directement à n’importe quelle mise en page. Il n’y a aucun problème à les afficher, qu’ils contiennent ou non des données prédéfinies.

Dans l’éditeur de mise en page :

Dans l’interface utilisateur du configurateur :

L’unité de mesure est vide car dans cet exemple, elle n’a pas été définie dans SFDC.

Le mappage de chacun de ces champs système à leur objet SFDC respectif est le suivant. Le nom de l’API de champ est entre parenthèses.

• sys.productUOM > Produit : unité de mesure de quantité (QuantityUnitOfMeasure)
• sys.productName > produit : nom du produit (Name)
• sys.productFamily > Produit : Famille de produits (Famille)
• sys.productDescription > produit : description du produit (Description)
• sys.productCode > Produit : Code produit (ProductCode)
• sys.enableValidation : la valeur par défaut est vrai
• sys.currentDate : appel d’API d’heure simple, renvoie la date UTC
• sys.actionContext > Ligne de devis : Contexte d’action (LGK ActionContext c)
• sys.productPrice > Entrée du livre des prix : Prix catalogue (prix unitaire)
• sys.productId : la valeur dépend des paramètres de l’administrateur

  sys.productId bascule sur ce qui est défini dans les paramètres de votre CPQ environnement. Par exemple, si le champ ID de produit était défini sur Code produit, les données résultantes seraient Code produit, ce qui les rendrait identiques au champ sys.productCode.

Si le champ ID du produit était plutôt défini sur ID de partenaire, les données seraient extraites du champ SFDC ID Product2 (ID comme nom de l’API du champ) :

Champs partenaires

Les champs partenaires sont des champs qui utilisent un appel POST pour initialiser une configuration via une API. Les champs Partenaire exploitent l’ensemble de données du partenaire pour générer des valeurs de champ.

Le mappage de chacun de ces champs partenaires à leur objet SFDC respectif est le suivant. Le nom de l’API de champ est entre parenthèses.

• partner.quote.id ID d’enregistrement de > de devis (ID)
• partner.quote.lineId ID d’enregistrement de > de ligne de devis (ID)
• partner.quote.pricebookId ID du livre de prix > de devis (SBQQPricebookIdc)
• Cotation.Devis.DevisIsoCode du partenaire > IsoCode de devise

  partner.quote.currencyIsoCode est défini par défaut sur USD si votre organisation n’a pas activé le multi-devise dans son organisation Salesforce. Pour activer le multidevise, suivez les étapes de cet article Salesforce : Activer plusieurs devises.

Lorsque vous utilisez ces champs, il est important de noter que certaines données peuvent ne pas avoir de valeur (null) lors de la première configuration du produit. Pour vous assurer qu’il n’y a pas d’erreurs d’initialisation, incluez des vérifications nulles dans toutes les règles ou tous les scripts qui utilisent des champs partenaires.

Ces champs ne peuvent pas être directement ajoutés à une mise en page comme le peuvent les champs système. Au lieu de cela, vous pouvez utiliser CPQ des champs pour renseigner les données des champs partenaires via un enrichissement d’initialisation.

L’exemple d’enrichissement d’initialisation suivant renseigne les valeurs des champs partenaire dans le configurateur :

let quoteId = cfgRequest.partner.quote.id.value;
let lineID = cfgRequest.partner.quote.lineId.value;
let currencyISO = cfgRequest.partner.quote.currencyIsoCode.value;
let priceBookID = cfgRequest.partner.quote.pricebookId.value;

if (quoteId != null) {
	cfgRequest.quoteIDTest.set("value", quoteId);
}
if (lineID != null) {
	cfgRequest.lineIDTest.set("value", lineID);
}
if (currencyISO != null) {
	cfgRequest.currencyISOCodeTest.set("value", currencyISO);
}
if (priceBookID != null) {
	cfgRequest.pricebookIDTest.set("value", priceBookID);
}
return cfgRequest;

Configuration initiale :

Reconfiguration :

L’ID de la ligne est maintenant renseigné.

La façon dont vous utilisez les champs partenaire et système dépend de vous. Certaines organisations trouvent utile d’afficher ces informations dans le configurateur pour l’utilisateur final, tandis que d’autres les utilisent en arrière-plan dans des règles pour déterminer les conditions de tarification.