Konfigurieren der Suche in der AEM Assets-Benutzeroberfläche id192SC800MY4

Standardmäßig erkennt AEM DITA-Inhalte nicht, bietet daher keinen Mechanismus zum Durchsuchen von DITA-Inhalten in seinem Repository. Außerdem gibt es keine OOTB-Fähigkeit, Inhalte basierend auf ihrer UUID zu suchen. Mit AEM Guides können Sie die DITA-Inhaltssuche und UUID-basierten Suchfunktionen zum 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 aufgenommen 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 Folgendes aus, um die UUID-basierte Suchkomponente in der AEM Assets-Benutzeroberfläche hinzuzufügen:

Bereitstellen von Berechtigungen für Benutzer id192SF0G0RUI

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 erteilen, können Ihre Benutzer DITA-Inhalte nicht anhand ihrer Element-/Attributwerte oder UUID durchsuchen.

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

Der ausgewählte Benutzer oder die ausgewählte Benutzergruppe hat jetzt Zugriff auf die DITA-Inhaltsfunktion in der Assets-Benutzeroberfläche.

Hinzufügen benutzerdefinierter Elemente oder Attribute zur Suche id192SF0G10YK

Damit die DITA-Suche funktioniert, ist eine gewisse Vorverarbeitung des DITA-Inhalts erforderlich. Dieser Vorverarbeitungsschritt extrahiert selektive Inhalte aus einzelnen DITA-Maps und -Themen, damit sie für eine schnellere Suche indiziert werden können. Intern heißt dieser Prozess Serialisierung. Die Serialisierung von DITA-Dateien erfolgt beim Hochladen von Inhalten oder kann auch bei Bedarf ausgeführt werden. Es 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 im DITA prolog -Element nach allen Elementen und Attributen 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. Im Folgenden finden Sie einen Ausschnitt des Regelsatzabschnitts:

<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 Regelsatzabschnitt können Sie Folgendes angeben:

Eine Regel besteht aus folgenden Elementen:

• 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 von prolog -Elementen ab. Sie können eine XPath-Abfrage angeben, um die Elemente oder Attribute zu serialisieren, nach denen Sie suchen möchten.

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

• text

  Wenn Sie nach dem Text innerhalb des angegebenen Elements suchen möchten, geben Sie den Wert yes an. Wenn Sie "Nein"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 Kennung des Attributsatzes an, den Sie mit dieser Regel verknüpfen möchten. Der Wert "all-attrs"ist ein Sonderfall, der angibt, dass alle Attribute für diese Regel serialisiert werden müssen.

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

• id

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

• attribute

  Eine Liste der Attribute, die durchsucht werden sollen. Für jedes Attribut müssen Sie einen einzelnen Eintrag im Element attribute erstellen.

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

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

Extrahieren von Metadaten aus vorhandenem Inhalt id192SF0GA0HT

Nachdem Sie die standardmäßige Serialisierungsdatei für die Suche geändert 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 bereitgestellt.

Wenn Sie nach dem Aktualisieren der Serialisierungsdatei neue Dateien erstellen oder eine Datei bearbeiten, werden die Metadaten automatisch aus diesen Dateien extrahiert. Der Prozess zum 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 (Eigenschaft)-Details an, um die Metadatenextraktionsoption zu konfigurieren:

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

Ausschließen temporärer Dateien aus Suchergebnissen id197AHI0035Z

Standardmäßig wird die Suche für das gesamte Repository der AEM durchgeführt. Es kann einige Orte geben, die Sie von der Suche ausschließen möchten. Wenn Sie beispielsweise den Arbeitsablauf für die Inhaltsübersetzung starten, bleiben die nicht genehmigten Dateien an einem temporären Ordnerspeicherort. 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 in der Ausschlussliste hinzufügen.

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