Introdução à API Compound Employee do SAP SuccessFactors

Compreender a API Compound Employee - Foco

Objective

After completing this lesson, you will be able to lembre-se dos aspectos gerais da API Compound Employee do SAP SuccessFactors.

Introdução

A interface de programação de aplicativos (API) CompoundEmployee para SAP SuccessFactors Employee Central é usada para extrair dados do colaborador do Employee Central.

A API CompoundEmployee é baseada no Simple Object Access Protocol (SOAP). Ele replica dados cadastrais do empregado do Employee Central para sistemas SAP, sistemas de folha de pagamento e sistemas de benefícios complementares.

Principais recursos

A API retorna todos os dados solicitados de um empregado em uma única chamada, fornecendo uma resposta estruturada hierarquicamente.

A resposta da consulta inclui todas as faixas de tempo de todas as entidades especificadas na solicitação. Você pode aplicar filtros na solicitação de consulta.

A API replica apenas os dados que foram aprovados no Employee Central.

Só são considerados os empregados que têm um emprego. Os empregados que não têm uma ocupação, como usuários técnicos, não são considerados.

Para melhorar o desempenho e devido ao foco da API, só são extraídos pela API os campos necessários para o respectivo processo de replicação.

Campos suportados

Antes de iniciar a implementação, reserve um tempo para verificar quais dos campos necessários são suportados por esta API. Estamos adicionando continuamente do release ao release. Você também pode combinar a API CompoundEmployee com outras APIs do Employee Central para cobrir quaisquer campos adicionais necessários.

Modos de transmissão

  • Modo de transmissão de instantâneo: neste modo, a API retorna os dados como estavam na data do instantâneo, considerando todas as modificações, correções e eliminações.
  • Modo de transmissão delta: neste modo, a API só retorna dados do empregado que foram criados, alterados ou excluídos desde a última replicação.

O modo de transmissão delta da API CompoundEmployee permite determinar as modificações de dados concretas de empregados que ocorreram desde um determinado momento. Ao contrário da transmissão completa, os consumidores só obtêm os dados modificados para um empregado, incluindo os valores anteriores, com uma indicação clara sobre como processar os dados.

Descontinuação da SFAPI

Cuidado

SFAPI obsoleta. Consulte o KBA 2682094 se forem necessárias mais informações sobre essa modificação. As integrações híbridas de talentos serão movidas para OData. Isso já foi efetuado para a sincronização de usuário (nota 2342729 - Comutar de SOAP para OData para executar a solicitação de upsert de usuário) e para pagamento variável (somente exportação, nota 2691764).

IMPORTANTE: Não há anúncio de descontinuação ou desativação para o CompoundEmployee da SFAPI.

API de colaborador composto

API de empregado composto - base de foco

A API Compound Employee é baseada no modelo de dados do Employee Central e retorna vários objetos do SAP SuccessFactors, como informações pessoais e informações de emprego. Compound Employee se concentra nos recursos do empregado que simplesmente retornam o modelo padrão de empregados, isso significa que uma pessoa também pode atualizar informações no sistema. Se executarmos as consultas da API Colaborador composto, temos a capacidade de fornecer alguns parâmetros chamados Selecionar parâmetros para restringir a seleção de dados e nem sempre temos um carregamento inicial, mas também suportamos alguns parâmetros da API do SAP SuccessFactors que controlam o comportamento da API.

API de colaborador composto

  • É baseado no modelo de dados EC
  • Seleciona vários objetos do SAP SuccessFactors
  • Empregado é objeto de foco
  • Retorna todos os dados em um XML de resposta estruturado hierarquicamente
  • Suporta parâmetros de seleção para restringir a seleção de dados
Estrutura XML exibindo dados do empregado.

API de empregado composto - parceiros de foco

Selecione o botão de reprodução para ver uma visão geral dos parceiros.

API Compound Employee - Aplicações Focus

Selecione o botão de reprodução para ver uma visão geral dos aplicativos.

Documentação

Página do portal de ajuda do SAP SuccessFactors HXM Suite:

Página do Help Portal de integração do SAP SuccessFactors Employee Central com o SAP Business Suite:

Integração do SAP SuccessFactors Employee Central com o SAP Business Suite | SAP Help Portal

A partir desses portais, você pode procurar pelos seguintes tópicos e guias:

Guia do desenvolvedor da API OData

  • Documentação geral sobre a utilização de OData independente da entidade

Guia de referência da API OData

  • APIs OData de módulos diferentes do Employee Central

Employee Central – API OData

  • Guia de referência OData específico do Employee Central

Implementação da API Compound Employee

  • Guia da API EC Compound Employee