Guide étape par étape

Cet article peut vous aider à décider comment ajouter la configuration CDS.

1. Ouvrez l’éditeur de mise en page dans votre CPQ configurateur.
2. Téléchargez votre fichier de mise en page CSV.
3. Ouvrez votre fichier de mise en page CSV et ajoutez les champs d’élément de mise en page CDS (mis en évidence en détail ci-dessous).
4. Téléchargez à nouveau votre fichier de mise en page CSV vers CPQ. Votre élément de mise en page CDS devrait maintenant être présent dans la mise en page.
5. Ouvrez les options de configuration de votre élément de mise en page CDS et ajoutez les lignes de données JSON nécessaires.

Options de configuration technique

L’intégration entre CPQ et CDS est réalisée dans la définition de la mise en page du plan. Le fichier CSV de mise en page suivant permet de montrer comment l’administrateur définit l’emplacement du rendu de la visualisation CDS dans l’interface utilisateur. Il précise également l’environnement CDS et les CPQ données de champ à envoyer.

La mise en page peut être mise à jour directement dans l’éditeur de mise en page. Dans l’éditeur de mise en page, créez une nouvelle section nommée CDS dans votre fichier CSV à l’aide des champs surlignés en rouge ci-dessous, puis chargez le nouveau fichier dans la mise en page.

À partir d’ici, vous pouvez ouvrir les paramètres de cet élément de mise en page et configurer les champs suivants à l’aide de l’éditeur JSON des propriétés CDS :

Ces propriétés peuvent être configurées dans cet élément. Le tableau suivant fournit le nom et la description de chaque élément.

setVariableName: [
{
field1: 'value',
field2: 'value'
}
{
field1: 'value',
field2: 'value'
}
]

{
   "eventProductPickers": [
      "productPicker1",
      "productPicker2"
   ]
}

{
  "eventProductPickers": {
     "logikProductPicker1": "cdsProductPickerName1",
     "logikProductPicker2": "cdsProductPickerName2"    }
}

Mise en forme de chaîne JSON

Le formatage final de la chaîne JSON doit ressembler à ce qui suit :

{

"domain": "exampleDomain", "env": "qa"

"eventFields": ["field1", "field2", "field3"]

}

Notes

• Dans l’exemple de définition de mise en page, le rendu CDS s’affichera dans une barre latérale BasicContainer positionnée en haut à droite.
  • CDS peut transmettre CPQ un objet JSON à un champ de texte.
  • Utilisez des règles avancées pour analyser les réponses JSON à partir de CDS.

• Le JSON fourni dans la colonne « value » (colonne I) de la ligne d’élément CDS contient la syntaxe suivante :

  {
  "eventFields": [ "FIELD1",
  "FIELD2", "FIELD3"
  ],
  "domain": "CDS_DOMAIN", "env": "CDS_ENV_SECTOR"
  }

  domaine : le nom du domaine au service de votre projet, tel que fourni par le SNC.

  env : le nom du service d’environnement pour votre projet, tel que fourni par CDS. Exemple : « qa ».

  Le tableau eventFields contient les noms de CPQ variables des champs transmis au CDS. Dans le passé, la norme était que les CDS fassent correspondre leurs variables aux noms des CPQ variables. Confirmez que c’est le cas pour votre mise en œuvre avec CDS.

  eventFields doit contenir tous les champs qui seront communiqués entre CPQ CDS (c’est-à-dire les deux CPQ champs qui contrôlent le visuel CDS et les champs qui sont renvoyés en CPQ fonction des changements apportés à la visualisation CDS).

• Les ensembles peuvent également être transmis au CDS, bien que seuls les 25 premiers index puissent être envoyés. Cela reflète le processus ci-dessus, sauf que le nom de propriété est eventSets au lieu de eventFields.
• Tableau ou objet d’ensembles à envoyer au SNC :
  • Un tableau supposera que les chaînes contenues sont à la fois CPQ un nom de variable et des noms de variable CDS.
  • Un objet possède des paires clé :valeur. La clé est le nom de la CPQ variable et la valeur est le nom de la variable CDS.

  • Celui-ci sera envoyé dans son ensemble, jusqu’à 25 index de long en utilisant la syntaxe suivante :

    setVariableName: [
    {
    field1: 'value', field2: 'value'
    },
    {
    field1: 'value', field2: 'value'
    },
    ]

• Les sélecteurs de produits peuvent également être transmis au CDS avec une restriction selon laquelle seuls les 25 premiers index peuvent être envoyés. Cela reflète le processus ci-dessus, sauf que le nom de propriété est eventProductPickers au lieu de eventFields ou setFields. Les deux syntaxes suivantes fonctionnent :

  {
    "eventProductPickers": ["productPicker1", "productPicker2"]
  }

  {
    "eventProductPickers": {
      "logikProductPicker1": "cdsProductPickerName1",
      "logikProductPicker2": "cdsProductPickerName2"
    }
  }

• Le SNC peut être configuré pour une communication bidirectionnelle. La communication unidirectionnelle met à jour le graphique CDS lorsque l’utilisateur met à jour les champs pertinents CPQ . Le deuxième mode permet à l’utilisateur de manipuler le graphique CDS, et CDS mettra à jour les entrées de champ pertinentes CPQ . Pour les champs standard, CDS réécrit dans le champ mappé CPQ . Si CPQ les appareils sont utilisés dans une configuration de communication bidirectionnelle, CPQ les administrateurs du SNC devront coordonner la configuration suivante :
  • L’administrateur CPQ définira un champ d’événement distinct dans lequel les données de l’ensemble seront écrites à partir du CDS.
  • L’administrateur CDS spécifiera ce champ comme destination des données de l’ensemble.
  • L’administrateur CPQ définit des règles de détermination qui analysent le champ et renseignent l’ensemble.