부록 이해

인핸스먼트: 새로운 기능 뷰어 공지

SAP Help Portal의 What's New Viewer에서 릴리스에 대한 모든 신규 기능과 인핸스먼트를 찾을 수 있습니다.

토픽에 대한 자세한 내용을 보려면 다음과 같이 하십시오.

SAP Help Portal로 이동한 후 모두 검색 드롭다운 리스트에서 SAP SuccessFactors 릴리스 정보 를 입력합니다.
SAP SuccessFactors 릴리스 정보 제목의 오른쪽에 있는 드롭다운 리스트에서 적절한 릴리스를 선택합니다.
새로운 기능 뷰어 를 선택합니다.
토픽을 보려면 필요한 필터를 선택합니다.
항목에 추가 정보가 포함된 경우 자세히 보기 를 선택합니다.
관련 정보 섹션에서 토픽에 대한 추가 세부사항을 찾습니다.

SAP SuccessFactors 최신 정보 문서: 새로운 기능의 개요, 수명 주기 상태, 참조 번호

사원 임포트 템플릿 인핸스먼트

그게 뭐죠?

"직원 데이터 가져오기" 페이지에서 템플릿을 다운로드할 때 개선된 내용이 있습니다. 여기에는 필드 ID, 알파벳 순서 지정 및 특정 국가 템플릿을 다운로드할 수 있는 기능 대신 필드 레이블을 볼 수 있는 기능이 포함됩니다.

왜 중요한가요?

이러한 인핸스먼트는 유용성을 크게 개선합니다. 데이터 모델에 구성된 필드 레이블을 볼 수 있으므로 필드 ID 대신 특정 데이터 필드를 쉽게 검색할 수 있습니다. 사용 편의성을 높이기 위해 알파벳순으로 정렬됩니다. 또한 이제 새로 도입된 '국가 선택' 드롭다운에서 국가 고유 템플릿을 다운로드할 수 있습니다.

선행조건

없어요

인핸스먼트 - EmpEmploymentTermination 엔티티에 대한 첨부파일 ID 지원

그게 뭐죠?

이 개선 사항은 EmpTermination 임포트의 첨부파일 ID에 대한 지원을 제공합니다. 사용자의 terminationInfo를 임포트하는 동안 임포트에서 유효한 첨부파일 ID를 허용합니다.

왜 중요한가요?

이번 릴리스를 통해 이제 관리자는 퇴사 세부사항 엔티티를 임포트하는 동안 첨부파일을 업로드할 수 있습니다. CSV 임포트 파일에서 문서의 첨부파일 ID를 지정하여 이 작업을 수행할 수 있습니다.

선행조건

없어요

인핸스먼트 - 특정 일자에 유효한 모든 복합 이벤트 제공

그게 뭐죠?

Compound Employee API는 신규 매개변수인 "segmentsForEnhancedEffectiveEndDateFilter"를 제공합니다. 쿼리 요청에 "effective_end_date" 매개변수를 포함하고 API가 같은 날 "직무 정보" 및 "보상 정보" 세그먼트에 대해 수행된 여러 이벤트를 반환하도록 하려면 이 매개변수를 사용합니다.

왜 중요한가요?

이전에는 같은 날 Employee Central에서 여러 이벤트가 수행되었고 효력 종료일이 해당 일자 이후인 경우 이 이벤트에만 "effective_end_date"와 겹치는 타임 슬라이스가 있으므로 최신 이벤트만 API에 의해 리턴되었습니다. "segmentsForEnhancedEffectiveEndDateFilter" 매개변수를 설정하면 다운스트림 시스템이 모든 이벤트를 저장하고 그에 따라 대응할 수 있는지 확인할 수 있습니다. 이 매개변수는 API의 전체 전송과 스냅샷 모드에서 지원됩니다. 이를 사용하려면 "resultOptions" 매개변수에 "allJobChangesPerDay" 또는 "allCompensationChangesPerDay"를 지정해야 합니다.

선행조건

Compound Employee API 쿼리에서 "segmentsForEnhancedEffectiveEndDateFilter" 매개변수 사용

확장 - hiringNotCompleted의 신규 필터

그게 뭐죠?

Compound Employee API는 hiringNotCompleted 라는 새로운 매개변수를 제공합니다. 이 매개변수는 Employee Central의 EmpEmployment 엔터티에서 hiringNotCompleted 지시자 속성을 평가하여 보류 중인 채용 관리 프로세스를 아직 완료하지 않은 온보딩 대상자의 데이터 레코드를 구별할 수 있도록 합니다. hiringNotCompleted가 False이면 API는 채용된 직원의 데이터만 반환합니다.

왜 중요한가요?

이 기능은 다운스트림 시스템에서 직원 데이터 모델에 대해 유효성이 확인된 데이터만 수신하도록 하려는 경우에 유용합니다. hiringNotCompleted 는 모든 API 모드에서 지원됩니다.

선행조건

Compound Employee API 쿼리에서 hiringNotCompleted 필터를 사용합니다.

인핸스먼트 - 국가/지역 기준 개인 정보 내의 글로벌 정보에 대한 신규 필터 매개변수

그게 뭐죠?

CompoundEmployee API는 국가/지역을 기반으로 글로벌 정보를 필터링하기 위한 새로운 쿼리 매개변수 suppressUnwantedGlobalInfo를 제공합니다.

필터링은 다음 세그먼트에 적용됩니다.

personal_information
dependent_information(dependent_person_information)
national_id_card

왜 중요한가요?

suppressUnwantedGlobalInfo 매개변수를 사용하여 쿼리의 WHERE 절에 지정된 국가/지역을 기반으로 SAP SuccessFactors Employee Central의 개인 정보 내 글로벌 정보를 필터링합니다. 국가/지역은 employment_information_country 또는 employment_information_company 매개변수를 사용하여 WHERE 절에 지정됩니다.

선행조건

전역 정보 필터링은 CompoundEmployee API의 표준 쿼리 모드에서만 지원됩니다.

주의

suppressUnwantedGlobalInfo 매개변수를 포함하여 글로벌 정보의 필수 부분만 다운스트림 시스템으로 전송되도록 데이터 보호 및 개인정보 보호 규정을 준수합니다.

인핸스먼트 - 복합 사원 API의 관련 사원 구조

그게 뭐죠?

Compound Employee API는 이제 각 관리자에 대한 세그먼트(세그먼트 이름 associated_employee_employment_information)의 관리자(세그먼트 이름 associated_employee_information)에 대한 모든 고용을 렌더링합니다.

변경사항은 키 중복 오류를 방지하기 위해 표준 모드의 동작을 델타 모드에서 이미 적용된 수정과 일치시킵니다. 이는 사원이 동일한 관리자를 가진 여러 다른 고용과 여러 관계가 있는 경우에만 해당됩니다.

이전 버전에서는 각 associated_employee_employment_information 세그먼트가 자체적으로 중복된 associated_employee_information 세그먼트에 렌더링되었습니다.

샘플 코드

Code Snippet

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657
<queryResponse xmlns="urn:sfobject.sfapi.successfactors.com" xmlns:ns2="urn:fault.sfapi.successfactors.com">
   <result>
    <sfobject>
     <id>53</id>
     <type>CompoundEmployee</type>
     <person>
      <created_by>v4admin</created_by>
      <created_on_timestamp>2011-04-25T15:01:48.000Z</created_on_timestamp>
      ...
      <person_id>53</person_id>
      <employment_information>
       <assignment_class>ST</assignment_class>
       ...
       <job_information>
        ...
        <start_date>2009-10-01</start_date>
        ...
       </job_information>
       <associated_employee_information>
        ...
        <person_id>91</person_id>
        <person_id_external>cgrant1</person_id_external>
        ...
        <associated_employee_employment_information>
         <assignment_class>GA</assignment_class>
         <assignment_type>ShortTermASS</assignment_type>
         <assignmentIdExternal>186</assignmentIdExternal>
         <user_id>186</user_id>
         ...
         <associated_employee_job_information>
          ...
          <start_date>2013-04-01</start_date>
          ...
         </associated_employee_job_information>
        </associated_employee_employment_information>
        <associated_employee_employment_information>
         <assignment_class>ST</assignment_class>
         <assignmentIdExternal>cgrant1</assignmentIdExternal>
         <user_id>cgrant1</user_id>
         ...
         <associated_employee_job_information>
          ...
          <start_date>2010-09-06</start_date>
          ...
         </associated_employee_job_information>
        </associated_employee_employment_information>
       </associated_employee_information>
      </employment_information>
     </person>
     <execution_timestamp>2021-01-15T09:58:13.000Z</execution_timestamp>
     <version_id>2105P0</version_id>
    </sfobject>
    <numResults>1</numResults>
    <hasMore>false</hasMore>
    <querySessionId>ce7c67ac-ab0a-446d-a97b-2539af8886d1</querySessionId>
   </result>
  </queryResponse>

인핸스먼트 - 최종 수정일 및 스냅샷 일자에 대한 API 필드에 대한 제한

그게 뭐죠?

Employee Central CompoundEmployee API의 last_modified_on 또는 snapshot_date 필드에서 데이터를 가져오는 쿼리는 이제 미리보기 및 운영 인스턴스에서 최대 3개월로 제한됩니다.

이 제한은 이제 2021년 하반기 릴리스부터 운영 환경에 영향을 미칩니다.

노트

이 제한은 모든 Employee Central CompoundEmployee API 모드(전체 전송, 델타, 스냅샷)에 적용됩니다.

이렇게 개선하면 성능이 향상되고 Employee Central과 대상 시스템 간의 동기화가 빨라집니다.

선행조건

기존 구성에 따라 필드를 조정해야 합니다.

인핸스먼트 - 신규 Employee Central Compound Employee API 세그먼트 액세스

그게 뭐죠?

이 새로운 권한은 구성 설정을 기반으로 한 개별 세그먼트에만 액세스할 수 있습니다. 이전에는 복합 직원 API 권한의 특정 세그먼트에 대한 사용자 액세스를 제한할 수 없었습니다. 이제 사용자는 역할 기반 권한을 통해 특정 세그먼트에 대한 액세스를 제한할 수 있습니다.

역할 기반 권한 선행조건

관리자→권한 역할 관리 권한이 있어야 합니다.

Employee Central API의 권한 설정으로, 선택 가능한 API 액세스 옵션 및 관련 권한이 표시됩니다.

개선 - Employee Central Compound Employee API를 위한 새 ID 정보 세그먼트

그게 뭐죠?

Employee Central Compound Employee API는 이제 ID 정보라는 새로운 세그먼트를 지원합니다.

이제 고객이 이 세그먼트를 사용하여 사원의 사용자 계정 정보에서 특정 필드를 복제할 수 있습니다. 세그먼트는 표준 쿼리 모드에서 지원됩니다.

이 새로운 세그먼트는 ID 정보를 사용하는 더 이해하기 쉬운 방법을 제공하기 위해 도입되었습니다. 지금 반환되는 값은 고용 수에 관계없이 항상 사용자 계정에서 가져옵니다. 또한 사용자 계정을 변경하면 이전 버전에서는 불가능했던 복제가 트리거될 수 있습니다.

현재 버전에서는 복합 사원 API 쿼리에서 ID 정보 세그먼트를 가져올 수 있습니다.

샘플 코드

Code Snippet

1234567891011121314151617181920212223
<queryResponse>
         <result>
            <sfobject>
               <id>1234</id>
               <type>CompoundEmployee</type>
               <person>
                  <created_by>HRAdmin</created_by>
                  <created_on_timestamp>2016-01-01T00:00:00.000Z</created_on_timestamp>
                  <last_modified_by>HRAdmin</last_modified_by>
                  <last_modified_on>2016-01-01T00:00:00.000Z</last_modified_on>
                  <per_person_uuid>E38E63CC36D744A7998753E25B32DDCA</per_person_uuid>
                  <person_id>1234</person_id>
                  <person_id_external>Employee1234</person_id_external>
                  <identity_information>
                     <account_uuid>8d83105f-b27c-b620-e105-00000a746454</account_uuid>
                     <created_on_timestamp>2016-01-01T00:00:00.000Z</created_on_timestamp>
                     <last_modified_on>2016-01-01T00:00:00.000Z</last_modified_on>
                     <user_is_active>true</user_is_active>
                     <user_name>Employee1234</user_name>
                  </identity_information>
               </person>
            </sfobject>
      </queryResponse>

인핸스먼트 - Employee Central Compound Employee API의 근로 허가에 대한 신규 의미 키

그게 뭐죠?

Employee Central Compound Employee AP에 작업 허가에 대한 새로운 의미 키 issue_date를 추가했습니다. 추가된 이 새로운 비즈니스 키를 사용하여 다른 발행일로 작업 허가를 관리할 수 있지만 다른 비즈니스 키는 동일하게 유지할 수 있습니다.

예를 들어, 문서 번호가 만료된 작업 허가와 동일하지만 갱신된 후에 다른 발행일을 사용하여 신규 작업 허가를 업로드할 수 있습니다. 현재 Employee Central Compound Employee API는 근로 허가에 대한 다음 비즈니스 키의 최신 결과 반환을 지원합니다.

개 국가
document_type
document_number
user_id
issue_date

작업 허가 정보를 사용하는 더 이해하기 쉬운 방법을 제공하기 위해 이 새로운 의미 키를 추가했습니다.

변경 사항

