La création d'une vue pour une grille ou un tableau permet de choisir une liste de colonnes à afficher et un filtre à appliquer lors de la récupération des lignes.
L'expression de base d'un filtre prend la forme : <nom du champ> <opération> <valeur>.
La liste des opérations est :
| Opération | Description |
|---|---|
| eq | égal à |
| ne | différent de |
| sw | commence par |
| ct | contient |
| ew | termine par |
| gt | supérieur à |
| ge | supérieur ou égal à |
| lt | inférieur à |
| le | inférieur ou égal à |
| in | est présent dans la liste (les valeurs recherchées sont séparées par un point-virgule « ; ») |
Les champs d'une entité sont listés dans la configuration.
Exemple de requête pour récupérer tous les contrats dont le numéro commence par « INF-000 » :
refNumber sw INF-000
Il est également possible de combiner les filtres avec les opérateurs logiques and et or, les parenthèses permettant de modifier la priorité des opérations :
(refNumber sw INF-000 or refNumber sw INF-002) and year eq 2019
La négation se fait avec !, toujours suivi de parenthèses :
(refNumber sw INF-000 or refNumber sw INF-002) and !(year eq 2019)
Lorsque la valeur du filtre contient un espace, il faut l'entourer d'apostrophes droites ('). Le caractère \ sert alors à échapper l'apostrophe et la barre oblique inverse elle-même. La recherche de la valeur l'école \ l'entreprise s'écrit :
comment eq 'l\'école \\ l\'entreprise'
Valeurs vides, booléens et nombres
- Pour rechercher un champ vide, utiliser null sans apostrophes et en minuscules : endedOn eq null. Pour un champ renseigné : endedOn ne null. Écrite entre apostrophes, 'null' désigne le texte « null ».
- Les champs booléens prennent les valeurs true ou false : isActive eq true.
- Les nombres décimaux acceptent le point ou la virgule : amount gt 1500.50.
- Les dates s'écrivent au format AAAA-MM-JJ : startedOn ge 2026-01-01.
Champs personnalisés
Un champ personnalisé se filtre avec le préfixe customData. suivi de sa clé :
customData.secteur eq Banque
Si le champ personnalisé est typé (nombre, date, booléen), toutes les opérations sont disponibles, sauf pour les booléens qui n'acceptent que eq et ne. Sinon, la valeur est comparée comme un texte et seules eq, ne, sw, ct et ew sont acceptées.
Paramètres
Il existe également des paramètres, à écrire entre accolades { } :
| Paramètre | Valeur |
|---|---|
| {year} | Année du mois de clôture (nombre) |
| {month} | Mois du mois de clôture (nombre de 1 à 12) |
| {startClosingMonth} | Date de début du mois de clôture |
| {endClosingMonth} | Date de fin du mois de clôture |
| {startYear} | 1er janvier de l'année du mois de clôture |
| {endYear} | 31 décembre de l'année du mois de clôture |
| {startToday} | Date du jour (début de journée) |
| {endToday} | Date du jour (fin de journée) |
| {currentUser} | Identifiant de l'utilisateur connecté |
| {divisionId} | Identifiant de la division de l'utilisateur connecté |
| {companyId} | Identifiant de la société de l'utilisateur connecté |
| {userName} | Nom de l'utilisateur connecté |
month eq {month}sentOn ge {startYear} and sentOn le {endYear}Un paramètre inconnu rend le filtre invalide. Dans les règles d'alerte, seuls les paramètres de date ({year}, {month} et les six dates de début et de fin) sont disponibles.
Dates relatives à la date du jour
Pour les champs de type Date, la valeur peut être relative à la date du jour : un nombre, précédé du signe « - » pour remonter dans le passé, suivi d'une unité.
| y | en années |
| m | en mois |
| d | en jours |
endedOn le 30d -- se termine au plus tard dans 30 jours startedOn le 2m -- débute au plus tard dans 2 mois birthdate ge -27y -- né il y a 27 ans au plus (aujourd'hui moins 27 ans ou après)
Cet article a-t-il été utile ?
C'est super !
Merci pour votre commentaire
Désolé ! Nous n'avons pas pu vous être utile
Merci pour votre commentaire
Commentaires envoyés
Nous apprécions vos efforts et nous allons corriger l'article