스포크의 Workday Hr 기능 확장

릴리스 버전: Washingtondc

업데이트 날짜 2024년 02월 01일

읽기6분

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

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

작업자 조회 작업 확장

스포크와 함께 사용할 수 있는 작업자 조회 작업은 대부분의 필요한 입력 및 출력을 제공합니다. 이 작업에 입력 및 출력을 더 추가하기 전에 기본 스포크 작업을 사용하는 방법을 살펴보십시오.

이 작업은 스포크의 Workday Hr 입력 필드 데이터 정제를 연결된 Workday 요청 XML 메시지로 변환하고 응답 XML 메시지를 에서 출력 필드 데이터 정제로 동기적으로 다시 Workday 렌더링합니다 ServiceNow 플로우 디자이너. 샘플 요청 메시지 및 샘플 응답 메시지를 확인해야 합니다.

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

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

주:

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

Workday 요청 메시지에서 직책 참조 ID가 어떻게 구성되어 있는지 평가하고 이해합니다. 요청 메시지에 직책 참조 ID를 추가하는 XPath는 Workday Public Web Services 커뮤니티 게시물에 따라 두 가지로 접혀 있습니다.
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 요청 섹션에서 설계 패턴을 활용하고 출력 변수를 정의합니다.
SOAP 단계에서 Position 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,
        };

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