Konfigurieren der Suche für die AEM Assets-Benutzeroberfläche id192SC800MY4

Standardmäßig erkennt AEM keine DITA-Inhalte und bietet daher keinen Mechanismus zum Durchsuchen von DITA-Inhalten in seinem Repository. Außerdem gibt es keine OOTB-Funktion, um Inhalte basierend auf ihrer UUID zu durchsuchen. Mit AEM Guides können Sie die Funktionen für die DITA-Inhaltssuche und die UUID-basierte Suche im AEM-Repository hinzufügen.

Die Konfiguration der DITA-Inhaltssuche umfasst die folgenden Aufgaben:

Zusätzlich zur Suchfunktion können Sie auch die Ordner konfigurieren, die nicht in die Suche einbezogen werden sollen. Weitere Informationen finden Sie unter Ausschließen temporärer Dateien aus Suchergebnissen.

Hinzufügen der DITA-Element-Suchkomponente in der Assets-Benutzeroberfläche id192SF0F50HS

Führen Sie die folgenden Schritte aus, um die DITA-Inhaltssuchkomponente in der AEM Assets-Benutzeroberfläche hinzuzufügen:

Hinzufügen einer UUID-basierten Suchkomponente in der Assets-Benutzeroberfläche id2034F04K05Z

Führen Sie folgende Schritte aus, um die UUID-basierte Suchkomponente in der AEM Assets-Benutzeroberfläche hinzuzufügen:

Berechtigungen für Benutzer bereitstellen id192SF0G0RUI

Die Autoren und Herausgeber benötigen explizite Berechtigungen, um über die Assets-Benutzeroberfläche auf die Suchfunktionen zugreifen zu können. Wenn Sie diese Berechtigungen nicht gewähren, können Ihre Benutzerinnen und Benutzer keine DITA-Inhalte basierend auf ihren Element-/Attributwerten oder ihrer UUID suchen.

Führen Sie die folgenden Schritte aus, um Zugriff auf die DITA-Suchfunktion zu gewähren:

Der/die ausgewählte Benutzende oder die ausgewählte Benutzergruppe hat jetzt Zugriff auf die Funktion DITA-Inhalt durchsuchen in der Assets-Benutzeroberfläche.

Hinzufügen benutzerdefinierter Elemente oder Attribute bei der Suche id192SF0G10YK

Damit die DITA-Suche funktioniert, ist eine Vorverarbeitung des DITA-Inhalts erforderlich. Dieser Vorverarbeitungsschritt extrahiert selektive Inhalte aus einzelnen DITA-Karten und -Themen, damit sie für eine schnellere Suche indiziert werden können. Intern wird dieser Prozess als "". Die Serialisierung von DITA-Dateien erfolgt während des Inhalts-Uploads oder kann auch bei Bedarf ausgeführt werden. Sie verwendet eine Konfigurationsdatei, um zu bestimmen, wie viel Inhalt aus jeder DITA-Datei indiziert werden soll. Der Standardspeicherort der Serialisierungsdatei lautet:

/libs/fmdita/config/serializationconfig.xml

Mit der Standardsuchkonfiguration können Sie nach allen Elementen und Attributen im DITA-prolog suchen. Wenn Sie anhand anderer Elemente oder Attribute suchen möchten, müssen Sie die Serialisierungsdatei für die Suche konfigurieren.

Diese Datei enthält zwei Hauptabschnitte: Attributsatz und Regelsatz. Ein Ausschnitt des Abschnitts „Regelsatz“ wird unten angezeigt:

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

Im Abschnitt Regelsatz können Sie Folgendes angeben:

Eine Regel besteht aus Folgendem:

xpath - Dies ist die XPath-Abfrage, die die Elemente oder Attribute aus DITA-Dateien abruft. Die Standardkonfiguration für die Elementregel ruft alle prolog Elemente ab. Außerdem ruft die Standardkonfiguration für die Attributregel alle Attribute prolog Elemente ab. Sie können eine XPath-Abfrage angeben, um die zu suchenden Elemente oder Attribute zu serialisieren.

