Workday에서 조직 데이터 가져오기

Workday SOAP(Simple Object Access Protocol) API에서 데이터를 사용할 수 있고 아래 설명된 프로세스를 사용하여 데이터의 사용자가 100,000명 이하인 경우 Workday 커넥터를 사용하여 조직 데이터를 Microsoft 365로 가져올 수 있습니다.

그렇지 않으면 Workday SOAP API를 호출하지 않고 아래 두 가지 방법 중 하나를 사용하여 Workday RaaS(Report as a Service)에서 데이터를 보낼 수 있습니다.

  • 다음 단계를 사용하여 Workday RaaS(Report as a Service)에서 Azure Blob Storage 연결로 데이터를 보냅니다.

  • 다음 단계를 사용하여 Workday RaaS에서 API 기반 연결로 데이터를 보냅니다.

필수 구성 요소

Workday와 Microsoft 365 간의 연결을 설정하려면 먼저 Workday 관리자로부터 Workday 환경에 대한 다음 정보가 필요합니다.

  • Workday 웹 서비스 URL
  • 토큰 URL
  • 사용자 이름
  • ClientID
  • 이후 섹션에 설명된 Workday 내에서 단계를 완료합니다.

단계

1. Workday 연결 설정

적용 대상: Microsoft 365 전역 관리자

  1. Microsoft 365 조직 데이터 서비스 페이지의 연결 유형 선택 페이지에서 가져오기를 시작합니다(홈>설정>, 마이그레이션 및Microsoft 365 조직 데이터 서비스> 가져오기>,연결 유형 선택). Workday 커넥터에서 Workday 설정 시작을 선택합니다.

    1. 왼쪽에서 Copilot 을 선택한 다음 에이전트 & 커넥터를 선택하여 가져오기를 시작할 수도 있습니다.

    2. 커넥터에서연결을 선택합니다.

    3. 연결 추가를 선택합니다.

    4. 페이지 아래쪽의 People 아래, Workday 옆에 있는 추가를 선택합니다.

    Workday 연결을 시작하는 페이지의 스크린샷.

  2. 시작 (데이터를 처음 가져오는 경우) 또는 새 가져오기 (데이터를 이미 가져온 경우)를 선택합니다.

  3. 연결 유형 선택 페이지에서 Workday 설정 시작을 선택합니다.

  4. 데이터를 공유할 앱 및 서비스를 선택합니다. 기본적으로 모든 공용 예약 특성은 Microsoft 365 및 Viva 앱 및 서비스에서 공유됩니다. 이 페이지를 사용하여 응용 프로그램별 및 사용자 지정 데이터를 공유할 앱을 선택합니다. 사용자는 설정 내에서 언제든지 선택 사항을 변경할 수 있습니다. 자세히 알아보기.

  5. Workday 인증서 다운로드에서 인증서 다운로드를 선택합니다. "publicKey.pem"이라는 x509 인증서 파일이 다운로드됩니다. 텍스트 편집기에서 파일을 열고 내용을 복사합니다. 이를 Workday 관리자와 공유합니다.

    인증서를 다운로드할 페이지의 스크린샷.

  6. 확인 메모를 읽고 다음을 선택합니다.

  7. Workday 연결 설정에서 다음을 수행합니다.

    1. 연결 이름을 입력합니다.

    2. Workday 관리자에게 문의하여 아래 설명된 Workday의 단계를 완료하세요.

    3. Workday 관리자가 제공한 Workday 웹 서비스 URL, 토큰 URL 및 ClientID 를 입력합니다.

    4. 사용자 이름에 Workday 관리자가 만든 ISU의 이름을 입력합니다.

    5. Workday에서 Microsoft 365에 데이터를 보낼 빈도(매주 또는 매월)를 선택합니다.

    6. 다운스트림 앱에서 사용할 수 있도록 하기 전에 수집된 데이터의 품질에 대한 세부 정보를 검토하려면 공유하기 전에 수동으로 데이터 승인을 선택합니다. 방법을 알아보세요.

      연결을 설정하는 페이지의 스크린샷.

  8. 원하는 경우 Microsoft 365 조직 데이터 서비스 우선 순위를 선택합니다. 데이터 우선 순위 지정에 대해 자세히 알아보세요.

  9. Workday API를 사용한 데이터 전송 약관에 동의하는지 확인합니다.

  10. 특성 매핑 업로드 페이지에서 사용자 지정 매핑을 사용하는 경우 찾아보기를 선택하여 사용자 지정한 .json 매핑 파일을 업로드합니다. 그런 다음 페이지 아래쪽에서 다음을 선택합니다.

    • 또는 기본 매핑을 사용하는 경우 .json 파일을 업로드할 필요가 없습니다. 페이지 아래쪽에서 다음을 선택합니다.

  11. 예약된 특성 매핑에 대한 세부 정보를 검토합니다. 변경하려면 특성 매핑 업로드 페이지로 돌아가서 새 .json 파일을 업로드합니다. 모든 것이 좋아 보이면 페이지 아래쪽에서 다음을 선택합니다.

  12. 사용자 지정 특성을 가져온 경우 다음 페이지에서 검토합니다. 이러한 이름은 변경할 수 없으며 데이터 형식을 변경할 수 없습니다. 이름을 변경하려면 특성 매핑 업로드 페이지로 돌아가서 새 .json 파일을 업로드합니다. 모든 것이 좋아 보이면 페이지 아래쪽에서 매핑 확인을 선택합니다.

  13. 다음으로, 앱별 또는 사용자 지정 데이터를 대상에 보낸 경우 매핑한 특성에 액세스할 수 있는 앱을 선택한 다음 모든 Microsoft 365 앱 및 서비스에 사용되는 전역 특성을 확인합니다. 방법을 알아보세요.

  14. 마지막 페이지에서 연결에 대한 모든 세부 정보, 앱 및 특성 매핑을 검토합니다. 모든 항목이 올바르게 표시되면 연결을 선택합니다. 유효성 검사가 완료되면 선택한 앱 및 서비스에서 조직 데이터를 사용할 수 있게 됩니다.

    참고

    주기적인 내보내기를 설정하면 Viva 및 Microsoft 365 서비스 요구 사항에 따라 데이터의 유효성이 검사됩니다. 유효성 검사에는 몇 시간이 걸립니다. 그러나 전체 데이터 업로드를 프로필 저장소에서 사용할 수 있을 때까지 최대 3일이 소요될 수 있습니다. Microsoft 365 관리 센터의 조직 데이터 페이지에서 유효성 검사 상태 검사할 수 있습니다. 유효성 검사가 완료되면 데이터가 Viva 및 Microsoft 365에서 사용 및 관리되고 있다는 메시지가 표시됩니다.

