Plage de dates

Aperçu

Le composant Avonni Date Range offre une interface intuitive qui permet aux utilisateurs de sélectionner une date de début et une date de fin ou une date et heure de début et de fin, définissant ainsi une période spécifique. Ceci est couramment utilisé pour filtrer des données, définir des paramètres pour des rapports, planifier ou toute autre situation nécessitant une fenêtre temporelle spécifiée.

Ce composant présente deux champs de saisie : un pour le début de la plage souhaitée et un pour la fin. Les principales caractéristiques incluent :

• Sélection de date et de date/heure : Prend en charge la sélection de dates complètes ou de valeurs de date et heure spécifiques.

• Définition claire de la plage : Les utilisateurs peuvent facilement voir et modifier le début et la fin de leur période sélectionnée.

• Formatage personnalisable : Contrôlez le style d'affichage des dates et des heures.

• Libellés d'entrée personnalisables : Personnalisez les libellés des champs d'entrée de début et de fin.

Cas d'utilisation

• Filtrer des tables de données, des listes ou des graphiques pour afficher les enregistrements dans une période sélectionnée (par exemple « Opportunités clôturées ce trimestre », « Cas créés la semaine dernière »).

• Définir les paramètres de date pour générer des rapports.

• Définir les heures de début et de fin pour planifier des événements ou des tâches.

• Enregistrer les périodes pour des activités ou des projets.

• Définir les périodes de validité pour des promotions ou des offres.

---

Configuration

Sélectionnez le composant Date Range sur le canevas pour voir ses propriétés dans le panneau Propriétés à droite.

Propriétés de base

Ceci gère l'étiquetage et l'identification.

Propriété	Type	Description	Exemple
par le véritable	Texte	Identifiant unique pour l'instance du composant.	ReportDateRange
Étiquette	Texte	Libellé principal affiché au-dessus ou à côté du composant.	"Sélectionner la plage de dates :"
Aide au niveau du champ	Texte (optionnel)	Texte d'aide supplémentaire à côté du libellé.	"Choisissez une période pour le filtrage."

Fonctionnalité principale et liaison de données

Ces paramètres définissent le type de plage et comment les données sont capturées.

Propriété	Type/Condition	Description
Type	Sélectionnez	date: Sélectionner les dates de début/fin. datetime: Sélectionner les dates et heures de début/fin. Remarque : Ceci affecte les propriétés Valeur actives ci-dessous.
Valeur de la date de début	Variable de date (Active pour date)	Date de début initiale ; liez-la à une Variable de Date pour capturer les sélections de l'utilisateur.
Valeur de la date de fin	Variable de date (Active pour date)	Date de fin initiale ; liez-la à une Variable de Date pour capturer les sélections de l'utilisateur.
Valeur de la date/heure de début	Variable datetime (Active pour datetime)	Date/heure de début initiale ; liez-la à une Variable Date/Heure.
Valeur de la date/heure de fin	Variable datetime (Active pour datetime)	Date/heure de fin initiale ; liez-la à une Variable Date/Heure.

Apparence et formatage

Ces propriétés contrôlent la présentation visuelle.

Propriété	Type/Condition	Description	Options/Exemples
Variante	Sélectionnez	Positionnement du libellé.	standard (au-dessus), label-hidden.
Style de date	Sélectionnez	Format d'affichage de la date.	court (5/29/2025), moyen (29 mai 2025), long (jeudi 29 mai 2025).
Style de l'heure	Sélectionnez (Actif pour datetime)	Format d'affichage de l'heure.	court (9:43 AM), moyen (9:43:00 AM), long (9:43:00 AM EDT).
Libellés d'entrée Date/Heure	Texte (séparé pour début/fin)	Libellés personnalisés pour les champs d'entrée.	Début : « De : », Fin : « À : ».

Propriétés de comportement

Ces paramètres affectent l'interaction utilisateur et l'état du composant.

Propriété	Type	Description
Désactivé	Booléen	Désactive le composant (aucune interaction).
Lecture seule	Booléen	Affiche les valeurs mais empêche les modifications.
Requis	Booléen	Exige des sélections de début/fin ; s'associe à la validation du formulaire.
Visible	Booléen	Bascule la visibilité ; liez à une Variable Booléenne pour un contrôle dynamique.

Exemple

Filtrer une table de données par date de clôture des opportunités

Suivez ces étapes pour filtrer les Opportunités par date de clôture :

1

Ajouter le composant Date Range

• Nom API : OpportunityDateFilter

• Libellé : "Filtrer les opportunités par date de clôture :"

• Type : date

2

Ajouter le composant Data Table

Suivez ces étapes pour intégrer une table de données sous le composant Date Range, affichant les Opportunités filtrées en fonction des dates sélectionnées.

• Faites glisser le composant : Depuis la bibliothèque de composants (panneau de gauche), faites glisser le "Data Table" sur le canevas et placez-le sous le composant Date Range.

• Créer une requête : Dans le panneau Propriétés de la table de données, configurez une source de données Avonni Query pour récupérer les enregistrements Opportunity (par ex., sélectionnez "Opportunity" comme objet).

• Ajouter des filtres de requête : Configurez des filtres sur la requête pour utiliser les dates du Date Range :

  • Filtre 1 : CloseDate >= {!DateRange1.startDate}

  • Filtre 2 : CloseDate <= {!DateRange1.endDate}

  • Astuce : Utilisez la logique ET pour vous assurer que les deux filtres s'appliquent uniquement lorsque les dates sont définies.

• Ajouter des colonnes : Dans la section Colonnes du panneau Propriétés, sélectionnez et ajoutez des champs de la requête Opportunity (par ex., Name, Amount, Stage, Close Date) à afficher dans la table.

Résultat : La table de données affichera les Opportunités filtrées par les sélections de dates de l'utilisateur, se mettant à jour dynamiquement lors des modifications

3

Définir une règle de visibilité pour la table de données

Pour éviter d'afficher la table de données avec des erreurs de requête (par ex., lorsque les filtres sont incomplets en raison de dates de début ou de fin manquantes), configurez une règle de visibilité. Cela garantit que la table n'apparaît qu'une fois que les deux dates sont sélectionnées dans le composant Date Range.

Résultat : Les sélections de l'utilisateur mettent à jour les variables, actualisant la table pour afficher les Opportunités filtrées.

Résultat : Lorsque l'utilisateur sélectionne une nouvelle date de début ou de fin dans le composant Date Range, les valeurs déclencheront la requête de la table de données pour refréer le filtre et n'afficher que les Opportunités dans la plage de dates de clôture sélectionnée.

---

Considérations clés

• Correspondance de type : Assurez-vous que l'option Type propriété (date ou datetime) correspond au type de données des variables que vous liez aux propriétés de valeur.

• Fuseaux horaires : Lors de l'utilisation de datetime, faites attention à la façon dont Salesforce gère les fuseaux horaires. Les valeurs sélectionnées seront généralement dans le fuseau horaire local de l'utilisateur.

• Libellés d'effacement : Utilisez le Étiquette principal et le Libellés d'entrée Date/Heure personnalisé de manière efficace pour guider les utilisateurs.

---

En résumé

Le composant Avonni Date Range offre un moyen convivial de sélectionner des périodes de date ou de date/heure. En liant ses propriétés de valeur de début et de fin à des variables, vous pouvez facilement utiliser la plage choisie pour filtrer des données, déclencher des actions ou contrôler d'autres aspects dynamiques de votre interface Salesforce.