Correspond aux propriétés JCR BOOLEAN. Accepte uniquement les valeurs " true
" et " false
". En cas de valeur « false
», il correspond si la valeur de la propriété est « false
» ou si la propriété n’existe pas. Cela peut s’avérer utile pour rechercher des indicateurs booléens qui sont définis uniquement lorsqu’ils sont activés.
Le paramètre « operation
» hérité n’a aucune signification.
Prend en charge l’extraction de facettes. Fournit des buckets pour chaque valeur true
ou false
, mais uniquement pour les propriétés existantes.
chemin
boolproperty relatif à la propriété, par exemple
myFeatureEnabled
ou jcr:content/myFeatureEnabled
valeur
à vérifier pour la propriété, "
true
" ou " false
"
Limite le résultat aux fragments de contenu.
Ne prend pas en charge le filtrage.
Ne prend pas en charge l’extraction de facettes.
Compare deux propriétés JCR DATE entre elles. Permet d’établir des comparaisons de type « est égale à », « est différente de », « est supérieure à » ou encore « est supérieure ou égale à ».
Il s’agit d’un prédicat de type filtrage seul qui ne peut pas exploiter d’index de recherche.
property1
chemin d’accès à la propriété first date
property2
chemin d’accès à la deuxième propriété de date
operation
" =
" pour la correspondance exacte, " !=
" pour la comparaison des inégalités, " >
" pour la propriété1 supérieure à la propriété2, " >=
" pour la propriété1 supérieure ou égale à la propriété2. La valeur par défaut est " =
".
Fait correspondre les propriétés JCR DATE par rapport à un intervalle de date/heure. Cette méthode utilise la norme ISO8601.
format pour les dates et les heures ( YYYY-MM-DDTHH:mm:ss.SSSZ
) et permet également des représentations partielles, comme YYYY-MM-DD
. L’horodatage peut également être fourni sous la forme d’un nombre de millisecondes écoulées depuis 1970 dans le fuseau horaire UTC (format d’heure UNIX).
Vous pouvez rechercher tout ce qui se trouve entre deux horodatages, un élément plus récent ou plus ancien qu’une date donnée, et également choisir entre des intervalles inclusifs et ouverts.
Prend en charge l’extraction de facettes. Fournit les buckets « aujourd’hui », « cette semaine » ou « ce mois-ci », « les 3 derniers mois », « cette année », « l’année dernière » et « avant l’année dernière ».
Ne prend pas en charge le filtrage.
property
chemin relatif à une propriété DATE
, par exemple jcr:lastModified
lowerBound
Limite de date inférieure pour laquelle la propriété doit être vérifiée ; par exemple, 2014-10-01
lowerOperation
" >
" (plus récent) ou " >=
" (plus récent ou plus récent), s'applique à lowerBound
. La valeur par défaut est de " >
".
upperBound
limite supérieure pour laquelle vérifier la propriété, par exemple 2014-10-01T12:15:00
upperOperation
" <
" (plus ancien) ou " <=
" (plus ancien) s'applique à upperBound
. La valeur par défaut est de " <
".
timeZone
ID du fuseau horaire à utiliser lorsqu’il n’est pas indiqué sous la forme d’une chaîne de date ISO-8601. La valeur par défaut est le fuseau horaire par défaut du système.
Exclut des nœuds du résultat lorsque leur chemin d’accès correspond à une expression régulière.
Il s’agit d’un prédicat de type filtrage seul qui ne peut pas exploiter d’index de recherche.
Ne prend pas en charge l’extraction de facettes.
excludepaths
Expression régulière comparée à des chemins de résultat, en excluant les correspondances du résultat.
Recherches de termes dans l’index en texte intégral.
Ne prend pas en charge le filtrage.
Ne prend pas en charge l’extraction de facettes.
texte intégral
le ou les termes de recherche de texte intégral
relPath
Chemin d’accès relatif devant faire l’objet d’une recherche dans la propriété ou le sous-nœud. Cette propriété est facultative.
Permet de créer des conditions imbriquées. Les groupes peuvent contenir des groupes imbriqués. Tout le contenu d’une requête Query Builder se trouve implicitement dans un groupe racine qui peut également posséder des paramètres p.or
et p.not
.
Exemple pour la correspondance de l’une des deux propriétés par rapport à une valeur :
group.p.or=true
group.1_property=jcr:title
group.1_property.value=My Page
group.2_property=navTitle
group.2_property.value=My Page
Il s’agit de (1_property
OU 2_property)
conceptuellement.
Exemple pour les groupes imbriqués :
fulltext=Management
group.p.or=true
group.1_group.path=/content/geometrixx/en
group.1_group.type=cq:Page
group.2_group.path=/content/dam/geometrixx
group.2_group.type=dam:Asset
Cela recherche le terme "Gestion" dans les pages de /content/geometrixx/en
ou dans les ressources de /content/dam/geometrixx
.
Il s'agit de fulltext AND ( (path AND type) OR (path AND type) )
conceptuellement. Pour des jointures OR de ce type, de bons index sont requis pour garantir les performances.
p.or
si elle est définie sur " true
", un seul prédicat du groupe doit correspondre. La valeur par défaut est « false
», ce qui signifie que tout doit correspondre.
p.not
s'il est défini sur " true
", il annule le groupe (par défaut, " false
").
<predicate>
ajoute des prédicats imbriqués
N_<predicate>
ajoute plusieurs prédicats imbriqués au même moment, comme 1_property, 2_property, ...
Limite les résultats aux éléments dont la session en cours possède les privilèges JCR spécifiés.
Il s’agit d’un prédicat de type filtrage seul qui ne peut pas exploiter d’index de recherche. Il ne prend pas en charge l’extraction de facettes.
hasPermission
les privilèges JCR séparés par des virgules que la session utilisateur active doit avoir TOUS pour le noeud en question ; par exemple jcr:write
, jcr:modifyAccessControl
Recherche des pages CQ dans une langue spécifique. Ce prédicat examine la propriété language de la page et le chemin d’accès de la page qui inclut souvent la langue ou le paramètre régional dans une structure de site de niveau supérieur.
Il s’agit d’un prédicat de type filtrage seul qui ne peut pas exploiter d’index de recherche.
Prend en charge l’extraction de facettes. Des buckets sont fournis pour chaque code de langue.
language
code de langue ISO, par exemple " de
"
Vérifie si un nœud est une ressource DAM principale et non une sous-ressource. Il s’agit, en fait, de tout nœud qui ne se trouve pas à l’intérieur d’un nœud « subassets ». Notez que ce prédicat ne recherche pas le type de nœud dam:Asset
. Pour utiliser ce prédicat, il suffit de définir " mainasset=true
" ou " mainasset=false
", il n'y a pas d'autres propriétés.
Il s’agit d’un prédicat de type filtrage seul qui ne peut pas exploiter d’index de recherche.
Prend en charge l’extraction de facettes. Fournit 2 buckets pour les ressources principales et les sous-ressources.
mainasset
booléen " true
" pour les actifs principaux, " false
" pour les sous-actifs
Recherche les éléments qui sont membres d’une collection de ressources Sling spécifique.
Il s’agit d’un prédicat de type filtrage seul qui ne peut pas exploiter d’index de recherche. Ne prend pas en charge l’extraction de facettes.
MemberOf
chemin de collecte des ressources Sling
Correspond aux noms de nœuds JCR.
Prend en charge l’extraction de facettes. Fournit des buckets pour chaque nom de nœud (nom de fichier).
nodename
modèle de nom de noeud qui autorise les caractères génériques : *
= n'importe quel caractère ou aucun caractère, ?
= n'importe quel caractère, [abc]
= uniquement les caractères entre crochets
Fait correspondre des éléments en vérifiant si une propriété JCR DATE est supérieure ou égale à l’heure actuelle du serveur. Ce prédicat peut être utilisé pour effectuer une vérification sur une propriété date de type « expiresAt
» et se limiter uniquement à celles qui n’ont pas encore expiré (notexpired=true
) ou qui ont déjà expiré ( notexpired=false
).
Ne prend pas en charge le filtrage.
Prend en charge l’extraction de facettes de la même manière que le prédicat daterange.
non expiré
Booléen, « true
» pour les propriétés qui n’ont pas encore expiré (date future ou égale à celle indiquée), « false
» pour les propriétés qui ont expiré (date dans le passé) (obligatoire)
property
chemin relatif à la propriété DATE
à vérifier (obligatoire)
Permet de trier les résultats. Si l’ordre par plusieurs propriétés est requis, ce préfixe doit être ajouté plusieurs fois à l’aide du préfixe de nombre, tel que 1_orderby=first
, 2_oderby=second
.
orderby
soit le nom de la propriété JCR indiqué par un caractère de début @, par exemple @jcr:lastModified
ou @jcr:content/jcr:title
, soit un autre prédicat dans la requête, par exemple 2_property
, sur lequel trier
trier
trier direction, soit " desc
" pour décroissant, soit " asc
" pour croissant (par défaut)
case
Si cette valeur est définie sur « ignore
», le tri n’est pas sensible à la casse, ce qui signifie que « a » vient avant « B » ; si cette valeur est vide ou ignorée, le tri est sensible à la casse, ce qui signifie que « B » vient avant « a ».
Effectue une recherche à un emplacement donné.
Ne prend pas en charge l’extraction de facettes.
chemin
modèle de chemin ; selon l'exact, soit la sous-arborescence entière correspond (comme l'ajout de //*
dans xpath, mais notez que cela n'inclut pas le chemin de base) (exact=false, par défaut), soit qu'un chemin exact correspond, ce qui peut inclure des caractères génériques ( *
); si self est défini, la sous-arborescence entière, y compris le noeud de base, sera recherchée.
exact
si exact
est true/on, le chemin exact doit correspondre, mais il peut contenir des caractères génériques simples ( *
), des noms de correspondance, mais pas " /
"; s’il est false (par défaut), tous les descendants sont inclus (facultatif).
plat
recherche uniquement les enfants directs (comme l'ajout de " /*
" dans xpath) (utilisé uniquement si " exact
" n'est pas vrai, facultatif).
self
Effectue des recherches dans la sous-arborescence, mais inclut le nœud de base indiqué comme chemin d’accès (pas de caractères génériques).
Correspond aux propriétés JCR et à leur valeurs.
Prend en charge l’extraction de facettes. Fournit des buckets pour chaque valeur de propriété dans les résultats.
property
chemin relatif à la propriété, par exemple jcr:title
value
Valeur dont la propriété doit être vérifiée ; suit le type de propriété JCR pour les conversions de chaînes
N_value
utilisez 1_value
, 2_value
, … pour rechercher plusieurs valeurs (combinées à OR
par défaut, avec AND
if and=true) (depuis 5.3).
et
défini sur true pour la combinaison de plusieurs valeurs ( N_value
) avec ET (depuis 5.3)
opération
" equals
" pour la correspondance exacte (par défaut), " unequals
" pour la comparaison des inégalités, " like
" pour l'utilisation de la fonction jcr:like
xpath (facultative), " not
" pour aucune correspondance (par ex. " not(@prop)
" dans xpath, le paramètre value sera ignoré) ou " exists
" pour la vérification de l'existence (la valeur peut être true - la propriété doit exister, la valeur par défaut - ou false - identique à " not
")
profondeur
nombre de niveaux de caractères génériques sous lesquels la propriété/le chemin relatif peut exister (par exemple, property=size depth=2
vérifiera le noeud/la taille, le noeud/& ; ast ;/size et le noeud/& ; ast ;/& ; ast ;/size)
Fait correspondre une propriété JCR par rapport à un intervalle de temps. Cela s’applique aux propriétés de types linéaires tels que LONG
, DOUBLE
et DECIMAL
. Pour DATE
, reportez-vous au prédicat daterange qui présente une entrée de format de date optimisée.
Vous pouvez définir une limite inférieure et une limite supérieure ou seulement l’une des deux. L’opération (par exemple, « inférieur à » ou « inférieur ou égal à ») peut également être spécifiée séparément pour la limite inférieure et la limite supérieure.
Ne prend pas en charge l’extraction de facettes.
property
chemin relatif à la propriété
lowerBound
limite inférieure pour vérifier la propriété
lowerOperation
" >
" (par défaut) ou " >=
", s'applique à lowerValue
upperBound
limite supérieure pour vérifier la propriété
upperOperation
" <
" (par défaut) ou " <=
", s'applique à lowerValue
decimal
" true
" si la propriété cochée est de type Décimal
Fait correspondre les propriétés JCR DATE
par rapport à un intervalle de date/heure à l’aide de décalages temporels relatifs à l’heure actuelle du serveur. Vous pouvez spécifier lowerBound
et upperBound
en utilisant soit une valeur de milliseconde, soit la syntaxe de bugzilla 1s 2m 3h 4d 5w 6M 7y
(une seconde, deux minutes, trois heures, quatre jours, cinq semaines, six mois, sept ans). Préfixe avec " -
" pour indiquer un décalage négatif avant l’heure actuelle. Si vous spécifiez uniquement lowerBound
ou upperBound
, l’autre propriété est définie par défaut sur 0, ce qui signifie l’heure actuelle.
Par exemple :
upperBound=1h
(et aucun lowerBound
) ne sélectionnerait quoi que ce soit dans l’heure suivantelowerBound=-1d
(et aucun upperBound
) ne sélectionnerait quoi que ce soit au cours des dernières 24 heures.lowerBound=-6M
et upperBound=-3M
choisissait n'importe quoi de 6 mois à 3 moislowerBound=-1500
et upperBound=5500
sélectionnerait n’importe quelle valeur comprise entre 1 500 millisecondes dans le passé et 5 500 millisecondes dans le futur.lowerBound=1d
et upperBound=2d
choisissait n'importe quoi après-demainNotez que ce prédicat ne tient pas compte des années bissextiles et que tous les mois comptent 30 jours.
Ne prend pas en charge le filtrage.
Prend en charge l’extraction de facettes de la même manière que le prédicat daterange.
upperBound
date supérieure liée en millisecondes ou 1s 2m 3h 4d 5w 6M 7y
(une seconde, deux minutes, trois heures, quatre jours, cinq semaines, six mois, sept ans) par rapport à l’heure actuelle du serveur, utilisez "-" pour un décalage négatif
lowerBound
date inférieure liée en millisecondes ou 1s 2m 3h 4d 5w 6M 7y
(une seconde, deux minutes, trois heures, quatre jours, cinq semaines, six mois, sept ans) par rapport à l’heure actuelle du serveur, utilisez "-" pour un décalage négatif
Groupe de prédicats racine. Prend en charge toutes les fonctionnalités d’un groupe et permet de définir des paramètres de requête globaux.
Le nom « root » n’est jamais utilisé dans une requête ; il est implicite.
p.offset
Nombre indiquant le début de la page de résultats, c’est-à-dire le nombre d’éléments à ignorer
p.limit
nombre indiquant le format de page
p.devinezTotal
Recommandé : évite de calculer le total des résultats, une opération qui peut s’avérer fastidieuse ; il s’agit soit d’un nombre qui indique la limite de comptage maximale (par exemple 1000, un nombre qui offre aux utilisateurs suffisamment d’informations sur la taille approximative et des valeurs exactes pour des résultats plus petits), soit de « true
» pour compter seulement jusqu’au minimum requis p.offset
+ p.limit
p.excerpt
si elle est définie sur " true
", inclure un extrait de texte complet dans le résultat
p.hits
(uniquement pour le servlet JSON) Sélectionne la manière dont les accès sont écrits au format JSON, avec ces éléments standard (extensibles via le service ResultHitWriter) :
simple:
éléments minimaux tels que path
, title
, lastmodified
, excerpt
(s'il est défini)
full:
rendu Sling JSON du noeud, avec jcr:path
indiquant le chemin d’accès de l’accès : par défaut, liste uniquement les propriétés directes du noeud, incluez une arborescence plus profonde avec p.nodedepth=N
, 0 signifiant la sous-arborescence entière et infinie ; ajoutez p.acls=true
pour inclure les autorisations JCR de la session en cours sur l’élément de résultat donné (mappages : create
= add_node
, modify
= set_property
, delete
= remove
)
sélective:
seules les propriétés spécifiées dans p.properties
, qui est une liste de chemins relatifs séparée par des espaces (utilisez "+" dans les URL); si le chemin relatif a une profondeur > 1, ils seront représentés comme des objets enfant ; la propriété spéciale jcr:path inclut le chemin de l’accès.
Inclut tous les prédicats d’une requête Query Builder persistante dans la requête actuelle sous la forme d’un prédicat de sous-groupe.
Notez que ce prédicat n’exécute pas une requête supplémentaire, mais étend la requête en cours.
Les requêtes peuvent être conservées par programmation à l'aide de QueryBuilder#storeQuery()
. Ce format peut être soit une propriété String multiligne, soit un nœud nt:file
contenant la requête en tant que fichier texte au format des propriétés Java.
Ne prend pas en charge l’extraction de facettes pour les prédicats de la requête enregistrée.
savedquery
chemin d’accès à la requête enregistrée (propriété String ou nt:file
noeud)
Recherche par analogie à l'aide de JCR XPath rep:similar()
.
Ne prend pas en charge le filtrage. Ne prend pas en charge l’extraction de facettes.
similar Chemin d’accès absolu au nœud pour lequel des nœuds similaires sont recherchés
local Chemin d’accès relatif à un nœud descendant ou
.
pour le noeud actif (facultatif, la valeur par défaut est " .
")
Recherche du contenu identifié avec une ou plusieurs balises, en spécifiant les chemins d’accès aux titres de balise.
Prend en charge l’extraction de facettes. Fournit des buckets pour chaque balise, en utilisant le chemin d’accès au titre de balise actif.
balise
Chemin d’accès au titre de la balise à rechercher ; par exemple, « Propriétés de ressource : Orientation / Paysage »
N_value
utilisez 1_value
, 2_value
, … pour rechercher plusieurs balises (combinées à OR
par défaut, avec AND
if and=true) (depuis 5.6).
property
propriété (ou chemin relatif à la propriété) à examiner (par défaut " cq:tags
")
Recherche du contenu identifié avec une ou plusieurs balises, en spécifiant des ID de balise.
Prend en charge l’extraction de facettes. Fournit des buckets pour chaque balise, en utilisant l’ID de balise en cours.
tagid
ID de balise à rechercher, par exemple " properties:orientation/landscape
"
N_value
utilisez 1_value
, 2_value
, … pour rechercher plusieurs tagids (combinés avec OR
par défaut, avec AND
if and=true) (depuis 5.6).
property
propriété (ou chemin relatif à la propriété) à examiner (par défaut " cq:tags
")
Recherche du contenu identifié avec une ou plusieurs balises, en spécifiant des mots-clés. Ce prédicat recherche d’abord les balises dont les titres contiennent ces mots-clés, puis limite les résultats aux seuls éléments balisés de la sorte.
Ne prend pas en charge l’extraction de facettes.
tagsearch
Mot-clé à rechercher dans les titres de nœud
property
propriété (ou chemin relatif à la propriété) à examiner (par défaut " cq:tags
")
lang
pour effectuer une recherche dans un certain titre de balise localisé uniquement (par ex. " de
")
all
(booléen) Effectue la recherche dans le texte intégral de la balise, c’est-à-dire tous les titres, la description, etc. (est prioritaire sur "l ang
")
Limite les résultats à un type de nœud JCR spécifique, aussi bien un type de nœud primaire qu’un type de mixin. Cela permet également de rechercher des sous-types de ce type de nœud. Pour une exécution efficace, notez que les index de recherche de référentiel doivent couvrir les types de nœud.
Prend en charge l’extraction de facettes. Fournit des buckets pour chaque type de valeur dans les résultats.
type
type de noeud ou nom de mixin à rechercher, par exemple cq:Page