Referencia de predicados del generador de consultas

PRECAUCIÓN

La información de esta página no es exhaustiva.

Para obtener información completa, consulte la lista debajo de Predicados disponibles en la consola de Query Builder Debugger; por ejemplo, en:

Por ejemplo, consulte:

General

Predicados

boolproperty

Coincide en las propiedades BOOLEANAS JCR. Solo acepta los valores " true" y " false". En el caso de " false", coincidirá 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 operationEl parámetro " no tiene significado.

Admite extracción de facetas. Proporcionará bloques para cada true o false , pero solo para las propiedades existentes.

Propiedades

  • boolproperty
    ruta relativa a la propiedad, por ejemplo
    myFeatureEnabled o jcr:content/myFeatureEnabled

  • valor
    valor para comprobar la propiedad de,"
    true" o " false"

contentfragment

Restringe el resultado a fragmentos de contenido.

No admite el filtrado.

No admite la extracción de facetas.

Propiedades

  • contentfragment
    Se puede utilizar con cualquier valor para comprobar fragmentos de contenido.

dateComparison

Compara dos propiedades JCR DATE entre sí. Puede comprobar si son iguales, desiguales, buenos o buenos que o iguales.

Este es un predicado solo de filtrado y no puede aprovechar un índice de búsqueda.

Propiedades

  • 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 la propiedad1 buena que la propiedad2, " >=" para la propiedad1 buena o igual a la propiedad2. El valor predeterminado es " equals".

intervalo de fechas

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 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. Proporcionará 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

  • propiedad

    ruta relativa a un DATE propiedad, por ejemplo jcr:lastModified

  • lowerBound

    límite de fecha inferior para la propiedad check, por ejemplo 2014-10-01

  • lowerOperation

    " >" (más reciente) o " >=" (en o posterior), se aplica al lowerBound. El valor predeterminado es " >".

  • upperBound

    límite superior para comprobar la propiedad, por ejemplo 2014-10-01T12:15:00

  • upperOperation

    " <" (anterior) o " <=" (en o anterior), se aplica a upperBound. 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

Excluye nodos del resultado donde su ruta coincida con una expresión regular.

Este es un predicado solo de filtrado y no puede aprovechar un índice de búsqueda.

No admite la extracción de facetas.

Propiedades

  • excludepaths

    expresión regular comparada con rutas de resultados, excluyendo las coincidentes del resultado.

texto completo

Busca términos en el índice de texto completo.

No admite el filtrado.

No admite la extracción de facetas.

Propiedades

  • 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

Permite generar condiciones anidadas. Los grupos pueden contener grupos anidados. Todo en una consulta de querybuilder 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) ). Tenga en cuenta que estas uniones OR necesitan buenos índices para el rendimiento.

Propiedades

  • p.or

    si se configura 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 configura como " true", anula el grupo (el valor predeterminado es " false")

  • <predicate>

    añade predicados anidados

  • N_<predicate>

    agrega varios predicados anidados al mismo tiempo, como 1_property, 2_property, ...

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 aprovechar un índice de búsqueda. No admite la extracción de facetas.

Propiedades

  • hasPermission

    privilegios JCR separados por comas que la sesión de usuario actual debe tener TODOS para el nodo en cuestión; por ejemplo jcr:write, jcr:modifyAccessControl

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 aprovechar un índice de búsqueda.

Admite extracción de facetas. Proporcionará bloques para cada código de idioma único.

Propiedades

  • language

    Código de idioma ISO, por ejemplo " de"

recurso principal

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". Tenga en cuenta que esto no comprueba la existencia de dam:Asset tipo de nodo. Para utilizar este predicado, simplemente configure " mainasset=true" o " mainasset=false", no hay más propiedades.

Este es un predicado solo de filtrado y no puede aprovechar un índice de búsqueda.

Admite extracción de facetas. Proporcionará 2 bloques para los recursos principales y secundarios.

Propiedades

  • recurso principal

    booleano, " true" para recursos principales, " false" para recursos secundarios

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 aprovechar un índice de búsqueda. No admite la extracción de facetas.

Propiedades

  • memberOf

    ruta de la colección de recursos de Sling

nombre de nodo

Coincide con los nombres de nodo JCR.

Admite extracción de facetas. Proporcionará bloques para cada nombre de nodo único (nombre de archivo).

Propiedades

  • 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

Coincide con los elementos comprobando si una propiedad JCR DATE es buena o igual a 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

  • notexpired

    booleano, " true" para no caducado todavía (fecha futura o igual), " false" para caducado (fecha en el pasado) (obligatorio)

  • propiedad

    ruta relativa a DATE propiedad para comprobar (obligatorio)

orderby

Permite ordenar el resultado. 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

  • orderby

    bien el nombre de la propiedad JCR indicado por una @ inicial, por ejemplo @jcr:lastModified o @jcr:content/jcr:titleu otro predicado de la consulta, por ejemplo 2_property, según el orden

  • ordenar

    la dirección del orden, ya sea " desc" para descendente o " asc" para ascendente (predeterminado)

  • estuche

    si se configura como " ignore" hará que la ordenación no distinga mayúsculas de minúsculas, es decir, "a" va antes que "B"; si está vacía o se deja de lado, la ordenación distingue mayúsculas de minúsculas, es decir, "B" va antes que "a"

path

Busca dentro de una ruta determinada.

No admite la extracción de facetas.

Propiedades

  • path

    patrón de ruta; según el valor exacto, coincidirá todo el subárbol (como anexar) //* en xpath, pero tenga en cuenta que esto no incluye la ruta base) (exacto=false, predeterminado) o solo coincide una ruta exacta, que puede incluir caracteres comodín ( *); si se establece self, se buscará 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)

  • self

    busca en el subárbol pero incluye el nodo base dado como ruta (sin comodines)

