Konfigurera sökning i AEM Assets UI id192SC800MY4

Som standard känner AEM inte igen DITA-innehåll, vilket innebär att det inte finns någon mekanism för att söka efter DITA-innehåll i dess databas. Med AEM Guides kan du lägga till sökfunktionen för DITA-innehåll i AEM.

Som standard känner AEM inte igen DITA-innehåll, vilket innebär att det inte finns någon mekanism för att söka efter DITA-innehåll i dess databas. Det finns heller ingen OOTB-funktion för att söka efter innehåll baserat på deras UUID. Med AEM Guides kan du lägga till funktionerna för sökning efter DITA-innehåll och UUID-baserad sökning i AEM.

När du konfigurerar innehållssökning i DITA utförs följande uppgifter:

Förutom att lägga till sökfunktioner kan du även konfigurera de mappar som inte ska ingå i sökningen. Mer information finns i Uteslut temporära filer från sökresultat.

Lägg till sökkomponenten för DITA-element i Assets UI id192SF0F50HS

Gör följande för att lägga till en sökkomponent för DITA-innehåll i AEM Assets-gränssnittet:

Lägg till UUID-baserad sökkomponent i Assets UI id2034F04K05Z

Gör följande för att lägga till UUID-baserad sökkomponent i AEM Assets UI:

Ge behörigheter till användare id192SF0G0RUI

Författare och utgivare måste få explicit behörighet för att kunna komma åt sökfunktionerna från Assets användargränssnitt. Om du inte ger dessa behörigheter kommer dina användare inte att kunna söka efter DITA-innehåll baserat på deras element-/attributvärden eller UUID.

Utför följande steg för att ge åtkomst till DITA-sökfunktionen:

Den valda användaren eller användargruppen har nu tillgång till sökfunktionen för DITA-innehåll i Assets användargränssnitt.

Lägg till anpassade element eller attribut i sökningen id192SF0G10YK

För att DITA-sökningen ska fungera krävs viss förbearbetning av DITA-innehållet. Detta förbearbetningssteg extraherar selektivt innehåll från enskilda DITA-kartor och -ämnen så att det kan indexeras för snabbare sökning. Internt kallas den här processen Serialisering. Serialisering av DITA-filer sker under överföring av innehåll eller kan även utföras on-demand. Den använder en konfigurationsfil för att avgöra hur mycket innehåll från varje DITA-fil som ska indexeras. Standardplatsen för serialiseringsfilen är:

/libs/fmdita/config/serializationconfig.xml

Med standardsökkonfigurationen kan du söka efter alla element och attribut i DITA-elementet prolog. Om du vill söka baserat på andra element eller attribut måste du konfigurera sökserialiseringsfilen.

Filen innehåller två huvudavsnitt - attributuppsättning och regeluppsättning. Nedan visas ett utdrag av regeluppsättningsavsnittet:

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

I avsnittet Regeluppsättning kan du ange:

En regel består av följande:

• xpath

  Det här är XPath-frågan som hämtar elementen eller attributen från DITA-filer. Standardkonfigurationen för elementregeln hämtar alla prolog-element. Standardkonfigurationen för attributregeln hämtar alla attribut för prolog-element. Du kan ange en XPath-fråga för att serialisera de element eller attribut som du vill söka efter.

XPath-frågan innehåller dokumenttypens klassnamn. Klassen topic/topic används för DITA-dokument av ämnestyp. Om du vill skapa en regel för andra DITA-dokument måste du använda följande klassnamn:

• text

  Om du vill söka efter texten i det angivna elementet anger du yes-värdet. Om du anger nej som värde serialiseras bara attributen i elementet. Attributen som du vill söka efter måste anges i attributuppsättningsavsnittet.

• attributuppsättning

  Ange ID:t för den attributuppsättning som du vill associera med den här regeln. Värdet all-attributes är ett specialfall som anger att alla attribut för den här regeln måste serialiseras.

En attributuppsättning innehåller en lista med attribut som du vill söka efter i DITA-innehåll. Attributuppsättningen innehåller följande:

• id

  En unik identifierare för attributuppsättningen. Detta ID anges i attributuppsättningsparametern för en regeluppsättning.

• attribute

  En lista med attribut som du vill söka efter. För varje attribut måste du skapa en enskild post i elementet attribute.

Utför följande steg för att lägga till anpassade DITA-element eller attribut i sökserialiseringsfilen:

Den nya serialiseringsinformationen lagras och aktiveras för sökning. Du måste dock extrahera metadata från ditt befintliga DITA-innehåll för att bli tillgängligt för sökning.

Extrahera metadata från befintligt innehåll id192SF0GA0HT

När du har ändrat standardfilen för sökserialisering måste du aktivera alternativet DITA-metadataextrahering i paketet com.adobe.fmdita.config.ConfigManager och sedan köra arbetsflödet för att extrahera metadata. Detta extraherar de metadata som krävs från de befintliga DITA-filerna och det samma görs sedan tillgängligt för sökning.

Om du skapar nya filer eller redigerar en fil efter att du har uppdaterat serialiseringsfilen, extraheras metadata automatiskt från sådana filer. Processen att extrahera metadata krävs bara för filer som redan finns i AEM.

Det finns två saker att extrahera metadata från befintliga DITA-filer:

Utför följande steg för att aktivera alternativet för metadataextrahering i configMgr:

Utför följande steg för att köra arbetsflödet för metadataextrahering:

Uteslut temporära filer från sökresultat id197AHI0035Z

Som standard utförs sökningen i hela AEM. Det kan finnas platser som du vill utesluta från sökningen. När du till exempel initierar arbetsflödet för översättning av innehåll blir de ogodkända filerna kvar i en tillfällig mapp. När du utför sökningen returneras filer från den här tillfälliga platsen också i sökresultaten.

Om du inte vill att AEM Guides ska kunna söka i den tillfälliga översättningsmappens plats måste du lägga till en tillfällig mappsökväg i exkluderingslistan.

Utför följande steg för att exkludera den tillfälliga översättningsmappen från sökningen: