Passer au contenu principal
Configurez et gérez la synchronisation entre le contenu ServiceNow et Paradigm.

Prérequis

Une instance ServiceNow fonctionnelle est requise, avec les éléments suivants :
  • URL de l’instance
  • Identifiants
    • nom d’utilisateur
    • mot de passe
    • ID client
    • secret client

Guide de Configuration

Le connecteur ServiceNow supporte l’authentification de base (non recommandée en production) et l’authentification OAuth. Le nom d’utilisateur et le mot de passe sont donnés lors de la création de l’instance, et ils permettent seulement l’authentification de base. Pour configurer et activer l’authentification OAuth, un ID client et un secret client sont nécessaires.

Générer les Identifiants pour OAuth dans ServiceNow

  1. Dans l’instance ServiceNow, naviguez vers System OAuth > Application Registry
  2. Créez une nouvelle entrée en sélectionnant “Create an OAuth API endpoint for external clients”
  3. Nommez-la et sauvegardez-la
  4. Cliquez sur l’application OAuth nouvellement créée pour récupérer l’ID client et le secret client

Créer une Nouvelle Source de Données dans l’Admin Paradigm

  1. Naviguez vers la section DATASOURCES dans votre interface d’administration Paradigm
  2. Créez une nouvelle Source de Données avec Type de source de données = ServiceNow
  3. Sélectionnez l’Entreprise à laquelle vous souhaitez associer la Source de Données
  4. Remplissez le champ URL de l’instance (ex. https://dev280517.service-now.com)
  5. Ajoutez vos identifiants :
    • nom d’utilisateur : votre nom d’utilisateur de tenant ServiceNow
    • mot de passe : votre mot de passe de tenant ServiceNow
    • id client : votre ID client d’application OAuth (recommandé)
    • secret client : votre secret client d’application OAuth (recommandé)
  6. Sauvegardez la Source de Données
  7. Désormais, vous pouvez cliquer sur le bouton “Test connection” en haut à droite de la page de détail de la Source de Données pour vérifier si ServiceNow est accessible
  8. En cas d’échec du contrôle de santé, veuillez réviser vos identifiants. Si le problème persiste, n’hésitez pas à contacter l’équipe de développement

Créer une Nouvelle Configuration d’Import

  1. Sur la Source de Données nouvellement créée, vous pouvez ajouter un nouvel Import dans la section “IMPORTS”
  2. Ajoutez un nouveau filtre dans le champ Critères de filtre, en complétant les entrées clé/valeur. Par exemple, pour récupérer des articles de connaissance, remplissez doc_type comme clé et knowledge comme valeur
💡 Au moins un filtre est requis → doc_type Il est nécessaire d’identifier quel type d’enregistrements doit être synchronisé dans cet import
  1. D’autres filtres peuvent être sélectionnés pour l’import, pour affiner la sélection des documents
  2. Sélectionnez l’Espace de Travail où les documents seront synchronisés dans votre application Paradigm
  3. Sélectionnez la fréquence de synchronisation entre votre instance ServiceNow et Paradigm
  4. Ajustez la priorité d’import si nécessaire, relativement aux autres imports
  5. Sauvegardez la Source de Données
  6. Désormais, vous pouvez cliquer sur le bouton “Trigger import” à droite de l’Import nouvellement créé, sur la page de détail de la Source de Données, pour lancer une première synchronisation !
  7. Les synchronisations suivantes se poursuivront, en respectant la fréquence

Méthodes d’Authentification

Authentification de Base

  • Utilise directement le nom d’utilisateur et le mot de passe
  • Non recommandée pour les environnements de production
  • Plus simple à configurer mais moins sécurisée

Authentification OAuth (Recommandée)

  • Utilise l’ID client et le secret client
  • Plus sécurisée pour les environnements de production
  • Nécessite une configuration supplémentaire dans ServiceNow mais offre une meilleure sécurité

Dépannage

Problèmes de Connexion

  • Vérifiez que votre URL d’instance ServiceNow est correcte et accessible
  • Vérifiez que vos identifiants sont valides et ont les permissions appropriées
  • Assurez-vous que l’instance ServiceNow fonctionne et est accessible depuis Paradigm

Problèmes d’Import

  • Vérifiez que le filtre doc_type est correctement configuré
  • Vérifiez que l’espace de travail sélectionné existe et est accessible
  • Révisez les journaux d’import pour des messages d’erreur spécifiques
Pour un support supplémentaire avec la configuration de la source de données ServiceNow, contactez l’équipe de développement.
I