Ensembles
Découvrez comment les ensembles organisent des groupes de champs répétables, simplifient des configurations complexes et permettent l’agrégation de données entre des éléments répétés dans CPQ.
Un ensemble est une collection de champs réutilisable et reproductible qui permet aux administrateurs de définir plusieurs instances de données de configuration similaires, telles que plusieurs produits, composants ou options, dans un seul plan.
Chaque ligne d’un ensemble représente une instance d’un groupe répété de champs, et chaque champ de cette ligne se comporte indépendamment. Les ensembles rationalisent la conception de configuration, réduisent les doublons et prennent en charge les cas d’utilisation avancés qui nécessitent des entrées tabulaires ou basées sur des listes.
Les administrateurs utilisent des ensembles pour présenter les options de configuration dans des mises en page structurées de type tableau que les clients peuvent facilement modifier dans l’interface de l’utilisateur final.
- Simplifiez les configurations reproductibles. Au lieu de créer plusieurs champs et règles pour chaque répétition, définissez une fois et réutilisez plusieurs fois.
- Fournissez une saisie intuitive des données tabulaires. Les utilisateurs finaux peuvent ajouter, supprimer ou modifier plusieurs instances de produit dans une grille structurée.
- Prendre en charge les règles dynamiques. Les règles peuvent référencer des valeurs dans la même ligne ou regrouper des données sur toutes les lignes.
- Activez les rapports et les résumés avancés. Les agrégats résument les valeurs de champ sur les lignes (par exemple, quantité totale ou nombre total d’unités de rack).
Fonctionnement des ensembles
Un ensemble regroupe plusieurs champs de configuration et répète ce groupe pour chaque élément de la liste.
- Les champs d’une même ligne peuvent affecter d’autres champs de cette ligne.
- Les champs d’une ligne ne peuvent pas affecter directement les champs d’une autre ligne.
- Les champs situés en dehors d’un ensemble peuvent influencer les champs situés à l’intérieur de celui-ci, mais pas l’inverse.
Pour affecter les champs situés en dehors d’un ensemble, utilisez :
- Agrégats : addition, nombre, moyenne, valeur maximale ou valeur minimale sur toutes les lignes.
- Règles de produit : définissez une logique qui définit les valeurs des champs externes en fonction des données définies.
Un ensemble peut contenir jusqu’à 2 000 lignes.
Options d'affichage
Les ensembles peuvent apparaître dans l’interface utilisateur sous plusieurs formats, en fonction des exigences de l’expérience utilisateur :
| Type d'affichage | Description | Exemple de cas d’utilisation |
|---|---|---|
| Table | Lignes, colonnes et cellules avec en-têtes ; idéal pour des comparaisons détaillées. | Configurez plusieurs équipements réseau. |
| Liste | Chaque ligne est affichée sous forme de carte ; Peut prendre en charge la sélection unique ou la sélection multiple. | Sélectionnez des créneaux de livraison ou des forfaits de services. |
| Répéteur | Affiche un enregistrement à la fois avec des contrôles de navigation. | Modifiez les configurations une par une dans des mises en page plus petites. |
Les administrateurs contrôlent la mise en page, l’alignement et le défilement dans l’éditeur de mise en page.
Relations de champs
| Relation | Comportement |
|---|---|
| À l’intérieur → à l’intérieur | Les champs d’une même ligne peuvent se déclencher mutuellement via des règles. |
| À l’intérieur → à l’extérieur | Non autorisé directement ; utiliser des agrégats ou des règles de produit. |
| À l’extérieur → à l’intérieur | Autorisé. Les règles ou les actions de champ en dehors d’un ensemble peuvent modifier les valeurs de champ définies. |
Propriétés clés
Les ensembles incluent plusieurs catégories de configuration qui façonnent la façon dont les utilisateurs interagissent avec la table ou la liste :
- Paramètres généraux : orientation, hauteur maximale, alignement, étiquettes d’index.
- Type d’affichage : Choisissez entre les vues Table et Liste.
- Paramètres en ligne : affichez les indicateurs « Ajouter une ligne », les commandes déroulantes ou les actions de survol.
- Paramètres de taille : gérez la façon dont les utilisateurs augmentent ou diminuent les lignes définies (champ numérique ou curseur).
- Paramètres de sélection : ajoutez une sélection à une ou plusieurs lignes avec un champ de sélection booléen.
- Paramètres de recherche : autorisez les utilisateurs à rechercher des valeurs dans un ensemble (par exemple, filtrer par date disponible).
- Paramètres de message : affichez des messages ou des indicateurs de validation dans des cellules spécifiques.
Gestion des données du jeu
Les ensembles prennent en charge l’importation et l’exportation de données au format CSV.
- Télécharger les données de l’ensemble : exporte uniquement les colonnes visibles en fonction des filtres appliqués dans l’interface utilisateur.
- Charger les données de l’ensemble : ajoute ou met à jour des lignes dans l’ensemble à l’aide d’un fichier CSV structuré.
- Les règles s’exécutent automatiquement lors du chargement.
- De nouvelles lignes sont ajoutées ; les lignes correspondantes sont mises à jour.
- Des limites appliquées par le système s’appliquent (25 colonnes visibles recommandées).
{
"uploadDetails": {
"uploadButton": { "label": "Upload CSV", "visible": true },
"downloadButton": { "label": "Download CSV", "visible": true }
}
}
Scripting avec des ensembles
Pour référencer des jeux dans des règles ou des scripts, utilisez la syntaxe suivante :
| Cas d'utilisation | Exemple de syntaxe |
|---|---|
| Accéder à l’ensemble | set.<setVarName> |
| Accéder à un champ d’agrégat | set.<setVarName>.<aggregateVarName> |
if (set.networkDevices.totalRackUnits > 50) {
field.requiresAdditionalCooling = true;
}