DocumentaciónAEM 6.5 LTSGuía del usuario

Referencia de predicados del generador de consultas query-builder-predicate-reference

Last update: Fri Jan 30 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Se aplica a:
  • Experience Manager 6.5 LTS
  • Temas:

Creado para:

  • Desarrollador
CAUTION
La información de esta página no es exhaustiva.
Para obtener información completa, consulte la lista en Predicados disponibles en la consola de Query Builder Debugger; por ejemplo, en:
Por ejemplo, consulte:

General general

Predicados predicates

boolproperty boolproperty

Coincide en las propiedades BOOLEANAS JCR. Solo acepta los valores " true" y " false". Si se establece en " false", coincide si la propiedad tiene el valor " false" o si no existe. Útil para comprobar indicadores booleanos que solo se establecen cuando están habilitados.

El parámetro " operation" heredado no tiene significado.

Admite la extracción de facetas. Proporciona bloques para cada valor true o false, pero solo para las propiedades existentes.

Propiedades properties

  • boolproperty
    Ruta relativa a la propiedad, por ejemplo, myFeatureEnabled o jcr: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

  • fragmento de contenido
    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.

Un predicado solo de filtrado y no puede utilizar un índice de búsqueda.

Propiedades properties-2

  • propiedad1

    Ruta a la primera propiedad de fecha.

  • propiedad2

    Ruta a la segunda propiedad de fecha.

  • operación

    " equals" para la coincidencia exacta, " !=" para la comparación de desigualdad, " greater" para la propiedad1 mayor que la propiedad2, " >=" para la propiedad1 mayor o igual que la propiedad2. El valor predeterminado es " equals".

daterange daterange

Hace coincidir las propiedades DATE de JCR con un intervalo de fecha y hora. Utiliza el ISO8601
formato 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 la extracción de facetas. Proporciona bloques "hoy", "esta semana", "este mes", "los últimos 3 meses", "este año", "el año pasado" y "anteriores al año pasado".

No admite el filtrado.

Propiedades properties-3

  • propiedad

    Ruta relativa a una propiedad DATE, por ejemplo, jcr:lastModified.

  • lowerBound

    La fecha inferior enlazada a la propiedad check de, por ejemplo, 2014-10-01.

  • lowerOperation

    " >" (más reciente) o " >=" (más reciente o más reciente) se aplica a lowerBound. El valor predeterminado es " >".

  • upperBound

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

  • upperOperation

    " <" (anterior) o " <=" (igual o anterior) se aplica a upperBound. El valor predeterminado es " <".

  • zona horaria

    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.

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.

fulltext 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.

group group

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 también puede tener p.or y p.not parámetros.

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 (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

Busca el término "Administración" en las páginas de /content/geometrixx/en o en los recursos de /content/dam/geometrixx.

Conceptualmente fulltext AND ( (path AND type) OR (path AND type) ). Estas uniones OR necesitan buenos índices para el rendimiento.

Propiedades properties-6

  • p.o

    Si se establece en "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 en " true", se anula el grupo (el valor predeterminado es " false").

  • <predicado>

    Agrega predicados anidados.

  • N_<predicado>

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

hasPermission haspermission

Restringe el resultado a elementos en los que la sesión actual tiene los privilegios JCR especificados.

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.

Un predicado solo de filtrado y no puede utilizar un índice de búsqueda.

Admite la 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".

mainasset mainasset

Comprueba si un nodo es un recurso principal DAM y no un subrecurso. Básicamente, cada nodo no está dentro de un nodo "subrecursos". No comprueba el tipo de nodo dam:Asset. 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 bloques para los recursos principal y secundario.

Propiedades properties-9

  • recurso principal

    Booleano, " true" para recursos principales, " false" para subrecursos.

memberOf memberof

Busca elementos que sean miembros de una colección de recursos de sling específica.

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.

nodename nodename

Coincide con los nombres de nodo JCR.

Admite la 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: * = cualquiera 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 usar para comprobar una "expiresAt" como la propiedad de 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 aún (fecha futura o igual), " false" para caducado (fecha anterior) (obligatorio).

  • propiedad

    Ruta relativa a la propiedad DATE 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, o por otro predicado de la consulta, por ejemplo, 2_property, en el que ordenar.

  • ordenar

    Dirección de orden: "desc" para descendente o "asc" para ascendente (predeterminado).

  • caso

    Si se establece en ignore, la ordenación no distingue entre mayúsculas y minúsculas, lo que significa que "a" va antes que "B"; si está vacía o se omite, 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. Si se usa exact=false (valor predeterminado), la búsqueda coincidirá con todo el subárbol de la ruta de acceso especificada (similar a la adición de //* en XPath), pero no incluirá la propia ruta de acceso base. Cuando exact=true, la búsqueda coincide únicamente con la ruta de acceso exacta, que puede incluir * caracteres comodín. Si se establece self, la búsqueda incluye el nodo base y todo su subárbol.

  • exacto

    Si exact es verdadero (activado), la ruta de acceso exacta debe coincidir, pero puede contener caracteres comodín simples ( *), que coincidan con los nombres, pero no con " /"; si es falso (predeterminado), se incluyen todos los descendientes (opcional).

  • piso

    Busca sólo los elementos secundarios directos (como anexar "/*" en xpath) (sólo se usa si 'exact' no es verdadero, opcional).

  • auto

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

property property

Coincide en las propiedades JCR y sus valores.

Admite la 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.

  • Valor_N

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

  • y

    Establezca como true para combinar varios valores (N_value) con AND (desde 5.3).

  • operación

    Use equals para una coincidencia exacta (predeterminado) y unequals para una comparación de desigualdad. Use like para aplicar la función XPath jcr:like opcional. Use not para que no haya coincidencias (por ejemplo, not(@prop) en XPath); en este caso, se omite el parámetro value. Use exists para comprobar si existe una propiedad: true (predeterminado) requiere la propiedad y false es equivalente a not.

  • profundidad

    Varios niveles comodín por debajo de los cuales puede existir la propiedad y la ruta relativa. Por ejemplo, property=size depth=2 comprueba el nodo y su tamaño, node/*/size y node/*/*/size.

rangeproperty rangeproperty

Hace coincidir una propiedad JCR con un intervalo. Se aplica a 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 a lowerValue

  • upperBound

    Límite superior para comprobar la propiedad de.

  • upperOperation

    " <" (predeterminado) o " <=" se aplica a lowerValue

  • decimal

    " true" si la propiedad marcada es de tipo Decimal

relativedaterange relativedaterange

Hace coincidir las propiedades de JCR DATE con un intervalo de fecha y hora mediante desplazamientos de tiempo en relación con la hora actual del servidor. Puede especificar lowerBound y upperBound mediante un valor de milisegundos o la sintaxis de bugzilla 1s 2m 3h 4d 5w 6M 7y. El prefijo "-" indica 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 ningún lowerBound) seleccionaría nada en la siguiente hora
  • lowerBound=-1d (y ningún upperBound) seleccionaría nada en las últimas 24 horas
  • lowerBound=-6M y upperBound=-3M seleccionarían cualquier cosa de 6 meses a 3 meses de edad
  • lowerBound=-1500 y upperBound=5500 seleccionarían cualquier valor entre 1500 milisegundos en el pasado y 5500 milisegundos en el futuro
  • lowerBound=1d y upperBound=2d seleccionarían 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

    La fecha superior enlazada en milisegundos o 1s 2m 3h 4d 5w 6M 7y (un segundo, dos minutos, tres horas, cuatro días, cinco semanas, seis meses o siete años) con respecto al tiempo actual del servidor, utilice "-" para el desplazamiento negativo.

  • lowerBound

    Reduzca el límite de la fecha en milisegundos o 1s 2m 3h 4d 5w 6M 7y (un segundo, dos minutos, tres horas, cuatro días, cinco semanas, seis meses o siete años) en relación con el tiempo actual del servidor, use "-" para el desplazamiento negativo.

root 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

    Para evitar el coste de calcular un total de resultados completo, no cuente todas las coincidencias. En su lugar, establezca un total máximo que contar (por ejemplo, 1000) para dar a los usuarios un tamaño aproximado y totales exactos para resultados más pequeños. O establézcalo en true para contar solamente hasta el mínimo requerido: p.offset + p.limit.

  • p.extracto

    Si se establece en " true", incluya un 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 se establecieron).

    • completo:

      Los resultados se representan como Sling JSON para cada nodo, y jcr:path muestra la ruta de la visita. De manera predeterminada, la respuesta incluye solamente las propiedades directas del nodo; use p.nodedepth=N para incluir contenido más profundo, donde 0 devuelve todo el subárbol. Establezca p.acls=true para incluir los permisos JCR de la sesión actual para cada elemento (create = add_node, modify = set_property, delete = remove).

    • selectivo:

      La respuesta incluye únicamente las propiedades enumeradas en p.properties, que es una lista de rutas relativas separadas por espacios (utilice + en las direcciones URL). Si una ruta relativa tiene una profundidad mayor que 1, la salida la anida como objetos secundarios. La propiedad especial jcr:path siempre incluye la ruta de acceso 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.

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 multilínea o un nodo nt:file que contenga 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 de acceso a la consulta guardada (propiedad String o nodo nt:file).

similar similar

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

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

Propiedades properties-20

  • similar
    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 " .").

tag tag

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

Admite la 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".

  • Valor_N

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

  • propiedad

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

tagid tagid

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

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

Propiedades properties-22

  • tagid

    Id. de etiqueta para que pueda buscar, por ejemplo, " properties:orientation/landscape".

  • Valor_N

    Use 1_value, 2_value, … para buscar varios tagids (combinados con OR de forma predeterminada, con AND si y = true) (desde 5.6).

  • propiedad

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

tagsearch tagsearch

Busca contenido etiquetado con una o más etiquetas, especificando palabras clave. Busca primero las etiquetas que contienen estas palabras clave en sus títulos y, a continuación, restringe el resultado únicamente a los elementos etiquetados.

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 únicamente 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".

type type

Restringe los resultados a un tipo de nodo JCR específico, tanto el tipo de nodo principal como el tipo de mezcla, y 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. Proporciona bloques para cada tipo único en los resultados.

Propiedades Properties-2

  • tipo

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

recommendation-more-help
51c6a92d-a39d-46d7-8e3e-2db9a31c06a2