스포크의 Workday HR 기능 확장

릴리스 버전: Australia

업데이트 날짜 2026년 03월 12일

소요 시간: 6분

새 입력 및 출력 필드 추가와 같은 기본 기능 이상으로 스포크를 Workday HR 확장합니다.

스포크를 Workday HR 확장하려면 관리자가 다음 사항을 알고 있어야 합니다. Workday 공용 웹 서비스 API 시스템을 구성할 Workday 수 있습니다.

작업자 조회 작업 확장

스포크와 함께 사용할 수 있는 작업자 조회 작업은 대부분의 필수 입력 및 출력을 제공합니다. 이 작업에 더 많은 입력과 출력을 추가하기 전에 기본 스포크 작업을 사용하는 방법을 탐색합니다.

이 작업은 스포크의 입력 필드 데이터 알약 Workday HR 을 연결된 Workday 요청 XML 메시지로 변환하고 응답 XML 메시지를 출력 필드 데이터 알약ServiceNow 워크플로우 스튜디오으로 동기적으로 다시 Workday 렌더링합니다. 샘플 요청 메시지 및 샘플 응답 메시지를 확인해야 합니다.

기본 작업자 조회 작업의 복사본을 만들어 수정하거나 확장합니다.

이 작업에 대한 요청 기준의 일부로 직책 참조 ID를 추가하려면 다음을 수행합니다.

주:

일반 입력 필드 또는 추가 필드 입력 필드에 원하는 입력이 있는지 확인해야 합니다. 원하는 입력이 없는 경우 이 지침에 따라 필요한 입력 필드를 수동으로 생성합니다.
작업자 조회 작업은 추가 필드 입력 필드에서 직책 참조 ID 요청 요소를 지원합니다. 데모를 위해 이 필드는 UI에 수동으로 추가되고 있습니다.

Workday 요청 메시지에 직책 참조 ID가 어떻게 구성되어 있는지 평가하고 이해합니다. 요청 메시지에 직책 참조 ID를 추가하는 XPath는 Workday 공용 웹 서비스 커뮤니티 게시물에 따라 두 겹으로 나뉩니다.
1. 직책 참조 유형 속성: Get_Workers_Request/Request_Criteria/Position_Reference/@type
2. 공용 웹 서비스 문서에 따라 위의 속성 값은 하드 코딩된 "직책 ID"입니다.
3. 직책 참조 값: Get_Workers_Request/Request_Criteria/Position_Reference
4. 위의 실제 값은 스포크 작업의 새 입력 필드입니다.
작업 입력 단계에서 입력 변수를 생성합니다. 입력 생성을 클릭하고 간단한 문자열 유형 입력 변수를 추가합니다.
전처리 스크립트 단계에서 입력 변수를 생성합니다.
1. 변수 생성을 클릭합니다.
2. 이름이 position_reference_id인 입력 변수 이름을 추가합니다.
3. 입력 변수에서 직책 참조 ID 데이터 알약을 끌어와 입력 변수의 값에 놓습니다.
스크립트 섹션에서 var organizationReferenceStr의 설계 패턴을 활용합니다.
1. 이 예시의 Workday 작업자 요청 가져오기 메시지 와 일치하도록 XML 노드를 만듭니다.
2. 스크립트 섹션에서 적절한 디자인 패턴을 찾습니다. 이 예에서는 위치 참조에 대해 이 XML 노드를 생성해야 합니다.
```
<bsvc:Position_Reference bsvc:Descriptor="string">
<bsvc:ID bsvc:type="Position_ID">string</bsvc:ID>
</bsvc:Position_Reference>
```
3. 위의 XML을 유사한 XML 노드와 비교할 때 조직 참조는 연관된 디자인 패턴 스크립트를 활용하기에 좋은 후보입니다. 스크립트 섹션에서 연결된 스크립트 스니펫은 "var organizationReferenceStr.
```
<bsvc:Organization_Reference bsvc:Descriptor="string">
<bsvc:ID bsvc:type="Organization_ID">string</bsvc:ID>
</bsvc:Organization_Reference>
```
4. var organizationReferenceStr 코드 스니펫을 활용하여 그에 따라 직책 참조 XML 노드를 구성합니다.
5. 동일한 스크립트의 var request 섹션에서 디자인 패턴을 활용하고 출력 변수를 정의합니다.
SOAP 단계에서 위치 XML 노드를 만듭니다.
1. Workday 작업자 요청 가져오기 메시지와 그에 따른 직책 참조 노드를 참조하십시오.
2. 저장한 후 게시합니다.
동작을 테스트합니다.
1. 이는 데이터 스트림 작업이므로 플로우를 사용하여 테스트해야 합니다. 작업이 포함된 샘플 플로우를 만듭니다.
2. 위치 ID를 입력하고 플로우를 테스트합니다.
3. 실행을 열고 SOAP 단계로 이동하여 위치 참조가 있는 업데이트된 XML 요소 노드가 작성되었는지 확인합니다.

