Résolution des problèmes liés au connecteur Microsoft Graph ServiceNow Knowledge

Les erreurs courantes suivantes sont observées lors de la configuration du connecteur, ou lors de l’analyse et de leurs raisons possibles.

1. Impossible de trouver des articles serviceNow Knowledge dans Microsoft 365 Copilot ou recherche Microsoft.

(Cliquez pour développer) Suivez les étapes de résolution des problèmes pour identifier la cause racine.

1. Vérifiez si l’utilisateur qui recherche l’article dispose des autorisations requises pour accéder aux articles ServiceNow Knowledge. Pour ce faire, utilisez l’outil Critères utilisateur diagnostics dans ServiceNow.

2. Vérifiez si l’utilisateur est correctement mappé à une identité Microsoft Entra. Les problèmes de mappage s’affichent généralement sous la forme d’une erreur « 2006 » sous l’onglet Erreur. Vérifiez la formule de mappage utilisateur et, si nécessaire, modifiez la méthode de mappage.
   

   

3. Vérifiez s’il existe un script Avancé dans l’un des critères utilisateur qui accordent l’accès à l’article. (Remarque : les scripts avancés ne sont pas pris en charge dans la version actuelle du connecteur Microsoft Graph ServiceNow Knowledge.)

   1. S’il existe un script avancé configuré dans l’un des critères utilisateur « Impossible de lire » au niveau base de connaissances, tous les articles de l’base de connaissances sont marqués avec refuser l’accès dans les données indexées.

   2. S’il existe un script avancé configuré dans l’un des critères utilisateur « Impossible de lire » au niveau de l’article, l’article est marqué avec refuser l’accès dans les données indexées.

4. Vérifiez s’il existe un critère vide présent au niveau de l’base de connaissances : « Impossible de lire », « Impossible de contribuer ». En outre, case activée s’il existe un critère vide au niveau de l’article : « Impossible de lire ». Les critères vides sont des critères utilisateur avec des champs vides. Si un critère vide est présent, l’article est marqué avec refuser l’accès dans les données indexées.

5. Si vous n’êtes toujours pas en mesure d’identifier la cause racine, contactez l’équipe du support technique du connecteur Microsoft Graph avec les informations suivantes.

   1. ID client
   2. ID de connexion
   3. ID sys de l’article
   4. ID sys de la base de connaissances
   5. Pour la collecte base de connaissances :
      1. Liste des critères utilisateur sys_id disponibles dans la table kb_uc_can_read_mtom (Who Can Read Knowledge Base)
      2. Liste des critères utilisateur sys_id disponibles dans la table kb_uc_cannot_read_mtom (Qui ne peut pas lire la base de connaissances)
      3. Liste des critères utilisateur sys_id disponibles dans la table kb_uc_cannot_contribute_mtom (Qui ne peut pas contribuer à la base de connaissances)
      4. Liste des critères utilisateur sys_id disponibles dans le kb_uc_can_contribute_mtom
   6. En outre, pour les sys_id d’éléments collectés à l’étape 3, partagez :
      1. Liste des critères utilisateur sys_id dans le champ can_read_user_criteria de l’article
      2. Liste des critères utilisateur sys_id dans le champ cannot_read_user_criteria de l’article

2. Impossible de se connecter en raison de l’authentification unique activée par ServiceNow instance

Si votre organization utilise l’authentification unique (SSO) auprès de ServiceNow, vous pouvez avoir des difficultés à vous connecter avec le compte de service. Vous pouvez afficher un nom d’utilisateur et une connexion basée sur un mot de passe en ajoutant login.do à l’URL de instance ServiceNow. Exemple. https://<your-organization-domain>.service-now.com./login.do

3. Réponse non autorisée ou interdite à la demande d’API

(Cliquez pour développer) Suivez les étapes pour résoudre ce problème.

1. Vérifiez les autorisations d’accès aux tables : Si vous voyez une réponse interdite ou non autorisée dans la status de connexion, case activée si le compte de service dispose de l’accès requis aux tables mentionnées à l’étape 2 : Paramètres de la source de données. Vérifiez si le compte de service dispose d’un accès en lecture à toutes les tables de la colonne.

2. Modification du mot de passe du compte : Le connecteur ServiceNow Knowledge Microsoft Graph utilise un jeton d’accès extrait au nom du compte de service pour l’analyse. Le jeton d’accès est actualisé toutes les 12 heures. Vérifiez que le mot de passe du compte de service n’est pas modifié après la publication de la connexion. Vous devrez peut-être réauthentifier la connexion en cas de modification du mot de passe.

3. Vérifiez si le instance ServiceNow se trouve derrière un pare-feu : Le connecteur ServiceNow Knowledge Microsoft Graph peut ne pas être en mesure d’atteindre votre instance ServiceNow s’il se trouve derrière un pare-feu réseau. Vous devez autoriser explicitement l’accès au service de connecteur. Vous trouverez la plage d’adresses IP publiques du service connecteur dans ce tableau. En fonction de la région de votre locataire, ajoutez-la à votre liste d’autorisation réseau ServiceNow instance.

   Environnement	Région	Range
   AIGUILLONNER	Amérique du Nord	52.250.92.252/30, 52.224.250.216/30
   AIGUILLONNER	Europe	20.54.41.208/30, 51.105.159.88/30
   AIGUILLONNER	Asie-Pacifique	52.139.188.212/30, 20.43.146.44/30

4. Les autorisations d’accès ne fonctionnent pas comme prévu : Si vous observez des différences dans les autorisations d’accès appliquées aux résultats de Recherche Microsoft ou Microsoft 365 Copilot, case activée si l’utilisateur qui recherche l’article dispose des autorisations requises pour accéder aux articles ServiceNow Knowledge. Pour ce faire, utilisez l’outil Critères utilisateur diagnostics dans ServiceNow.

4. Pour afficher l’URL de l’article de base de connaissances, modifiez-la dans le portail de support

(Cliquez pour développer) Suivez les étapes pour modifier l’URL de l’article de connaissances.

Le connecteur Microsoft Graph ServiceNow Knowledge calcule la propriété AccessUrl à l’aide de sys_id au <instance_url>/kb_view.do?sys_kb_id<sysId> format . Il ouvre l’article de base de connaissances dans la vue système back-end. Si vous préférez rediriger l’article vers une autre URL, suivez ces instructions.

1. Sous l’onglet Personnalisation de la section Rechercher & Intelligence du Centre d’administration Microsoft 365, accédez à modifier le type de résultat configuré pour votre connexion ServiceNow Knowledge.

   Lorsque la boîte de dialogue « Modifier le type de résultat » s’ouvre, cliquez sur Modifier en regard de la section disposition des résultats.

2. Recherchez le bloc d’éléments contenant la propriété de texte avec les shortDescription valeurs et AccessUrl .

   

3. Modifier la propriété AccessUrl Pour modifier l’URL de destination, modifiez la AccessUrl partie de la propriété text dans le bloc d’éléments. Par exemple, si un article ServiceNow Knowledge doit être redirigé vers https://contoso.service-now.com/sp où sp est le préfixe du portail d’URL de service, procédez comme suit.

   Valeur d’origine	New value
   "[{shortdescription}]({AccessUrl})"	"[{shortdescription}](https://contoso.service-now.com/sp?id=kb_article_view&sysparm_article={number})"

   Où number est la propriété de numéro d’article de base de connaissances. Il doit être marqué comme récupéré dans l’écran Gérer le schéma lors de la création de la connexion.

4. Terminez l’examen des mises à jour de vos types de résultats et appuyez sur Envoyer. Donnez-lui une ou deux minutes pour récupérer les modifications. Vos résultats de recherche doivent maintenant rediriger vers les URL souhaitées.

5. Problèmes liés à l’autorisation « Uniquement les personnes ayant accès à cette source de données »

Si vous constatez des différences dans la validation des critères utilisateur entre ServiceNow et Microsoft Search ou Microsoft 365 Copilot, définissez glide.knowman.block_access_with_no_user_criteria la propriété système sur no.

Si vous rencontrez des problèmes ou si vous souhaitez fournir des commentaires, contactez Microsoft Graph | Support.