# Création d’un filtre de liste

Les filtres (appelés aussi paramètres) servent à filtrer une liste sur un critère.

**Exemple** : tri sur la société.

## Créer un paramètre de filtre

### **Méthode I**

**Dans les formulaires, il est possible d’ajouter des filtres pour faciliter les recherches.**

![](https://1324884545-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvBJ3Kpe0vg6NlDz0QDIX%2Fuploads%2FpJvbNXHbuagywtoEqDk8%2F0.png?alt=media)

<p align="right"><em>IMG_P00102</em></p>

![](https://1324884545-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvBJ3Kpe0vg6NlDz0QDIX%2Fuploads%2Fi63VJjPfjMv0wfLFhTwd%2F1.png?alt=media)

<p align="right"><em>IMG_P00103</em></p>

### **Méthode II**

Tout comme les formulaires, les menus, les listes ont un lien ![](https://1324884545-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvBJ3Kpe0vg6NlDz0QDIX%2Fuploads%2FnS3s5PDIGw2buP2qFikV%2F2.png?alt=media) qui permet d’afficher la liste des paramètres de filtre.

<p align="right"><em>IMG_P00090</em></p>

![](https://1324884545-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvBJ3Kpe0vg6NlDz0QDIX%2Fuploads%2FI1t1z1Xwi3wzjfwo1859%2F3.png?alt=media)

<p align="right"><em>IMG_P00091</em></p>

Cliquez sur![](https://1324884545-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvBJ3Kpe0vg6NlDz0QDIX%2Fuploads%2FWWDtqVLHkvDRwa8kTtm9%2F4.png?alt=media), pour avoir accès à la liste des paramètres. Une interface s’ouvre sur « Liste Paramètre ». Sélectionnez l’action désirée.

<p align="right"><em>IMG_P00090</em></p>

![](https://1324884545-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvBJ3Kpe0vg6NlDz0QDIX%2Fuploads%2F5yER9Fbpm9EZOT9ak7bi%2F5.png?alt=media)

<p align="right"><em>IMG_P00092</em></p>

Vous pouvez ajouter autant de paramètres de filtre que vous le souhaitez.

![](https://1324884545-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvBJ3Kpe0vg6NlDz0QDIX%2Fuploads%2FtNpNnX9U3jgCfXbzAcQR%2F6.png?alt=media)

<p align="right"><em>IMG_P00093</em></p>

| **Modèle** : le paramètre de filtre doit avoir **le même modèle** que la colonne du tableau auquel il se rapporte.                                                                                                                                                                                                                                                        |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Libellé** : le paramètre de filtre doit avoir le **même libellé** que la colonne du tableau auquel il se rapporte.                                                                                                                                                                                                                                                      |
| **Saisie obligatoire ?** : si le paramètre de filtre est coché en « saisie obligatoire », alors la liste ne se remplit pas tant que le paramètre de filtre obligatoire n'a pas été rempli. Cela permet de limiter les grosses recherches et calculs.                                                                                                                      |
| **Invisible ?** : vous pouvez créer un paramètre de filtre qui ne sera pas visible pour les utilisateurs.                                                                                                                                                                                                                                                                 |
| <p><strong>Formule</strong> : vous pouvez décider de remplir le paramètre de filtre avec une valeur par défaut (exemple : type de client : revendeur). La valeur peut aussi être une formule.</p><p>Pour forcer l'initialisation à la valeur à « \<TOUS> » mettez «  -1 » en valeur par défaut (cf. image IMG\_P00055, le paramètre de filtre type de client = tous).</p> |
| **Aide** : renseignez un texte d'aide qui s'affichera dans la bulle d'aide.                                                                                                                                                                                                                                                                                               |

{% hint style="warning" %}
&#x20;**Le paramètre de filtre doit avoir le même modèle et le même libellé que la colonne du tableau auquel il se rapporte.** Exception pour le champ « A » et « liste A ». Exemple: pour insérer un paramètre de filtre dans la liste des collaborateurs, nous pouvons insérer le champ équipe et non le champ liste équipe. Ainsi, nous obtiendrons la liste des collaborateurs filtrés par équipe.
{% endhint %}

## Ajout d’un filtre à confirmer

Au lieu que sur chaque changement de champs la liste soit rechargée, dans le cas d'une action liste pour laquelle la case à cocher « A confirmer » est cochée lorsqu’une action est créée, les filtres ne sont plus appliqués automatiquement à chaque modification. L’envoi des filtres de liste devient alors non automatique et et vous devez cliquer sur le bouton « Filtrer » pour obtenir l’élément que vous rechercher.

**Si la liste est cochée «A confirmer», les filtres s’activeront avec le bouton filtrer et non à chaque saisie.**

![](https://1324884545-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvBJ3Kpe0vg6NlDz0QDIX%2Fuploads%2FNxwbXGzdLAgxFhfQPMW3%2F7.png?alt=media)

<p align="right"><em>IMG_P00092</em></p>

Un bouton « Filtrer » est ajouté permettant à l'utilisateur de filtrer uniquement quand tous les filtres qu’il souhaite renseigner, le sont.

Cette nouvelle fonctionnalité est utile, entre autre, pour éviter de recharger plusieurs fois une grosse liste inutilement.

![](https://1324884545-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvBJ3Kpe0vg6NlDz0QDIX%2Fuploads%2FBXkrEnK9WK8ce0R3oGhV%2F8.png?alt=media)

<p align="right"><em>IMG_P00094</em></p>

{% hint style="info" %}
La liste se charge toujours lors de la première ouverture, pour éviter cela utilisez des filtres obligatoires comme avant cette nouveauté.
{% endhint %}

## Bouton survol et clic droit de paramétrage pour les filtres de liste

Pour les superviseurs avec droit de paramétrage, les filtres en mode liste propose un bouton paramétrage qui apparaît en survol d'une colonne (ou par clic droit). Depuis la version 12.001820.01 : ce menu est disponible pour les filtres d'une liste.

<p align="right"> <em>IMG_P000 IMG_P000959</em></p>

<figure><img src="https://1324884545-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvBJ3Kpe0vg6NlDz0QDIX%2Fuploads%2FA37KtPtrVvjMCfJE8pIy%2F9.png?alt=media" alt=""><figcaption></figcaption></figure>

Le bouton propose un ensemble d'options pour modifier le paramètre.

![](https://1324884545-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvBJ3Kpe0vg6NlDz0QDIX%2Fuploads%2FR3MgLw0LlTGi11Xqhb5g%2F10.png?alt=media)

<p align="right"><em>IMG_P000 IMG_P000969</em></p>

\
Les options possibles sont les suivantes :

\- Modifier ;

\- Supprimer ;

\- Sous menu « Sous Formulaire » pour manipuler le formulaire lié

\- Déplacer après ;

\- Modification d'option : saisie obligatoire et invisible.

## Ajout rapide de filtres à une liste

Pour les superviseurs avec droits de paramétrage, un bouton dans les filtres d'une liste, situé à côté de « Recherche avancée », permet d'ajouter rapidement un filtre prédéfini ou sur une colonne.

Les filtres prédéfinis possibles sont les suivants :

\- Recherche ;

\- Date de début et de fin ;

\- Type de formulaire.

Les filtres prédéfinis proposées dépendent des filtres déjà existant dans le mode liste. Par exemple, dans la liste client, le filtre « Recherche » existe déjà, le filtre prédéfini ne vous sera donc pas proposé.

![](https://1324884545-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvBJ3Kpe0vg6NlDz0QDIX%2Fuploads%2FF07Dus6gJPLk8inFdnkH%2F11.png?alt=media)

<p align="right"><em>IMG_P000 IMG_P00097</em></p>

Pour ajouter un filtre « date de début » et un filtre « date de fin », cliquez simplement sur « Ajouter filtres date de début et date de fin ». Ils s’ajouteront automatiquement.

Pour ajouter un filtre « type de formulaire », cliquez simplement sur « Ajouter filtre de formulaire ».

Pour ajouter un filtre « recherche », cliquez simplement sur « Ajouter filtre recherche ».

Utiliser les modèles de champ pour les filtres de liste

Lors de la création d’un paramètre de filtre sur le formulaire sur lequel vous souhaitez créer un filtre, vous devez choisir un modèle de champ.

En vous rendant sur la liste des modèles de champs, choisissez le modèle de champ « Type de formulaire » de type « Modèle liste déroulante ».

![](https://1324884545-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvBJ3Kpe0vg6NlDz0QDIX%2Fuploads%2FPT11AKSIjDEcfAx8eJT7%2F12.png?alt=media)

<p align="right"><em>IMG_P00098</em></p>

Ce modèle de champ « Type de formulaire » vous permet de créer un filtre « Type de formulaire » lequel vous permet de trier votre liste de clients par « Agence, Client, Client particulier, Client professionnel, Patient, Revendeur » sur « Liste client », dans l’exemple ci-dessous.

![](https://1324884545-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvBJ3Kpe0vg6NlDz0QDIX%2Fuploads%2F2UjZUStiqX59CYiUfbHj%2F13.png?alt=media)

<p align="right"><em>IMG_P00099</em></p>

<p align="right"></p>

## Filtre avec modèle classique « Recherche simple »

Importez le SMX : Langage v12.

Utilisez le modèle classique « **Recherche simple** » à la place du modèle « **Recherche** » pour ne plus faire de recherche globale (comme par défaut depuis la version 12) afin de limiter les résultats renvoyés.\
**Attention** : ne pas mettre les 2 types de recherche dans la même action.

![](https://1324884545-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvBJ3Kpe0vg6NlDz0QDIX%2Fuploads%2Fb9hNbFeSPSVBHEGNm5dY%2F14.png?alt=media)

<p align="right"><em>IMG_P00100</em></p>

Résultat :

![](https://1324884545-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvBJ3Kpe0vg6NlDz0QDIX%2Fuploads%2FOkH79mouQfo7D52N6QKK%2F15.png?alt=media)

<p align="right"><em>IMG_P00101</em></p>
