Introduzione
Connettere le knowledge base di ServiceNow in modo che gli articoli della knowledge base pubblicati diventino conoscenze ricercabili in Docebo.
Questo connettore sincronizza gli articoli della knowledge base pubblicati dall'istanza ServiceNow in Docebo Knowledge. Copre solo il contenuto degli articoli, non i file o gli allegati.
Come funzionano i permessi per ServiceNow: Docebo legge le knowledge base, gli utenti, i gruppi, i ruoli e i criteri utente che stabiliscono chi può leggere ciascun articolo. Ogni articolo viene mostrato agli utenti la cui email corrisponde a un utente ServiceNow autorizzato a leggerlo. I criteri utente che utilizzano uno script non possono essere valutati a partire dai dati sincronizzati. Vengono applicati solo per gli utenti che connettono il proprio account ServiceNow; pertanto, finché un utente non lo fa, potrebbe visualizzare articoli che tale script gli nasconderebbe. Se si utilizzano criteri utente basati su script, chiedere ai colleghi di connettere i propri account.
1. Informazioni di base
Quali contenuti vengono sincronizzati
| Tipo di contenuto | Stato |
|---|---|
| Articoli della knowledge base pubblicati | Sincronizzato |
| Articoli in bozza | Non sincronizzato |
| Articoli rimossi | Non sincronizzato |
| Articoli scaduti | Non sincronizzato |
| File e allegati | Non sincronizzato |
Quali contenuti vengono estratti
| Tipo di contenuto | Stato |
|---|---|
| Titolo e corpo del testo dell'articolo | Estratto |
| Metadati dell'articolo | Estratto |
| Contenuto di file e allegati | Non estratto |
| Commenti | Non estratto |
2. Prerequisiti nel sistema sorgente
Ruolo obbligatorio
È necessario un amministratore ServiceNow per registrare l'applicazione OAuth.
L'account utilizzato successivamente per autorizzare il connettore deve disporre del ruolo admin, o di un altro ruolo in grado di leggere le knowledge base e gli utenti, i gruppi, i ruoli e i criteri utente che stabiliscono chi può leggere ciascun articolo.
Impostazioni obbligatorie
In ServiceNow deve essere registrata un'applicazione OAuth per Docebo. La creazione è descritta nella sezione successiva.
3. Preparazione nel sistema sorgente
Creare l'applicazione OAuth
In ServiceNow, aprire System OAuth → Application Registry, selezionare New, quindi New Inbound Integration Experience. Creare una nuova integrazione di tipo OAuth - Authorization code grant e incollare l'URL di callback come Redirect URL. Segue sempre questo schema: https://[YOUR-DOCEBO-PLATFORM-URL]/knowledge/v1/integrations/connections/callback, ad esempio https://demo.docebosaas.com/knowledge/v1/integrations/connections/callback.
Recuperare il Client ID e il Client secret
Salvare l'applicazione, quindi copiarne il Client ID e il Client secret. Questi dati andranno inseriti in Docebo insieme al nome dell'istanza.
4. Azioni obbligatorie in Docebo
| Informazioni da inserire | Dove trovarle |
|---|---|
| Nome dell'istanza | La prima parte dell'indirizzo ServiceNow. Ad es. https://acme.service-now.com |
| Client ID | ServiceNow → System OAuth → Application Registry → applicazione creata |
| Client secret | ServiceNow → System OAuth → Application Registry → applicazione creata |
Autorizzare il connettore
- Andare in Componenti aggiuntivi e integrazioni → Connettori di conoscenze → Crea → ServiceNow. Questo menu è visibile solo ai Superadmin.
- Nella scheda Quadro generale, verificare cosa verrà e non verrà sincronizzato, quindi selezionare Inizia.
- Nella scheda Autorizza, inserire il nome dell'istanza, il Client ID e il Client secret, quindi selezionare Autentica.
- Nella finestra pop-up di ServiceNow, accedere con un account in grado di leggere tutti i contenuti da sincronizzare (vedere Ruolo obbligatorio) e consentire l'accesso.
- Nella scheda Scopo, selezionare quali knowledge base rendere disponibili per l'aggiunta alle raccolte di conoscenze in un secondo momento, quindi salvare la selezione.