Créer un index personnalisé pour les références de formulaire adaptatif create-custom-index-for-adaptive-forms-references

Créez un index Lucene balisé pour éviter les requêtes de traversée lorsque Adobe Experience Manager (AEM) Forms résout les références de formulaires adaptatifs. Sans index approprié, la publication d’un fragment d’expérience contenant une référence de formulaire adaptatif peut générer un avertissement Traversal query (query without index) dans les journaux.

Dans AEM Forms 6.5 LTS SP1 et versions ultérieures, la requête de référence utilise la balise d’index aemformsAFReferences. Ces versions incluent la modification de la requête, mais vous devez créer un index personnalisé avec cette balise. Cet article explique comment définir et déployer l’index.

Pour AEM Forms 6.5, voir Création d’un index personnalisé pour les références de formulaires adaptatifs dans AEM Forms 6.5.

Prérequis prerequisites

Avant de commencer, vérifiez que vous disposez des éléments suivants :

Testez l’index dans un environnement de développement ou d’évaluation avant de le déployer en production. La création d’un index peut prendre du temps sur un référentiel volumineux.

Définition de l’index personnalisé define-the-custom-index

Créez l’index à l’adresse /oak:index/customAFReferenceLuceneIndex-1. Vous pouvez choisir un autre nom de nœud d’index, mais ne modifiez pas la balise aemformsAFReferences afin que la requête de référence Forms puisse sélectionner l’index.

Utilisez la définition suivante. Il indexe les sling:resourceType sur nt:unstructured nœuds sous /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’ajoutez pas de analyzed=true. La requête de référence utilise des restrictions de propriété plutôt qu’une condition de contains en texte intégral, ce qui rend ce paramètre inutile.

Déployer l’index avec un package de contenu deploy-the-index-with-a-content-package

Utilisez un package de contenu pour les déploiements en production.

Si vous choisissez un autre nom d’index, utilisez-le de manière cohérente dans le répertoire, le filtre et le chemin d’accès au référentiel.

Création de l’index avec CRXDE Lite create-the-index-with-crxde-lite

Utilisez cette alternative dans un environnement de développement au lieu de la méthode du package de contenu.

Utilisez les propriétés suivantes lors de la création du nœud d’index :

String[] signifie une propriété String à plusieurs valeurs, même si elle ne contient qu’une seule valeur.

Vérifiez que la requête utilise l’index . verify-that-the-query-uses-the-index

Vérifiez le plan de requête pour vous assurer que la requête de référence sélectionne votre index personnalisé.

Si le plan ne sélectionne pas l’index personnalisé, vérifiez la balise , la hiérarchie des indexRules et la définition de propriété sling:resourceType par rapport aux exemples ci-dessus. Pour un diagnostic plus approfondi, voir Dépannage des index Oak.

Tâches connexes related-tasks

Pour plus d’informations sur les performances des requêtes et la configuration de l’index, voir :