Compreensão do apêndice

Encontre todos os novos recursos e melhorias da versão no Visualizador de novidades do SAP Help Portal.

Se você quiser mais detalhes sobre um tópico, proceda da seguinte forma:

1. Navegue até o SAP Help Portal e, na lista suspensa Pesquisar tudo, insira Informações da versão do SAP SuccessFactors.
2. Na lista suspensa à direita do título Informações de release do SAP SuccessFactors, selecione o release apropriado.
3. Selecione Visualizador de novidades.
4. Selecione os filtros conforme necessário para visualizar o tópico.
5. Se o tópico contiver mais informações, selecione Ver mais.
6. Na seção Informações relacionadas, localize mais detalhes sobre o tópico.

Melhorias foram feitas quando você está baixando modelos na página "Importar dados do colaborador". Isso inclui a capacidade de exibir rótulos de campo que, em vez de códigos de campo, ordenação alfabética e capacidade de fazer o download do modelo de um país específico.

Esses aprimoramentos melhoram muito a usabilidade. Uma vez que você pode visualizar denominadores de campo que foram configurados no modelo de dados, em vez de IDs de campo, isso ajuda você a procurar facilmente um determinado campo de dados. Eles também são classificados em ordem alfabética para melhorar a facilidade de uso. Além disso, você pode agora baixar um modelo específico para um país a partir do menu suspenso recém-introduzido "Selecionar um país".

Nenhum

Esta melhoria fornece suporte para ID de anexo na importação de Rescisão do colaborador. Ao importar terminationInfo para usuários, a importação aceitará IDs de anexo válidos.

Nesta versão, os administradores agora podem carregar anexos ao importar a entidade Detalhes da demissão. Isso pode ser conseguido especificando o código do anexo do documento no arquivo de importação CSV.

Nenhum

A API Compound Employee fornece um novo parâmetro, "segmentsForEnhancedEffectiveEndDateFilter". Use este parâmetro se você incluir o parâmetro "effective_end_date" na solicitação de consulta e quiser que a API retorne vários eventos realizados para os segmentos "Informações do cargo" e "Informações de compensação" no mesmo dia.

Anteriormente, se vários eventos fossem executados no Employee Central no mesmo dia e a data de término efetiva fosse posterior a esse dia, somente o último evento era retornado pela API porque somente esse evento tem uma faixa de tempo que se sobrepõe a "effective_end_date". Ao definir o parâmetro "segmentsForEnhancedEffectiveEndDateFilter", você pode garantir que o sistema subsequente armazena todos os eventos e pode reagir aos mesmos de modo correspondente. O parâmetro é suportado nos modos de transmissão completa e instantâneo da API. A sua utilização requer que você indique "allJobChangesPerDay" ou "allCompensationChangesPerDay" para o parâmetro "resultOptions".

Use o parâmetro "segmentsForEnhancedEffectiveEndDateFilter" na consulta da API Compound Employee

A API Compound Employee fornece um novo parâmetro, hiringNotCompleted. Este parâmetro avalia a propriedade do indicador hiringNotCompleted na entidade EmpEmployment no Employee Central, que permite diferenciar registros de dados de admitidos que ainda não concluíram o processo Gerenciar contratação pendente. Se hiringNotCompleted for False, a API retornará apenas dados de funcionários contratados

Isso é útil se você quiser que seus sistemas subsequentes recebam somente dados que foram validados em relação ao modelo de dados do empregado. hiringNotCompleted é suportado em todos os modos de API.

Use o filtro hiringNotCompleted em sua consulta da API Compound Employee.

A API CompoundEmployee fornece o novo parâmetro de consulta suppressUnwantedGlobalInfo para filtrar informações globais com base no país/região.

A filtragem se aplica aos seguintes segmentos:

• personal_information
• dependent_information(dependent_personal_information)
• nacional_id_card

Use o parâmetro suppressUnwantedGlobalInfo para filtrar informações globais em Informações pessoais do SAP SuccessFactors Employee Central com base no país/região especificado na cláusula WHERE da consulta. O país/região é indicado com o parâmetro Employment_information_country ou Employment_information_company na cláusula WHERE.

A filtragem de informações globais só é suportada no modo de consulta padrão da API CompoundEmployee.

A API Compound Employee agora renderiza todos os empregos para um gerente (nome do segmento associated_employee_Employment_information) em um segmento para cada gerente (nome do segmento associated_employee_information).

A modificação alinha o comportamento no modo padrão com uma correção já aplicada no modo delta para evitar erros de chave duplicada. Isso só é relevante para casos em que um empregado tem várias relações com diferentes empregos com o mesmo gerente.

Na versão anterior, cada segmento associated_employee_Employment_information era renderizado no próprio segmento associated_employee_information duplicado.

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>

As consultas que obtêm dados dos campos last_modified_on ou snapshot_date da API do Employee Central CompoundEmployee agora estão restritas a um máximo de 3 meses no passado em instâncias de visualização E produtivas.

NOTA que esta restrição afeta agora seu ambiente produtivo a partir do release 2H 2021.

Essa melhoria aumenta o desempenho e permite uma sincronização mais rápida entre o Employee Central e os sistemas de destino.

Você precisa ajustar os campos de acordo com sua configuração existente.

Esta nova permissão permite o acesso somente a segmentos individuais com base na configuração definida. Anteriormente, não era possível restringir o acesso dos usuários a segmentos específicos das permissões da API Compound Employee. Agora, os usuários podem restringir o acesso a segmentos específicos por meio de Permissões baseadas em função.

Você tem a permissão→Administrador Gerenciar funções de permissão.

