Расширенный поток соединителя Microsoft Graph для ServiceNow Knowledge

Если экземпляр ServiceNow использует расширенные скрипты в критериях пользователя базы знаний или статьи, необходимо использовать поток Advanced . Это обеспечивает точную обработку разрешений при приеме содержимого в Microsoft Graph.

Шаг 1. Выбор расширенного потока в программе установки

При настройке соединителя Microsoft Graph для ServiceNow Knowledge выберите параметр Дополнительно в поле "Выбор на основе пользовательских условий, заданных в ServiceNow". Это имеет решающее значение для правильной обработки расширенных условий пользователя.

Шаг 2. Настройка REST API с помощью скриптов в ServiceNow

Чтобы разрешить соединителю получать расширенные условия пользователя, необходимо создать скриптовый REST API в экземпляре ServiceNow. Выполните указанные ниже действия.

2.1. Повышение роли пользователя

1. Повысьте свою роль в ServiceNow до security_admin.

2.2. Создание контроль доступа (ACL)

1. В ServiceNow перейдите в раздел Все > контроль доступа системной безопасности > (ACL).
2. Нажмите кнопку Создать , чтобы создать ACL.
3. Задайте следующие значения:
   • Тип: REST_Endpoint
   • Операция: Execute
   • Имя: Microsoft Copilot
   • Роль: admin(или та же роль, назначенная учетной записи обхода).
4. Нажмите кнопку Отправить.

2.3. Создание REST API с помощью скриптов

1. Перейдите в раздел Все > системные веб-службы > , засписанные скриптами интерфейсы > REST API.

2. Нажмите кнопку Создать.

3. Введите следующее:

   • Имя: Microsoft Copilot
   • Идентификатор API: microsoft_copilot

4. Нажмите кнопку Отправить.

5. На странице списка REST API со скриптами щелкните Microsoft Copilot только что созданный REST API.

6. Задайте для списков ACL по умолчанию значение Microsoft Copilot (из шага 2.2).

2.4. Добавление ресурса в API

1. На вкладке Ресурсы нажмите кнопку Создать.
2. Укажите сведения:
   • Имя: GetAllUserCriteria
   • Относительный путь: /user_criteria
   • Скрипт. Вставьте следующий код:

(function execute (/*RESTAPIRequest*/ request, /*RESTAPIResponse*/ response) {
    var queryParams = request.queryParams;
    var user = new String(queryParams.user);
    return (new sn_uc.UserCriteriaLoader()).getAllUserCriteria(user);
})(request, response);

3. Убедитесь, что установлены оба следующих флажка:

   • Требуется проверка подлинности
   • Требуется авторизация ACL

4. Убедитесь, что для списков ACL задано значение Microsoft Copilot.

5. Нажмите кнопку Обновить.

2.5. Проверка установки

1. Убедитесь, что путь к ресурсу :

   /api/<API Namespace>/microsoft_copilot/user_criteria
   

2. Нажмите кнопку Обновить , чтобы сохранить конфигурацию.

Шаг 3. Введите пространство имен API в интерфейсе настройки соединителя Graph

В настройке соединителя Microsoft Graph введите пространство имен API , созданное в ServiceNow.

Например: если путь к ресурсу — /api/abcdef/microsoft_copilot/user_criteria, то пространство имен API имеет значение abcdef.