Enregistrer des types de ressources personnalisés registering-custom-asset-types
Activez des types de ressources personnalisés pour une liste dans le portail AEM Forms.
Spécifier le chemin d’accès de base specify-base-path
Le chemin d’accès de base est le chemin d’accès du référentiel de niveau supérieur qui comprend toutes les ressources qu’un utilisateur ou une utilisatrice peut vouloir répertorier dans le composant Search & Lister. Si vous le souhaitez, l’utilisateur ou l’utilisatrice peut également configurer des emplacements spécifiques dans le chemin d’accès de base à partir de la boîte de dialogue de modification des composants, de sorte que la recherche soit déclenchée à des emplacements spécifiques plutôt que de rechercher tous les nœuds dans le chemin d’accès de base. Par défaut, le chemin d’accès de base est utilisé comme critère de chemin d’accès de recherche pour récupérer les ressources, sauf si l’utilisateur ou l’utilisatrice configure un ensemble de chemins d’accès spécifiques à partir de cet emplacement. Il est important de disposer d’une valeur optimale de ce chemin d’accès pour effectuer une recherche performante. La valeur par défaut du chemin d’accès de base reste /content/dam/formsanddocuments car toutes les ressources AEM Forms résident dans /content/dam/formsanddocuments.
Étapes à suivre pour configurer le chemin de base
-
connectez-vous à CRX ;
-
Accédez à /libs/fd/fp/extensions/querybuilder/basepath
-
Cliquez sur « nœud de recouvrement » dans la barre d’outils.
-
Assurez-vous que l’emplacement de recouvrement est « /apps/ ».
-
Cliquez sur OK.
-
Cliquez sur Enregistrer.
-
Accédez à la nouvelle structure créée à l’adresse /apps/fd/fp/extensions/querybuilder/basepath
-
Remplacez la valeur de la propriété du chemin d’accès par « /content/dam ».
-
Cliquez sur Enregistrer.
En spécifiant la propriété du chemin d’accès sur « /content/dam », vous définissez simplement le chemin d’accès de base sur /content/dam. Vous pouvez le vérifier en ouvrant le composant Search & Lister.
Enregistrer des types de ressources personnalisés register-custom-asset-types
Nous avons ajouté un nouvel onglet (Liste des ressources) dans le composant Search & Lister. Cet onglet répertorie les types de ressources prêts à l’emploi et les types de ressources supplémentaires que vous configurez. Par défaut, les types de ressources suivants sont répertoriés :
- Formulaires adaptatifs
- Modèles de formulaire
- Formulaires PDF
- Document (PDF statiques)
Étapes à suivre pour enregistrer un type de ressource personnalisé
-
Créez un nœud de recouvrement de /libs/fd/fp/extensions/querybuilder/assettypes
-
Définissez l’emplacement du recouvrement sur « /apps ».
-
Accédez à la nouvelle structure créée à l’adresse
/apps/fd/fp/extensions/querybuilder/assettypes. -
Sous cet emplacement, créez un nœud « nt:unstructured » pour le type à enregistrer, et nommez le nœud mp4files. Ajoutez les deux propriétés suivantes à ce nœud mp4files.
- Ajoutez la propriété jcr:title pour spécifier le nom d’affichage du type de ressource. Définissez la valeur de jcr:title sur « Fichiers Mp4 ».
- Ajoutez la propriété « type » et définissez sa valeur sur « vidéos ». Il s’agit de la valeur que nous utilisons dans notre modèle pour répertorier les ressources de type vidéo. Enregistrez vos modifications.
-
Créez un nœud de type « nt:unstructured » sous mp4files. Nommez ce nœud « searchcriteria ».
-
Ajoutez un ou plusieurs filtres sous les critères de recherche. Supposons que l’utilisateur ou l’utilisatrice souhaite avoir un filtre de recherche pour répertorier les fichiers mp4 dont le type MIME est « video/mp4 ». Vous pouvez le faire ici.
-
Créez un nœud de type « nt:unstructured » sous le nœud searchcriteria. Nommez ce noeud « filetypes ».
-
Ajoutez les 2 propriétés suivantes à ce nœud « filetypes »
- Nom :/jcr:content/metadata/dc:format
- Valeur : video/mp4
-
Cela signifie que les ressources dont la propriété dc:format est égale à video/mp4 sont considérées comme un type de ressource « Vidéos Mp4 ». Vous pouvez utiliser n’importe quelle propriété répertoriée sur le noeud « jcr:content/metadata » comme critère de recherche.
-
Veillez à enregistrer votre travail.
Une fois les étapes ci-dessus effectuées, le nouveau type de ressource (Fichiers Mp4) s’affiche dans la liste déroulante Types de ressources du composant Search & Lister, comme illustré ci-dessous.
Si vous rencontrez des problèmes, importez le package suivant.Deux types de ressources personnalisés composent le package. Fichiers Mp4 et documents Word. Consultez /apps/fd/fp/extensions/querybuilder/assettypes
Installez le package customeportal. Il contient un exemple de page de portail. Cette page est utilisée dans la 2ème partie du tutoriel.