Qualification
La qualification est la partie après la clause WHERE et est composée de qualificatifs, d'opérateurs logiques et de parenthèses.
… where (core.primary_format_extension='pdf' or standard.status='Approved')
and standard.subject like '*installation'
and core.primary_format_size>1000
Opérateurs logiques
Le GQL ne prend en charge que les opérateurs AND, OR et NOT.
… (core.primary_format_extension='pdf' or standard.status='Approved')
and standard.subject like '*installation'
and not core.version_tags='Expired'
Vous pouvez combiner et regrouper explicitement des conditions à l'aide de parenthèses. Les conditions entre parenthèses seront considérées comme une condition unique.
… (core.primary_format_extension='pdf' or standard.status='Approved')
and (standard.subject like '*installation' or core.version_tags='Expired')
Prédicats
Les prédicats suivants sont pris en charge dans les conditions :
| Prédicat | Condition |
|---|---|
<métadonnée> = '<texte>'<métadonnée> = <booléen><métadonnée> = <nombre><métadonnée> = <date> | Les métadonnées sont égales à la valeur |
<métadonnée> <> '<texte>'<métadonnée> <> <nombre><métadonnée> <> <date> | Les métadonnées ne sont pas égales à la valeur |
<métadonnée> > <nombre><métadonnée> > <date> | Les métadonnées sont supérieures à la valeur |
<métadonnée> >= <nombre><métadonnée> >= <date> | Les métadonnées sont supérieures ou égales à la valeur |
<métadonnée> < <nombre><métadonnée> < <date> | Les métadonnées sont inférieures à la valeur |
<métadonnée> <= <nombre><métadonnée> <= <date> | Les métadonnées sont inférieures ou égales à la valeur |
<métadonnée> like '<texte>' | La chaîne de métadonnées est comme une autre chaîne. Les caractères génériques pris en charge sont *, qui correspond à n'importe quelle séquence de caractères (y compris la séquence vide) et ?, qui correspond à n'importe quel caractère unique. Exemple : standard.title like '*quer?' correspondra au titre single query mais pas à all queries |
<métadonnée> @@ '<expression régulière>' | La valeur de la métadonnée correspond à l'expression régulière, qui doit couvrir la valeur entière. Voir Expressions régulières. Exemple : standard.title @@ 'Rapport .*' |
<métadonnée> in (valeur1, valeur2) | Les métadonnées sont égales à au moins une valeur dans la liste. La valeur peut être une chaîne ou un nombre. Exemple : standard.status in ('Published','Approved') |
<métadonnée> not in (valeur1, valeur2) | Les métadonnées ne sont égales à aucune valeur de la liste. La valeur peut être une chaîne ou un nombre. Exemple : standard.status not in ('Draft','Obsolete') |
<métadonnée> is null | La chaîne de métadonnées n'existe pas ou est vide. Exemple : custom.my_field is null |
<métadonnée> is not null | La chaîne de métadonnées existe et n'est pas vide. Exemple : custom.my_field is not null |
Expressions régulières
L'opérateur @@ compare une métadonnée à une expression régulière, là où like se limite aux caractères génériques * et ?.
- L'expression doit correspondre à la valeur entière de la métadonnée, pas à une partie seulement. Pour retrouver les valeurs qui commencent par
Rapport, il faut écrireRapport.*:Rapportseul ne correspond qu'à la valeur exacte « Rapport ». - La comparaison est sensible à la casse, contrairement à
like. - Sur une métadonnée à valeurs multiples, le document est retenu dès qu'une seule de ses valeurs correspond.
- L'expression s'écrit entre guillemets simples, comme tout texte GQL. Une apostrophe à l'intérieur se double (
'').
Éléments de syntaxe courants :
| Élément | Correspond à |
|---|---|
. | N'importe quel caractère |
.* | N'importe quelle suite de caractères, y compris vide |
[0-9] | Un caractère de la plage indiquée |
(a|b) | a ou b |
x?, x+ | x facultatif ; x répété une ou plusieurs fois. Contrairement à like, le ? ne désigne pas un caractère quelconque |
x{3} | x répété exactement trois fois |
Exemples
Titres qui commencent par « Rapport » suivi d'un espace :
standard.title @@ 'Rapport .*'
Titres qui se terminent par 2025 ou 2026 :
standard.title @@ '.*(2025|2026)'
Documents qui ont au moins un mot-clé commençant par finance ou juridique :
standard.keywords @@ '(finance|juridique).*'
Type de données
Texte
La valeur de texte doit être encapsulée avec des guillemets simples :
core.version_tags='Expired'
Booléen
La valeur booléenne (true ou false) n'a pas besoin de guillemets :
extended.is_confidential=true
Nombre entier
La valeur entière n'a pas besoin de guillemets :
custom.my_integer > 3
Nombre flottant
Tout nombre avec un point ('.') est considéré comme un nombre flottant :
custom.my_float > 3.5
Date
La valeur de date est représentée par une expression de fonction {d 'yyyy-mm-dd'} :
core.creation_date > {d '2017-02-20'}
Fonctions spéciales
Différence de date
Pour la comparaison de dates, vous pouvez utiliser la fonction spéciale
_datediff(). Cette fonction renvoie le nombre d'unités entre une date de
début et une date de fin (ou le moment présent si la date de fin n'est pas
spécifiée). Le résultat vaut 0 si les dates arrondies sont
identiques, il est positif si la date de début est antérieure à la date de fin,
et négatif si la date de début est postérieure à la date de fin.
select * from documents where _datediff(core.creation_date,y)<=3
L'unité sert à arrondir la valeur vers le bas et à spécifier la quantité que vous souhaitez compter. Les unités prises en charge sont les suivantes :
d: arrondir au jour inférieur et compter le nombre de jours.w: arrondir à la semaine inférieure et compter le nombre de semaines.M: arrondir au mois inférieur et compter le nombre de mois.y: arrondir à l'année inférieure et compter le nombre d'années.H/h: arrondir à l'heure inférieure et compter le nombre d'heures.m: arrondir à la minute inférieure et compter le nombre de minutes.s: arrondir à la seconde inférieure et compter le nombre de secondes.
select * from documents where _datediff(core.creation_date,y)<=3
select * from documents where _datediff(core.creation_date,M)<=48
| Champ | Condition |
|---|---|
| _datediff(metadata,unit) | Nombre d'unités à partir de la date spécifiée dans une métadonnée jusqu'à maintenant. Exemples : - Contenus créés il y a 3 ans et avant : _datediff(core.creation_date,y) >= 3 - Contenu expiré depuis 2 mois ou plus : _datediff(extended.expiration_date,M) >= 2 - Contenu expirant dans 2 semaines ou plus : _datediff(extended.expiration_date,w) <= -2 - Contenus créés cette année : _datediff(core.creation_date,y) = 0 |
| _datediff(metadata,'date expression',unit) | Nombre d'unités entre une date spécifiée dans une métadonnée et une date spécifiée en tant qu'expression de date. L'expression de date doit être définie au format ISO 8601 (ex : yyyy-mm-dd). Le caractère générique ${TODAY} est également pris en charge. Exemples : - Contenus créés en février 2019 : _datediff(core.creation_date,'2019-02-01',M) = 0 - Contenu expirant après le 15 mai 2020 : _datediff(extended.expiration_date,'2020-05-15') < 0 - Contenu expirant avant le 15 mai 2020 : _datediff(extended.expiration_date,'2020-05-15') > 0 |
Champs spéciaux
En plus des métadonnées de contenu, le GQL propose des champs calculés internes utilisés pour filtrer d'autres critères.
Emplacement
Les champs d'emplacement commencent par _location et peuvent être
utilisés pour filtrer ou exclure les contenus d'une room spécifique.
| Champ | Condition |
|---|---|
| _location.room | Référence l'ID de la room où se trouvent les contenus. Peut être utilisé avec les opérateurs = ou <>. Exemple : _location.room='room01' |
| _location.room.link_date('room ID') | Référence la date de liaison des contenus à la room. Peut être utilisé avec des opérateurs de date. Exemple : _location.room.link_date('room01') > {d '2017-01-02'} |
Texte intégral
Les champs de texte intégral commencent par _fulltext et peuvent
être utilisés pour filtrer ou exclure des contenus en fonction des
données internes en texte intégral.
| Champ | Condition |
|---|---|
| _fulltext.is_indexed | Indique si le contenu a été indexé en texte intégral. Peut être utilisé avec l'opérateur = ou <>. Exemple : _fulltext.is_indexed=true |
| _fulltext.failures | Référence le nombre d'échecs survenus lors de l'indexation en texte intégral du contenu. Peut être utilisé avec des comparateurs de nombres. Exemple : _fulltext.failures>2 |