현재 버전에서는 기존 personal_document_information 레코드의 issue_date 업데이트가 CHANGE 작업으로 렌더링되지 않고 델타 및 기간 델타 쿼리 모드에서 INSERT 및 DELETE 액션으로 렌더링됩니다. 샘플 코드는 아래와 같습니다.

Code Snippet

123456789101112131415161718192021222324
<personal_documents_information>
   <action>DELETE</action>
   <country>USA</country>
  <created_by>admin</created_by>
   <created_on_timestamp>2010-06-22T13:14:01.000Z </created_on_timestamp>
   <document_number>1234567890</document_number>
   <document_type>PP</document_type>
   <is_validated>false</is_validated>
   <issue_date>2010-06-03</issue_date>
   <last_modified_by>admin</last_modified_by>
   <last_modified_on>2022-06-23T06:44:59.000Z</last_modified_on>
  </personal_documents_information>
  <personal_documents_information>
   <action>INSERT</action>
   <country>USA</country>
   <created_by>admin</created_by>
   <created_on_timestamp>2010-06-22T13:14:01.000Z </created_on_timestamp>
   <document_number>1234567890</document_number>
   <document_type>PP</document_type>
   <is_validated>false</is_validated>
   <issue_date>2020-05-23</issue_date>
   <last_modified_by>admin</last_modified_by>
   <last_modified_on>2022-06-23T06:44:59.000Z</last_modified_on>
  </personal_documents_information>

기능 확장 - 필드 및 세그먼트에 대한 신규 선택

그게 뭐죠?

이제 Compound Employee API 쿼리에서 특정 필드 및 세그먼트를 추출할 수 있습니다. 복합 사원 API 쿼리의 소비자가 일반 데이터 보호 규정 가이드라인을 준수하고 시스템 간에 전송되는 데이터 금액을 줄일 수 있도록 이 기능을 도입했습니다.

샘플 코드

Code Snippet

123456789101112131415161718192021
<person>  

<person_id>920</person_id>  

<address_information>  

<address_type>home</address_type>  

<country>DEU</country>  

<created_by>root</created_by>  

<created_on_timestamp>2013-07-22T07:20:13.000Z</created_on_timestamp>  

<end_date>9999-12-31</end_date>  <is_global_model_address>false</is_global_model_address>  <last_modified_by>root</last_modified_by>  <last_modified_on>2022-01-22T07:20:13.000Z</last_modified_on>  

<start_date>2022-01-01</start_date>  

</address_information>  

</person>

인핸스먼트 - 문서 유형 작업 적격성에 영구 필터 추가

그게 뭐죠?

개인 문서 정보 세그먼트는 Employee Central Compound Employee API의 근무 자격만 지원합니다. 기존 법인의 사용 중단 - 시민권 및 비자로 인해 엔티티 근무 자격 및 세부사항만 표시하도록 엔티티 유형을 필터링해야 했습니다. 자세한 내용은 SAP SuccessFactors 최신 정보 뷰어에서 직원 데이터 임포트에서 임포트 유형 삭제 를 참조하십시오.

샘플 코드

Code Snippet

1234567891011121314151617
<personal_documents_information>

<attachment_id>863</attachment_id>

 <created_by>admin</created_by>

 <created_on_timestamp>2022-09-03T08:33:02.000Z</created_on_timestamp>

 <document_number>123-abc-456</document_number>

 <document_title>Work Eligibility document</document_title>

 <is_validated>false</is_validated> <issue_date>2022-09-03</issue_date>

 <last_modified_by>admin</last_modified_by> <last_modified_on>2022-09-03T08:33:46.000Z</last_modified_on>

 </personal_documents_information>

인핸스먼트 - Employee Central Compound Employee API의 새로운 시작일/종료일 WHERE 절 조건

그게 뭐죠?

표준 쿼리 모드에서 fromDate/toDate WHERE 절 조건을 Compound Employee API에 도입했습니다.

지정된 기간에 적용되는 변경사항이 있는 사원을 표준 쿼리 모드에서 쉽게 선택할 수 있도록 이 조건을 추가했습니다.

샘플 코드

Code Snippet

123
FROM CompoundEmployee        
    WHERE fromDate = to_date(FromDate,'YYYY-MM-DD')
              AND toDate   = to_date(ToDate,'YYYY-MM-DD')

인핸스먼트 - 복합 사원 API의 신규 소셜 계정 세그먼트

그게 뭐죠?

social_accounts_information 세그먼트를 Employee Central Compound Employee API에 도입했습니다.

소셜 계정 세그먼트는 개인별로 다릅니다.

Code Snippet

12345678910111213141516171819202122232425262728293031
<queryResponse>

<result>

