Referencia del predicado del generador de consultas

General

raíz

Este es 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 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 la página
  • p.guessTotal - recomendado: evite calcular el total del resultado completo, que puede resultar costoso; bien un número que indica el total máximo que se va a contar (por ejemplo, 1000, un número que proporciona 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 únicamente hasta el mínimo necesario p.offset + p.limit
  • p.excerpt - si se establece en true, incluya el 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 visitas estándar (ampliables mediante el servicio ResultHitWriter):
    • simple - elementos mínimos como path, title, lastmodified, excerpt (si están configurados)
    • full - renderización JSON de sling del nodo , con jcr:path que indica 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, 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)
    • selective - solo las propiedades especificadas en p.properties, que es una lista de rutas relativas separadas por espacios (se usa + en direcciones URL); si la ruta relativa tiene una profundidad, >1 se representarán como objetos secundarios; la jcr:path propiedad especial incluye la ruta de la visita

grupo

Este predicado permite generar condiciones anidadas. Los grupos pueden contener grupos anidados. Todo lo que hay en una consulta de Query Builder está implícito en un grupo raíz, que también puede tener parámetros p.or y p.not.

A continuación se muestra un ejemplo para 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 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

Esto busca el término Administración dentro de las páginas en /content/wknd/ch/de o en los recursos en /content/dam/wknd.

Conceptualmente es fulltext AND ( (path AND type) OR (path AND type) ). Tenga en cuenta que estas uniones O necesitan buenos índices por motivos de rendimiento.

Propiedades

  • p.or - si se establece en true, solo debe coincidir un predicado del grupo. El valor predeterminado es false, lo que significa que todas deben coincidir
  • p.not - si se establece en true, anula el grupo (el valor predeterminado es false)
  • <predicate> - agrega predicados anidados
  • N_<predicate> - añade varios predicados anidados del mismo tiempo, como 1_property, 2_property, ...

pedido por

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

  • orderby - bien el nombre de la propiedad JCR indicado por un @ inicial, por ejemplo @jcr:lastModified o @jcr:content/jcr:title, u otro predicado en la consulta, por ejemplo 2_property, en el que ordenar
  • sort - dirección de clasificación, ya sea desc para descendente o asc para ascendente (valor predeterminado)
  • case - si se establece en , ignore hará que la ordenación no distinga entre mayúsculas y minúsculas, lo que significa que a va antes de B; si está vacío o se ha excluido, la ordenación distingue entre mayúsculas y minúsculas, lo que significa que B va antes de a

Predicados

boolproperty

Este predicado coincide con las propiedades booleanas de 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 los indicadores booleanos que solo se establecen cuando están activados.

El parámetro heredado operation no tiene significado.

Este predicado admite la extracción de facetas y proporciona contenedores para cada valor true o false, pero solo para las propiedades existentes.

Propiedades

  • boolproperty - ruta relativa a la propiedad, por ejemplo myFeatureEnabled o jcr:content/myFeatureEnabled
  • value - valor para comprobar la propiedad, true o false

contentfragment

Este predicado 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 si hay fragmentos de contenido.

dateComparison

Este predicado compara dos propiedades de fecha JCR entre sí. Puede comprobar si son iguales, desiguales, buenos o buenos que o iguales.

Se trata de un predicado de solo filtrado y no puede aprovechar un índice de búsqueda.

Propiedades

  • property1 - ruta a la propiedad de primera fecha
  • property2 - ruta a la propiedad de segunda fecha
  • operation
    • = para coincidencia exacta (predeterminado)
    • != para comparación de desigualdad
    • > para property1 buenos property2
    • >= para property1 bueno o igual a property2

daterange

Este predicado coincide con las propiedades de fecha de JCR con respecto a un intervalo de fecha y hora. Utiliza la norma 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 hora POSIX.

Puede buscar cualquier cosa entre dos marcas de tiempo, cualquier cosa más reciente o anterior que una fecha determinada, y también elegir entre intervalos abiertos e inclusivos.

Admite la extracción de facetas y proporciona buckets today, this week, this month, last 3 months, this year, last year y earlier than last year.

No admite el filtrado.

Propiedades

  • property - ruta relativa a una DATE propiedad, por ejemplo jcr:lastModified
  • lowerBound - fecha inferior enlazada para comprobar la propiedad, 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, por ejemplo 2014-10-01T12:15:00
  • upperOperation - < (mayor) o <= (mayor o menor), se aplica a upperBound. 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

Este predicado excluye los nodos del resultado donde su ruta coincide con una expresión regular.

