Referencia de predicados del generador de consultas query-builder-predicate-reference
General general
Predicados predicates
boolproperty boolproperty
Coincide en las propiedades BOOLEANAS JCR. Solo acepta los valores " true
" y " false
". Si " false
", coincide si la propiedad tiene el valor " false
" o si no existe en absoluto. Esto puede resultar útil para comprobar si hay indicadores booleanos que solo se establecen cuando están habilitados.
El " heredado operation
El parámetro " no tiene significado.
Admite extracción de facetas. Proporciona bloques para cada true
o false
, pero solo para las propiedades existentes.
Propiedades properties
-
boolproperty
Ruta relativa a la propiedad, por ejemplo,myFeatureEnabled
ojcr:content/myFeatureEnabled
. -
valor
Valor para comprobar la propiedad de,"true
" o "false
".
contentfragment contentfragment
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
Compara dos propiedades JCR DATE entre sí. Puede comprobar si son iguales, desiguales, mayores o mayores que o iguales.
Este es 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.
-
operación
"
equals
" para coincidencia exacta, "!=
" para comparación de desigualdad, "greater
" para propiedad1 mayor que propiedad2, ">=
" para propiedad1 mayor o igual que propiedad2. El valor predeterminado es "equals
".
intervalo de fechas daterange
Hace coincidir las propiedades DATE de JCR con un intervalo de fecha y hora. Utiliza el formato ISO8601 para 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 el número de milisegundos desde 1970 en la zona horaria UTC, el formato de hora UNIX®.
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 extracción de facetas. Proporciona bloques "hoy", "esta semana", "este mes", "los últimos 3 meses", "este año", "el año pasado" y "antes del año pasado".
No admite el filtrado.
Propiedades properties-3
-
propiedad
Ruta relativa a un
DATE
, por ejemplo,jcr:lastModified
. -
lowerBound
La fecha inferior enlazada a la propiedad check para, por ejemplo,
2014-10-01
. -
lowerOperation
"
>
" (más reciente) o ">=
" (en o posterior), se aplica allowerBound
. El valor predeterminado es ">
". -
upperBound
Límite superior de la propiedad check para, por ejemplo,
2014-10-01T12:15:00
. -
upperOperation
"
<
" (anterior) o "<=
" (en o anterior), se aplica aupperBound
. El valor predeterminado es "<
". -
timeZone
ID de 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
Excluye nodos del resultado donde su ruta coincida con una expresión regular.
Este es 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
-
texto completo
Los términos de búsqueda de texto completo.
-
relPath
La ruta relativa a la búsqueda en la propiedad o subnodo. Esta propiedad es opcional.
grupo group
Permite crear condiciones anidadas. Los grupos pueden contener grupos anidados. Todo 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.
Ejemplo de coincidencia de 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, esto es (1_property
O 2_property)
.
Ejemplo para grupos anidados:
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
Esto busca el término "Administración" en páginas en /content/geometrixx/en
o en recursos en /content/dam/geometrixx
.
Conceptualmente, esto es fulltext AND ( (path AND type) OR (path AND type) )
. Estas uniones OR necesitan buenos índices para el rendimiento.
Propiedades properties-6
-
p.or
Si se establece como "
true
", solo debe coincidir un predicado del grupo. El valor predeterminado es "false
", lo que significa que todos deben coincidir -
p.not
Si se establece como "
true
", anula el grupo (el valor predeterminado es "false
"). -
<predicate>
Agrega predicados anidados.
-
N_<predicate>
Agrega varios predicados anidados al mismo tiempo, como
1_property, 2_property, ...
.
hasPermission haspermission
Restringe el resultado a elementos donde la sesión actual tiene el especificado Privilegios JCR.
Este es 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
Privilegios JCR separados por comas que la sesión de usuario actual debe tener TODOS el nodo en cuestión. Por ejemplo,
jcr:write
,jcr:modifyAccessControl
.
language language
Busca páginas de CQ en un idioma específico. Esto tiene en cuenta 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.
Este es un predicado solo de filtrado y no puede utilizar un índice de búsqueda.
Admite extracción de facetas. Proporciona bloques para cada código de lenguaje único.
Propiedades properties-8
-
idioma
Código de idioma ISO, por ejemplo,"
de
"
recurso principal mainasset
Comprueba si un nodo es un recurso principal DAM y no un subrecurso. Básicamente, se trata de todos los nodos que no están dentro de un nodo "subrecursos". Esto no comprueba si hay dam:Asset
tipo de nodo. Para utilizar este predicado, establezca " mainasset=true
" o " mainasset=false
", no hay más propiedades.
Este es 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
-
recurso principal
Booleano, "
true
" para recursos principales, "false
" para subrecursos.
memberOf memberof
Busca elementos que son miembros de un específico colección de recursos de sling.
Este es 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
Coincide con los nombres de nodo JCR.
Admite extracción de facetas. Proporciona bloques para cada nombre de nodo único (nombre de archivo).
Propiedades properties-11
-
nombre de nodo
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
Coincide con los elementos comprobando si una propiedad JCR DATE es mayor o igual que la hora actual del servidor. Se puede utilizar para comprobar un " expiresAt
" gusta la propiedad fecha y limitar solo a las 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 el predicado daterange.
Propiedades properties-12
-
notexpired
Booleano, "
true
" para no caducado todavía (fecha futura o igual), "false
" para caducado (fecha anterior) (obligatorio). -
propiedad
Ruta relativa a
DATE
propiedad que se va a comprobar (obligatorio).
orderby orderby
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 cuál ordenar. -
sort
Dirección de ordenación, ya sea "
desc
" para descendente o "asc
" para ascendente (predeterminado). -
estuche
Si se establece en
ignore
, hace que la ordenación no distinga entre mayúsculas y minúsculas, lo que significa que "a" va antes que "B"; si está vacía o se deja de lado, la ordenación distingue entre mayúsculas y minúsculas, lo que significa que "B" va antes que "a"
path path
Busca dentro de una ruta determinada.
No admite la extracción de facetas.
Propiedades properties-14
-
ruta
Patrón de ruta. Dependiendo de lo exacto, todo el subárbol coincide (como anexar)
//*
en xpath, pero tenga en cuenta que esto no incluye la ruta base) (exacto=false, predeterminado) o solo una coincidencia de ruta exacta, que puede incluir caracteres comodín (*
); si se establece self, se busca en todo el subárbol, incluido el nodo base. -
exacto
If
exact
es true/on, la ruta exacta debe coincidir, pero puede contener caracteres comodín simples (*
), que coinciden con los nombres, pero no con "/
"; si es false (predeterminado), se incluyen todos los descendientes (opcional). -
plano
Busca solo los elementos secundarios directos (como anexar "
/*
" en xpath) (solo se usa si 'exact
' no es true, opcional). -
uno mismo
Busca en el subárbol pero incluye el nodo base dado como ruta (sin comodines).
propiedad property
Coincide en las propiedades JCR y sus valores.
Admite extracción de facetas. Proporciona bloques para cada valor de propiedad único en los resultados.
Propiedades properties-15
-
propiedad
Ruta relativa a la propiedad, por ejemplo,
jcr:title
. -
valor
Valor para comprobar la propiedad; sigue el tipo de propiedad JCR a las conversiones de cadena.
-
N_value
Uso
1_value
,2_value
, … para buscar varios valores (combinados conOR
de forma predeterminada, conAND
if y=true) (desde 5.3). -
y
Establezca como true para combinar varios valores (
N_value
) con AND (desde 5.3). -
operación
"
equals
" para coincidencia exacta (predeterminado), "unequals
" para comparación de desigualdad, "like
" para usar eljcr:like
función xpath (opcional), "not
" para no coincidir (por ejemplo, "not(@prop)
" en xpath, el parámetro value se ignora) o "exists
" para la comprobación de existencia (el valor puede ser true - la propiedad debe existir, el valor predeterminado - o false - igual que "not
"). -
profundidad
Número de niveles comodín por debajo de los cuales puede existir la propiedad o ruta relativa (por ejemplo,
property=size depth=2
comprueba nodo/tamaño, nodo/ast;/tamaño y nodo/ast;/*/tamaño).
rangeProperty rangeproperty
Hace coincidir una propiedad JCR con un intervalo. Esto se aplica a las propiedades con tipos lineales como LONG
, DOUBLE
, y DECIMAL
. Para DATE
, consulte el predicado daterange que ha optimizado la entrada de formato de fecha.
Puede definir un límite inferior y un límite superior o solo uno de ellos. La operación (por ejemplo, "menor que" o "menor o igual que") también se puede especificar para los límites inferior y superior, individualmente.
No admite la extracción de facetas.
Propiedades properties-16
-
propiedad
Ruta relativa a la propiedad.
-
lowerBound
Límite inferior para comprobar la propiedad de.
-
lowerOperation
"
>
" (predeterminado) o ">=
", se aplica allowerValue
-
upperBound
Límite superior para comprobar la propiedad de.
-
upperOperation
"
<
" (predeterminado) o "<=
", se aplica allowerValue
-
decimal
"
true
" si la propiedad activada es de tipo Decimal
relativedaterange relativedaterange
Coincide 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 valor predeterminado es 0, es decir, la hora actual.
Por ejemplo:
upperBound=1h
(y nolowerBound
) seleccionaría cualquier cosa en la hora siguientelowerBound=-1d
(y noupperBound
) seleccionaría cualquier cosa en las últimas 24 horaslowerBound=-6M
yupperBound=-3M
seleccionaría cualquier cosa de 6 meses a 3 meses de edadlowerBound=-1500
yupperBound=5500
seleccionaría cualquier valor entre 1500 milisegundos en el pasado y 5500 milisegundos en el futurolowerBound=1d
yupperBound=2d
seleccionaría 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 el predicado daterange.
Propiedades properties-17
-
upperBound
Límite de fecha superior en milisegundos o
1s 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, utilice "-" para el desplazamiento negativo. -
lowerBound
Límite de fecha inferior en milisegundos o
1s 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, utilice "-" para el desplazamiento negativo.
raíz root
Grupo de predicados raíz. Admite todas las funciones de un grupo y permite establecer parámetros de consulta globales.
El nombre "root" nunca se utiliza 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 completo de resultados, que puede resultar costoso; ya sea un número que indique el total máximo que se va a contar hasta (por ejemplo, 1000, un número que proporcione a los usuarios suficientes comentarios sobre el tamaño aproximado y los números exactos para resultados más pequeños) o "
true
" para contar solo hasta el mínimo necesariop.offset
+p.limit
. -
p.extracto
Si se establece como "
true
", incluir extracto de texto completo en el resultado. -
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 como
path
,title
,lastmodified
,excerpt
(si está configurado). -
completo:
Representación del nodo JSON de Sling, con
jcr:path
indicando la ruta de la visita: de forma predeterminada solo enumera las propiedades directas del nodo, incluya un árbol más profundo conp.nodedepth=N
, con 0 que significa todo el subárbol infinito; agreguep.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
). -
selectivo:
Solo las propiedades especificadas en
p.properties
, que es una lista de rutas relativas separadas por espacios (utilice "+" en las direcciones URL); si la ruta relativa tiene una profundidad > 1, se representan como objetos secundarios; la propiedad especial jcr:path incluye la ruta de la visita
-
savedquery savedquery
Incluye todos los predicados de una consulta del generador de consultas persistente en la consulta actual como predicado de subgrupo.
Esto no ejecuta una consulta adicional, sino que amplía la consulta actual.
Las consultas se pueden mantener mediante programación usando QueryBuilder#storeQuery()
. El formato puede ser una propiedad String de varias líneas o una propiedad 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 (propiedad de cadena o
nt:file
node).
parecido similar
Búsqueda por similitud con XPath de JCR rep:similar()
.
No admite el filtrado. No admite la extracción de facetas.
Propiedades properties-20
-
parecido
Ruta absoluta al nodo para el que se buscarán nodos similares. -
local
Una ruta relativa a un nodo descendiente o.
para el nodo actual (opcional), el valor predeterminado es ".
").
etiqueta tag
Busca contenido etiquetado con una o más etiquetas, especificando las rutas de título de las etiquetas.
Admite extracción de facetas. Proporciona bloques para cada etiqueta única, utilizando su ruta de título de etiqueta actual.
Propiedades properties-21
-
etiqueta
Etiquete la ruta del título que desee buscar, por ejemplo, "Propiedades del recurso : Orientación / Horizontal".
-
N_value
Uso
1_value
,2_value
, … para buscar varias etiquetas (combinadas conOR
de forma predeterminada, conAND
if y=true) (desde 5.6). -
propiedad
Propiedad (o ruta relativa a la propiedad) que se va a ver (predeterminado "
cq:tags
")
tagid tagid
Busca contenido etiquetado con una o más etiquetas, especificando los ID de etiqueta.
Admite extracción de facetas. Proporciona bloques para cada etiqueta única, utilizando su ID de etiqueta actual.
Propiedades properties-22
-
tagid
ID de etiqueta para poder buscar, por ejemplo, "
properties:orientation/landscape
". -
N_value
Uso
1_value
,2_value
, … para comprobar si hay varios tagids (combinados conOR
de forma predeterminada, conAND
if y=true) (desde 5.6). -
propiedad
Propiedad (o ruta relativa a la propiedad) que se va a ver (predeterminado "
cq:tags
").
tagsearch tagsearch
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 etiquetas.
-
propiedad
Propiedad (o ruta relativa a la propiedad) que se va a ver (valor predeterminado
cq:tags
). -
lang
Para buscar solo en un determinado título de etiqueta localizado (por ejemplo,
de
). -
todo
(Bool) Busque texto completo de la etiqueta, es decir, todos los títulos, descripciones, etc. Tiene prioridad sobre "l"
ang
".
tipo type
Restringe los resultados a un tipo de nodo JCR específico, tanto del tipo de nodo principal como del tipo de mezcla. Esto 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 extracción de facetas. Proporciona bloques para cada tipo único en los resultados.
Propiedades Properties-2
-
type
Tipo de nodo o nombre de mezcla que buscar, por ejemplo,
cq:Page
.