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

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 статьи

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

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

Если вы используете OAuth2.0, проверка, если пароль учетной записи правильный или не был сброшен. Соединитель ServiceNow Knowledge Microsoft Graph использует маркер доступа, извлекаемый от имени учетной записи службы для обхода контента. Маркер доступа обновляется каждые 12 часов. При изменении пароля может потребоваться повторная проверка подлинности подключения.

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

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

Соединитель 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-адреса.

По умолчанию ServiceNow пытается подключиться с помощью Microsoft 365 Admin учетных данных через единый вход (SSO) из имени входа в браузер, что может привести к сбою подключения. В результате появится окно "Выход успешно".

Чтобы устранить эту проблему, выполните следующие действия.

1. Откройте окно частного браузера и войдите с учетными данными ServiceNow.
2. На новой вкладке войдите в центр Microsoft 365 Admin. Это позволяет единому входу ServiceNow выходить из службы и при необходимости переключать учетные данные.
3. Повторите попытку настройки OAuth. Для авторизации подключения должно появиться следующее окно:

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

Удар:

• Без правильного доступа все содержимое может быть не проиндексировано, а разрешения могут быть предоставлены неправильно.

Решение

Требуется роль

• ServiceNow Администратор

Действия по проверке разрешений таблиц с помощью REST API Обозреватель:

1. Олицетворение учетной записи обхода контента, созданной в экземпляре ServiceNow.

   Убедитесь, что учетная запись имеет следующие роли: rest_api_explorer и web_service_admin.

2. Перейдите к:
   Rest API системных веб-служб > Обозреватель REST >

3. Выберите одну из таблиц, упомянутых в сообщении об ошибке.

   

4. Задайте значение sysparm_limit10 (чтобы ограничить результаты тестирования).

   

5. Щелкните Отправить.

6. Просмотрите ответ:

   • Если вы получаете 403 Status Code и сообщение об ошибке о том, что вы не имеете права на доступ к таблице, выполните приведенные здесь действия , чтобы предоставить доступ на уровне таблицы.
   • Если вы получаете 200 Status Code но текст ответа содержит пустые результаты (например, нет полей), это означает, что доступ к строкам существует, но доступ на уровне полей отсутствует. Выполните приведенные здесь действия , чтобы предоставить доступ на уровне полей. (media/tsg-servicenowkb-table-access-3.png#lightbox)

   Если имя таблицы не отображается в раскрывающемся списке, это может указывать на отсутствие доступа к самой таблице.

Альтернативный метод: проверка доступа с помощью браузера

1. Откройте окно браузера инкогнито .
2. Введите следующий URL-адрес (замените заполнители соответствующим образом):
   https://<instance-url>/api/now/table/<table_name>?sysparm_limit=10
3. При появлении запроса войдите в систему, используя учетные данные для обхода контента.
4. Просмотрите ответ:
   • Если ответа нет или появится ошибка, у учетной записи, скорее всего, отсутствует необходимый доступ.