2. Workday 내의 단계

적용 대상: Workday 관리자

  1. Workday를 엽니다. "Create Integration System User"를 검색하여 선택합니다. 실제 사람과 연결되지 않은 시스템 사용자입니다.

    통합 시스템 사용자 만들기에 대한 검색 필드의 스크린샷입니다.

  2. 통합 시스템 사용자 만들기에서 각 필드를 입력한 다음 확인을 선택합니다.

    통합 시스템 사용자를 만드는 페이지의 스크린샷입니다.

  3. 보안 그룹을 만듭니다. Workday에서 "보안 그룹 만들기"를 검색하여 선택합니다.

  4. 통합 시스템 보안 그룹(제한 없음)을 선택합니다.

    보안 그룹을 만드는 페이지의 스크린샷.

  5. 이 그룹에 Integration System 사용자를 추가합니다.

  6. "보안 그룹 유지"를 검색하고 보안 그룹에 대한 권한 유지 관리를 선택합니다.

    보안 그룹에 대한 사용 권한을 유지 관리하는 페이지의 스크린샷.

  7. 작업 옆에 있는 유지 관리를 선택합니다. 원본 보안 그룹 옆에서 만든 보안 그룹을 선택합니다.

    만든 보안 그룹을 선택하는 페이지의 스크린샷.

  8. "+" 아이콘을 선택하여 새 도메인 보안 정책 권한을 추가합니다.

    1. 선택됨 확인란을 선택한 상태로 둡니다.

    2. 액세스 보기/수정 옆에 있는 Get Only를 선택합니다.

    3. 도메인 보안 정책의 경우:

      1. 작업자 데이터 추가: 공개 작업자 보고서
      2. 작업자 데이터 추가: 조직 정보
      3. 개인 데이터 추가: Private Work Email Integration
      4. 개인 데이터 추가: 기술
      5. 작업자 데이터 추가: 현재 직원 정보

      도메인 보안 정책을 추가하는 페이지의 스크린샷입니다.

  9. "보류 중인 보안 정책 변경 사항 활성화"를 검색하여 선택합니다.

  10. 변경 내용에 대한 설명이 포함된 메모를 추가하고 확인을 선택합니다.

  11. 확인을 선택한 다음 확인을 선택합니다. 이제 작업자 데이터를 가져오는 데 필요한 적절한 권한을 가진 새 시스템 사용자가 있습니다.

3. API 클라이언트 등록

  1. "API 클라이언트 등록"을 검색하여 선택합니다.

    API 클라이언트를 검색하는 페이지의 스크린샷.

  2. 다음 필드를 입력합니다.

    1. 클라이언트에 "VivaConnectorClient"와 같은 적절한 이름을 지정합니다.
    2. 클라이언트 권한 부여 유형으로 Jwt 전달자 권한 부여를 선택합니다.
    3. x509 인증서의 경우:
      1. x509 공개 키 만들기를 선택합니다.
      2. 인증서에 "VivaX509Certificate"와 같은 적절한 이름을 지정합니다.
      3. 이전 단계에서 전역 관리자가 공유한 publicKey.pem 파일의 내용을 붙여넣습니다.
      4. 확인을 선택합니다.
      5. x509 인증서 필드에 대해 이 인증서가 선택되어 있는지 확인합니다.
    4. 통합 시스템 사용자에 이전에 만든 사용자를 입력합니다.
    5. 액세스 토큰 유형을 "소지자"로 둡니다.
    6. 범위(기능 영역)에서 "직원 배치", "연락처 정보" 및 "직원 프로필 및 기술"을 검색하여 선택합니다.
    7. 근무일 소유 범위 포함을 해제한 상태로 둡니다.
    8. 나머지 필드의 기본값을 선택합니다.

  3. 확인을 선택합니다.

    API 클라이언트 창의 스크린샷

  4. IP 범위로 제한 아래에 몇 가지 새 필드가 채워집니다. 다음 정보를 저장하고 전역 관리자와 공유하여 Microsoft 365 관리 센터에 입력합니다.

    1. "ClientID"

    2. Workday 토큰 URL(예: https://wd3-impl-services1.workday.com/ccx/oauth2/contoso4/token).

    3. Workday 웹 서비스 URL(예: https://wd3-impl-services1.workday.com/ccx/service/contoso4). Microsoft 365 조직 데이터 서비스는 XML(Extensible Markup Language)/SOAP 웹 서비스의 일부인 작업 자 작업 세부 정보 가져오기 웹 서비스를 Human_Resources.

      참고

      이는 Workday REST API 엔드포인트와 동일하지 않습니다. Workday 웹 서비스 URL에 익숙하지 않은 경우 토큰 엔드포인트를 복사하고 "oauth2"를 "service"로 바꾸고 끝에서 "/token"을 제거하여 만들 수 있습니다.

연결 또는 데이터 변경

  1. Microsoft 365 조직 데이터 서비스 페이지의 연결 유형 선택 페이지로 이동합니다(홈>설정>, 마이그레이션 및Microsoft 365 조직 데이터 서비스> 가져오기>,연결 유형 선택). Workday 커넥터에서 Workday 설정 시작을 선택합니다.

  2. 연결 편집을 선택합니다.

  3. 데이터에 액세스할 수 있는 앱을 변경하려면 첫 페이지에서 데이터 액세스 선택 편집 을 선택하고 위에서 설명한 것과 동일한 프로세스를 사용하여 변경합니다.

  4. 프로세스를 계속하고 화면을 진행하여 자격 증명, 특성 액세스 및 매핑과 같은 해당 페이지에서 필요한 변경 내용을 적용합니다. 업데이트가 필요하지 않은 페이지는 건너뜁니다.

  5. 완료되면 검토 및 확인 페이지에서 새 연결 세부 정보를 검토합니다. 모든 것이 정상 같으면 확인을 선택합니다.

Workday가 Microsoft 365에 데이터를 보내는 방법

Workday를 Microsoft 365에 연결하면 Workday는 기본 매핑 파일을 사용하는 경우 미리 정의된 원본 열 집합을 전송합니다. 이러한 열은 Microsoft 365의 필드에 매핑됩니다. 매핑 파일을 업데이트하여 이러한 미리 정의된 필드를 변경할 수 있습니다.

필드 매핑

아래 표는 Workday 필드가 기본 매핑 파일의 Microsoft 365 필드에 어떻게 대응하는지 보여줍니다. 데이터 형식 및 서식 요구 사항을 포함하여 Microsoft 365 필드에 대해 자세히 알아봅니다.

특성 근무일 필드
Microsoft_PersonEmail /wd:Worker/wd:Worker_Data/wd:Personal_Data/wd:Contact_Data/wd:Email_Address_Data/wd:Email_Address
Microsoft_ManagerEmail /wd:Worker/wd:Worker_Data/wd:Employment_Data/wd:Worker_Job_Data/wd:Position_Data/wd:Manager_as_of_last_detected_manager_change_Reference/wd:ID[@wd:type="Employee_ID" or @wd:type=\"Contingent_Worker_ID"][1]
Microsoft_DotLineManagersEmailAndLabel ExternalSource_PersonIdentifier, ExternalSource_DotLineManagersIdAndLabel, Microsoft_PersonEmail
Microsoft_Organization(부서) /wd:Worker/wd:Worker_Data/wd:Organization_Data/wd:Worker_Organization_Data[1]/wd:Organization_Data/wd:Organization_Name
Microsoft_Layer Workday에서 매핑 없음
Microsoft_LevelDesignation /wd:Worker/wd:Worker_Data/wd:Employment_Data/wd:Worker_Job_Data/wd:Position_Data/wd:Job_Profile_Summary_Data/wd:Management_Level_Reference/wd:ID[@wd:type="Management_Level_ID"]
Microsoft_JobDiscipline /wd:Worker/wd:Worker_Data/wd:Employment_Data/wd:Worker_Job_Data/wd:Position_Data/wd:Job_Profile_Summary_Data/wd:Job_Family_Reference/wd:ID[@wd:type="Job_Family_ID"]
Microsoft_CompanyOfficeLocation /wd:Worker/wd:Worker_Data/wd:Employment_Data/wd:Worker_Job_Data/wd:Position_Data/wd:Business_Site_Summary_Data/wd:Location_Reference/wd:ID[@wd:type="Location_ID"]
Microsoft_CompanyOfficeCountryOrRegion /wd:Worker/wd:Worker_Data/wd:Employment_Data/wd:Worker_Job_Data/wd:Position_Data/wd:Business_Site_Summary_Data/wd:Address_Data/wd:Country_Reference/wd:ID[@wd:type="ISO_3166-1_Alpha-3_Code"]
Microsoft_CompanyPostOfficeBox Workday에서 매핑 없음
Microsoft_CompanyOfficeStreet /wd:Worker/wd:Worker_Data/wd:Employment_Data/wd:Worker_Job_Data/wd:Position_Data/wd:Business_Site_Summary_Data/wd:Address_Data/wd:Address_Line_Data
Microsoft_CompanyOfficeCity /wd:Worker/wd:Worker_Data/wd:Employment_Data/wd:Worker_Job_Data/wd:Position_Data/wd:Business_Site_Summary_Data/wd:Address_Data/wd:Municipality
Microsoft_CompanyOfficeState /wd:Worker/wd:Worker_Data/wd:Employment_Data/wd:Worker_Job_Data/wd:Position_Data/wd:Business_Site_Summary_Data/wd:Address_Data/wd:Country_Region_Descriptor
Microsoft_CompanyOfficePostalCode /wd:Worker/wd:Worker_Data/wd:Employment_Data/wd:Worker_Job_Data/wd:Position_Data/wd:Business_Site_Summary_Data/wd:Address_Data/wd:Postal_Code
Microsoft_Company /wd:Worker/wd:Worker_Data/wd:Organization_Data/wd:Worker_Organization_Data[1]/wd:Organization_Data/wd:Organization_Name
Microsoft_CompanyCode Workday에서 매핑 없음
Microsoft_FirstName /wd:Worker/wd:Worker_Data/wd:Personal_Data/wd:Name_Data/wd:Legal_Name_Data/wd:Name_Detail_Data/wd:First_Name
Microsoft_LastName /wd:Worker/wd:Worker_Data/wd:Personal_Data/wd:Name_Data/wd:Legal_Name_Data/wd:Name_Detail_Data/wd:Last_Name
Microsoft_DisplayName /wd:Worker/wd:Worker_Data/wd:Personal_Data/wd:Name_Data/wd:Preferred_Name_Data/wd:Name_Detail_Data/@wd:Formatted_Name
Microsoft_JobTitle /wd:Worker/wd:Worker_Data/wd:Employment_Data/wd:Worker_Job_Data/wd:Position_Data/wd:Business_Title
Microsoft_SecondaryJobTitle Workday에서 매핑 없음
Microsoft_UserSkillNames /wd:Worker/wd:Worker_Data/wd:Skill_Data/wd:Worker_Skill_Item/wd:Skill_Data[@wd:Inactive="0"]/@wd:Name
Microsoft_EmploymentType /wd:Worker/wd:Worker_Data/wd:Employment_Data/wd:Worker_Job_Data/wd:Position_Data/wd:Worker_Type_Reference/wd:ID[@wd:type="Employee_Type_ID" or @wd:type=\"Contingent_Worker_Type_ID"][1]
Microsoft_EmployeeID /wd:Worker/wd:Worker_Data/wd:Worker_ID
Microsoft_ManagerID /wd:Worker/wd:Worker_Data/wd:Employment_Data/wd:Worker_Job_Data/wd:Position_Data/wd:Manager_as_of_last_detected_manager_change_Reference/wd:ID[@wd:type="Employee_ID" or @wd:type=\"Contingent_Worker_ID"][1]
Microsoft_HireDate /wd:Worker/wd:Worker_Data/wd:Employment_Data/wd:Worker_Status_Data/wd:Hire_Date
Microsoft_EmploymentStatus /wd:Worker/wd:Worker_Data/wd:Employment_Data/wd:Worker_Status_Data/wd:Active (1은 "활성"에 매핑되고 0은 "비활성"에 매핑됨)
Microsoft_GlintEmploymentStatus /wd:Worker/wd:Worker_Data/wd:Employment_Data/wd:Worker_Status_Data/wd:Active (1은 "활성"에 매핑되고 0은 "비활성"에 매핑됨)
Microsoft_Phone /wd:Worker/wd:Worker_Data/wd:Personal_Data/wd:Contact_Data/wd:Phone_Data/@wd:Tenant_Formatted_Phone
Microsoft_CostCenter /wd:Worker/wd:Worker_Data/wd:Organization_Data/wd:Worker_Organization_Data/wd:Organization_Reference/wd:ID[@wd:type='Cost_Center_Reference_ID'][1]
ExternalSource_PersonIdentifier /wd:Worker/wd:Worker_Data/wd:Worker_ID
ExternalSource_ManagerIdentifier /wd:Worker/wd:Worker_Data/wd:Employment_Data/wd:Worker_Job_Data/wd:Position_Data/wd:Manager_as_of_last_detected_manager_change_Reference/wd:ID[@wd:type="Employee_ID" or @wd:type=\"Contingent_Worker_ID"][1]
ExternalSource_DotLineManagersIdAndLabel /wd:Worker/wd:Worker_Data/wd:Management_Chain_Data/wd:Worker_Matrix_Management_Chain_Data/wd:Management_Chain_Data/wd:Manager_Reference/(wd:ID[@wd:type="Employee_ID" or @wd:type="Contingent_Worker_ID"] | '점선 관리자')
  • Last updated on