Se trata de un predicado de solo filtrado y no puede aprovechar un índice de búsqueda.

No admite la extracción de facetas.

Propiedades

  • excludepaths : la expresión regular coincide con las rutas de resultados, excluyendo las coincidentes del resultado.

texto completo

Este predicado busca términos en el índice de texto completo.

No admite el filtrado.

No admite la extracción de facetas.

Propiedades

  • fulltext - los términos de búsqueda de texto completo
  • relPath - la ruta relativa para buscar en la propiedad o subnodo. Esta propiedad es opcional.

hasPermission

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

Se trata de un predicado de solo 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 ALL para el nodo en cuestión; por ejemplo jcr:write, jcr:modifyAccessControl

language

Este predicado encuentra AEM páginas en un idioma específico. Esto examina tanto la propiedad idioma de la página como la ruta de la página, que a menudo incluye el idioma o la configuración regional en una estructura de sitio de nivel superior.

Se trata de un predicado de solo filtrado y no puede aprovechar un índice de búsqueda.

Admite la extracción de facetas y proporciona contenedores para cada código de idioma único.

Propiedades

  • language - Código de idioma ISO, por ejemplo de

mainasset

Este predicado comprueba si un nodo es un activo principal de DAM y no un subactivo. Básicamente se trata de todos los nodos que no están dentro de un nodo de subrecursos. Tenga en cuenta que esto no comprueba el tipo de nodo dam:Asset. Para usar este predicado, simplemente configure mainasset=true o mainasset=false. No hay más propiedades.

Se trata de un predicado de solo filtrado y no puede aprovechar un índice de búsqueda.

Admite la extracción de facetas y proporciona dos bloques para los recursos principales y secundarios.

Propiedades

  • mainasset : booleano, true para recursos principales, false para subrecursos

memberOf

Este predicado encuentra elementos que son miembros de una colección de recursos de sling específica.

Se trata de un predicado de solo filtrado y no puede aprovechar un índice de búsqueda.

No admite la extracción de facetas.

Propiedades

  • memberOf - ruta de la recopilación de recursos de Sling

nombre de nodo

Este predicado coincide con los nombres de nodos JCR.

Admite la extracción de facetas y proporciona contenedores para cada nombre de nodo único (nombre de archivo).

Propiedades

  • nodename - patrón de nombre de nodo que permite comodines: * = cualquier carácter o ningún carácter, ? = cualquier carácter, [abc] = solo caracteres entre corchetes

notexpired

Este predicado coincide con elementos comprobando si una propiedad de fecha JCR es buena o igual a la hora del servidor actual. Se puede usar para comprobar un valor expiresAt y limitar los resultados a solo aquellos que aún no hayan caducado (notexpired=true) o que ya hayan 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 aún no caducado (fecha futura o igual), false para caducado (fecha anterior) (obligatorio)
  • property - ruta relativa a la DATE propiedad que se va a comprobar (obligatorio)

path

Este predicado busca dentro de una ruta determinada.

No admite la extracción de facetas.

