Einführung
Verbinden Sie ServiceNow-Wissensdatenbanken, damit veröffentlichte Wissensartikel in Docebo als durchsuchbares Wissen verfügbar werden.
Dieser Konnektor synchronisiert veröffentlichte Wissensartikel aus Ihrer ServiceNow-Instanz mit Docebo Knowledge. Der Inhalt von Artikeln wird berücksichtigt, Dateien oder Anhänge jedoch nicht.
So funktionieren die Berechtigungen für ServiceNow: Docebo liest die Wissensdatenbanken, Benutzer, Gruppen, Rollen und Benutzerkriterien, anhand derer festgelegt wird, wer die einzelnen Artikel lesen darf. Jeder Artikel wird Benutzern angezeigt, deren E-Mail-Adresse mit der eines ServiceNow-Benutzers übereinstimmt, der zum Lesen des Artikels berechtigt ist. Benutzerkriterien, die ein Skript verwenden, können anhand der synchronisierten Daten nicht ausgewertet werden. Sie werden nur auf Benutzer angewendet, die ihr eigenes ServiceNow-Konto verbinden. Bis dies geschehen ist, werden diesen Benutzern möglicherweise Artikel angezeigt, die ein solches Skript vor ihnen verbergen würde. Wenn Sie skriptbasierte Benutzerkriterien verwenden, bitten Sie Ihre Kollegen, ihre Konten zu verbinden.
1. Grundlegende Informationen
Welche Inhalte synchronisiert werden
| Inhaltstyp | Status |
|---|---|
| Veröffentlichte Wissensartikel | Synchronisiert |
| Entwurfsartikel | Nicht synchronisiert |
| Archivierte Artikel | Nicht synchronisiert |
| Abgelaufene Artikel | Nicht synchronisiert |
| Dateien und Anhänge | Nicht synchronisiert |
Welche Inhalte extrahiert werden
| Inhaltstyp | Status |
|---|---|
| Artikeltitel und Artikeltext | Extrahiert |
| Artikelmetadaten | Extrahiert |
| Datei- und Anhanginhalte | Nicht extrahiert |
| Kommentare | Nicht extrahiert |
2. Voraussetzungen im Quellsystem
Erforderliche Rolle
Sie benötigen einen ServiceNow-Administrator, um die OAuth-Anwendung zu registrieren.
Das Konto, mit dem Sie den Konnektor später autorisieren, benötigt die Rolle admin oder eine andere Rolle, mit der die Wissensdatenbanken sowie die Benutzer, Gruppen, Rollen und Benutzerkriterien gelesen werden können, anhand derer festgelegt wird, wer die einzelnen Artikel lesen darf.
Erforderliche Einstellungen
Für Docebo muss eine OAuth-Anwendung in ServiceNow registriert werden. Sie erstellen sie im nächsten Abschnitt.
3. Vorbereitung im Quellsystem
OAuth-Anwendung erstellen
Öffnen Sie in ServiceNow System OAuth → Application Registry, wählen Sie New und anschließend New Inbound Integration Experience. Erstellen Sie eine neue Integration des Typs OAuth - Authorization code grant und fügen Sie die Callback-URL als Redirect URL ein. Sie folgt immer diesem Muster: https://[YOUR-DOCEBO-PLATFORM-URL]/knowledge/v1/integrations/connections/callback, zum Beispiel https://demo.docebosaas.com/knowledge/v1/integrations/connections/callback.
Client-ID und Client-Secret abrufen
Speichern Sie die Anwendung und kopieren Sie anschließend deren Client ID und Client secret. Sie geben diese zusammen mit dem Namen Ihrer Instanz in Docebo ein.
4. Erforderliche Aktionen in Docebo
| Einzugebende Informationen | Wo Sie sie finden |
|---|---|
| Instanzname | Der erste Teil Ihrer ServiceNow-Adresse. Z. B. https://acme.service-now.com |
| Client-ID | ServiceNow → System OAuth → Application Registry → Ihre Anwendung |
| Client-Secret | ServiceNow → System OAuth → Application Registry → Ihre Anwendung |
Konnektor autorisieren
- Gehen Sie zu Add-ons und Integrationen → Wissenskonnektoren → Erstellen → ServiceNow. Dieses Menü ist nur für Superadmins sichtbar.
- Überprüfen Sie auf der Registerkarte Overview, was synchronisiert wird und was nicht, und wählen Sie anschließend Get started.
- Geben Sie auf der Registerkarte Authorize den Instanznamen, die Client-ID und das Client-Secret ein und wählen Sie anschließend Authenticate.
- Melden Sie sich im ServiceNow-Popup mit einem Konto an, das alles lesen kann, was Sie synchronisieren möchten (siehe „Erforderliche Rolle“), und erlauben Sie den Zugriff.
- Wählen Sie auf der Registerkarte Scope die Wissensdatenbanken aus, die später zum Hinzufügen zu Knowledge-Sammlungen verfügbar sein sollen, und speichern Sie anschließend Ihre Auswahl.