propiedad

Coincide en las propiedades JCR y sus valores.

Admite extracción de facetas. Proporcionará bloques para cada valor de propiedad único en los resultados.

Propiedades

  • 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

    use 1_value, 2_value, … para buscar varios valores (combinados con OR de forma predeterminada, con AND if y=true) (desde 5.3)

  • y

    establezca en 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 el jcr:like función xpath (opcional), " not" para no coincidir (p. ej. "not(@prop)" en xpath, el parámetro value se omitirá) 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 de comodín bajo los cuales puede existir la propiedad o ruta relativa (por ejemplo, property=size depth=2 comprobará node/size, node/*/size y node/*/*/size)

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 (p. ej. "menor que" o "menor o igual que") también se puede especificar para los límites inferior y superior de forma individual.

No admite la extracción de facetas.

Propiedades

  • propiedad

    ruta relativa a la propiedad

  • lowerBound

    límite inferior para comprobar la propiedad de

  • lowerOperation

    " >" (predeterminado) o " >=", se aplica al lowerValue

  • upperBound

    límite superior de la propiedad check para

  • upperOperation

    " <" (predeterminado) o " <=", se aplica al lowerValue

  • decimal

    " true" si la propiedad activada es de tipo Decimal

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 será 0, es decir, la hora actual.

Por ejemplo:

  • upperBound=1h (y no lowerBound) seleccionaría cualquier cosa en la hora siguiente
  • lowerBound=-1d (y no upperBound) seleccionaría cualquier cosa en las últimas 24 horas
  • lowerBound=-6M y upperBound=-3M seleccionaría cualquier cosa de 6 meses a 3 meses de edad
  • lowerBound=-1500 y upperBound=5500 seleccionaría cualquier valor entre 1500 milisegundos en el pasado y 5500 milisegundos en el futuro
  • lowerBound=1d y upperBound=2d seleccionaría cualquier cosa pasado mañana.

Tenga en cuenta que no tiene en cuenta los años bisiestos y que 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

  • 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

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

  • 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 de resultados completo, 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 necesario p.offset + p.limit

  • p.extracto

    si se configura 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)

    • completa:

      procesamiento JSON de sling del nodo, 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 con p.nodedepth=N, con 0 que significa todo el subárbol infinito; agregue p.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, estas se representarán como objetos secundarios; la propiedad especial jcr:path incluye la ruta de la visita

savedquery

Incluye todos los predicados de una consulta de querybuilder persistente en la consulta actual como predicado de subgrupo.

Tenga en cuenta que esto no ejecutará una consulta adicional, sino que ampliará 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

  • savedquery

    ruta a la consulta guardada (propiedad de cadena o nt:file node)

parecido

Búsqueda por similitud con XPath de JCR rep:similar().

No admite el filtrado. No admite la extracción de facetas.

Propiedades

  • parecido
    ruta absoluta al nodo para el que buscar nodos similares

  • local
    una ruta relativa a un nodo descendiente o
    . para el nodo actual (opcional), el valor predeterminado es " .")

etiqueta

Busca contenido etiquetado con una o más etiquetas, especificando las rutas de título de las etiquetas.

Admite extracción de facetas. Proporcionará bloques para cada etiqueta única, utilizando su ruta de título de etiqueta actual.

Propiedades

  • etiqueta

    ruta de título de etiqueta que buscar, por ejemplo, "Propiedades del recurso : Orientación / Horizontal"

  • N_value

    use 1_value, 2_value, … para buscar varias etiquetas (combinadas con OR de forma predeterminada, con AND if y=true) (desde 5.6)

  • propiedad

    propiedad (o ruta relativa a la propiedad) que se va a ver (predeterminado " cq:tags")

tagid

Busca contenido etiquetado con una o más etiquetas, especificando los ID de etiqueta.

Admite extracción de facetas. Proporcionará bloques para cada etiqueta única, utilizando su ID de etiqueta actual.

Propiedades

  • tagid

    id de etiqueta que buscar, por ejemplo, " properties:orientation/landscape"

  • N_value

    use 1_value, 2_value, … para comprobar si hay varios tagids (combinados con OR de forma predeterminada, con AND if y=true) (desde 5.6)

  • propiedad

    propiedad (o ruta relativa a la propiedad) que se va a ver (predeterminado " cq:tags")

tagsearch

Busca contenido etiquetado con una o más etiquetas, especificando palabras clave. Primero se buscan etiquetas que contengan estas palabras clave en sus títulos y luego se restringe el resultado a solo elementos etiquetados con estas palabras clave.

No admite la extracción de facetas.

Propiedades

  • tagsearch

    palabra clave para buscar en títulos de etiquetas

  • propiedad

    propiedad (o ruta relativa a la propiedad) que se va a ver (predeterminado " cq:tags")

  • lang

    para buscar solo en un determinado título de etiqueta localizado (por ejemplo, " de")

  • todo

    (bool) buscar texto completo de la etiqueta completa, es decir, todos los títulos, descripción, etc. (tiene prioridad sobre "l ang")

tipo

Restringe los resultados a un tipo de nodo JCR específico, tanto del tipo de nodo principal como del tipo de mezcla. También se encuentran subtipos de ese tipo de nodo. Tenga en cuenta que los índices de búsqueda del repositorio deben cubrir los tipos de nodo para una ejecución eficaz.

Admite extracción de facetas. Proporcionará bloques para cada tipo único en los resultados.

Propiedades

  • tipo

    tipo de nodo o nombre de mezcla que buscar, por ejemplo cq:Page

En esta página