Propiedades

  • path - Define el patrón de ruta.
    • Dependiendo de la propiedad exact, todo el subárbol coincidirá (como anexar //* en xpath, pero tenga en cuenta que esto no incluye la ruta base) o solo coincidirá una ruta exacta, que puede incluir caracteres comodín (*).
      • El valor predeterminado es true
    • Si se establece la propiedad self, se buscará en todo el subárbol, incluido el nodo base.
  • exact - si exact es true, la ruta exacta debe coincidir, pero puede contener caracteres comodín simples (*), que coincidan con los nombres, pero no /; si es false (predeterminado), se incluyen todos los descendientes (opcional)
  • flat - busca solo los elementos secundarios directos (como anexar /* en xpath) (solo se usa si no exact es true, opcional)
  • self - busca en el subárbol pero incluye el nodo base dado como ruta (sin comodines)

propiedad

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

  • property - ruta relativa a la propiedad, por ejemplo jcr:title
  • value - valor para comprobar la propiedad; sigue al tipo de propiedad JCR a las conversiones de cadena
  • N_value - utilice 1_value, 2_value, … para comprobar si hay varios valores (combinados con OR de forma predeterminada, con AND if and=true)
  • and - se configura como true para combinar varios valores (N_value) con AND
  • operation
    • equals para coincidencia exacta (predeterminado)
    • unequals para comparación de desigualdad
    • like para utilizar la función jcr:like xpath (opcional)
    • not para que no haya coincidencia (por ejemplo, not(@prop) en xpath, se ignorará el parámetro value )
    • exists para la comprobación de existencia
      • true la propiedad debe existir
      • false es el mismo que not y es el valor predeterminado
  • depth - número de niveles comodín debajo de los cuales puede existir la propiedad/ruta relativa (por ejemplo, property=size depth=2 comprobará node/size, node/*/size y node/*/*/size)

rangeproperty

Este predicado coincide con una propiedad JCR respecto a un intervalo. Esto 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, un límite superior o ambos. La operación (por ejemplo, menor o menor que o igual a) también se puede especificar individualmente para los límites inferior y superior.

No admite la extracción de facetas.

Propiedades

  • property - ruta relativa a la propiedad
  • lowerBound - límite inferior para comprobar la propiedad
  • lowerOperation - > (predeterminado) o >=, se aplica a la variable lowerValue
  • upperBound - límite superior para comprobar la propiedad
  • upperOperation - < (predeterminado) o <=, se aplica a la variable lowerValue
  • decimal - true si la propiedad marcada es del tipo Decimal

relativedaterange

Este predicado coincide con JCR DATE propiedades en comparación con un intervalo de fecha y hora mediante desplazamientos de tiempo relativos a la hora del servidor actual. Puede especificar lowerBound y upperBound utilizando 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 tendrá el valor predeterminado 0, que representa la hora actual.

Por ejemplo:

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

Tenga en cuenta que no toma años bisiestos en consideración 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 - 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, siete años) en relación con la hora del servidor actual, utilice - para compensación negativa
  • 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 actual del servidor, utilice - para compensación negativa

savedquery

Este predicado incluye todos los predicados de una consulta de Query Builder persistente en la consulta actual como un predicado de subgrupo.

Tenga en cuenta que esto no ejecutará una consulta adicional sino que extenderá la consulta actual.

Las consultas se pueden mantener mediante programación utilizando QueryBuilder#storeQuery(). El formato puede ser una propiedad multilínea String 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

  • savedquery - ruta a la consulta guardada (String propiedad o nt:file nodo)

similar

Este predicado es una búsqueda de similitud usando rep:similar() de JCR XPath.

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

Propiedades

  • similar - ruta absoluta al nodo para el que encontrar nodos similares
  • local - una ruta relativa a un nodo descendiente o . para el nodo actual (opcional, el valor predeterminado es .)

etiqueta

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 la ruta de título de etiqueta actual.

Propiedades

  • tag - ruta de título de etiqueta que se va a buscar, por ejemplo properties:orientation/landscape
  • N_value - utilice 1_value, 2_value, … para comprobar si hay varias etiquetas (combinadas con OR de forma predeterminada, con AND if and=true)
  • property - propiedad (o ruta relativa a la propiedad) a ver (valor predeterminado cq:tags)

tagid

Este predicado busca contenido etiquetado con una o más etiquetas, especificando los ID de las etiquetas.

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

Propiedades

  • tagid - ID de etiqueta que se debe buscar, por ejemplo properties:orientation/landscape
  • N_value - utilice 1_value, 2_value, … para comprobar si hay varios ID de etiqueta (combinados con OR de forma predeterminada, con AND if and=true)
  • property - propiedad (o ruta relativa a la propiedad) a ver (valor predeterminado cq:tags)

tagsearch

Este predicado busca contenido etiquetado con una o más etiquetas, especificando palabras clave. Primero buscará las etiquetas que contengan estas palabras clave en sus títulos y luego restringirá el resultado a solo los elementos etiquetados con ellas.

No admite la extracción de facetas.

Propiedades

  • tagsearch - palabra clave para buscar en títulos de etiquetas
  • property - propiedad (o ruta relativa a la propiedad) a considerar (predeterminado cq:tags)
  • lang - para buscar solo en un título de etiqueta localizado (p. ej. de)
  • all - valor booleano para buscar todo el texto completo de la etiqueta, es decir, todos los títulos, descripción, etc. (tiene prioridad sobre lang)

tipo

Este predicado restringe los resultados a un tipo de nodo JCR específico, tanto tipos de nodo primario como tipos de mezcla. También se encontrarán subtipos de ese tipo de nodo. Tenga en cuenta que los índices de búsqueda del repositorio deben cubrir los tipos de nodos para una ejecución eficiente.

Admite la extracción de facetas y proporciona contenedores para cada tipo único en los resultados.

Propiedades

  • type - tipo de nodo o nombre de mezcla para buscar, por ejemplo cq:Page

En esta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now