<sfobject>

<id>123</id>

<type>CompoundEmployee</type>

<person>

...

<social_accounts_information>

 

 <created_by>admin</created_by> <created_on_timestamp>2024-05-10T21:31:10.000Z</created_on_timestamp>

 

<domain>instant_messenger</domain> <im_id>messengerUserId</im_id> <last_modified_by>admin</last_modified_by> <last_modified_on>2024-06-20T14:45:57.000Z</last_modified_on> <url>www.example_instant_messenger.com</url>

 

</social_accounts_information>

...

</person>

인핸스먼트 - 사원 데이터 복제에서 종료된 고용 필터링

그게 뭐죠?

Employee Central에서 사원 데이터를 복제할 때 이제 복합 사원 API의 WHERE 절에 EMPLOYMENT_END_DATE 필터를 사용하여 종료된 고용이 SAP S/4HANA 또는 SAP ERP HCM으로 복제되는 것을 방지합니다.

고용 종료일은 Employee Central에서 사원 데이터 복제에 대해 정의한 전체 전송 시작일(FTSD)로 설정됩니다. 즉, FTSD가 기본적으로 SAP S/4HANA 또는 SAP ERP HCM에 복제되는 데 하루 이상 활성 상태인 고용만 가능합니다. FTSD 이전에 종료된 고용을 복제하려는 경우 EMPLOYMENT_END_DATE 필터를 끌 수 있습니다. 그러나 특별한 경우에만 이 작업을 수행하는 것이 좋습니다. 예를 들어, FTSD 전에 종료된 고용도 시스템에 필요하기 때문에 SAP S/4HANA 또는 SAP ERP HCM 시스템에서 문제가 발생하는 경우입니다.

필터를 도입하면 Employee Central에서 전송되는 페이로드가 감소하여 복제 성능이 향상됩니다.

샘플 코드

Code Snippet

12345678910111213141516171819202122232425
<queryCompoundEmployeeResponse>

<CompoundEmployee>

<id>278718</id>

<person>

...

<employment_information>

<end_date>2013-08-31</end_date> <start_date>2012-01-01</start_date>

</employment_information>

<employment_information> <start_date>2015-01-01</start_date> </employment_information>

...

</person>

</CompoundEmployee>

</queryCompoundEmployeeResponse>

확장 - 이제 PA_SE_IN 애드온에서 데이터 삭제에 대한 삭제 상태 개요가 기본 옵션이 됨

그게 뭐죠?

이제 SAP S/4HANA 또는 SAP ERP HCM 시스템에서 Employee Central에서 삭제된 직원 데이터를 쿼리할 때 복합 직원 API에서 제공하는 삭제 상태 개요 정보를 기본 옵션으로 사용합니다.

삭제 상태 개요 대신 Compound Employee API에서 제공한 효력 종료일 필터에 대한 유효성 확인을 사용해야 하는 경우, SAP S/4HANA 또는 SAP ERP HCM 시스템에서 매개변수를 설정하여 삭제 상태 개요 사용을 비활성화할 수 있습니다.

Compound Employee API의 DRTMPurgeStatusOverview 세그먼트를 사용하면 SAP S/4HANA 또는 SAP ERP HCM 시스템에서 세부 삭제일의 유효성을 확인하고 그에 따라 대응할 수 있습니다. 오류를 방지하기 위해 사원 마스터 데이터 복제에 대해 정의된 전체 전송 시작일(FTSD)을 조정할 필요가 없습니다.

구성 요구사항

SFSF EC INTEGRATION(PA_SE_IN) 애드온의 지원 패키지 38이 SAP S/4HANA 또는 SAP ERP 시스템에 설치되어 있어야 합니다.

역할 기반 권한 선행조건

Compound Employee API 사용자 액세스 권한을 정의된 세그먼트에만 부여하는 경우 DRTMPurgeStatusOverview 세그먼트에 대한 권한을 추가해야 합니다.

변경 사항

삭제 상태 개요 없음 쿼리 매개변수 옵션을 표시하는 EE 마스터 데이터의 SAP 설정 인터페이스

지금 보는 방법

현재 버전에서는 SAP S/4HANA 또는 SAP ERP 시스템에서 기본적으로 삭제 상태 개요를 사용합니다. 필요한 경우 옵트아웃할 수 있습니다. 직원 마스터 데이터 및 조직 지정 쿼리의 매개변수를 정의할 때 삭제 상태 개요 사용 안 함 확인란을 선택하여 복합 직원 API에서 제공하는 유효 종료일 필터에 대해 유효성 확인을 활성화할 수 있습니다.