Configurare la ricerca per l’interfaccia utente di AEM Assets id192SC800MY4

Per impostazione predefinita, l'AEM non riconosce il contenuto DITA, pertanto non fornisce alcun meccanismo per eseguire ricerche nel contenuto DITA all'interno del relativo archivio. Inoltre, non esiste alcuna funzionalità OOTB per cercare contenuti in base al loro UUID. AEM Guides consente di aggiungere le funzionalità di ricerca di contenuti DITA e basate su UUID nell’archivio AEM.

La configurazione della ricerca del contenuto DITA prevede le seguenti attività:

Oltre ad aggiungere la funzionalità di ricerca, puoi anche configurare le cartelle da non includere nella ricerca. Per ulteriori dettagli, vedere Escludere i file temporanei dai risultati della ricerca.

Aggiungere il componente di ricerca degli elementi DITA nell’interfaccia utente di Assets id192SF0F50HS

Per aggiungere il componente di ricerca contenuto DITA nell’interfaccia utente di AEM Assets, effettua le seguenti operazioni:

Aggiungere un componente di ricerca basato su UUID nell’interfaccia utente di Assets id2034F04K05Z

Per aggiungere un componente di ricerca basato su UUID nell’interfaccia utente di AEM Assets, effettua le seguenti operazioni:

Fornire autorizzazioni agli utenti id192SF0G0RUI

Per poter accedere alle funzionalità di ricerca dall’interfaccia utente di Assets, gli autori e gli editori devono disporre di autorizzazioni esplicite. Se non concedi queste autorizzazioni, gli utenti non potranno cercare contenuto DITA in base ai valori elemento/attributo o UUID.

Per fornire l'accesso alla funzione di ricerca DITA, effettuare le seguenti operazioni:

L’utente o il gruppo di utenti selezionato avrà ora accesso alla funzione di ricerca di contenuti DITA nell’interfaccia utente di Assets.

Aggiungere elementi o attributi personalizzati nella ricerca id192SF0G10YK

Affinché la ricerca DITA funzioni, è necessaria una preelaborazione del contenuto DITA. Questo passaggio di pre-elaborazione estrae contenuto selettivo da singole mappe e argomenti DITA in modo che possa essere indicizzato per velocizzare la ricerca. Internamente, questo processo è denominato Serializzazione. La serializzazione dei file DITA avviene durante il caricamento del contenuto o può anche essere eseguita su richiesta. Viene utilizzato un file di configurazione per determinare la quantità di contenuto da indicizzare da ciascun file DITA. La posizione predefinita del file di serializzazione è:

/libs/fmdita/config/serializationconfig.xml

La configurazione di ricerca predefinita consente di cercare tutti gli elementi e gli attributi all'interno dell'elemento DITA prolog. Se desideri eseguire una ricerca in base ad altri elementi o attributi, devi configurare il file di serializzazione della ricerca.

Questo file contiene due sezioni principali: set di attributi e set di regole. Di seguito è riportato uno snippet della sezione relativa al set di regole:

<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>

Nella sezione del set di regole puoi specificare:

Una regola è costituita dai seguenti elementi:

• xpath

  Query XPath che recupera gli elementi o gli attributi dai file DITA. La configurazione predefinita per la regola elemento recupera tutti gli elementi prolog. La configurazione predefinita per la regola attributo recupera tutti gli attributi degli elementi prolog. È possibile specificare una query XPath per serializzare gli elementi o gli attributi che si desidera cercare.

La query XPath contiene il nome della classe del tipo di documento. La classe topic/topic viene utilizzata per i documenti DITA di tipo argomento. Se si desidera creare una regola per altri documenti DITA, è necessario utilizzare i seguenti nomi di classe:

• text

  Se desideri cercare il testo all’interno dell’elemento specificato, specifica il valore yes. Se non si specifica alcun valore come, vengono serializzati solo gli attributi all'interno dell'elemento. Gli attributi che si desidera cercare devono essere specificati nella sezione del set di attributi.

• attributeset

  Specificare l'ID del set di attributi che si desidera associare alla regola. Il valore all-attrs è un caso speciale per indicare che tutti gli attributi per questa regola devono essere serializzati.

Un set di attributi contiene un elenco di attributi che si desidera cercare all'interno del contenuto DITA. Il set di attributi contiene quanto segue:

• id

  Identificatore univoco per il set di attributi. Questo ID è specificato nel parametro attributeset di un set di regole.

• attributo

  Elenco di attributi che si desidera cercare. Per ogni attributo, è necessario creare una singola voce nell'elemento attribute.

Per aggiungere elementi o attributi DITA personalizzati nel file di serializzazione della ricerca, effettuare le seguenti operazioni:

Le nuove informazioni di serializzazione vengono memorizzate e attivate per la ricerca. Tuttavia, è necessario estrarre i metadati dal contenuto DITA esistente per renderli disponibili per la ricerca.

Estrai metadati da contenuto esistente id192SF0GA0HT

Dopo aver apportato modifiche al file di serializzazione della ricerca predefinito, è necessario abilitare l'opzione Estrazione metadati DITA nel bundle com.adobe.fmdita.config.ConfigManager e quindi eseguire il flusso di lavoro per estrarre i metadati. In questo modo i metadati richiesti vengono estratti dai file DITA esistenti e lo stesso viene quindi reso disponibile per la ricerca.

Se si creano nuovi file o si modifica un file dopo aver aggiornato il file di serializzazione, i metadati vengono estratti automaticamente da tali file. Il processo di estrazione dei metadati è necessario solo per i file già esistenti nell’archivio AEM.

L'estrazione dei metadati da file DITA esistenti comporta due attività:

Utilizza le istruzioni fornite in Sostituzioni configurazione per creare il file di configurazione. Nel file di configurazione, fornisci i seguenti dettagli (property) per configurare l’opzione di estrazione dei metadati:

Per eseguire il flusso di lavoro di estrazione dei metadati, effettua le seguenti operazioni:

Escludere i file temporanei dai risultati della ricerca id197AHI0035Z

Per impostazione predefinita, la ricerca viene eseguita sull’intero archivio dell’AEM. Potrebbero essere presenti alcune posizioni da escludere dalla ricerca. Ad esempio, quando avvii il flusso di lavoro di traduzione del contenuto, i file non approvati rimangono in una posizione di cartella temporanea. Quando si esegue la ricerca, nei risultati della ricerca vengono restituiti anche i file di questa posizione temporanea.

Per impedire ad AEM Guides di effettuare ricerche nel percorso della cartella di traduzione temporanea, devi aggiungere il percorso della cartella temporanea nell’elenco delle esclusioni.

Per escludere la cartella di traduzione temporanea dalla ricerca, effettua le seguenti operazioni: