Aller au contenu principal
Version: Any 26

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édicatCondition
<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 nullLa chaîne de métadonnées n'existe pas ou est vide. Exemple : custom.my_field is null
<métadonnée> is not nullLa 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 écrire Rapport.* : Rapport seul 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émentCorrespond à
.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
ChampCondition
_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.

ChampCondition
_location.roomRé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.

ChampCondition
_fulltext.is_indexedIndique si le contenu a été indexé en texte intégral. Peut être utilisé avec l'opérateur = ou <>. Exemple : _fulltext.is_indexed=true
_fulltext.failuresRé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