Workday 스포크 작업의 출력 필드 추가 및 수정

Workday 스포크를 확장하여 현지 이름과 현지 성을 검색합니다.

Workday 응답 메시지에서 로컬 이름이 어떻게 구성되어 있는지 평가하고 이해합니다.
- 로컬 이름: 이 요소의 XPath는 Get_Workers_Response/Response_Data/Worker/Worker_Data/Personal_Data/Name_Data/Legal_Name_Data/Name_Detail_Data/Local_Name_Detail_Data/First_Name입니다.
- 현지 성: 이 요소의 XPath는 Get_Workers_Response/Response_Data/Worker/Worker_Data/Personal_Data/Name_Data/Legal_Name_Data/Name_Detail_Data/Local_Name_Detail_Data/Last_Name입니다.

스크립트 파서 단계에서 법적 이름 디자인 패턴을 활용하고 현지 법적 이름에 대한 스니펫을 생성합니다.

var LocalFirstName = xmlDoc.getNodeText(Worker_DataXpath.concat("wd:Personal_Data/wd:Name_Data/wd:Legal_Name_Data/wd:Name_Detail_Data/wd:Local_Name_Detail_Data/wd:First_Name"));
        var LocalLastName = xmlDoc.getNodeText(Worker_DataXpath.concat("wd:Personal_Data/wd:Name_Data/wd:Legal_Name_Data/wd:Name_Detail_Data/wd:Local_Name_Detail_Data/wd:Last_Name"));

        var LocalLegalName = {
            LocalFirstName: LocalFirstName,
            LocalLastName: LocalLastName,
        };

LocalLegalName을 PersonalData 개체에 추가합니다.
출력 단계에서 출력 변수를 생성합니다.
1. 출력 편집을 클릭합니다.
2. 출력 필드는 정확한 Workday 응답 메시지 계층 구조를 따를 필요가 없습니다. 2단계의 XPAth가 올바른 Workday XPath를 따르는 한 스포크 작업은 그에 따라 요소를 렌더링할 수 있습니다. 이 경우 개인 데이터 아래에 현지 법적 이름을 추가하는 것으로 충분합니다.
  
  주:
  이름 섹션의 문자열 변수 이름은 위의 2단계에서 정의한 것과 동일한 var 이름과 일치해야 합니다.
작업을 저장하고 게시합니다.
주:
작업자 조회 작업에는 데이터 스트림 작업에 포함될 수 있는 최대 출력 요소 수가 있습니다. 복사된 작업을 새 출력 요소로 게시하는 동안 오류가 발생하면 필요하지 않은 몇 가지 출력 요소를 삭제하고 다시 게시를 시도하십시오.
동작을 테스트합니다.
1. 테스트 작업자 제목에 Workday에서 현지 이름과 현지 성이 있는지 확인합니다.
2. 샘플 플로우를 만들고, 작업을 추가하고, 응답을 기록하여 출력 요소를 확인합니다.
3. 플로우를 테스트하고 실행하려면 연결된 테스트 작업자 주체의 직원 ID를 제공합니다.
4. 로그와 실행을 확인하여 현지 이름과 현지 성이 올바르게 검색되었는지 확인합니다.