Introduction
Connectez des bases de connaissances ServiceNow pour que leurs articles publiés deviennent des connaissances consultables dans Docebo.
Ce connecteur synchronise les articles de connaissances publiés de votre instance ServiceNow avec Docebo Knowledge. Il ne couvre que le contenu des articles, et non les fichiers ou les pièces jointes.
Fonctionnement des droits pour ServiceNow : Docebo lit les bases de connaissances, les utilisateurs, les groupes, les rôles et les critères utilisateur qui déterminent qui peut lire chaque article. Chaque article est présenté aux utilisateurs dont l’adresse e-mail correspond à celle d’un utilisateur ServiceNow autorisé à le lire. Les critères utilisateur qui reposent sur un script ne peuvent pas être évalués à partir des données synchronisées. Ils ne s’appliquent qu’aux utilisateurs qui connectent leur propre compte ServiceNow, si bien que tant qu’un utilisateur ne l’a pas fait, il peut voir des articles que ce type de script lui masquerait. Si vous utilisez des critères utilisateur basés sur des scripts, demandez à vos collègues de connecter leur compte.
1. Informations de base
Contenu synchronisé
| Type de contenu | Statut |
|---|---|
| Articles de connaissances publiés | Synchronisé |
| Articles en brouillon | Non synchronisé |
| Articles retirés | Non synchronisé |
| Articles expirés | Non synchronisé |
| Fichiers et pièces jointes | Non synchronisé |
Contenu extrait
| Type de contenu | Statut |
|---|---|
| Titre et corps de texte de l’article | Extrait |
| Métadonnées de l’article | Extrait |
| Contenu des fichiers et des pièces jointes | Non extrait |
| Commentaires | Non extrait |
2. Prérequis dans le système source
Rôle obligatoire
L’enregistrement de l’application OAuth doit être effectué par un administrateur ServiceNow.
Le compte que vous utiliserez ensuite pour autoriser le connecteur doit disposer du rôle admin, ou d’un autre rôle permettant de lire les bases de connaissances ainsi que les utilisateurs, les groupes, les rôles et les critères utilisateur qui déterminent qui peut lire chaque article.
Paramètres obligatoires
Une application OAuth doit être enregistrée dans ServiceNow pour Docebo. Vous la créerez dans la section suivante.
3. Préparation dans le système source
Créer l’application OAuth
Dans ServiceNow, ouvrez System OAuth → Application Registry, sélectionnez New, puis New Inbound Integration Experience. Créez une nouvelle intégration de type OAuth - Authorization code grant, puis collez l’URL de rappel en tant que Redirect URL. Elle suit toujours ce modèle : https://[YOUR-DOCEBO-PLATFORM-URL]/knowledge/v1/integrations/connections/callback, par exemple https://demo.docebosaas.com/knowledge/v1/integrations/connections/callback.
Récupérer l’ID client et le secret client
Enregistrez l’application, puis copiez son ID client et son Secret client. Vous les saisirez dans Docebo avec le nom de votre instance.
4. Actions obligatoires dans Docebo
| Informations à saisir | Où les trouver |
|---|---|
| Nom de l’instance | La première partie de votre adresse ServiceNow. Par exemple https://acme.service-now.com |
| ID client | ServiceNow → System OAuth → Application Registry → votre application |
| Secret client | ServiceNow → System OAuth → Application Registry → votre application |
Autorisation du connecteur
- Accédez à Modules et intégrations → Connecteurs de connaissances → Créer → ServiceNow. Ce menu n’est visible que par les Superadmins.
- Dans l’onglet Aperçu, vérifiez ce qui sera synchronisé et ce qui ne le sera pas, puis sélectionnez Démarrer.
- Dans l’onglet Autoriser, saisissez le nom de l’instance, l’ID client et le secret client, puis sélectionnez S’authentifier.
- Dans la fenêtre contextuelle ServiceNow, connectez-vous avec un compte capable de lire tout ce que vous souhaitez synchroniser (voir Rôle obligatoire), puis autorisez l’accès.
- Dans l’onglet Champ d’application, sélectionnez les bases de connaissances que vous souhaitez pouvoir ajouter ultérieurement à des collections de connaissances, puis enregistrez votre sélection.