Composant d’affichage du calendrier
Utilisez le composant CPQ d’affichage de calendrier pour présenter les options de configuration basées sur le temps dans une vue mensuelle. Configurez les ensembles, les champs et les paramètres de sélection pour permettre aux utilisateurs d’afficher, de sélectionner et de gérer des enregistrements spécifiques à une date directement dans l’interface de configuration.
CPQ L’interface utilisateur native permet à l’administrateur de présenter un composant d’affichage de calendrier à l’utilisateur pour faciliter les configurations basées sur le temps. Le calendrier s’affiche dans le contexte d’un mois. Les données sous-jacentes à l’affichage du calendrier constituent un ensemble, chaque jour du calendrier étant représenté par un enregistrement dans l’ensemble.
L’exemple ci-dessous montre un ensemble de 30 enregistrements, un pour chaque jour, représentés comme un composant d’affichage de calendrier.
availableDates. Cet ensemble contient les champs associés suivants :selectedDate(booléen) : détermine si l’utilisateur a sélectionné une ou plusieurs date/enregistrementsrawDate(texte) : contient la date brute formatée pour chaque enregistrement définiavailableDate(texte) ; contient la date au format « JJ/MM/AAAA » pour chaque enregistrement défini. Ceci est utilisé pour faciliter l’affichage de la date lisible par l’homme sur l’affichage du calendrierloadSize(liste déroulante) : les options incluent S, M et L. Cette liste déroulante s’affiche dans chaque enregistrement (chaque jour du calendrier mensuel).Les enregistrements de calendrier (jours) peuvent afficher n’importe quel nombre de champs associés à un ensemble. L’administrateur doit appliquer une limite pratique au nombre de champs définis, en fonction de la taille de l’écran des utilisateurs et de la réactivité fournie par l’application.
L’enrichissement On Configure/Reconfigure initialise l’ensemble avec la taille appropriée pour les mois à afficher et un élément JSON contenant des valeurs de champ pour chaque enregistrement. Voici la sortie de l’enrichissement On Configure pour le calendrier brut ci-dessus :
{
"availableDates": {
"data": [
{
"availableDate": { "value": "6/1/2024" },
"rawDate": {
"value": "2024-06-01T00:00:00.000Z"
}
}, //skipped interior records for brevity
{
"availableDate": { "value": "6/30/2024" },
"rawDate": {
"value": "2024-06-30T00:00:00.000Z"
}
}
],
"userEdited": false
}
}Notez que le champ loadSize a été exclu du JSON défini, car l’administrateur ne voulait pas préremplir le champ.
Dans la mise en page du plan, l’administrateur définit l’emplacement d’affichage de l’ensemble et les sous-champs qui seront affichés dans chaque enregistrement/jour calendaire.
Dans les paramètres Définir les propriétés > la sélection, l’administrateur définit si l’utilisateur doit être autorisé à sélectionner un ou plusieurs jours. Le champ booléen pour la sélection (dans ce cas, selectedDate) stocke si un enregistrement d’ensemble/un jour du calendrier spécifique est sélectionné.
Les propriétés définies > les paramètres de recherche vous aident à afficher le sous-ensemble de jours le plus pertinent pour l’utilisateur lorsque votre calendrier lui permet de choisir parmi plus d’un mois. À cette fin, le champ source est le jour (enregistrement) que l’administrateur souhaite afficher dans l’ensemble de calendriers mensuels. Le champ cible est le champ associé à l’ensemble qui contient la plage complète des dates du calendrier.
La zone Définir les propriétés > la valeur brute contient la sortie JSON par les sélections sur la page ci-dessus. Toutefois, comme « calendrier » n’est pas actuellement sélectionnable en tant que displayType, l’administrateur doit modifier le JSON pour le définir explicitement.