Chargement des champs CSV du chargeur de matrice et des options de champ Chargement et exportation
Utilisez le chargeur de matrice pour créer, modifier et exporter en bloc des champs, des options de champ et des sélecteurs de produits dans CPQ. Définissez les données dans des fichiers CSV avec des colonnes et des formats pris en charge, puis chargez-les ou téléchargez-les pour accélérer la gestion des configurations et la migration de l’environnement.
Chargement des champs CSV
Tous les types de champs peuvent être ajoutés et modifiés via le chargeur de matrice. Cette section suppose que le lecteur fonctionnera dans un fichier de feuille de calcul (Google Sheets, Microsoft Excel ou similaire), puis exportera le résultat dans un fichier CSV pour le charger dans le chargeur de matrice. Cette rubrique décrit les colonnes et les données que le chargeur de matrice accepte dans le chargement de champ.
| Nom de colonne | Description | Valeurs valides | Notes |
|---|---|---|---|
| field_type | Définit le type de données du champ | texte | textField booléen | nombre booleanField | Liste déroulante numberField | pickListField | Obligatoire |
| nom | Le nom que l’administrateur voit sur la page d’administration de la liste des champs | Les chaînes valides peuvent être composées d’un maximum de 255 caractères, y compris des lettres, des chiffres, des espaces et les caractères spéciaux suivants : {}[]()|\~'_^@ ?<=> ;:/.-,+*ʼ& %$#" ! |
Obligatoire |
| variableName | Chaîne distincte utilisée pour référencer le champ | Les noms de variables de champ valides comprennent jusqu’à 128 lettres, chiffres et traits de soulignement. Le premier et le dernier caractère doivent être une lettre ou un chiffre. | Requis ; doit être unique |
| obligatoire | Non utilisé actuellement par l’application |
VRAI | FAUX <vide> |
En option ; non utilisé actuellement par l’application |
| defaultValue | Fournir une valeur initiale dans le champ au début de l’expérience de configuration | [Voir la note] |
En option ; pertinent pour textField, booleanField, numberField et singlePickListField uniquement. Multi pickListFields définit les valeurs par défaut dans le fichier de chargement fieldOptions. |
| minLength | Nombre minimum de caractères acceptés | <numéro> | En option ; pertinent uniquement pour textField |
| maxLength | Nombre maximal de caractères acceptés | <numéro> | En option ; pertinent uniquement pour textField |
| Précision | Définir des chiffres de précision à droite de la décimale | <numéro> | En option ; pertinent pour numberField uniquement |
| Valeur minimale | Valeur numérique minimum acceptée | <numéro> | En option ; pertinent pour numberField uniquement |
| maxValue | Valeur numérique maximum acceptée | <numéro> | En option ; pertinent pour numberField uniquement |
| selectType | Définir si pickListField est à sélection unique ou à sélection multiple |
Multi unique <vide> |
En option ; pertinent uniquement pour pickListField. Si <vide>, suppose une seule |
- Les valeurs par défaut du champ booléen valide sont TRUE et FALSE.
- Si minValue ou maxValue est défini pour un champ numérique, la valeur par défaut spécifiée doit être conforme à la définition.
- La valeur par défaut d’un seul pickListField doit correspondre à une valeur d’option définie pour le champ. Cette valeur d’option peut être définie dans un fichier CSV d’option de champ qui est traité par le chargeur de matrice dans le même lot que le fichier CSV de champ.
- Les valeurs de champ de texte sont limitées à 2 000 caractères.
L’ordre des colonnes n’est pas fixe. Pour plus de commodité, les administrateurs peuvent réorganiser les colonnes de leur feuille de calcul et le fichier CSV qui en résulte.
Le fichier explicatif de chargement des champs montre la variété des champs et des paramètres de champ acceptés par le chargeur de matrice. Les cellules avec des arrière-plans gris indiquent que la cellule n’est pas pertinente pour le contexte de la ligne. Pour télécharger le fichier explicatif, dans le chargeur de matrice, cliquez sur le lien Champs dans la section Fichiers d’exemple.
Tout comme les champs ajoutés via l’interface utilisateur d’administration doivent être associés à un ou plusieurs plans, les champs ajoutés en bloc via le chargeur de matrice doivent l’être aussi. Pour obtenir des instructions, consultez Associer un champ à un plan.
Exportation de champs CSV
Pour plus de commodité, les administrateurs peuvent exporter un fichier CSV des champs et des options de champ définis dans l’environnement en procédant comme suit :
- Dans le volet de navigation de l’administrateur, cliquez sur Champs.
La liste de tous les champs définis s’affiche.
- (Facultatif) Saisissez une chaîne de recherche et appuyez sur < Entrée > pour réduire la liste des champs.
- Cliquez sur Exporter. Un message apparaît temporairement en bas de la page.
- Cliquez sur le centre de notifications dans le coin inférieur gauche.
- Cliquez sur Télécharger pour télécharger le fichier CSV.
Le fichier ZIP obtenu contient le fichier CSV des champs et le fichier CSV des options de champ.
Chargement des options de champ CSV
Le chargement des options de champ définit les options pickListField et l’attribution. Cette section suppose que le lecteur travaillera dans un fichier de feuille de calcul (Google Sheets, Microsoft Excel ou similaire), puis téléchargera/exportera le résultat dans un fichier CSV pour le charger dans le chargeur de matrice. Ce qui suit décrit les colonnes et les données que le chargeur de matrice accepte dans l’option de champ Télécharger.
| Nom de colonne | Description | Valeurs valides | Notes |
|---|---|---|---|
| variableName | Nom de variable du champ pour lequel cette option de ligne sera ajoutée | <nom variable de champ> | Obligatoire |
| nom | Nom de l’option visible par l’utilisateur final | Les chaînes valides peuvent être composées d’un maximum de 255 caractères, y compris des lettres, des chiffres, des espaces et les caractères spéciaux suivants : {}[]()|\~'_^@ ?<=> ;:/.-,+*ʼ& %$#" ! |
Obligatoire |
| valide | Une chaîne distincte sera utilisée pour référencer l’option de champ | Les noms de variables d’option de champ valides comprennent jusqu’à 128 lettres, chiffres et traits de soulignement. Le premier et le dernier caractère doivent être une lettre ou un chiffre. Les noms de variables d’option de champ doivent être uniques dans le champ d’application du même champ. | Obligatoire |
| defaultValue | Fournir une valeur initiale dans le champ au début de l’expérience de configuration |
VRAI FAUX <vide> |
En option ; pertinent uniquement pour les pickListFields multiples |
| Description étendue | Description contextuelle pour référence de l’administrateur | Les chaînes valides peuvent être composées d’un maximum de 255 caractères, y compris des lettres, des chiffres, des espaces et les caractères spéciaux suivants : {}[]()|\~'_^@ ?<=> ;:/.-,+*ʼ& %$#" ! |
Facultatif |
| imageUrl | L’image montre l’utilisateur final pour cette option pickListField | <URL> |
En option ; à utiliser avec pickListField. Le type d’affichage est défini comme VisualPicker ou MultiSelectVisua lPicker dans la mise en page |
Le fichier explicatif de chargement des champs montre la variété des options de champ et des paramètres d’option de champ acceptés par le chargeur de matrice. Les cellules avec des arrière-plans gris indiquent que la cellule n’est pas pertinente pour le contexte de la ligne. Pour télécharger le fichier explicatif, dans le chargeur de matrice, cliquez sur le lien Champs dans la section Fichiers d’exemple.
Options de champs : exportation CSV
Les options de champ sont exportées dans le même mouvement que celui utilisé pour exporter des champs à partir de CPQ. Pour obtenir des instructions, consultez la section « Exportation des champs CSV » ci-dessus.
Chargement CSV : sélecteur de produit
Cette section décrit les étapes de création d’un sélecteur de produits nommé « Mon sélecteur de produits », qui comprendra les produits/options suivants :
- Option1/Produit1 : Produit Un
- Option2/Produit2 : Produit Deux
- Option3/Produit3 : Produit Trois
Pour créer un sélecteur de produit, procédez comme suit.
- Extrayez un exemple de fichier CSV pour les champs du chargeur de matrice.
Ce fichier CSV doit contenir les informations de champ requises pour créer un sélecteur de produit. Veillez à ajouter une ligne supplémentaire en haut du fichier d’exemple spécifiant le type de champ en tant que sélecteur de produit (ce type de champ peut ne pas être présent dans le fichier d’exemple).
- Extrayez un exemple de fichier CSV pour les options de champ à partir du chargeur de matrice.
Ce fichier CSV doit contenir les noms de produits qui seront affichés dans l’interface utilisateur de l’utilisateur final pour les champs créés à l’étape précédente.
- Créez un fichier .yaml.
Ce fichier doit inclure les champs contenus dans le sélecteur de produits, tels que définis dans le fichier CSV à l’étape 1. Le fichier .yaml sera utilisé pour lier les deux fichiers CSV pendant le processus de téléchargement dans le chargeur de matrice. Sans lui, le sélecteur de produit ne sera pas créé.
Exemple de syntaxe .yaml :--- - variableName: myProductPicker fields: - variableName: myProductPicker.value target: ProductId - variableName: myProductPicker.select - variableName: myProductPicker.quantity target: ProductQuantity - Télécharger des fichiers dans le chargeur de matrice : compressez les deux fichiers .csv et le fichier .yaml des étapes précédentes dans un dossier compressé. Ensuite, allez dans le chargeur de matrice, téléchargez le dossier compressé, cliquez sur Importer, puis sur Continuer.
- Valider dans l’interface utilisateur : le sélecteur de produit nouvellement créé doit être disponible dans les CPQ champs Admin, comme indiqué ci-dessous.
Exportation CSV : sélecteur de produit
Pour exporter un sélecteur de produits, cliquez sur les champs dans CPQ Admin. Cliquez sur Sélecteurs de produits, sélectionnez le sélecteur de produits à exporter, puis cliquez sur Exporter.