Поделиться через

Соединитель BambooHR Microsoft 365 Copilot (предварительная версия)

Соединитель Microsoft 365 Copilot для данных людей позволяет организациям индексировать данные из сторонних систем в Microsoft 365. BambooHR является одной из этих сторонних систем.

Соединитель BambooHR Microsoft 365 Copilot позволяет организациям индексировать профили из BambooHR в Microsoft Graph, что делает их доступными в интерфейсах Microsoft 365, включая Microsoft 365 Copilot.

Это руководство предназначено для администраторов Microsoft 365 или тех, кто отвечает за настройку соединителя BambooHR Copilot, а также управление ими.

Возможности

  • Индексирование сведений о профиле из BambooHR.
  • Разрешить пользователям задавать вопросы, связанные с профилями BambooHR.
  • Используйте семантический поиск в Copilot, чтобы пользователи могли находить релевантные профили на основе ключевых слов, личных предпочтений и социальных связей.

Дополнительные сведения см. в разделе соединитель Microsoft 365 Copilot для данных людей.

Ограничения

  • Время отгула, документы, преимущества, учебные курсы, ресурсы, заметки, чрезвычайные ситуации, подключение, отключение и настраиваемые свойства не индексируемы.

Предварительные условия

  1. Настройте приложение на портале разработчика BambooHR.

  2. Настройте приложение BambooHR с уникальным именем приложения.

    Снимок экрана: добавление приложения.

  3. Добавьте прямые URL-адреса в поле URL-адреса перенаправления в разделе сведений о приложении.
    Для Microsoft 365 корпоративный скопируйте и вставьте:https://gcs.office.com/v1.0/admin/oauth/callback

    Снимок экрана: сведения о приложении.

    Снимок экрана: форма

  4. В поле Области приложения выберите следующие области с доступом только для чтения:

    Категория Требуемые области
    Claims email
    openid
    Сотрудник служащий
    employee:contact
    employee:identification
    employee:job
    employee:management
    employee:name
    employee_directory
    sensitive_employee:protected_info
    Разное поле
    offline_access
    public.user
    Отчеты сообщать

    Снимок экрана: выбор областей.

    Снимок экрана: выбор области.

  5. Перейдите к учетным данным приложения, чтобы получить идентификатор клиента приложения и секрет клиента приложения.

    Снимок экрана: раздел идентификатора клиента и секрета клиента.

Начало работы

Добавьте соединитель BambooHR Microsoft 365 Copilot.

Снимок экрана: добавление соединителя BambooHR Microsoft 365 Copilot из каталога.

1. Выберите отображаемое имя

Выберите отображаемое имя, например BambooHR Profiles, которое помогает пользователям легко распознавать связанные профили в ответе Copilot.

2. Добавьте URL-адрес экземпляра.

Введите URL-адрес экземпляра BambooHR, например: https://contoso.bamboohr.com/

3. Выбор типа проверки подлинности

Выберите OAuth 2.0 из списка типов проверки подлинности и введите идентификатор клиента и секрет клиента на портале приложения BambooHR.

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

Страница Параметры Значения по умолчанию
Пользователи Разрешения доступа

Примечание. Все данные, полученные через соединитель BambooHR Copilot, видны всем пользователям в клиенте Майкрософт. Однако мы не изменяем поведение системы, например соблюдение ограничений доступа. Если пользователю запрещено просматривать данные профиля другого пользователя, эти данные профиля (включая данные BambooHR Copilot) не будут совместно использоваться или храниться в представлении заблокированного пользователя. Данные с ограниченным доступом будут включены в будущие обновления при реализации элементов управления разрешениями на уровне пользователя.		 Все профили доступны для всех пользователей.
Сопоставление удостоверений Удостоверения источников данных, сопоставленные с помощью идентификаторов Microsoft Entra.
Синхронизация Добавочный обход контента Частота: каждые 15 минут.
Синхронизация Полный обход контента Частота: каждый день.
Свойство Schema Описание Свойство в схеме профиля пользователя Microsoft 365
Имя Имя сотрудника name-first>
Фамилия Фамилия сотрудника name-last>
Имя Полные имена сотрудников names-displayName>
Электронная почта Рабочий адрес электронной почты сотрудника emails-address>[type='work']

Примечание. Email преобразуется в Microsoft Entra objectId конечного пользователя и используется для внутренней обработки.
Дата рождения Дата рождения сотрудника годовщины-дата>[type='день рождения']
Отдел сведений о задании Отдел работы сотрудника, например, кадровые ресурсы positions-detail-company-department>>>
Разделение сведений о задании Разделение работы сотрудника, например, Северная Америка position-detail-company-division>>>
Номер сотрудника Номер сотрудника position-detail-employeeId>>
Eeid сотрудника Идентификатор сотрудника в BambooHR webAccounts-userId>

Примечание. Eeid сотрудника также используется внутри компании, чтобы периодически проверка для любых обновлений для данного сотрудника в BambooHR.
Состояние занятости Состояние сотрудника, например полный рабочий день, подрядчик и т. д. position-detail-employeeType>>
Исходное время даты найма Данные о найме сотрудника годовщины-дата>[type='originalHireDate']
Дата аренды Данные о найме сотрудника

Примечание. Если время первоначальной даты найма имеет значение NULL, мы индексируем время даты найма		 годовщины-дата>[type='originalHireDate']
Название задания сведений о задании Должность сотрудника, например старший администратор отдела кадров positions-detail-jobTitle>>
Идентификатор руководителя Идентификатор руководителя сотрудника positions-manager-userId>>

Примечание. Идентификатор руководителя используется для поиска сообщения электронной почты руководителя, который затем преобразуется в Microsoft Entra objectId руководителя для внутренней обработки.
Мобильный телефон Рабочий мобильный телефон сотрудника phone-number>(type=mobile)
Рабочий телефон Рабочий телефон сотрудника phone-number>(type=work)
Расположение сведений о задании Расположение офиса сотрудника positions-positionDetail-companyDetail-officeLocation>>>
Состояние Состояние сотрудника, например активный или неактивный Н/Д

Примечание. Внутреннее использование для фильтрации неактивных сотрудников, чтобы исключить их из получения данных BambooHR.

Настраиваемая настройка

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

Пользователи

Соединитель BambooHR Copilot поддерживает только данные, видимые для всех. Это означает, что индексированные данные отображаются в результатах поиска для всех пользователей. Соединитель BambooHR Copilot поддерживает сопоставление удостоверений источника данных только с Microsoft Entra ID, проверяя, совпадает ли адрес электронной почты профилей BambooHR с UserPrincipalName (UPN) или адрес электронной почты пользователей в Microsoft Entra ID.

Содержимое

Соединитель BambooHR Copilot не поддерживает добавление новых свойств или удаление существующих свойств на этой вкладке. На этой вкладке есть свойство с именем annotationSerialized, которое включает все свойства по умолчанию, упомянутые ранее.

Синхронизация

Интервал обновления определяет частоту синхронизации данных между источником данных и индексом соединителя BambooHR Copilot. Существует два типа интервалов обновления: полный обход контента и добавочный обход контента. Дополнительные сведения см. в разделе Параметры обновления.

Устранение неполадок

  1. Недопустимые учетные данные. Проверьте учетные данные из приложения BambooHR.

    Убедитесь, что области правильно настроены в приложении BambooHR, и убедитесь, что введенные идентификатор и секрет клиента совпадают в приложении BambooHR.

Дальнейшие действия

После публикации подключения можно просмотреть состояние в разделе Источники данных в Центре администрирования. Сведения об обновлении и удалении см. в статье Управление соединителем.

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