Configuration de la recherche dans l’interface utilisateur d’AEM Assets id192SC800MY4

Par défaut, AEM ne reconnaît pas le contenu DITA, il ne fournit donc aucun mécanisme pour rechercher le contenu DITA dans son référentiel. AEM Guides vous permet d’ajouter la fonctionnalité de recherche de contenu DITA dans AEM référentiel.

Par défaut, AEM ne reconnaît pas le contenu DITA, il ne fournit donc aucun mécanisme pour rechercher le contenu DITA dans son référentiel. En outre, il n’existe aucune fonctionnalité prête à l’emploi pour rechercher du contenu en fonction de leur UUID. AEM Guides vous permet d’ajouter les fonctionnalités de recherche de contenu DITA et de recherche UUID dans le référentiel AEM.

La configuration de la recherche de contenu DITA implique les tâches suivantes :

Outre la fonctionnalité de recherche, vous pouvez configurer les dossiers qui ne doivent pas être inclus dans la recherche. Pour plus d’informations, voir Exclure les fichiers temporaires des résultats de recherche.

Ajout d’un composant de recherche d’éléments DITA dans l’interface utilisateur d’Assets id192SF0F50HS

Procédez comme suit pour ajouter le composant de recherche de contenu DITA dans l’interface utilisateur d’AEM Assets :

Ajout d’un composant de recherche basé sur l’UUID dans l’interface utilisateur Assets id2034F04K05Z

Procédez comme suit pour ajouter un composant de recherche basé sur l’UUID dans l’interface utilisateur d’AEM Assets :

Octroi d’autorisations aux utilisateurs id192SF0G0RUI

Les auteurs et les éditeurs doivent disposer d’autorisations explicites pour pouvoir accéder aux fonctionnalités de recherche à partir de l’interface utilisateur d’Assets. Si vous n’accordez pas ces autorisations, vos utilisateurs ne pourront pas rechercher du contenu DITA en fonction de leurs valeurs d’élément/attribut ou UUID.

Effectuez les étapes suivantes pour accorder l’accès à la fonction de recherche DITA :

L’utilisateur ou le groupe d’utilisateurs sélectionné aura désormais accès à la fonctionnalité de contenu DITA de recherche dans l’interface utilisateur d’Assets.

Ajout d’éléments ou d’attributs personnalisés dans la recherche id192SF0G10YK

Pour que la recherche DITA fonctionne, un certain prétraitement du contenu DITA est requis. Cette étape de prétraitement extrait le contenu sélectif des différents mappages et rubriques DITA afin qu’il puisse être indexé pour une recherche plus rapide. En interne, ce processus est appelé Sérialisation. La sérialisation des fichiers DITA a lieu pendant le chargement du contenu ou peut également être exécutée à la demande. Il utilise un fichier de configuration pour déterminer la quantité de contenu de chaque fichier DITA à indexer. L’emplacement par défaut du fichier de sérialisation est le suivant :

/libs/fmdita/config/serializationconfig.xml

La configuration de recherche par défaut vous permet de rechercher tous les éléments et attributs dans le DITA. prolog élément . Si vous souhaitez effectuer une recherche en fonction d’autres éléments ou attributs, vous devez configurer le fichier de sérialisation de la recherche.

Ce fichier contient deux sections principales : jeu d’attributs et jeu de règles. Vous trouverez ci-dessous un extrait de la section du jeu de règles :

<ruleset filetypes="xml dita"><!-- Element rules --><rule xpath="//[contains(@class, 'topic/topic')]/[contains(@class, 'topic/prolog')]//*[not(*)]" text="yes" attributeset="all-attrs" /><!-- Attribute rules --><rule xpath="//[contains(@class, 'topic/topic')]/[contains(@class, 'topic/prolog')]///@[local-name() != 'class']" /></ruleset>

Dans la section du jeu de règles, vous pouvez spécifier :

Une règle se compose des éléments suivants :

xpath : il s’agit de la requête XPath qui récupère les éléments ou les attributs des fichiers DITA. La configuration par défaut de la règle d’élément récupère toutes les prolog éléments . Et la configuration par défaut de la règle d’attribut récupère tous les attributs de prolog éléments . Vous pouvez spécifier une requête XPath pour sérialiser les éléments ou attributs que vous souhaitez rechercher.

La requête XPath contient le nom de classe du type de document. La variable topic/topic est utilisée pour les documents DITA de type rubrique. Si vous souhaitez créer une règle pour d’autres documents DITA, vous devez utiliser les noms de classe suivants :

text : si vous souhaitez rechercher le texte dans l’élément spécifié, indiquez la valeur oui. Si vous spécifiez non comme valeur, seuls les attributs de l’élément sont sérialisés. Les attributs que vous souhaitez rechercher doivent être spécifiés dans la section du jeu d’attributs .

attributeset : spécifiez l’identifiant du jeu d’attributs que vous souhaitez associer à cette règle. La valeur all-attrs est un cas spécial pour indiquer que tous les attributs de cette règle doivent être sérialisés.

Un jeu d’attributs contient une liste d’attributs que vous souhaitez rechercher dans le contenu DITA. Le jeu d’attributs contient les éléments suivants :

id : identifiant unique du jeu d’attributs. Cet identifiant est spécifié dans le paramètre attributeset d’un jeu de règles.

attribute : liste des attributs que vous souhaitez rechercher. Pour chaque attribut, vous devez créer une entrée individuelle dans la variable attribute élément .

Effectuez les étapes suivantes pour ajouter des éléments ou des attributs DITA personnalisés dans le fichier de sérialisation de recherche :

Les nouvelles informations de sérialisation sont stockées et activées pour la recherche. Cependant, vous devez extraire les métadonnées de votre contenu DITA existant pour pouvoir les rechercher.

Extraction des métadonnées du contenu existant id192SF0GA0HT

Une fois que vous avez apporté des modifications au fichier de sérialisation de recherche par défaut, vous devez activer l’option Extraction des métadonnées DITA dans la variable com.adobe.config.ConfigManager regroupez et exécutez ensuite le workflow pour extraire les métadonnées. Cette opération extrait les métadonnées requises des fichiers DITA existants, puis les rend disponibles pour la recherche.

Si vous créez des fichiers ou modifiez un fichier après la mise à jour du fichier de sérialisation, les métadonnées sont automatiquement extraites de ces fichiers. Le processus d’extraction des métadonnées n’est nécessaire que pour les fichiers qui existent déjà dans le référentiel AEM.

L’extraction de métadonnées à partir de fichiers DITA existants implique deux tâches :

Effectuez les étapes suivantes pour activer l’option d’extraction des métadonnées dans configMgr :

Effectuez les étapes suivantes pour exécuter le workflow d’extraction de métadonnées :

Exclure les fichiers temporaires des résultats de recherche id197AHI0035Z

Par défaut, la recherche est effectuée sur l’ensemble du référentiel d’AEM. Il peut y avoir certains emplacements que vous souhaitez exclure de la recherche. Par exemple, lorsque vous lancez le processus de traduction de contenu, les fichiers non approuvés restent dans un emplacement de dossier temporaire. Lorsque vous effectuez la recherche, les fichiers de cet emplacement temporaire sont également renvoyés dans les résultats de la recherche.

Pour empêcher AEM Guides de rechercher l’emplacement du dossier de traduction temporaire, vous devez ajouter un emplacement de dossier temporaire dans la liste d’exclusion.

Pour exclure le dossier de traduction temporaire de la recherche, procédez comme suit :