Тестовое приложение пакета SDK для соединителей Microsoft Graph

Исполняемый файл GraphConnectorAgentTest — это тестовая служебная программа для пользовательского соединителя. Он не создает подключения и не добавляет данные в индекс Майкрософт. Служебная программа тестирования выполняется на компьютере, где установлен агент, и не подключается к внешним ресурсам, за исключением источника данных, который является частью теста. Тестовое приложение можно найти в папке TestApp в папке установки агента соединителя Microsoft Graph.

Обновите следующие файлы конфигурации, чтобы использовать эту тестовую программу:

• ConnectionInfo.json. Этот файл содержит все сведения о подключении: идентификатор соединителя, определяющий настраиваемый соединитель, для которого создается это подключение, URL-адрес источника данных, учетные данные для доступа к источнику данных, схему, связанную с подключением, и дополнительные параметры подключения. Этот файл конфигурации находится в папке Config тестового приложения.

• CustomConnectorPortMap.json. После создания пользовательского соединителя добавьте в этот файл сопоставление идентификатора соединителя и порта, на котором он работает. Этот файл находится в папке установки агента соединителя Microsoft Graph.

  

  Примечание.

  В этот файл можно добавить несколько идентификаторов соединителей и соответствующие сведения о портах, используя <формат соединителя Id>:<Port> . Каждый уникальный соединитель должен работать на разных портах.

• Manifest.json. Файл манифеста необходим для идентификации соединителя и его конфигурации при публикации подключения через центр Microsoft 365 Admin. Обновите этот файл манифеста, чтобы использовать его для проверки в этом тестовом приложении. Этот файл находится в папке Config тестового приложения.

  Укажите сведения о манифесте в следующем формате:

  {
    // This is the unique connector ID/provider ID.
    "connectorId": "<ConnectorGuid>",
  
    // This is a list of all supported auth types. Remove the ones that the connector does not support.
    "authTypes": [ "Windows", "Basic", "Anonymous", "OAuth2ClientCredentials" ],
  
    // The list of additional crawl types that the connector supports in addition to full and periodic full crawl. This is an optional field.
    "additionalCrawlsSupported": [ "Incremental" ]
  }
  
  

  • connectorId должен быть GUID. Это поле совпадает с полем ConnectorUniqueId в файле реализации службы сведений о соединителе или идентификаторе GUID, который вы определяете.
  • AuthTypes должен быть непустый массив с одним или несколькими из следующих типов: Anonymous, Basic, Windows, . OAuth2ClientCredentials
  • additionalCrawlsSupported является необязательным; Вы можете определить типы обхода контента в дополнение к полному и периодическому полному обходу контента в зависимости от реализации и поддержки источника данных. В настоящее время в качестве параметра доступен только Incremental обход контента.

Тестовые сценарии

Тестовая служебная программа имеет пять вариантов:

• Проверка подключения к службе соединителя. Проверяет, может ли служебная программа тестирования подключиться к соединителю, указанному в ConnectionInfo.json, через порт, указанный для этого идентификатора соединителя в CustomConnectorPortMap.json.

• Поток создания тестового подключения (ValidateAuthentication, ValidateCustomConfiguration, API GetDataSourceSchema): проверяет методы, указанные в ConnectionManagementService. Он вызывает каждый из методов и отображает результаты на консоли.

• Проверка манифеста. Проверяет содержимое manifest.json. Он проверяет, реализованы ли API-интерфейсы, связанные с информацией, предоставленной в манифесте. Тестовое приложение возвращает обновленный манифест после проверки. Используйте этот проверенный манифест для дальнейшего тестирования и использования.

• Тестирование обхода источника данных с имитируемым подключением. Проверяет методы в ConnectorCrawlerService. Он вызывает обход контента по расписанию, указанному в ConnectionInfo.json, и выводит состояние текущего или последнего завершенного обхода каждую минуту. После успешного завершения первого обхода отображается сообщение о завершении обхода контента, а платформа продолжает работать, чтобы активировать дополнительные обходы контента через интервал, указанный в ConnectionInfo.json. Если указать частоту добавочного обхода контента в файле ConnectionInfo.json, он активирует добавочный обход контента после первого полного обхода.

• Проверка сквозного потока публикации подключения. Проверяет весь поток от создания настраиваемого подключения до обхода источника данных. Вам будет предложено предоставить входные данные в той же последовательности, что и поток публикации подключения Microsoft 365 Admin Center. Проверка выполняется на каждом шаге в зависимости от входных данных.

Чтобы остановить обход источника данных, закройте и перезапустите исполняемый файл GraphConnectorAgentTest. Затем можно выбрать другой вариант теста или повторно протестировать параметр после обновления кода соединителя или файлов конфигурации.

Как работает исполняемый файл GraphConnectorAgentTest?

При открытии исполняемого файла GraphConnectorAgentTest он считывает файл конфигурации ConnectionInfo.json. После выбора одного из параметров теста он попытается подключиться к указанному соединителю через порт, указанный в файле конфигурации CustomConnectorPortMap. После подключения платформа вызывает соответствующие методы.

При тестировании потока создания подключения или обхода источника данных укажите учетные данные для доступа к источнику данных в файле конфигурации ConnectionInfo.json. Платформа считывает учетные данные и передает их соединителю для доступа к источнику данных. До тех пор, пока никто другой не имеет доступа к файлу конфигурации ConnectionInfo.json, учетные данные являются безопасными.

Связанные материалы

• Рекомендации
• Устранение неполадок