Creare un indice personalizzato per i riferimenti ai moduli adattivi create-custom-index-for-adaptive-forms-references

Crea un indice Lucene con tag per evitare query trasversali quando Adobe Experience Manager (AEM) Forms risolve i riferimenti ai moduli adattivi. Senza un indice appropriato, la pubblicazione di un frammento di esperienza contenente un riferimento a un modulo adattivo può produrre un avviso Traversal query (query without index) nei registri.

In AEM Forms 6.5.24.0 e versioni successive, la query di riferimento utilizza il tag di indice aemformsAFReferences. Queste versioni includono la modifica della query, ma è necessario creare un indice personalizzato con tale tag. Questo articolo mostra come definire e distribuire l’indice.

Per AEM Forms 6.5 LTS, consulta Creare un indice personalizzato per i riferimenti ai moduli adattivi in AEM Forms 6.5 LTS.

Prerequisiti prerequisites

Prima di iniziare, assicurati di avere:

Verifica l’indice in un ambiente di sviluppo o di staging prima di distribuirlo in produzione. La creazione di un indice può richiedere tempo in un repository di grandi dimensioni.

Definire l’indice personalizzato define-the-custom-index

Creare l’indice in /oak:index/customAFReferenceLuceneIndex-1. È possibile scegliere un nome di nodo di indice diverso, ma mantenere il tag aemformsAFReferences invariato in modo che la query di riferimento Forms possa selezionare l’indice.

Utilizza la seguente definizione. Indica sling:resourceType nei nodi nt:unstructured in /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"
        }
      }
    }
  }
}

Non aggiungere analyzed=true. La query di riferimento utilizza restrizioni di proprietà anziché una condizione contains full-text, pertanto l’impostazione non è necessaria.

Distribuire l’indice con un pacchetto di contenuti deploy-the-index-with-a-content-package

Utilizza un pacchetto di contenuti per le distribuzioni di produzione.

Se hai scelto un nome di indice diverso, utilizza tale nome in modo coerente nella directory, nel filtro e nel percorso dell’archivio.

Creare l’indice con CRXDE Lite create-the-index-with-crxde-lite

Utilizza questa alternativa in un ambiente di sviluppo invece del metodo del pacchetto di contenuti.

Utilizza le seguenti proprietà quando crei il nodo di indice:

String[] indica una proprietà String con più valori, anche se contiene un solo valore.

Verificare che la query utilizzi l’indice verify-that-the-query-uses-the-index

Controllare il piano di query per verificare che la query di riferimento selezioni l’indice personalizzato.

Se il piano non seleziona l’indice personalizzato, controllare il tag, la gerarchia indexRules e la definizione della proprietà sling:resourceType rispetto agli esempi precedenti. Per ulteriori diagnosi, vedere Risoluzione dei problemi relativi agli indici Oak.

Attività correlate related-tasks

Per ulteriori informazioni sulle prestazioni delle query e sulla configurazione degli indici, consulta: