Устранение неполадок с соединителем Microsoft Graph serviceNow Knowledge

При настройке соединителя или во время обхода контента и их возможных причинах наблюдаются следующие распространенные ошибки.

1. Не удается найти статьи ServiceNow Knowledge в Microsoft 365 Copilot или Поиске (Майкрософт).

(Щелкните, чтобы развернуть) Выполните действия по устранению неполадок, чтобы определить первопричину.

1. Проверьте, имеет ли пользователь, который ищет статью, необходимые разрешения для доступа к статьям ServiceNow Knowledge. Это можно сделать с помощью средства user criteria диагностика в ServiceNow.

2. Проверьте, правильно ли сопоставлен пользователь с удостоверением Microsoft Entra. Проблемы с сопоставлением обычно отображаются как ошибка 2006 на вкладке Ошибка. Проверьте формулу сопоставления пользователей и при необходимости измените метод сопоставления.
   

   

3. Проверьте, есть ли расширенный скрипт в любом из критериев пользователя, предоставляющих доступ к этой статье. (Примечание. Расширенные скрипты не поддерживаются в текущей версии соединителя ServiceNow Knowledge Microsoft Graph.)

   1. Если в любом из условий пользователя "Не удается прочитать" на уровне база знаний настроен расширенный скрипт, все статьи в база знаний помечены как запрещенный доступ к индексированных данных.

   2. Если в любом из условий пользователя "Не удается прочитать" на уровне статьи настроен расширенный скрипт, статья помечена как запрет доступа в индексированных данных.

4. Проверьте наличие пустого критерия на уровне база знаний : "Не удается прочитать", "Не удается внести вклад". Кроме того, проверка, если на уровне статьи есть пустое условие - "Не удается прочитать". Пустое условие — это условие пользователя с пустыми полями. При наличии пустого критерия статья помечена как запрет доступа в индексированных данных.

5. Если вы по-прежнему не можете определить первопричину, обратитесь в службу поддержки соединителя Microsoft Graph со следующими сведениями.

   1. Идентификатор клиента
   2. Идентификатор подключения
   3. Идентификатор sys статьи
   4. Идентификатор sys базы знаний
   5. Для база знаний сбора:
      1. Список условий пользователя, sys_id доступных в таблице kb_uc_can_read_mtom (кто может читать базу знаний)
      2. Список условий пользователя, sys_id доступных в таблице kb_uc_cannot_read_mtom (Кто не может прочитать базу знаний)
      3. Список условий пользователя, sys_id доступных в таблице kb_uc_cannot_contribute_mtom (Кто не может участвовать в базе знаний)
      4. Список условий пользователя, sys_id доступных в kb_uc_can_contribute_mtom
   6. Кроме того, для sys_id элементов, собранных на шаге 3, поделиться следующими сведениями:
      1. Список условий пользователя sys_id в поле can_read_user_criteria статьи
      2. Список условий пользователя, sys_id в поле cannot_read_user_criteria статьи

2. Не удалось войти в систему из-за экземпляра ServiceNow с поддержкой единого входа.

Если ваша организация использует единый вход (SSO) в ServiceNow, могут возникнуть проблемы со входом с помощью учетной записи службы. Вы можете открыть имя пользователя и имя входа на основе пароля, добавив login.do в URL-адрес экземпляра ServiceNow. Эти URL-адреса должны поддерживать протокол HTTPS. https://<your-organization-domain>.service-now.com./login.do

3. Несанкционированный или запрещенный ответ на запрос API

(Щелкните, чтобы развернуть) Выполните действия, чтобы устранить эту проблему.

1. Проверьте разрешения на доступ к таблице: Если в состоянии подключения отображается запрещенный или несанкционированный ответ, проверка, имеет ли учетная запись службы необходимый доступ к таблицам, указанным в шаге 2. Параметры источника данных. Проверьте, имеет ли учетная запись службы доступ на чтение ко всем таблицам в столбце.

2. Изменение пароля учетной записи: Соединитель ServiceNow Knowledge Microsoft Graph использует маркер доступа, извлекаемый от имени учетной записи службы для обхода контента. Маркер доступа обновляется каждые 12 часов. Убедитесь, что пароль учетной записи службы не изменен после публикации подключения. При изменении пароля может потребоваться повторная проверка подлинности подключения.

3. Проверьте, находится ли экземпляр ServiceNow за брандмауэром: Соединитель ServiceNow Knowledge Microsoft Graph может не получить доступ к экземпляру ServiceNow, если он находится за сетевым брандмауэром. Необходимо явно разрешить доступ к службе соединителя. Диапазон общедоступных IP-адресов службы соединителя можно найти в этой таблице. В зависимости от региона клиента добавьте его в список разрешенных сетей экземпляров ServiceNow.

   Среда	Region	Range
   ТЫКАТЬ	Северная Америка	52.250.92.252/30, 52.224.250.216/30
   ТЫКАТЬ	Европа	20.54.41.208/30, 51.105.159.88/30
   ТЫКАТЬ	Азиатско-Тихоокеанский регион	52.139.188.212/30, 20.43.146.44/30

4. Разрешения доступа не работают должным образом: Если вы наблюдаете расхождения в разрешениях доступа, применяемых к поиску (Майкрософт) или Microsoft 365 Copilot результатов, проверка, если пользователь, выполняя поиск по этой статье, имеет необходимые разрешения для доступа к статьям ServiceNow Knowledge. Это можно сделать с помощью средства user criteria диагностика в ServiceNow.

4. Чтобы просмотреть URL-адрес статьи знаний, измените его на портале поддержки.

(Щелкните, чтобы развернуть) Выполните действия, чтобы изменить URL-адрес статьи знаний.

Соединитель ServiceNow Knowledge Microsoft Graph вычисляет свойство AccessUrl с помощью sys_id в <instance_url>/kb_view.do?sys_kb_id<sysId> формате . Откроется статья знаний в системном представлении серверной части. Если вы предпочитаете перенаправлять статью на другой URL-адрес, следуйте этим инструкциям.

1. На вкладке настройки в разделе Поиск & аналитики Центр администрирования Microsoft 365 перейдите, чтобы изменить тип результата, настроенный для подключения ServiceNow Knowledge.

   Когда откроется диалоговое окно "Изменить тип результата", щелкните Изменить рядом с разделом макета результата.

2. Найдите блок элементов, содержащий текстовое свойство со значениями shortDescription и AccessUrl .

   

3. Изменение свойства AccessUrl Чтобы изменить URL-адрес назначения, измените AccessUrl часть свойства text в блоке элементов. Например, если статья ServiceNow Knowledge должна быть перенаправлена на страницу https://contoso.service-now.com/sp , где sp является префиксом портала URL-адреса службы, выполните следующие действия.

   Исходное значение	Новое значение
   "[{shortdescription}]({AccessUrl})"	"[{shortdescription}](https://contoso.service-now.com/sp?id=kb_article_view&sysparm_article={number})"

   Где number — свойство номера статьи знаний. Он должен быть помечен как полученный на экране Управление схемой во время создания подключения.

4. Завершите проверку обновлений типа результатов и нажмите кнопку Отправить. Дайте ему минуту или две, чтобы забрать изменения. Теперь результаты поиска должны перенаправляться на нужные URL-адреса.

5. Проблемы с разрешением "Только люди с доступом к этому источнику данных"

Если вы видите различия в проверке условий пользователя между ServiceNow и Поиском (Майкрософт) или Microsoft 365 Copilot, задайте для glide.knowman.block_access_with_no_user_criteria свойства system значение no.

Если у вас возникли проблемы или вы хотите отправить отзыв, обратитесь в Microsoft Graph | Поддержка.