Die XPath-Abfrage enthält den Klassennamen des Dokumenttyps. Die topic/topic-Klasse wird für DITA-Dokumente vom Typ Thema verwendet. Wenn Sie eine Regel für andere DITA-Dokumente erstellen möchten, müssen Sie die folgenden Klassennamen verwenden:

text - Wenn Sie im angegebenen Element nach dem Text suchen möchten, geben Sie den Wert „yes“ an. Wenn Sie keinen als Wert angeben, werden nur die Attribute innerhalb des Elements serialisiert. Die Attribute, nach denen Sie suchen möchten, müssen im Abschnitt Attributsatz angegeben werden.

attributeSet - Geben Sie die ID des Attributsatzes an, den Sie mit dieser Regel verknüpfen möchten. Der Wert all-attrs ist ein Sonderfall, um anzugeben, dass alle Attribute für diese Regel serialisiert werden müssen.

Ein Attributsatz enthält eine Liste von Attributen, nach denen Sie im DITA-Inhalt suchen möchten. Der Attributsatz enthält Folgendes:

id - Eine eindeutige Kennung für den Attributsatz. Diese ID wird im attributeSet-Parameter eines Regelsatzes angegeben.

attribute - Eine Liste von Attributen, die Sie durchsuchen möchten. Für jedes Attribut muss ein einzelner Eintrag im attribute erstellt werden.

Führen Sie die folgenden Schritte aus, um benutzerdefinierte DITA-Elemente oder -Attribute in die Serialisierungsdatei für die Suche einzufügen:

Die neuen Serialisierungsinformationen werden gespeichert und für die Suche aktiviert. Sie müssen jedoch die Metadaten aus Ihrem vorhandenen DITA-Inhalt extrahieren, damit sie für die Suche verfügbar werden.

Extrahieren von Metadaten aus vorhandenen Inhalten id192SF0GA0HT

Nachdem Sie Änderungen an der Standard-Suchserialisierungsdatei vorgenommen haben, müssen Sie die Option DITA-Metadatenextraktion im Bundle com.adobe.fmdita.config.ConfigManager aktivieren und dann den Workflow zum Extrahieren von Metadaten ausführen. Dadurch werden die erforderlichen Metadaten aus den vorhandenen DITA-Dateien extrahiert, und dieselben werden dann für die Suche verfügbar gemacht.

Wenn Sie nach dem Aktualisieren der Serialisierungsdatei neue Dateien erstellen oder eine Datei bearbeiten, werden die Metadaten automatisch aus diesen Dateien extrahiert. Das Extrahieren von Metadaten ist nur für Dateien erforderlich, die bereits im AEM-Repository vorhanden sind.

Das Extrahieren von Metadaten aus vorhandenen DITA-Dateien umfasst zwei Aufgaben:

Verwenden Sie die Anweisungen unter Konfigurationsüberschreibungen, um die Konfigurationsdatei zu erstellen. Geben Sie in der Konfigurationsdatei die folgenden (property)-Details an, um die Option zur Extraktion von Metadaten zu konfigurieren:

Führen Sie die folgenden Schritte aus, um den Workflow für die Metadatenextraktion auszuführen:

Ausschließen temporärer Dateien aus Suchergebnissen id197AHI0035Z

Standardmäßig wird die Suche für das gesamte Repository von AEM durchgeführt. Es könnte einige Orte geben, die Sie von der Suche ausschließen möchten. Wenn Sie beispielsweise den Workflow für die Inhaltsübersetzung starten, bleiben die nicht genehmigten Dateien an einem temporären Speicherort. Wenn Sie die Suche durchführen, werden auch Dateien von diesem temporären Speicherort in den Suchergebnissen zurückgegeben.

Um zu verhindern, dass AEM Guides den Speicherort des temporären Übersetzungsordners durchsucht, müssen Sie den temporären Ordnerspeicherort zur Ausschlussliste hinzufügen.

Führen Sie die folgenden Schritte aus, um den temporären Übersetzungsordner von der Suche auszuschließen: