Widget Search Filter

Modifié le 28/05/2022 10:53

Apps - Widget - Search Filter icon.png  Ce type de widget appartient à la catégorie EasyVista de la bibliothèque des widgets. S'appuyant sur un ou plusieurs datasources liés à Product name - ev itsm.png, il permet de filtrer les données à partir d'une zone de recherche dynamique liée à une ou plusieurs colonnes des datasources. 

  • La recherche peut s'effectuer dans les options de menu Product name - ev itsm.png, dans les discussions et dans la base de connaissance.
  • Le widget applique les critères de recherche sur les différents datasources en parallèle.
  • Une page de l'application peut être dédiée à l'affichage des résultats de la recherche.

Remarques

  Open url.png  voir Remarques générales sur les widgets

  • Le widget peut pointer sur les datasources :
  • Jusqu'à 5 champs de recherche peuvent être sélectionnés dans chaque datasource lié au widget. La liste des colonnes du datasource servant de critère de recherche est définie par Logo - EasyVista.png. Vous ne pouvez pas les modifier.
  • En mode Exécution, la recherche agit sur l'ensemble des widgets de l'application utilisant les mêmes datasources EasyVista que ceux utilisés par le widget Search Filter (ex. : widgets Dashboards, widgets Data Viewer).

Best Practice big icon.pngBonnes pratiques

  • Utilisez un widget Search Filter pour donner la possibilité de filtrer des données Product name - ev itsm.png à partir d'une zone de recherche dynamique et un widget Filter List pour donner la possibilité de les consulter à partir d'une liste de filtres dynamiques. Vous pouvez combiner les 2 widgets lorsqu'ils utilisent le même datasource EasyVista.
  • Vous pouvez modifier l'apparence graphique (police, taille des caractères, alignement, couleur...) des différentes composantes du widget via la section Theme et la section Theme > Search pour le paramétrage global.

Exemples

  • Recherche dans l'annuaire des employés avec plusieurs critères de recherche (login, e-mail, fonction, service)
             Employee directory - Example with several criteria.png
  • Recherche à partir de plusieurs datasources
    • (1) Widgets Bar Chart et Data Viewer pointant sur un datasource EasyVista All Problems
    • (2) Widget Data Viewer pointant sur un datasource EasyVista All Incidents

      Apps - widget Search Filter - Example before search.png

    Recherche sur le critère En cours dans tous les enregistrements des 2 datasources

    Apps - widget Search Filter - Example after search.png

Example2
  • Recherche combinée entre un widget Search Filter et un widget Filter List pointant sur le même datasource EasyVista
Recherche des incidents avec le mot clé failure, via le widget Search Filter (1) : les 2 widgets Bar Chart et Data Viewer qui pointent sur le même datasource EasyVista sont automatiquement réactualisés Parmi ces incidents, application du filtre Open pour afficher uniquement les incidents ouverts, via le widget Filter List (2) : les 2 widgets sont automatiquement réactualisés
Apps - widgets Filter List and Search Filter - Example - Search restriction.png Apps - widgets Filter List and Search Filter - Example - Search and Filter restrictions.png
Example2_End

Liste des propriétés

Content

DeviceNativeStyle

Device Native Style : Pour une application destinée à un smartphone, permet d'afficher le widget en appliquant la charte graphique du navigateur du smartphone (case cochée), ou de conserver le style standard de Service Apps (case non cochée).


case cochée (mode smartphone : Android, iPhone) case non cochée (mode standard Product name - ev sas.png)

Apps - widget Search Filter - Device native style On.png

Apps - widget Search Filter - Device native style Off.png

SearchPlaceholder

Search Placeholder : Texte affiché dans la zone de recherche (1), qui est automatiquement effacé dès que l'utilisateur commence sa saisie.
         Search placeholder example.png

Best Practice icon.png  Utilisez ce champ comme une aide à la saisie, par exemple en indiquant les critères de recherche disponibles.

Clear Search Input

Target Page : Page dédiée à la présentation des résultats de la recherche.

  • Cliquez sur Apps - Edit icon.png pour ouvrir la page dans le volet Conception.
  • Cliquez sur Apps - Delete 2 icon.png pour annuler la sélection de la page.

Datasource And Fields : Liste des datasources / champs sur lesquels s'effectue la recherche.
         Apps - widget Search Filter - Datasource and fields properties.png

  • Pour ajouter un datasource, cliquez sur [ ADD ITEM ].
  • Apps - Edit icon.png : Permet de modifier le datasource ou de visualiser son contenu.
  • Apps - Delete icon.png : Permet de ne plus prendre en compte le datasource. Tous les champs sélectionnés précédemment sont effacés des critères de recherche.
  • Apps - Order objects icon.png : Permet de modifier l'ordre de prise en compte des datasources lors de l'exécution de la recherche.
  • Search Fields : Liste des colonnes du datasource à partir desquelles peut s'effectuer la recherche des enregistrements.
    • Cliquez sur Apps - Delete 2 icon.png pour supprimer l'une des colonnes sélectionnées.

Theme

    Open url.png  voir Description des propriétés
 

Représentation graphique Élément paramétrable Propriétés à renseigner
Graphic Properties - General elements.png (1) Couleur de fond du widget Propriétés générales > 2ème liste Background Color
(2) Couleur de fond de la zone de recherche Propriétés générales > 1ère liste Background Color
(3) Arrondi des angles de la zone de recherche Section Search > Radius

Note : Appliquez un rayon 0 pour avoir une zone à angles droits

(4) Icône de recherche Apps - Search icon.png

Note : L'icône de recherche est définie par Logo - EasyVista.png. Vous ne pouvez pas la modifier.

section Search
  • Icon Size : taille de l'icône
  • Search Icon Color : couleur de l'icône
  • Search Icon Background Color : couleur de fond de l'icône
Graphic Properties - PlaceHolder element.png (5) Texte affiché dans la zone de recherche, à l'ouverture de la page Propriétés générales > Element = PlaceHolder
Graphic Properties - Text Before Search element.png (6) Couleur des caractères pendant la saisie de l'utilisateur Propriétés générales > Element = Text Before Search
Graphic Properties - Text After Search element.png Affichage de la zone après exécution de la recherche
  • (7) Couleur des caractères
  • (8) Couleur de fond de la zone de recherche
Propriétés générales > Element = Text After Search

Procédure : Comment implémenter un widget Search Filter

1. Dans la liste déroulante située sous la propriété Datasource And Fields, sélectionnez le datasource EasyVista à partir duquel vous souhaitez sélectionner les critères de recherche du widget.

2. Cliquez dans la zone Search Fields et sélectionnez chaque champ du datasource devant servir de critère de recherche. Pour supprimer l'un d'entre eux, cliquez sur Apps - Delete 2 icon.png situé après le libellé.

3. Si vous souhaitez effectuer la recherche sur les données d'un autre datasource, cliquez sur [ ADD ITEM ] puis sélectionnez le datasource et les champs souhaités.

4. Définissez l'apparence des différentes zones du widget en sélectionnant l'élément souhaité dans la section Theme.

5. Définissez les widgets permettant l'affichage des résultats de la recherche. Si vous les ajoutez sur une autre page, sélectionnez celle-ci dans la liste Target Page.

6. Passez en mode Exécution et testez le bon fonctionnement du widget.

Tags :
Powered by XWiki © EasyVista 2022