A Employee Central Compound Employee API agora suporta um novo segmento chamado Informações de identidade.

Os clientes agora podem utilizar esse segmento para replicar determinados campos das informações da conta do usuário de um empregado. O segmento é suportado no modo de consulta padrão.

Este novo segmento foi introduzido para fornecer uma forma mais compreensível de consumir informações de identidade. Os valores retornados agora são sempre recuperados da conta do usuário, independentemente do número de empregos. Além disso, as modificações na conta do usuário podem acionar uma replicação, o que não era possível em versões anteriores.

Na versão atual, você pode obter o segmento Informações de identidade na consulta Compound Employee API.

Codificação de exemplo

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>

Adicionamos uma nova chave semântica issue_date para a autorização de trabalho na Employee Central Compound Employee API. Com esta nova chave empresarial adicionada, você pode gerenciar sua autorização de trabalho com uma data de emissão diferente, mas manter as outras chaves empresariais iguais.

Por exemplo, você pode carregar uma nova autorização de trabalho com o número de documento idêntico à sua autorização de trabalho expirada, mas com uma data de emissão diferente após renovada. Por enquanto, a Employee Central Compound Employee API suporta o retorno dos resultados mais recentes das seguintes chaves empresariais para a autorização de trabalho:

• país
• document_type
• document_number
• user_id
• data_emissão

Adicionamos esta nova chave semântica para fornecer uma forma mais compreensível de consumir informações de autorização de trabalho.

Na versão atual, a atualização da issue_date de um registro personal_document_information existente não é renderizada como uma ação CHANGE, mas como ações INSERT e DELETE nos modos de consulta Delta e Delta de período. Você pode encontrar o código-exemplo abaixo.

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>

Agora é possível extrair campos e segmentos específicos de uma consulta da API Colaborador composto. Introduzimos esse recurso para permitir que os consumidores da consulta da API de empregado composto estejam em conformidade com as diretrizes do Regulamento geral de proteção de dados e para que o montante de dados transferido entre sistemas possa ser reduzido.

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>

O segmento de informações de documentos pessoais suporta apenas a elegibilidade para o trabalho na Employee Central Compound Employee API. Devido à descontinuação de entidades legadas - cidadania e visto, esses tipos de entidade tinham que ser filtrados para exibir somente a elegibilidade de trabalho da entidade e seus detalhes. Para mais informações, consulte Exclusão de tipos de importação de Importar dados do colaborador no Visualizador de novidades do SAP SuccessFactors.

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>

Introduzimos a condição da cláusula WHERE fromDate/toDate na API Compound Employee no modo de consulta padrão.

Adicionamos essa condição para aumentar a facilidade de seleção de funcionários que têm alterações que se tornam efetivas em determinado período de tempo no modo de consulta padrão.

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

Introduzimos o segmento social_accounts_information na Employee Central Compound Employee API.

O segmento de contas sociais é específico da pessoa.

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>

A replicação de dados do colaborador do Employee Central agora usa o filtro EMPLOYMENT_END_DATE na cláusula WHERE da API Compound Employee para evitar que empregos demitidos sejam replicados para o SAP S/4HANA ou SAP ERP HCM.

A data de término do emprego é definida para estar na data de início da transferência completa (DITC) que você definiu para a replicação de dados do colaborador do Employee Central. Isso significa que somente os empregos que estiveram ativos por pelo menos um dia ou após a FTSD são replicados para SAP S/4HANA ou SAP ERP HCM por padrão. Se você quiser replicar empregos que foram encerrados antes da FTSD, tem a opção de desativar o filtro EMPLOYMENT_END_DATE. Mas recomendamos que você só faça isso em casos especiais. Por exemplo, quando ocorrem problemas em seu sistema SAP S/4HANA ou SAP ERP HCM porque o sistema também precisa de ocupações que foram encerradas antes da FTSD.

Ao introduzir o filtro, o payload transferido do Employee Central é reduzido, o que melhora o desempenho da replicação.

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>

Agora, usamos as informações de síntese de status de limpeza fornecidas pela API Compound Employee como opção padrão quando o sistema SAP S/4HANA ou SAP ERP HCM consulta dados do colaborador que foram eliminados no Employee Central.

Se você precisar usar a validação em relação ao filtro de data de fim efetiva fornecido pela API Colaborador composto em vez da síntese de status de depuração, pode definir um parâmetro no sistema SAP S/4HANA ou SAP ERP HCM para desativar a utilização da síntese de status de depuração.

O uso do segmento DRTMPurgeStatusOverview da API Compound Employee permite que o sistema SAP S/4HANA ou SAP ERP HCM valide datas de limpeza detalhadas e reaja de acordo. Você não precisa ajustar a data de início da transferência completa (DITC) definida para a replicação de dados mestre do colaborador para evitar erros.

O support package 38 do add-on SFSF EC INTEGRATION (PA_SE_IN) deve estar instalado em seu sistema SAP S/4HANA ou SAP ERP.

Se você conceder ao usuário da API Colaborador composto acesso somente a segmentos definidos, deverá adicionar a permissão para o segmento DRTMPurgeStatusOverview.

Como isso parece agora

Na versão atual, o sistema SAP S/4HANA ou SAP ERP usa a visão geral de status de eliminação por padrão. Se precisar, você pode optar por não aceitá-lo. Ao definir os parâmetros para os dados cadastrais do colaborador e a consulta de atribuição organizacional, você pode marcar o campo de seleção Não usar visão geral do status de limpeza para ativar a validação em relação ao filtro de data de término efetiva fornecido pela API Colaborador composto.