Anzeigen ServiceNowWissensartikel auf einer Adobe Experience Manager-Seite

Freigeben Version: Yokohama

Aktualisiert 30. Januar 2025

6 Minuten Lesedauer

Verwenden Sie Wissenskomponenten, die in Adobe Experience Manager (AEM) verfügbar sind, um über auf Knowledge Bases zuzugreifen ServiceNowInstanz und Anzeige zugehöriger Wissensartikel auf einer AEM-basierten Website.

Vorbereitungen

Aktivieren Sie das Knowledge API-Plugin (sn_km_api), um die REST-API-Endpunkte des Wissensmanagements für Wissensartikel zu verwenden. Weitere Informationen finden Sie unter Wissensmanagement-REST-API .
Definieren Sie die CORS-Regel (Cross-Origin Resource Sharing), um über Ihre AEM-Instanz auf die Knowledge API zuzugreifen. Weitere Informationen finden Sie unter Definieren Sie eine ursprungsübergreifende Ressourcenfreigaberegel für den Zugriff ServiceNowAPI-Endpunkte von AEM.

Erforderliche Rolle: AEM-Autor

Prozedur

Melden Sie sich bei Ihrer AEM-Instanz an.
Öffnen Sie Ihre AEM-Seite in Bearbeitungsmodus .
Öffnen Sie Komponentenbrowser .
Von Alle Liste, wählen Sie aus ServiceNow .
Ziehen Sie eine Komponente an die erforderliche Position auf der Seite.

Hinweis:
Wenn keine Komponenten verfügbar sind, aktualisieren Sie Ihre Vorlagenkonfiguration, um die Wissenskomponenten einzubeziehen. Darüber hinaus müssen Sie die Eigenschaften der Websitevorlage ändern und jede wissensartikelkomponente der Liste der zulässigen Komponenten hinzufügen.
Öffnen Sie Komponentendialogfeld zur Bearbeitung .

Hinweis:
Standardmäßig sind die Wissenskomponenten im Bearbeitungsmodus einer Seite in AEM für öffentliche Anwender nicht zugänglich, die anonyme AEM-Anwender sind, die nicht angemeldet sind. Um das Standardverhalten zu ändern, müssen Sie aktivieren Öffentlich Eigenschaft für jede Wissenskomponente.

Legen Sie die Komponenteneigenschaften „Suchergebnisse“ fest, um Knowledge-Suchergebnisse anzuzeigen, die eine Liste von Wissensartikeln aus den Knowledge Bases in enthalten ServiceNowInstanz.

Tabelle : 1. Eigenschaften der Suchergebniskomponente
Eigenschaft	Beschreibung
Öffentlich	Option, um den Inhalt der Komponente für öffentliche Anwender sichtbar zu machen. Wenn diese Option ausgewählt ist, sind die Wissensartikel, die für nicht authentifizierte Anwender in der Komponente verfügbar sind, für alle Anwender verfügbar, einschließlich öffentlicher Anwender.
Knowledge Bases	Systembezeichner (sys_ID) einer Knowledge Base, die zugehörige Wissensartikel enthält. Klicken Sie Auf Feld hinzufügen Und geben Sie die sys_ID einer Knowledge Base ein. Sie können mehrere Einträge hinzufügen. Hinweis: Wenn Sie keinen Wert hinzufügen, werden Knowledge Bases aus den OSGi-Konfigurationseinstellungen für verwendet ServiceNowKomponenten.
Sprache	Aktiviert die Anzeige von Suchergebnissen für wissensartikel in verschiedenen Sprachen. Wählen Sie eine der folgenden Optionen aus: Wählen Sie aus der ServiceNow-OSGi-Konfiguration aus : Wissensartikel werden in der Sprache angezeigt, die in der OSGi-Konfiguration für konfiguriert ist ServiceNowKomponenten. Dieser Wert ist standardmäßig ausgewählt. Auf Portalsprache beschränken : Wissensartikel werden in der auf der AEM-Website konfigurierten Sprache angezeigt. Alle Sprachen : Wissensartikel werden in allen Sprachen angezeigt.
Suchparameter	Parameterschlüssel für die Suchabfrage. Beispiel: `kb_query`
Sekundäre Felder	Metadaten eines wissensartikels, die mit dem artikel angezeigt werden. Metadaten enthalten Informationen wie den Autor, das Datum der letzten Aktualisierung des artikels und das Datum, an dem der artikel zuletzt angezeigt wurde. Trennen Sie bei mehreren Einträgen die Felder durch Kommas. Beispiel: `Autor,sys_View_count,sys_updated_on,Bewertung`
Anzahl der Suchergebnisse	Maximale Anzahl von Artikeln, die in der Suchergebnisliste enthalten sind. Verwenden Sie die Symbole „Inkrement“ oder „Reduzieren“, um die Werte zu erhöhen oder zu verringern. Sie können einen Wert auch manuell eingeben. Der Wert muss größer als sein `1` .
Artikelseiten-URL	Relative URL der artikelseite, zu der umgeleitet werden soll. Beispiel: /Content/NOWApp/now_article_view.html
Anwenderdefinierte CSS-Klasse	Anwenderdefinierte CSS-Klasse zum Anwenden anwenderdefinierter Stile auf diese Komponente. Weitere Informationen finden Sie unter Anpassen der Farben von ServiceNowKomponenten in AEM.

Legen Sie die Komponenteneigenschaften des Suchfelds fest, um ein Suchfeld anzuzeigen, in dem Anwender Suchtext eingeben und Wissensartikel in finden können ServiceNowInstanz, die dem Suchtext entspricht.

Hinweis:

Das Auslösen einer Suche über die Suchfeldkomponente führt zur Komponente „Suchergebnisse“.

Tabelle : 2. Eigenschaften der Suchfeld-Komponente
Eigenschaft	Beschreibung
Öffentlich	Option, um den Inhalt der Komponente für öffentliche Anwender sichtbar zu machen. Wenn diese Option ausgewählt ist, sind die Wissensartikel, die für nicht authentifizierte Anwender in der Komponente verfügbar sind, für alle Anwender verfügbar, einschließlich öffentlicher Anwender.
Platzhalter	Hinweistext, der im Suchfeld angezeigt wird, um Informationen darüber bereitzustellen, wonach Anwender suchen können, oder Bedingungen für den Suchtext. Beispiel: `Suche (mindestens drei Zeichen)`
Knowledge Bases	Systembezeichner (sys_ID) einer Knowledge Base, die zugehörige Wissensartikel enthält. Klicken Sie Auf Feld hinzufügen Und geben Sie die sys_ID einer Knowledge Base ein. Sie können mehrere Einträge hinzufügen. Hinweis: Wenn Sie keinen Wert hinzufügen, werden Knowledge Bases aus den OSGi-Konfigurationseinstellungen für verwendet ServiceNowKomponenten.
Sprache	Aktiviert die Anzeige von Wissensartikeln in verschiedenen Sprachen im Suchfeld. Wählen Sie eine der folgenden Optionen aus: Wählen Sie aus der ServiceNow-OSGi-Konfiguration aus : Wissensartikel werden in der Sprache angezeigt, die in der OSGi-Konfiguration für konfiguriert ist ServiceNowKomponenten. Dieser Wert ist standardmäßig ausgewählt. Auf Portalsprache beschränken : Wissensartikel werden in der auf der AEM-Website konfigurierten Sprache angezeigt. Alle Sprachen : Wissensartikel werden in allen Sprachen angezeigt.
Suchseiten-URL	Relative URL der Suchseite, zu der umgeleitet werden soll. Beispiel: /Content/NOWApp/now_article_search.html
Suchparameter	Parameterschlüssel für die Suchabfrage. Beispiel: `kb_query`
Typeahead	Option zum Aktivieren der Typeahead-Suche.
Anzahl der Typeahead-Suchergebnisse	Maximale Anzahl von Artikeln, die in die Typeahead-Suchergebnisliste aufgenommen werden sollen. Verwenden Sie die Symbole „Inkrement“ oder „Reduzieren“, um die Werte zu erhöhen oder zu verringern. Sie können einen Wert auch manuell eingeben. Der Wert muss größer als sein `1` .
Artikelseiten-URL	Relative URL der artikelseite, zu der umgeleitet werden soll. Beispiel: /Content/NOWApp/now_article_view.html
Anwenderdefinierte CSS-Klasse	Anwenderdefinierte CSS-Klasse zum Anwenden anwenderdefinierter Stile auf diese Komponente. Weitere Informationen finden Sie unter Anpassen der Farben von ServiceNowKomponenten in AEM.

Legen Sie die Komponenteneigenschaften der Artikelansicht fest, um Wissensartikel und ihre Anhänge, falls verfügbar, von einem anzuzeigen ServiceNowInstanz.

