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

Par défaut, AEM ne reconnaît pas le contenu DITA. Par conséquent, il ne fournit aucun mécanisme pour rechercher du 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 son UUID. AEM Guides vous permet d'ajouter les fonctionnalités de recherche de contenu DITA et de recherche basée sur l'UUID dans le référentiel AEM.

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

Outre l’ajout de la fonctionnalité de recherche, vous pouvez également 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 la recherche.

Ajout du composant Recherche d’éléments DITA dans l’interface utilisateur d’Assets id192SF0F50HS

Pour ajouter un composant de recherche de contenu DITA à l'interface utilisateur d'AEM Assets, procédez comme suit :

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

Pour ajouter un composant de recherche basé sur l’UUID à l’interface utilisateur d’AEM Assets, procédez comme suit :

Fournir des 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 de leur UUID.

Pour fournir l'accès à la fonction de recherche DITA, procédez comme suit :

L’utilisateur ou le groupe d’utilisateurs sélectionné aura désormais accès à la fonction de recherche de contenu DITA 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 prétraitement du contenu DITA est nécessaire. Cette étape de prétraitement extrait le contenu sélectif des cartes et rubriques DITA individuelles afin de pouvoir l'indexer pour accélérer la recherche. 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 :

/libs/fmdita/config/serializationconfig.xml

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

Ce fichier contient deux sections principales : jeu d’attributs et jeu de règles. Un extrait de la section Ensemble de règles est fourni ci-dessous :

<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 Ensemble de règles , vous pouvez indiquer les informations suivantes :

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 attributs des fichiers DITA. La configuration par défaut de la règle d’élément récupère tous les éléments prolog. De plus, la configuration par défaut de la règle d’attribut récupère tous les attributs des éléments prolog. Vous pouvez spécifier une requête XPath pour sérialiser les éléments ou attributs à rechercher.

La requête XPath contient le nom de classe du type de document. La classe 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 du texte dans l’élément spécifié, spécifiez la valeur oui. Si vous spécifiez la valeur no, 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 - Indiquez l’identifiant du jeu d’attributs à associer à cette règle. La valeur all-attrs est un cas particulier qui indique 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 de jeu d’attributs d’un ensemble de règles.

attribute - Liste des attributs que vous souhaitez rechercher. Pour chaque attribut, vous devez créer une entrée individuelle dans l’élément attribute.

Procédez comme suit pour ajouter des éléments ou 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. Toutefois, vous devez extraire les métadonnées de votre contenu DITA existant pour pouvoir effectuer des recherches.

Extraction de métadonnées à partir de 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 de métadonnées DITA dans le lot com.adobe.fmdita.config.ConfigManager, puis exécuter le workflow pour extraire les métadonnées. Cette opération extrait les métadonnées requises des fichiers DITA existants, puis les met à disposition pour la recherche.

Si vous créez de nouveaux 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 :

Suivez les instructions fournies dans Remplacements de la configuration pour créer le fichier de configuration. Dans le fichier de configuration, fournissez les détails (property) suivants pour configurer l’option d’extraction des métadonnées :

Pour exécuter le workflow d’extraction des métadonnées, procédez comme suit :

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. Certains emplacements peuvent être à exclure de la recherche. Par exemple, lorsque vous lancez le workflow 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 l’emplacement du dossier temporaire dans la liste d’exclusion.

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