ServiceNow-Wissensartikel auf einer Adobe Experience Manager-Seite anzeigen
Verwenden Sie Wissenskomponenten, die in Adobe Experience Manager (AEM) verfügbar sind, um über die ServiceNow-Instanz auf Knowledge Bases zuzugreifen und zugehörige Wissensartikel auf einer AEM-basierten Website anzuzeigen.
Vorbereitungen
- Aktivieren Sie das Knowledge API-Plugin (sn_km_api), um die Knowledge Management-REST-API-Endpunkte für Wissensartikel zu verwenden. Weitere Informationen finden Sie unter Knowledge Management REST-API.
- Definieren Sie die CORS-Regel (Cross-origin resource sharing) für den Zugriff auf die Knowledge API von Ihrer AEM-Instanz aus. Weitere Informationen finden Sie unter Definieren Sie eine ursprungsübergreifende Ressourcenfreigaberegel (CORS) für den Zugriff ServiceNow API-Endpunkte von AEM.
Erforderliche Rolle: AEM-Autor
Prozedur
- Melden Sie sich bei Ihrer AEM-Instanz an.
- Öffnen Sie Ihre AEM-Seite im Bearbeitungsmodus.
- Öffnen Sie den Komponentenbrowser.
- Wählen Sie in der Liste Alle ServiceNow aus.
-
Ziehen Sie eine Komponente an die gewünschte Position auf der Seite.
Hinweis:Wenn keine Komponenten verfügbar sind, aktualisieren Sie die Vorlagenkonfiguration, um die Wissenskomponenten einzubeziehen. Darüber hinaus müssen Sie die Eigenschaften der Website-Vorlage ändern und jede Wissensartikelkomponente der Liste der zulässigen Komponenten hinzufügen.
-
Öffnen Sie das Komponentendialogfeld zur Bearbeitung.
Hinweis:Standardmäßig sind die Wissenskomponenten im Bearbeitungsmodus einer Seite in AEM nicht zugänglich für öffentliche Benutzer, bei denen es sich um nicht angemeldete anonyme AEM-Benutzer handelt. Um das Standardverhalten zu ändern, müssen Sie die Eigenschaft Öffentlich für jede Wissenskomponente aktivieren.
-
Legen Sie die Komponenteneigenschaften für Suchergebnisse fest, um Wissenssuchergebnisse anzuzeigen, die eine Liste von Wissensartikeln aus den Knowledge Bases in der ServiceNow-Instanz enthalten.
Tabelle : 1. Komponenteneigenschaften der Suchergebnisse Eigenschaft Beschreibung Öffentlich Diese Option dient dazu, den Inhalt der Komponente für öffentliche Anwender sichtbar zu machen. Wenn sie aktiviert ist, stehen die Wissensartikel, die für nicht authentifizierte Benutzer in der Komponente verfügbar sind, allen Benutzern zur Verfügung, einschließlich öffentlicher Benutzer. 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 ServiceNow-Komponenten verwendet.Sprache Ermöglicht die Anzeige der Suchergebnisse von Wissensartikeln in verschiedenen Sprachen. Wählen Sie eine der folgenden Optionen aus:- Aus ServiceNow OSGi-Konfiguration wählen: Wissensartikel werden in der Sprache angezeigt, die in der OSGi-Konfiguration für ServiceNow-Komponenten konfiguriert ist. Dieser Wert ist standardmäßig ausgewählt.
- Auf Portalsprache beschränken: Wissensartikel werden in der Sprache angezeigt, die in der AEM-Website konfiguriert ist.
- 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 beinhalten Informationen wie den Autor, das Datum der letzten Aktualisierung des Artikels und das Datum der letzten Anzeige des Artikels. Trennen Sie die Felder für mehrere Einträge durch Kommata. Beispiel:
author,sys_view_count,sys_updated_on,ratingAnzahl der Suchergebnisse Maximale Anzahl der Artikel, die in die Suchergebnisliste aufgenommen werden sollen. Verwenden Sie die Erhöhen- und Verringern-Symbole, um die Anzahl der Werte zu erhöhen oder zu verringern. Sie können auch manuell einen Wert eingeben. Der Wert muss größer als 1 sein.
URL der Artikelseite Relative URL der Artikelseite, an die weitergeleitet werden soll. Beispiel: /content/NOWApp/now_article_view.html
Benutzerdefinierte CSS-Klasse Benutzerdefinierte CSS-Klasse zum Anwenden benutzerdefinierter Styles auf diese Komponente. Weitere Informationen finden Sie unter Farben von ServiceNow-Komponenten in AEM anpassen. -
Legen Sie die Eigenschaften der Suchfeldkomponente so fest, dass ein Suchfeld angezeigt wird, in dem Benutzer Suchtext eingeben und Wissensartikel in der ServiceNow-Instanz finden können, die dem Suchtext entsprechen.
Hinweis:Das Auslösen der Suche über diese Suchfeld-Komponente führt zur Suchergebnisse-Komponente.
Tabelle : 2. Suchfeld-Komponenteneigenschaften Eigenschaft Beschreibung Öffentlich Diese Option dient dazu, den Inhalt der Komponente für öffentliche Anwender sichtbar zu machen. Wenn sie aktiviert ist, stehen die Wissensartikel, die für nicht authentifizierte Benutzer in der Komponente verfügbar sind, allen Benutzern zur Verfügung, einschließlich öffentlicher Benutzer. Platzhalter Hinweistext, der im Suchfeld angezeigt wird, um Informationen darüber bereitzustellen, was Benutzer suchen können, oder Bedingungen für den Suchtext zu erläutern. 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 ServiceNow-Komponenten verwendet.Sprache Ermöglicht die Anzeige von Wissensartikeln in verschiedenen Sprachen im Suchfeld. Wählen Sie eine der folgenden Optionen aus:- Aus ServiceNow OSGi-Konfiguration wählen: Wissensartikel werden in der Sprache angezeigt, die in der OSGi-Konfiguration für ServiceNow-Komponenten konfiguriert ist. Dieser Wert ist standardmäßig ausgewählt.
- Auf Portalsprache beschränken: Wissensartikel werden in der Sprache angezeigt, die in der AEM-Website konfiguriert ist.
- Alle Sprachen: Wissensartikel werden in allen Sprachen angezeigt.
URL der Suchseite Relative URL der Suchseite, an die weitergeleitet werden soll. Beispiel: /content/NOWApp/now_article_search.html
Suchparameter Parameterschlüssel für die Suchabfrage. Beispiel: kb_query
Vorauseingabe Option zur Aktivierung der Typeahead-Suche. Anzahl der Vorauseingabe-Suchergebnisse Maximale Anzahl von Artikeln, die in die Vorauseingabe-Suchergebnisliste aufgenommen werden sollen. Verwenden Sie die Erhöhen- und Verringern-Symbole, um die Anzahl der Werte zu erhöhen oder zu verringern. Sie können auch manuell einen Wert eingeben. Der Wert muss größer als 1 sein.
URL der Artikelseite Relative URL der Artikelseite, an die weitergeleitet werden soll. Beispiel: /content/NOWApp/now_article_view.html
Benutzerdefinierte CSS-Klasse Benutzerdefinierte CSS-Klasse zum Anwenden benutzerdefinierter Styles auf diese Komponente. Weitere Informationen finden Sie unter Farben von ServiceNow-Komponenten in AEM anpassen. -
Legen Sie die Komponenteneigenschaften der Artikelansicht so fest, dass Wissensartikel und ihre Anhänge, falls verfügbar, aus einer ServiceNow-Instanz angezeigt werden.
Tabelle : 3. Komponenteneigenschaften der Artikelansicht Eigenschaft Beschreibung Öffentlich Diese Option dient dazu, den Inhalt der Komponente für öffentliche Anwender sichtbar zu machen. Wenn sie aktiviert ist, stehen die Wissensartikel, die für nicht authentifizierte Benutzer in der Komponente verfügbar sind, allen Benutzern zur Verfügung, einschließlich öffentlicher Benutzer. 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 beinhalten Informationen wie den Autor, das Datum der letzten Aktualisierung des Artikels und das Datum der letzten Anzeige des Artikels. Trennen Sie die Felder für mehrere Einträge durch Kommata. Beispiel:
author,sys_view_count,sys_updated_on,ratingSprachparameter Name des URL-Abfrageparameters, der die angeforderte Sprache für einen Wissensartikel enthält. Beispiel: kb_lang
Benutzerdefinierte CSS-Klasse Benutzerdefinierte CSS-Klasse zum Anwenden benutzerdefinierter Styles auf diese Komponente. Weitere Informationen finden Sie unter Farben von ServiceNow-Komponenten in AEM anpassen. -
Legen Sie die Komponenteneigenschaften der Artikelliste so fest, dass eine Liste von Wissensartikeln abhängig von den Listenkriterien angezeigt wird.
Tabelle : 4. Komponenteneigenschaften der Artikelliste Eigenschaft Beschreibung Öffentlich Diese Option dient dazu, den Inhalt der Komponente für öffentliche Anwender sichtbar zu machen. Wenn sie aktiviert ist, stehen die Wissensartikel, die für nicht authentifizierte Benutzer in der Komponente verfügbar sind, allen Benutzern zur Verfügung, einschließlich öffentlicher Benutzer. Titel Titel, der der Artikelliste entspricht, die als Komponenten-Header angezeigt wird. Beispiel: Am häufigsten gelesene 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 ServiceNow-Komponenten verwendet.Sprache Ermöglicht bei Anzeige des Artikels die Darstellung von Wissensartikeln in verschiedenen Sprachen. Wählen Sie eine der folgenden Optionen aus:- Aus ServiceNow OSGi-Konfiguration wählen: Wissensartikel werden in der Sprache angezeigt, die in der OSGi-Konfiguration für ServiceNow-Komponenten konfiguriert ist. Dieser Wert ist standardmäßig ausgewählt.
- Auf Portalsprache beschränken: Wissensartikel werden in der Sprache angezeigt, die in der AEM-Website konfiguriert ist.
- Alle Sprachen: Wissensartikel werden in allen Sprachen angezeigt.
Sekundäre Felder Metadaten eines Wissensartikels, die mit dem Artikel angezeigt werden. Metadaten beinhalten Informationen wie den Autor, das Datum der letzten Aktualisierung des Artikels und das Datum der letzten Anzeige des Artikels. Trennen Sie die Felder für mehrere Einträge durch Kommata. Beispiel:
author,sys_view_count,sys_updated_on,ratingKriterien Liste der Kriterien für die Liste der Wissensartikel. Wählen Sie eine der folgenden Optionen aus: - Featured: Liste der empfohlenen Wissensartikel basierend auf den in der Eigenschaft glide.knowman.default_keyword konfigurierten Stichwörtern Informationen zu empfohlenen Artikeln finden Sie unter Einen Wissensartikel zu besonderen Inhalten hinzufügen und Wissens-Eigenschaften.
- Am häufigsten angezeigt: Zeigen Sie eine Liste der Wissensartikel an, die am häufigsten aufgerufen wurden.
Artikelanzahl Maximale Anzahl von Artikeln, die in die Artikelliste aufgenommen werden sollen. Verwenden Sie die Erhöhen- und Verringern-Symbole, um die Anzahl der Werte zu erhöhen oder zu verringern. Sie können auch manuell einen Wert eingeben. Der Wert muss größer als 1 sein.
URL der Artikelseite Relative URL der Artikelseite, an die weitergeleitet werden soll. Beispiel: /content/NOWApp/now_article_view.html
Hide component when empty (Komponente ausblenden, wenn leer) Option zum Ausblenden der Komponente, wenn keine Wissensartikel zur Anzeige vorhanden sind. Benutzerdefinierte CSS-Klasse Benutzerdefinierte CSS-Klasse zum Anwenden benutzerdefinierter Styles auf diese Komponente. Weitere Informationen finden Sie unter Farben von ServiceNow-Komponenten in AEM anpassen.