Crear un índice personalizado para referencias de formularios adaptables create-custom-index-for-adaptive-forms-references

Cree un índice de Lucene etiquetado para evitar consultas de recorrido cuando Adobe Experience Manager (AEM) Forms resuelva referencias de formularios adaptables. Sin un índice adecuado, la publicación de un fragmento de experiencia que contenga una referencia de formulario adaptable puede producir una advertencia Traversal query (query without index) en los registros.

En AEM Forms 6.5.24.0 y versiones posteriores, la consulta de referencia usa la etiqueta de índice aemformsAFReferences. Estas versiones incluyen el cambio de consulta, pero debe crear un índice personalizado con esa etiqueta. Este artículo muestra cómo definir e implementar el índice.

Para AEM Forms 6.5 LTS, consulte Crear un índice personalizado para referencias de formularios adaptables en AEM Forms 6.5 LTS.

Requisitos previos prerequisites

Antes de empezar, asegúrese de que dispone de lo siguiente:

Pruebe el índice en un entorno de ensayo o desarrollo antes de implementarlo en producción. Crear un índice puede llevar tiempo en un repositorio grande.

Definición del índice personalizado define-the-custom-index

Cree el índice en /oak:index/customAFReferenceLuceneIndex-1. Puede elegir un nombre de nodo de índice diferente, pero mantenga la etiqueta aemformsAFReferences sin cambios para que la consulta de referencia de Forms pueda seleccionar el índice.

Utilice la siguiente definición. Indexa sling:resourceType en nt:unstructured nodos bajo /content.

{
  "jcr:primaryType": "oak:QueryIndexDefinition",
  "selectionPolicy": "tag",
  "compatVersion": 2,
  "includedPaths": ["/content"],
  "queryPaths": ["/content"],
  "tags": ["aemformsAFReferences"],
  "type": "lucene",
  "async": ["async"],
  "evaluatePathRestrictions": true,
  "reindex": false,
  "indexRules": {
    "jcr:primaryType": "nt:unstructured",
    "nt:unstructured": {
      "jcr:primaryType": "nt:unstructured",
      "properties": {
        "jcr:primaryType": "nt:unstructured",
        "resourceType": {
          "jcr:primaryType": "nt:unstructured",
          "propertyIndex": true,
          "name": "sling:resourceType"
        }
      }
    }
  }
}

No agregue analyzed=true. La consulta de referencia usa restricciones de propiedad en lugar de una condición de contains de texto completo, por lo que no es necesario establecer esta configuración.

Implementación del índice con un paquete de contenido deploy-the-index-with-a-content-package

Utilice un paquete de contenido para implementaciones de producción.

Si elige un nombre de índice diferente, utilice ese nombre de forma coherente en el directorio, filtro y ruta de acceso al repositorio.

Creación del índice con CRXDE Lite create-the-index-with-crxde-lite

Utilice esta alternativa en un entorno de desarrollo en lugar del método de paquete de contenido.

Utilice las siguientes propiedades al crear el nodo de índice:

String[] significa una propiedad String de varios valores, incluso cuando contiene sólo un valor.

Compruebe que la consulta utiliza el índice verify-that-the-query-uses-the-index

Compruebe el plan de consultas para confirmar que la consulta de referencia selecciona el índice personalizado.

Si el plan no selecciona el índice personalizado, compare la etiqueta, la jerarquía indexRules y la definición de propiedad sling:resourceType con los ejemplos anteriores. Para obtener más información, consulte Solución de problemas de índices Oak.

Tareas relacionadas related-tasks

Para obtener más información sobre el rendimiento de las consultas y la configuración de índices, consulte: