Widget Date Filter (Filtre de date)

Le widget Date Filter (Filtre de date) vous permet de filtrer les entités en sélectionnant une date ou une plage de dates spécifique à l’aide d’un calendrier.

Vous pouvez utiliser le widget Date Filter (Filtre de date) pour filtrer les couches qui incluent au moins un champ Date ou un champ Date only (Date uniquement) valide.

Exemples

Utilisez ce widget pour prendre en charge les exigences de conception d’application, telles que les suivantes :

• Vous disposez de données liées aux dates pour lesquelles chaque enregistrement est associé à une date spécifique et vous voulez filtrer un widget Table ou un widget List (Liste) afin d’afficher uniquement les entités d’une date donnée.
• Vous disposez d’une liste d’événements qui ont eu lieu sur plusieurs jours et vous voulez choisir une date pour voir lesquels ont eu lieu ce jour-là.
• Vous disposez d’une carte Web avec des couches qui incluent des champs de date et vous voulez appliquer un filtre pour voir des données pour la date ou plage de dates que vous avez choisie.

Remarques sur l’utilisation

Ce widget nécessite une connexion à une source de données ayant au moins un champ attributaire contenant des informations de date. La source de données connectée doit inclure des champs des types suivants :

• Date
• Date uniquement

Dans les paramètres du widget, vous pouvez autoriser les utilisateurs à sélectionner une date unique ou une plage de dates. En mode de sélection de date unique, le widget inclut un bouton Today (Aujourd’hui) qui renvoie le calendrier au mois actuel. Cliquez sur un jour dans le calendrier pour sélectionner une date unique. Cliquez sur un jour de début et un jour de fin pour sélectionner une plage de dates.

Lorsque vous intégrez ce widget dans une application, il fournit aux utilisateurs un outil de sélection de date basé sur le calendrier. Vous pouvez choisir entre les styles d’interface utilisateur suivants dans les paramètres du widget :

• Inline (En ligne) : le widget apparaît sous forme de volet qui contient le calendrier.
• Icon (Icône) : le widget est un bouton. En cliquant sur ce bouton, vous ouvrez une fenêtre contenant le calendrier. Vous pouvez modifier l’icône du bouton en modifiant l’icône en haut du volet des paramètres du widget Date Filter (Filtre de date).
• Input (Entrée) : le widget est constitué d’une ou deux zones de texte. Vous pouvez saisir des dates ou cliquer sur chaque zone de texte pour choisir des dates dans le calendrier. Ce style ne prend pas en charge le bouton Today (Aujourd’hui).

Paramètres

Le widget Date Filter (Filtre de date) inclut les paramètres suivants :

• Source : connectez le widget à des données de l’une des manières suivantes :
  • Select layers (Sélectionner des couches) : connectez des couches individuelles au widget. Cliquez sur Select data (Sélectionner des données) pour ouvrir le volet Select data (Sélectionner des données). Vous pouvez y faire un choix parmi les couches prises en charge avec au moins un champ de date que vous avez déjà ajoutées à l’application, ou ajouter de nouvelles données. Les couches que vous connectez au widget apparaissent dans une liste dans le volet des paramètres du widget, sous Source. Cliquez sur une couche pour ouvrir le volet de ses paramètres, dans lequel vous pouvez configurer les paramètres suivants :
    • Data (Données) : la source de données connectée apparaît ici.
    • Fields (Champs) : indiquez les champs à utiliser pour la date Start (Début) et éventuellement la date End (Fin).

      Remarque :

      Pour chaque couche, vous devez indiquer un champ Start date (Date de début). Si les données incluent des champs pour les dates de début et les dates de fin, vous pouvez également spécifier un champ End date (Date de fin). Ensemble, les dates de début et de fin indiquent qu’une entité existe pendant une certaine durée, ce qui signifie que l’entité s’affiche dans les résultats du filtre tous les jours pendant cette durée.

      Remarque :

      Les champs de date de début et de fin sont renseignés automatiquement pour les couches avec un champ de date et pour les couches temporelles avec plusieurs champs de date. Vous devez spécifier manuellement les champs de date de début et de fin pour les données qui proviennent de couches non temporelles avec plusieurs champs de date.

  • Interact with a Map widget (Interagir avec un widget Carte) : connectez le widget Date Filter (Filtre de date) à un widget Map (Carte). Le widget Map (Carte) doit contenir au moins une carte Web ou une scène Web comportant des couches avec des champs de date valides. Le widget Date Filter (Filtre de date) se connecte automatiquement au premier widget Map (Carte) sur la page en cours.
    • Les cartes Web ou scènes Web dans le widget Carte connecté apparaissent dans la liste. Vous pouvez cliquer sur chaque carte ou scène Web pour ouvrir le volet de configuration dans lequel vous pouvez activer Customize layers (Personnaliser les couches).
      • Customize layers (Personnaliser les couches) : toutes les couches prises en charge avec des champs de date valides dans la carte ou scène connectée sont automatiquement synchronisées avec le widget Date Filter (Filtre de date). Si vous activez ce paramètre, ces couches apparaissent dans une liste et vous pouvez choisir celles à connecter au widget.
      • Toutes les couches que vous activez sous Customize layers (Personnaliser les couches) apparaissent dans un menu déroulant sous la carte ou la scène associée. Cliquez sur une couche pour ouvrir le volet de ses paramètres, dans lequel vous pouvez configurer les paramètres suivants :
        • Data (Données) : c’est ici qu’apparaît le nom de la couche connectée.
        • Fields (Champs) : indiquez les champs à utiliser pour la date Start (Début) et éventuellement la date End (Fin).
• Styles : choisissez un style d’interface utilisateur pour le widget, Inline (En ligne), Icon (Icône) ou Input (Entrée).
• Options : configurez les fonctionnalités et outils suivants :
  • Date selection mode (Mode de sélection de date) : choisissez si les utilisateurs peuvent sélectionner des dates uniques ou des plages de dates.
  • Default date (Date par défaut) : si vous le souhaitez, saisissez une date par défaut (pour les dates uniques) ou une date de début et une date de fin par défaut (pour les plages de dates). Vous pouvez définir des dates par défaut des manières suivantes :
    • Empty (Vide) : ne définissez pas de date par défaut.
    • Today (Aujourd’hui) : ancrez la date par défaut à la date actuelle lorsque l’utilisateur accède à l’application.
    • Yesterday (Hier) : ancrez la date par défaut à la veille de la date actuelle.
    • Tomorrow (Demain) : ancrez la date par défaut au lendemain de la date actuelle.
    • Custom (Personnalisé) : choisissez une date spécifique à l’aide du calendrier.
  • Auto apply filter (Appliquer automatiquement le filtre) : appliquez automatiquement le filtre de date lorsque l’utilisateur sélectionne une date ou une plage de dates, au lieu de demander à l’utilisateur de cliquer sur le bouton Apply (Appliquer). Si vous activez ce paramètre et indiquez une date par défaut, le filtre par défaut s’applique au premier chargement du widget.

    Remarque :

    Le paramètre Auto apply filter (Appliquer automatiquement le filtre) est toujours activé lorsque vous sélectionnez le style Input (Entrée).