Referencia de predicados del generador de consultas query-builder-predicate-reference
General general
raíz root
El grupo de predicados raíz. Admite todas las funciones de un grupo y permite configurar parámetros de consulta globales.
El nombre "root" nunca se usa en una consulta; está implícito.
Propiedades properties-18
-
p.offset
: número que indica el inicio de la página de resultados, es decir, cuántos elementos se deben omitir. -
p.limit
: número que indica el tamaño de página. -
p.guessTotal
- recomendado: evite calcular el total del resultado, que puede resultar costoso. Un número que indica el total máximo que se va a contar hasta (por ejemplo, 1000, un número que proporciona a los usuarios comentarios suficientes sobre el tamaño aproximado y los números exactos para obtener resultados más pequeños). O bien,true
para contar solo hasta el mínimo necesariop.offset
+p.limit
. -
p.excerpt
- si se configura comotrue
, incluya un extracto de texto completo en el resultado. -
p.indexTag
: si se configura, incluirá una opción de etiqueta de índice en la consulta (consulte Etiqueta de índice de opción de consulta). -
p.facetStrategy
- si se configura comooak
, Query Builder delegará la extracción de facetas a Oak (consulte Facetas). -
p.hits
: (solo para el servlet JSON) seleccione la forma en que se escriben las visitas como JSON, con estas estándar (ampliables mediante el servicio ResultHitWriter).simple
- elementos mínimos comopath
,title
,lastmodified
,excerpt
(si está configurado).full
- procesamiento JSON de sling del nodo, conjcr:path
que indica la ruta de la visita. De forma predeterminada, solo enumera las propiedades directas del nodo, incluido un árbol más profundo conp.nodedepth=N
, donde 0 significa todo el subárbol infinito. Añadirp.acls=true
para incluir los permisos JCR de la sesión actual en el elemento de resultado dado (asignaciones:create
=add_node
,modify
=set_property
,delete
=remove
).selective
- solo las propiedades especificadas enp.properties
, que es un espacio separado (use+
en la lista de direcciones URL) de rutas relativas. Si la ruta relativa tiene una profundidad>1
, estas propiedades se representan como objetos secundarios. El especialjcr:path
La propiedad incluye la ruta de la visita.
grupo group
Este predicado permite crear condiciones anidadas. Los grupos pueden contener grupos anidados. Todo lo que hay en una consulta del Generador de consultas está implícito en un grupo raíz, que puede tener p.or
y p.not
también parámetros de.
A continuación se muestra un ejemplo de cómo hacer coincidir una de las dos propiedades con un valor:
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
Conceptualmente, lo es (1_property
O 2_property)
.
El siguiente es un ejemplo para grupos anidados:
fulltext=Management
group.p.or=true
group.1_group.path=/content/wknd/ch/de
group.1_group.type=cq:Page
group.2_group.path=/content/dam/wknd
group.2_group.type=dam:Asset
Busca el término Administración dentro de páginas en /content/wknd/ch/de
o en recursos en /content/dam/wknd
.
Conceptualmente, lo es fulltext AND ( (path AND type) OR (path AND type) )
. Estas uniones OR necesitan buenos índices por motivos de rendimiento.
Propiedades properties-6
p.or
- si se configura comotrue
, solo debe coincidir un predicado del grupo. El valor predeterminado esfalse
, lo que significa que todos deben coincidirp.not
- si se configura comotrue
, anula el grupo (el valor predeterminado esfalse
)<predicate>
- añade predicados anidadosN_<predicate>
: añade varios predicados anidados al mismo tiempo, como1_property, 2_property, ...
orderby orderby
Este predicado permite ordenar los resultados. Si se requiere ordenar por varias propiedades, este predicado debe agregarse varias veces utilizando el prefijo numérico, como 1_orderby=first
, 2_oderby=second
.
Propiedades properties-13
orderby
: nombre de propiedad JCR indicado por una @ inicial, por ejemplo,@jcr:lastModified
o@jcr:content/jcr:title
u otro predicado de la consulta, por ejemplo,2_property
, según el ordensort
- dirección del orden, ya seadesc
para descendente oasc
para ascendente (predeterminado)case
- si se configura comoignore
, no distingue entre mayúsculas y minúsculas, es decir,a
va antes queB
; si está vacío o no, la ordenación distingue entre mayúsculas y minúsculas, es decirB
va antes quea
Predicados predicates
boolproperty boolproperty
Este predicado coincide con las propiedades booleanas JCR. Solo acepta los valores true
y false
. Si el valor es false
, coincide si la propiedad tiene el valor false
, o si no existe en absoluto. Este predicado es útil para comprobar indicadores booleanos que solo se establecen cuando está habilitado.
El heredado operation
parámetro no tiene significado.
Este predicado admite la extracción de facetas y proporciona bloques para cada uno true
o false
, pero solo para las propiedades existentes.
Propiedades properties
boolproperty
- ruta relativa a la propiedad, por ejemplo,myFeatureEnabled
ojcr:content/myFeatureEnabled
value
- valor para comprobar la propiedad,true
ofalse
contentfragment contentfragment
Este predicado restringe el resultado a fragmentos de contenido.
- No admite el filtrado.
- No admite la extracción de facetas.
Propiedades properties-1
contentfragment
: se puede utilizar con cualquier valor para comprobar fragmentos de contenido.
dateComparison
datecomparison
Este predicado compara dos propiedades de fecha JCR entre sí. Puede comprobar si son iguales, desiguales, mayores o mayores que o iguales.
Un predicado solo de filtrado y no puede utilizar un índice de búsqueda.
Propiedades properties-2
-
property1
- ruta a la primera propiedad de fecha -
property2
- ruta a la segunda propiedad de fecha -
operation
=
para coincidencia exacta (predeterminado)!=
para comparación de desigualdad>
paraproperty1
mayor queproperty2
>=
paraproperty1
mayor que o igual aproperty2
intervalo de fechas daterange
Este predicado compara las propiedades de fecha JCR con un intervalo de fecha y hora. Utiliza el formato ISO8601 para las fechas y horas (YYYY-MM-DDTHH:mm:ss.SSSZ
) y también permite representaciones parciales, como YYYY-MM-DD
. Alternativamente, la marca de tiempo se puede proporcionar como hora POSIX.
Puede buscar cualquier cosa entre dos marcas de tiempo, cualquier cosa más reciente o anterior a una fecha determinada, y también elegir entre intervalos inclusivos y abiertos.
Admite la extracción de facetas y proporciona contenedores today
, this week
, this month
, last 3 months
, this year
, last year
, y earlier than last year
.
No admite el filtrado.
Propiedades properties-3
property
- ruta relativa a unDATE
, por ejemplo,jcr:lastModified
lowerBound
: límite de fecha inferior para comprobar la propiedad, por ejemplo,2014-10-01
lowerOperation
->
(más reciente) o>=
(en o posterior), se aplica allowerBound
. El valor predeterminado es>
upperBound
: límite superior para comprobar la propiedad de, por ejemplo,2014-10-01T12:15:00
upperOperation
-<
(anterior) o<=
(en o anteriores), se aplica aupperBound
. El valor predeterminado es<
timeZone
: ID de la zona horaria que se utilizará cuando no se proporcione como cadena de fecha ISO-8601. El valor predeterminado es la zona horaria predeterminada del sistema.
excludepaths excludepaths
Este predicado excluye nodos del resultado donde su ruta coincida con una expresión regular.
Un predicado solo de filtrado y no puede utilizar un índice de búsqueda.
No admite la extracción de facetas.
Propiedades properties-4
excludepaths
: expresión regular comparada con las rutas de resultados, excluyendo las coincidentes del resultado.
texto completo fulltext
Busca términos en el índice de texto completo.
No admite el filtrado.
No admite la extracción de facetas.
Propiedades properties-5
fulltext
- los términos de búsqueda de texto completorelPath
: la ruta relativa a la búsqueda en la propiedad o subnodo. Esta propiedad es opcional.
hasPermission haspermission
Este predicado restringe el resultado a los elementos en los que la sesión actual tiene el especificado Privilegios JCR.
Un predicado solo de filtrado y no puede utilizar un índice de búsqueda. No admite la extracción de facetas.
Propiedades properties-7
hasPermission
- todos los privilegios JCR separados por comas que la sesión de usuario actual debe tener para el nodo en cuestión. Por ejemplo,jcr:write
,jcr:modifyAccessControl
language language
AEM Este predicado encuentra páginas en un idioma específico para el usuario. Examina tanto la propiedad de idioma de la página como la ruta de página que a menudo incluye el idioma o la configuración regional en una estructura de sitio de nivel superior.
Un predicado solo de filtrado y no puede utilizar un índice de búsqueda.
Admite la extracción de facetas y proporciona bloques para cada código de idioma único.
Propiedades properties-8
language
- código de idioma ISO, por ejemplo,de
recurso principal mainasset
Este predicado comprueba si un nodo es un recurso principal DAM y no un subrecurso. Básicamente son todos los nodos que no están dentro de un nodo de subrecursos. No comprueba la existencia de dam:Asset
tipo de nodo. Para utilizar este predicado, establezca mainasset=true
o mainasset=false
. No hay más propiedades.
Un predicado solo de filtrado y no puede utilizar un índice de búsqueda.
Admite la extracción de facetas y proporciona dos contenedores para recursos principales y secundarios.
Propiedades properties-9
mainasset
- booleano,true
para los activos principales,false
para subrecursos
memberOf memberof
Este predicado encuentra elementos que son miembros de un grupo específico colección de recursos de sling.
Un predicado solo de filtrado y no puede utilizar un índice de búsqueda.
No admite la extracción de facetas.
Propiedades properties-10
memberOf
- ruta de la colección de recursos de Sling
nombre de nodo nodename
Este predicado coincide con los nombres de nodo JCR.
Admite la extracción de facetas y proporciona bloques para cada nombre de nodo único (nombre de archivo).
Propiedades properties-11
nodename
- patrón de nombre de nodo que permite caracteres comodín:*
= cualquier o ningún carácter,?
= cualquier carácter,[abc]
= solo caracteres entre corchetes
notexpired notexpired
Este predicado coincide con los elementos al comprobar si una propiedad de fecha JCR es mayor o igual que la hora actual del servidor. Se puede utilizar para comprobar un expiresAt
y limita los resultados únicamente a los valores que aún no han caducado (notexpired=true
) o que ya han caducado (notexpired=false
).
No admite el filtrado.
Admite la extracción de facetas del mismo modo que la variable daterange
predicado.
Propiedades properties-12
notexpired
- booleano,true
para todavía no caducado (fecha futura o igual),false
para caducado (fecha en el pasado) (obligatorio)property
- ruta relativa aDATE
propiedad para comprobar (obligatorio)
path path
Este predicado busca dentro de una ruta determinada.
No admite la extracción de facetas.
Propiedades properties-14
path
: define el patrón de ruta.- Según la variable
exact
propiedad, o bien todo el subárbol coincide (como anexar)//*
en xpath, pero tenga en cuenta que no incluye la ruta base) o que solo coincide una ruta exacta, que puede incluir caracteres comodín (*
).- El valor predeterminado es
true
.
<!— * Si la variableself
se establece, se busca en todo el subárbol, incluido el nodo base.—>
- El valor predeterminado es
- Según la variable
exact
- siexact
estrue
, la ruta exacta debe coincidir, pero puede contener caracteres comodín simples (*
), que coinciden con los nombres, pero no con/
; si esfalse
(predeterminado) se incluyen todos los descendientes (opcional).flat
: busca solo los elementos secundarios directos (como anexar/*
en xpath) (solo se utiliza siexact
no es true, opcional).self
: busca en el subárbol pero incluye el nodo base dado como ruta (sin comodines).- Nota importante: Se ha identificado un problema con
self
en la implementación actual del generador de consultas y su uso en consultas puede no producir resultados de búsqueda correctos. Cambiar la implementación actual deself
tampoco es viable porque podría romper las aplicaciones existentes que dependen de ella. Debido a esta funcionalidad,self
La propiedad de está en desuso, por lo que se recomienda evitar utilizarla.
- Nota importante: Se ha identificado un problema con
propiedad property
Este predicado coincide con las propiedades JCR y sus valores.
Admite la extracción de facetas y proporciona bloques para cada valor de propiedad único en los resultados.
Propiedades properties-15
-
property
- ruta relativa a la propiedad, por ejemplo,jcr:title
. -
value
: valor para comprobar la propiedad; sigue el tipo de propiedad JCR a las conversiones de cadena. -
N_value
- uso1_value
,2_value
, … para buscar varios valores (combinados conOR
de forma predeterminada, conAND
ifand=true
). -
and
- se establece entrue
para combinar varios valores (N_value
) conAND
-
operation
-
equals
para la coincidencia exacta (valor predeterminado). -
unequals
para comparación de desigualdad. -
like
para usar eljcr:like
función xpath (opcional). -
not
para que no haya coincidencia (por ejemplo,not(@prop)
en xpath, el parámetro value se ignora). -
exists
para la comprobación de existencia.true
la propiedad debe existir.false
es igual quenot
y es el valor predeterminado.
-
-
depth
: número de niveles comodín por debajo de los cuales puede existir la propiedad o ruta relativa (por ejemplo,property=size depth=2
chequesnode/size
,node/*/size
, ynode/*/*/size
).
rangeProperty rangeproperty
Este predicado compara una propiedad JCR con un intervalo. Se aplica a propiedades con tipos lineales como LONG
, DOUBLE
, y DECIMAL
. Para DATE
, consulte la daterange
predicado que ha optimizado la entrada de formato de fecha.
Puede definir un límite inferior, un límite superior o ambos. La operación (por ejemplo, menor o menor o igual que) también se puede especificar individualmente para los límites inferior y superior.
No admite la extracción de facetas.
Propiedades properties-16
property
- ruta relativa a la propiedadlowerBound
- límite inferior para comprobar la propiedadlowerOperation
->
(predeterminado) o>=
, se aplica allowerValue
upperBound
- límite superior de la propiedad checkupperOperation
-<
(predeterminado) o<=
, se aplica allowerValue
decimal
-true
si la propiedad activada es de tipo Decimal
relativedaterange relativedaterange
Este predicado coincide con JCR DATE
propiedades para un intervalo de fecha y hora con desplazamientos de tiempo respecto a la hora del servidor actual. Puede especificar lowerBound
y upperBound
usando un valor de milisegundos o la sintaxis de Bugzilla 1s 2m 3h 4d 5w 6M 7y
(un segundo, dos minutos, tres horas, cuatro días, cinco semanas, seis meses, siete años). Prefijo con -
para indicar un desplazamiento negativo antes de la hora actual. Si solo especifica lowerBound
o upperBound
, el otro toma el valor predeterminado 0
, que representa la hora actual.
Por ejemplo:
upperBound=1h
(y nolowerBound
) selecciona cualquier cosa en la hora siguientelowerBound=-1d
(y noupperBound
) selecciona cualquier cosa en las últimas 24 horaslowerBound=-6M
yupperBound=-3M
selecciona cualquier cosa en los últimos 3 a 6 meseslowerBound=-1500
yupperBound=5500
selecciona cualquier valor entre 1500 milisegundos y 5500 milisegundos en el futurolowerBound=1d
yupperBound=2d
selecciona cualquier cosa pasado mañana
No tiene en cuenta los años bisiestos y todos los meses son 30 días.
No admite el filtrado.
Admite la extracción de facetas del mismo modo que la variable daterange
predicado.
Propiedades properties-17
upperBound
- límite superior de fecha en milisegundos o1s 2m 3h 4d 5w 6M 7y
(un segundo, dos minutos, tres horas, cuatro días, cinco semanas, seis meses, siete años) en relación con el tiempo de servidor actual, use-
para desplazamiento negativolowerBound
: límite de fecha inferior en milisegundos o1s 2m 3h 4d 5w 6M 7y
(un segundo, dos minutos, tres horas, cuatro días, cinco semanas, seis meses, siete años) en relación con el tiempo de servidor actual, use-
para desplazamiento negativo
savedquery savedquery
Este predicado incluye todos los predicados de una consulta del Generador de consultas persistente en la consulta actual como predicado de subgrupo.
No ejecuta una consulta adicional pero amplía la consulta actual.
Las consultas se pueden mantener mediante programación usando QueryBuilder#storeQuery()
. El formato puede ser de varias líneas String
propiedad o un nt:file
nodo que contiene la consulta como archivo de texto en formato de propiedades Java™.
No admite la extracción de facetas para los predicados de la consulta guardada.
Propiedades properties-19
savedquery
- ruta a la consulta guardada (String
property ont:file
node)
parecido similar
Este predicado es una búsqueda de similitud que utiliza XPath de JCR rep:similar()
.
No admite el filtrado y no admite la extracción de facetas.
Propiedades properties-20
similar
- ruta absoluta al nodo para el que se buscarán nodos similareslocal
- una ruta relativa a un nodo descendiente o.
para el nodo actual (opcional), el valor predeterminado es.
)
etiqueta tag
Este predicado busca contenido etiquetado con una o más etiquetas, especificando las rutas de título de las etiquetas.
Admite la extracción de facetas y proporciona bloques para cada etiqueta única, utilizando su ruta de título de etiqueta actual.
Propiedades properties-21
tag
- ruta del título de la etiqueta que se va a buscar, por ejemplo,properties:orientation/landscape
N_value
- uso1_value
,2_value
, … para buscar varias etiquetas (combinadas conOR
de forma predeterminada, conAND
ifand=true
)property
- propiedad (o ruta relativa a la propiedad) que se va a ver (valor predeterminadocq:tags
)
tagid tagid
Este predicado busca contenido etiquetado con una o más etiquetas, especificando los ID de etiqueta.
Admite la extracción de facetas y proporciona bloques para cada etiqueta única, utilizando su ID de etiqueta actual.
Propiedades properties-22
tagid
- ID de etiqueta que se va a buscar, por ejemplo,properties:orientation/landscape
N_value
- uso1_value
,2_value
, … para comprobar si hay varios ID de etiqueta (combinados conOR
de forma predeterminada, conAND
ifand=true
)property
- propiedad (o ruta relativa a la propiedad) que se va a ver (valor predeterminadocq:tags
)
tagsearch tagsearch
Este predicado busca contenido etiquetado con una o más etiquetas especificando palabras clave. Primero busca las etiquetas que contienen estas palabras clave en sus títulos y luego restringe el resultado a solo los elementos etiquetados con estas palabras clave.
No admite la extracción de facetas.
Propiedades Properties-1
tagsearch
: palabra clave para buscar en títulos de etiquetasproperty
- propiedad (o ruta relativa a la propiedad) a tener en cuenta (predeterminado)cq:tags
)lang
: para buscar solo en un determinado título de etiqueta localizado (por ejemplo,de
)all
: valor booleano para buscar texto completo de etiqueta completo, es decir, todos los títulos, descripciones, etc. (tiene prioridad sobrelang
)
tipo type
Este predicado restringe los resultados a un tipo de nodo JCR específico, ambos tipos de nodo principal o mixin
tipos. También encuentra subtipos de ese tipo de nodo. Los índices de búsqueda del repositorio deben cubrir los tipos de nodo para una ejecución eficiente.
Admite la extracción de facetas y proporciona bloques para cada tipo único en los resultados.
Propiedades Properties-2
type
- tipo de nodo omixin
nombre para buscar, por ejemplo,cq:Page