Tabelle : 3. Komponenteneigenschaften der Artikelansicht
Eigenschaft	Beschreibung
Öffentlich	Option, um den Inhalt der Komponente für öffentliche Anwender sichtbar zu machen. Wenn diese Option ausgewählt ist, sind die Wissensartikel, die für nicht authentifizierte Anwender in der Komponente verfügbar sind, für alle Anwender verfügbar, einschließlich öffentlicher Anwender.
Artikelparameter	Name des URL-Abfrageparameters für die artikelnummer. Beispiel: `kb_article`
Sekundäre Felder	Metadaten eines wissensartikels, die mit dem artikel angezeigt werden. Metadaten enthalten Informationen wie den Autor, das Datum der letzten Aktualisierung des artikels und das Datum, an dem der artikel zuletzt angezeigt wurde. Trennen Sie bei mehreren Einträgen die Felder durch Kommas. Beispiel: `Autor,sys_View_count,sys_updated_on,Bewertung`
Sprachparameter	Name des URL-Abfrageparameters, der die angeforderte Sprache für einen wissensartikel enthält. Beispiel: `kb_lang`
Anwenderdefinierte CSS-Klasse	Anwenderdefinierte CSS-Klasse zum Anwenden anwenderdefinierter Stile auf diese Komponente. Weitere Informationen finden Sie unter Anpassen der Farben von ServiceNowKomponenten in AEM.

Legen Sie die Komponenteneigenschaften der Artikelliste fest, um eine Liste von Wissensartikeln je nach Listenkriterien anzuzeigen.

Tabelle : 4. Eigenschaften der Artikellistenkomponente
Eigenschaft	Beschreibung
Öffentlich	Option, um den Inhalt der Komponente für öffentliche Anwender sichtbar zu machen. Wenn diese Option ausgewählt ist, sind die Wissensartikel, die für nicht authentifizierte Anwender in der Komponente verfügbar sind, für alle Anwender verfügbar, einschließlich öffentlicher Anwender.
Titel	Titel, der der Artikelliste entspricht, die als Komponentenheader angezeigt wird. Beispiel: `Am häufigsten angezeigte Artikel`
Knowledge Bases	Systembezeichner (sys_ID) einer Knowledge Base, die zugehörige Wissensartikel enthält. Klicken Sie Auf Feld hinzufügen Und geben Sie die sys_ID einer Knowledge Base ein. Sie können mehrere Einträge hinzufügen. Hinweis: Wenn Sie keinen Wert hinzufügen, werden Knowledge Bases aus den OSGi-Konfigurationseinstellungen für verwendet ServiceNowKomponenten.
Sprache	Aktiviert die Anzeige eines wissensartikels in verschiedenen Sprachen, wenn der artikel angezeigt wird. Wählen Sie eine der folgenden Optionen aus: Wählen Sie aus der ServiceNow-OSGi-Konfiguration aus : Wissensartikel werden in der Sprache angezeigt, die in der OSGi-Konfiguration für konfiguriert ist ServiceNowKomponenten. Dieser Wert ist standardmäßig ausgewählt. Auf Portalsprache beschränken : Wissensartikel werden in der auf der AEM-Website konfigurierten Sprache angezeigt. Alle Sprachen : Wissensartikel werden in allen Sprachen angezeigt.
Sekundäre Felder	Metadaten eines wissensartikels, die mit dem artikel angezeigt werden. Metadaten enthalten Informationen wie den Autor, das Datum der letzten Aktualisierung des artikels und das Datum, an dem der artikel zuletzt angezeigt wurde. Trennen Sie bei mehreren Einträgen die Felder durch Kommas. Beispiel: `Autor,sys_View_count,sys_updated_on,Bewertung`
Kriterien	Liste der Kriterien für die Wissensartikelliste. Wählen Sie eine der folgenden Optionen aus: Empfohlen : Liste der empfohlenen Wissensartikel basierend auf den in konfigurierten Stichwörtern glide.knowman.default_keywordEigenschaft. Informationen zu empfohlenen Artikeln finden Sie unter Fügen Sie dem empfohlenen Inhalt einen wissensartikel hinzu Und Wissenseigenschaften . Am Häufigsten Angezeigt : Liste der Wissensartikel mit den meisten Ansichten.
Artikelanzahl	Maximale Anzahl von Artikeln, die in die Artikelliste aufgenommen werden sollen. Verwenden Sie die Symbole „Inkrement“ oder „Reduzieren“, um die Werte zu erhöhen oder zu verringern. Sie können einen Wert auch manuell eingeben. Der Wert muss größer als sein `1` .
Artikelseiten-URL	Relative URL der artikelseite, zu der umgeleitet werden soll. Beispiel: /Content/NOWApp/now_article_view.html
Komponente ausblenden, wenn leer	Option zum Ausblenden der Komponente, wenn keine Wissensartikel zum Anzeigen vorhanden sind.
Anwenderdefinierte CSS-Klasse	Anwenderdefinierte CSS-Klasse zum Anwenden anwenderdefinierter Stile auf diese Komponente. Weitere Informationen finden Sie unter Anpassen der Farben von ServiceNowKomponenten in AEM.