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à:
- Aggiungere il componente di ricerca degli elementi DITA nell’interfaccia utente di Assets
- Aggiungere un componente di ricerca basato su UUID nell’interfaccia utente di Assets
- Fornire autorizzazioni agli utenti
- Aggiungere elementi o attributi personalizzati nella ricerca
- Estrai metadati da contenuto esistente
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:
-
Accedi a Adobe Experience Manager come amministratore.
-
Fai clic sul collegamento Adobe Experience Manager in alto e scegli Strumenti.
-
Selezionare Generale dall'elenco degli strumenti e fare clic sul riquadro Cerca in Forms.
-
Nell'elenco Cerca in Forms, selezionare la Barra di ricerca amministrazione di Assets.
-
Fai clic su Modifica.
-
Nella scheda Seleziona predicato, scorri fino alla fine dell'elenco.
-
Trascinare il predicato Elemento DITA nella posizione desiderata nel modulo di ricerca.
-
Fai clic su Fine per salvare le modifiche.
Quando accedi all’opzione Filtri nell’interfaccia utente di Assets, riceverai l’opzione Filtro di ricerca per elemento DITA.
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:
-
Accedi a Adobe Experience Manager come amministratore.
-
Fai clic sul collegamento Adobe Experience Manager in alto e scegli Strumenti.
-
Selezionare Generale dall'elenco degli strumenti e fare clic sul riquadro Cerca in Forms.
-
Nell'elenco Cerca in Forms, selezionare la Barra di ricerca amministrazione di Assets.
-
Fai clic su Modifica.
-
Nella scheda Seleziona predicato, scegli Predicato proprietà e trascinalo nella posizione desiderata nel modulo di ricerca.
-
Nella scheda Impostazioni, fornisci i seguenti dettagli per il componente Predicato proprietà appena aggiunto:
- Etichetta campo: UUID
- Nome proprietà: jcr:content/fmUuid
-
Fai clic su Fine per salvare le modifiche.
Quando accedi all’opzione Filtri nell’interfaccia utente di Assets, riceverai l’opzione Filtro ricerca basato su UUIS.
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:
-
Accedere alla pagina delle autorizzazioni di utenti e gruppi.
-
Cerca il gruppo di utenti o un singolo utente a cui desideri concedere l’accesso. Ad esempio, per concedere l'accesso a tutti gli utenti nel gruppo autori, immettere autori nel campo Filtra query e premere Invio.
-
Seleziona il gruppo authors.
-
Nel riquadro di destra, selezionare la scheda Autorizzazioni.
-
Passare alla cartella seguente:
/conf/global/settings/dam/search
-
Concedi l'autorizzazione Lettura per la cartella ricerche.
-
Fai clic su Salva.
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.
prolog
, è possibile saltare questo processo.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:
-
Regole per estrarre gli elementi
-
Regole per estrarre gli attributi
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 elementiprolog
. È 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:
-
Utilizza Gestione pacchetti per scaricare il file /libs/fmdita/config/serializationconfig.xml.
-
Creare un nodo di sovrapposizione della cartella
config
all'interno del nodoapps
. -
Passare al file di configurazione disponibile nel nodo
apps
:/apps/fmdita/config/serializationconfig.xml
-
Aggiungere l'elemento o i set di regole di attributo richiesti.
-
Esegui il commit delle modifiche ed esegui la pipeline Cloud Manager (CI/CD) per distribuire le modifiche di configurazione.
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à:
- Abilitazione dell’opzione di estrazione dei metadati in configMgr
- Esecuzione del flusso di lavoro di estrazione dei metadati
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:
com.adobe.fmdita.config.ConfigManager
dita.serialization
Valore predefinito:
false
Per eseguire il flusso di lavoro di estrazione dei metadati, effettua le seguenti operazioni:
-
Accedi a Adobe Experience Manager come amministratore.
-
Fai clic sul collegamento Adobe Experience Manager in alto e scegli Strumenti.
-
Selezionare Guide dall'elenco degli strumenti e fare clic sul riquadro Estrazione metadati DITA.
-
Se si desidera estrarre i metadati da un singolo file e dalle relative dipendenze, fare clic sul collegamento Seleziona un file e cercare un file.
-
Se desideri estrarre i metadati da più file all'interno di una cartella, fai clic sul collegamento Seleziona cartella(s), sfoglia e seleziona la cartella richiesta. Fare clic sul pulsante Aggiungi per aggiungere la cartella all'elenco delle attività di serializzazione.
note note NOTE È possibile selezionare e aggiungere più cartelle a un'attività di serializzazione. -
Fare clic su Inizio.
-
Nella finestra di dialogo Conferma estrazione metadati fare clic su OK.
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:
-
Aggiungi la seguente proprietà nell’indice damAssetLucene personalizzato:
table 0-row-3 1-row-3 Nome proprietà Tipo Valore excludedPaths Stringa[] Aggiungi il seguente valore a questa proprietà: /content/dam/projects/translation\_output
-
Passa al nodo Lucene disponibile nella posizione seguente:
/oak:index/lucene
-
Aggiungi la seguente proprietà nel nodo Lucene:
table 0-row-3 1-row-3 Nome proprietà Tipo Valore excludedPaths Stringa[] Aggiungi i seguenti valori a questa proprietà: /content/dam/projects/translation\_output