Integrationseinstellungen für ServiceNow -Services und -Komponenten in AEM konfigurieren

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 3 Minuten Lesedauer

    • Sie müssen Ihre ServiceNow-Dienste und -Komponenten so einrichten, dass sie sich in Ihre Adobe Experience Manager (AEM)-Instanz integrieren lassen.

    Einstellungen zum Aktivieren der Verwendung von ServiceNow-Services in AEM

    Sie können die folgenden Arten von Konfigurationseinstellungen für ServiceNow-Services in AEM definieren:

    Einstellungen für die Verwendung von ServiceNow-Komponenten in AEM

    Um den Knowledge API-Endpunkt in Ihrer AEM-Instanz zu verwenden, müssen Sie die CORS-Regel (Cross-Origin Resource Sharing) für Ihre ServiceNow-Instanz definieren. Weitere Informationen finden Sie unter Cross Origin Ressource Sharing-Regeln für den Zugriff auf die ServiceNow-API-Endpunkte von AEM definieren.

    OSGi-Konfigurationseinstellungen für ServiceNow-Services definieren

    Definieren Sie OSGi-Konfigurationseinstellungen für ServiceNow-Services, die von ServiceNow-Komponenten in Adobe Experience Manager (AEM) verwendet werden.

    Vorbereitungen

    Erforderliche Rolle: AEM-Administrator

    Prozedur

    1. Greifen Sie auf die Webkonsole in AEM zu, indem Sie eine URL im folgenden Format verwenden: https://<AEM_Hostname>:<AEM_Port>/system/console/configMgr.
    2. Suchen Sie nach ServiceNow-Konfiguration.
    3. Klicken Sie in der Spalte Name auf den Link ServiceNow-Konfiguration.
    4. Geben Sie Werte für die Konfigurationseinstellungen an.
      Tabelle : 1. ServiceNow-Konfigurationseinstellungen
      Feld Beschreibung
      Basisinstanz-URL Vollständige URL Ihrer ServiceNow-Instanz.
      Knowledge Bases Systembezeichner (sys_id) einer Knowledge Base, die zugehörige Wissensartikel enthält. Trennen Sie bei mehreren Einträgen die Knowledge Bases durch Kommata.
      Hinweis:
      Ein leerer Wert gibt an, dass Artikel aus allen Knowledge Bases in Ihrer ServiceNow-Instanz für einen Benutzer mit den entsprechenden Berechtigungen zugänglich sind.
      Artikel in allen Sprachen anzeigen Option zum Anzeigen von Wissensartikeln in allen Sprachen für ServiceNow-Komponenten.
    5. Klicken Sie auf Speichern.

    Protokolldateieinstellungen für die ServiceNow-Services in Adobe Experience Manager (AEM) konfigurieren

    Konfigurieren Sie Protokolldateieinstellungen für ServiceNow-Services in Adobe Experience Manager (AEM), um Debug-Protokolle zu generieren, die bei der Erkennung von Problemen im Authentifizierungsprozess helfen.

    Vorbereitungen

    Erforderliche Rolle: AEM-Administrator

    Prozedur

    1. Greifen Sie auf die Webkonsole in AEM zu, indem Sie eine URL im folgenden Format verwenden: https://<AEM_Hostname>:<AEM_Port>/system/console/configMgr.
    2. Navigieren zu OSGi > Konfiguration.
    3. Suchen Sie logs/project-servicenow-components.log: info, und wählen Sie die Option aus.
    4. Überprüfen Sie die Standardfeldwerte, oder tragen Sie für eine benutzerdefinierte Konfiguration eigene Werte ein.
      Tabelle : 2. Protokollierung-Konfigurationseinstellungen
      Feld Wert
      Protokollebene Debuggen
      Protokolldatei Pfad der ServiceNow-Protokolldatei.
      Nachrichtenmuster Nachrichtenformat-Muster zum Formatieren von Protokollnachrichten.
      Protokollierung Protokollierungsname für ServiceNow-Anmelde-Services.
      Additivität Option zum Deaktivieren des Sendens von Protokollen an einen weiter oben in der Hierarchie angehängten Appender.
    5. Klicken Sie auf Speichern.

    Cross Origin Ressource Sharing-Regeln für den Zugriff auf die ServiceNow-API-Endpunkte von AEM definieren

    Definieren Sie eine CORS-Regel (Cross-Origin Resource Sharing) auf Ihrer ServiceNow-Instanz, um von Ihrer AEM-Instanz (Adobe Experience Manager) aus auf Endpunkte der Knowledge Management-REST-API, Fall-API oder CSM-Anhang-API zuzugreifen.

    Vorbereitungen

    Vergewissern Sie sich, dass Sie die API konfiguriert haben, für die Sie die CORS-Regel definieren.
    • 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.
    • Aktivieren Sie das Plugin „Customer Service“ (com.sn_customerservice), um die Fall-API-Endpunkte für Kundenservicefälle zu verwenden. Weitere Informationen finden Sie unter Fall-API.
    • Konfigurieren Sie die Systemeigenschaft glide.rest.attachment_csm_api.allowed_tables, und schließen Sie die Falltabelle [sn_customerservice_case] ein, um die CSM-Anhang-API-Endpunkte für Fallanlagen zu verwenden. Weitere Informationen finden Sie unter CSM-Anhang-API.

    Erforderliche Rolle: web_service_admin

    Warum und wann dieser Vorgang ausgeführt wird

    Prozedur

    1. Navigieren zu Alle > System-Webservices > CORS-Regeln.
    2. Klicken Sie auf Neu.
    3. Füllen Sie die Felder im Formular „CORS-Regel“ aus.
      Tabelle : 3. CORS-Regelformular
      Feld Beschreibung
      Name Name zum Identifizieren Ihrer CORS-Regel.
      REST-API REST API, für die diese CORS-Regel gilt.
      • Für Wissensartikel wählen Sie Knowledge Management-REST-API [sn_km_api/knowledge] aus.
      • Für Kundenservicefälle wählen Sie Fall [sn_customerservice/case] aus.
      • Für Fallanlagen wählen Sie die CSM-Anhang-API aus [now attachment_csm] aus.
      Domäne AEM-Instanz, für die diese CORS-Regel gilt.
      Max. Alter Anzahl von Sekunden, um die Clientsitzung im Cache zu speichern.
    4. Wählen Sie in der zugehörigen Liste „HTTP-Methoden“ HTTP-Methoden aus, um eine Anforderung an einen Webservice-Provider zu senden.
      • Für Wissensartikel wählen Sie GET.
      • Für Kundenservicefälle wählen Sie GET, PUT, POST.
      • Für Fallanlagen wählen Sie GET, POST, DELETE.
    5. Geben Sie im Feld Zugängliche Header der zugehörigen Liste „HTTP-Header“ für Fall-API X-Gesamtzahl ein.
    6. Klicken Sie auf Absenden.