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

Настройка подготовки Microsoft Entra для получения сведений о существительном из Workday

  • Статья

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

Сведения о местоимениях в Workday

Workday представляет возможность для работников отображать сведения о местоимениях в своем профиле работника в выпуске Workday 2021 R1. Возможность получения сведения о местоимениях с помощью вызова API веб-служб Workday (WWS) была представлена в API Get_Workers версии 38.1 в выпуске Workday 2022 R1.

Примечание.

Для перехода по ссылкам на определенные заметки и документы сообщества Workday в этой статье требуются учетные данные учетной записи сообщества Workday. Обратитесь к партнеру или администратору Workday, чтобы получить необходимый доступ.

Включение сведений о местоимениях в Workday

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

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

  2. Используйте задачу Workday Maintain Pronouns (Управление местоимениями), чтобы определить предпочтительные сведения о местоимениях (HE/HIM, SHE/HER и THEY/THEM) в арендаторе Workday.

  3. Используйте задачу "Параметры локализации Workday " —> область "Личная информация" для активации данных о существительных для разных стран или регионов.

  4. Выберите группу безопасности системы интеграции Workday, используемую с интеграцией Microsoft Entra. Обновите разрешения домена для группы безопасности для получения доступа GET для отчетов домена Workday — Reports: Public Profile (Отчеты: общедоступный профиль).

    Снимок экрана: разрешения на настройку в Workday.

  5. Активируйте ожидающие изменения политик безопасности.

  6. Выберите работника в арендаторе Workday для тестирования. Задайте для этого работника сведения о местоимении с помощью задачи Edit Personal Information (Изменить личные сведения). Убедитесь, что работник включил отображение местоимений для всех пользователей в настройках общедоступного профиля.

    Снимок экрана: включение отображения местоимений.

  7. Используйте Workday Studio для вызова Get_Workers API версии 38.1 для тестового пользователя с помощью пользователя системы интеграции Workday Microsoft Entra. В заголовке запроса SOAP укажите параметр Include_Reference_Descriptors_In_Response.

      <bsvc:Workday_Common_Header>
     <bsvc:Include_Reference_Descriptors_In_Response>true</bsvc:Include_Reference_Descriptors_In_Response>
  </bsvc:Workday_Common_Header>

  8. В ответе Get_Workers просмотрите сведения о существительных.

    Снимок экрана: ответ API Get_Workers.

Примечание.

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

Убедившись, что данные о том, что имя будет доступно в ответе Get_Workers , перейдите к следующему шагу обновления конфигурации приложения подготовки Microsoft Entra.

Чтобы получить имя из Workday, обновите приложение подготовки Microsoft Entra, чтобы запросить Workday с помощью версии 38.1 веб-служб Workday. Мы рекомендуем сначала протестировать эту конфигурацию в вашей тестовой среде или песочнице, прежде чем вносить изменения в рабочую среду.

  1. Войдите в Центр администрирования Microsoft Entra как минимум администратор приложений.

  2. Перейдите к приложениям Identity>Applications>Enterprise.

  3. Выберите приложение подготовки пользователей Workday в Active Directory или Microsoft Entra и перейдите к подготовке .

  4. В разделе "Учетные данные администратора" обновите URL-адрес клиента, чтобы включить веб-службу Workday версии 38.1, как показано ниже.

    Снимок экрана: приложение подготовки Центра администрирования Microsoft Entra с версией Workday.

  5. Откройте колонку Сопоставления атрибутов. Прокрутите вниз и щелкните " Показать расширенные параметры". Щелкните Edit attribute list for Workday (Изменить список атрибутов для Workday).

  6. Если приложение подготовки настроено для использования API WWS версии 21.1 по умолчанию, ознакомьтесь с этой статьей, чтобы просмотреть и обновить XPATH для каждого атрибута.

  7. Добавление нового атрибута PreferredPronoun с помощью XPATH

    /wd:Worker/wd:Worker_Data/wd:Personal_Data/wd:Personal_Information_Data/wd:Pronoun_Reference/@wd:Descriptor

  8. Сохранение изменений.

  9. Теперь можно добавить новое сопоставление атрибутов для потока атрибута Workday PreferredPronoun к любому атрибуту в AD/Microsoft Entra ID.

  10. Если вы хотите включить в отображаемое имя информацию об имени, можно обновить сопоставление атрибутов для атрибута displayName, чтобы использовать выражение.

    Switch([PreferredPronoun], Join("", [PreferredNameData], " (", [PreferredPronoun], ")"), "", [PreferredNameData])

  11. Если рабочий Аарон Холл установил свою информацию о существии в Workday как HE/HIM, приведенное выше выражение задает отображаемое имя в идентификаторе Microsoft Entra ID как: Aaron Hall (HE/HIM)

  12. Сохранение изменений.

  13. Протестируйте конфигурацию для одного пользователя с подготовкой по запросу.

Следующие шаги