Публикация пользовательских соединителей в Центр администрирования Microsoft 365
При использовании пакета SDK для соединителей Microsoft Graph можно опубликовать пользовательские соединители через Центр администрирования Microsoft 365 так же, как и встроенные соединители Майкрософт.
Примечание.
Ознакомьтесь со статьей Настройка соединителя Graph , чтобы понять общие инструкции по настройке соединителей Graph.
Чтобы опубликовать подключение для пользовательского соединителя, выполните следующие действия.
Убедитесь, что файл CustomConnectorPortMap.json обновлен. После разработки пользовательского кода соединителя добавьте в этот файл сопоставление идентификатора соединителя и порта, на котором он работает. Этот файл находится в папке установки агента соединителя Microsoft Graph.
Примечание.
- В этот файл можно добавить несколько идентификаторов соединителей и соответствующие сведения о портах, используя <формат соединителя Id>:<Port> . Каждый уникальный соединитель должен работать на разных портах.
- Если вы выполнили обновление с версии GCA ниже 1.8.0.0, выполните действия по устранению неполадок , чтобы устранить сбои подключения.
Добавьте соединитель Microsoft Graph в Центр администрирования Microsoft 365 на вкладке Источники данных в разделе Аналитика Поиск &. Дополнительные сведения см. в разделе Добавление соединителя Microsoft Graph в Центр администрирования Microsoft 365.
Выберите Пользовательский соединитель и укажите манифест, проверенный тестируемым приложением.
Присвоение имени соединению. Дополнительные сведения см. в разделе Шаг 2. Присвойте соединению имя.
Укажите URL-адрес источника данных, к которому вы подключаетесь, и учетные данные для доступа к нему. Выберите агент соединителя Microsoft Graph и проверьте предоставленные сведения. Нажмите кнопку Далее.
Укажите любую дополнительную конфигурацию, если это необходимо для соединителя. Вы можете передать в источник данных любые сведения, относящиеся к подключению.
Например, если вы создаете соединитель для Azure DevOps Services, проекты, которые необходимо индексировать, могут быть дополнительными параметрами. Для соединителя вики-сайта подразделы, которые необходимо проиндексировать, могут быть дополнительными параметрами. API для запроса вики-сайта может принимать фильтры, указанные в дополнительных параметрах, и получать элементы из источника данных.
Данные в параметре непрозрачны для платформы. Он сериализуется и сохраняется в виде строки и передается соединителю. Соединитель может десериализовать эти данные по мере необходимости и использовать их.
На странице Назначение меток свойств назначьте семантические метки свойствам источника. Тип результата по умолчанию не будет работать, если не назначены семантические метки.
Управление схемой:
- Выберите свойство содержимого. Рекомендуется выбрать свойство содержимого в раскрывающемся меню параметров или оставить значение по умолчанию, если оно присутствует. Это свойство используется для полнотекстового индексирования содержимого и повышения релевантности поиска.
- Определите псевдонимы для свойств. Вы можете добавить псевдонимы в свойства на странице Управление схемой в столбце Псевдоним . Псевдонимы — это понятные имена для ваших свойств.
- Задайте атрибуты схемы поиска. Атрибуты схемы поиска можно задать для управления функциями поиска каждого исходного свойства. Схема поиска помогает определить, какие результаты отображаются на странице результатов поиска и какие сведения пользователи могут просматривать и получать к ней доступ.
Дополнительные сведения см. в разделе Шаг 7. Управление схемой.
Вы можете управлять базовыми списками управления доступом (ACL), которые определяют, какие пользователи в вашей организации могут получить доступ к каждому элементу. Для пользователей, имеющих доступ к источнику данных, поддерживаются только контроль доступа Списки на основе Microsoft Entra ID. Дополнительные сведения см. в разделе Шаг 5. Управление разрешениями поиска.
Выберите частоту обновления обходов контента. Интервал обновления определяет частоту синхронизации данных между источником данных и Microsoft Поиск. Дополнительные сведения см. в разделе Шаг 8. Частота обновления.
Просмотрите предоставленные сведения и нажмите кнопку Готово. Дополнительные сведения см. в разделе Шаг 9. Проверка подключения.
Настройте страницу результатов поиска, настроив вертикали и типы результатов. Дополнительные сведения см. в разделе Шаг 10. Настройка страницы результатов поиска.
Проверьте опубликованное подключение на вкладке Источники данных , чтобы убедиться, что настройка подключения сработала. Дополнительные сведения см. в разделе Шаг 11. Подтверждение успешной настройки подключения.