Criar um índice personalizado para referências de formulário adaptáveis create-custom-index-for-adaptive-forms-references

Crie um índice Lucene marcado para evitar consultas de passagem quando o Adobe Experience Manager (AEM) Forms resolver referências de formulário adaptáveis. Sem um índice adequado, a publicação de um Fragmento de experiência que contenha uma referência de formulário adaptável pode produzir um aviso Traversal query (query without index) nos logs.

No AEM Forms 6.5.24.0 e posterior, a consulta de referência usa a marca de índice aemformsAFReferences. Essas versões incluem a alteração da consulta, mas você deve criar um índice personalizado com essa tag. Este artigo mostra como definir e implantar o índice.

Para o AEM Forms 6.5 LTS, consulte Criar um índice personalizado para referências de formulário adaptável no AEM Forms 6.5 LTS.

Pré-requisitos prerequisites

Antes de começar, verifique se você tem:

Teste o índice em um ambiente de desenvolvimento ou de preparo antes de implantá-lo na produção. A compilação de um índice pode demorar em um repositório grande.

Definir o índice personalizado define-the-custom-index

Criar o índice em /oak:index/customAFReferenceLuceneIndex-1. Você pode escolher um nome de nó de índice diferente, mas mantenha a marca aemformsAFReferences inalterada para que a consulta de referência do Forms possa selecionar o índice.

Use a definição a seguir. Ele indexa sling:resourceType em nt:unstructured nós em /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"
        }
      }
    }
  }
}

Não adicionar analyzed=true. A consulta de referência usa restrições de propriedade em vez de uma condição contains de texto completo, de modo que a configuração é desnecessária.

Implantar o índice com um pacote de conteúdo deploy-the-index-with-a-content-package

Use um pacote de conteúdo para implantações de produção.

Se você escolher um nome de índice diferente, use esse nome de forma consistente no diretório, filtro e caminho do repositório.

Criar o índice com o CRXDE Lite create-the-index-with-crxde-lite

Use essa alternativa em um ambiente de desenvolvimento, em vez do método do pacote de conteúdo.

Use as seguintes propriedades ao criar o nó de índice:

String[] significa uma propriedade de Cadeia de Caracteres de vários valores, mesmo quando contém apenas um valor.

Verificar se a consulta usa o índice verify-that-the-query-uses-the-index

Verifique o plano de consulta para confirmar se a consulta de referência seleciona o índice personalizado.

Se o plano não selecionar o índice personalizado, verifique a marca, a hierarquia indexRules e a definição de propriedade sling:resourceType em relação aos exemplos acima. Para obter mais diagnósticos, consulte Solução de problemas de índices do Oak.

Tarefas relacionadas related-tasks

Para obter mais informações sobre o desempenho da consulta e a configuração do índice, consulte: