Integração com outros sistemas usando ODATA e APIs

Descrição de OData e APIs no Recrutamento

Objective

After completing this lesson, you will be able to descrever a utilização de OData e APIs no SAP SuccessFactors Recruiting.

Introdução ao OData e APIs

O Open Data Protocol (OData) é um protocolo padronizado para criar e consumir APIs de dados (interface de programa de aplicação). O OData é baseado em protocolos centrais, como HTTP, e metodologias comumente aceitas, como REST. O resultado é uma forma uniforme de expor APIs de dados com recursos completos. O OData fornece um padrão para como representar seus dados e um método de metadados para descrever a estrutura de seus dados e as operações disponíveis em sua API. O serviço API OData do SAP SuccessFactors é baseado no OData V2.0.

A API OData do HCM Suite é a API de serviços Web do SAP SuccessFactors com base no protocolo OData destinado a permitir o acesso aos dados no sistema SAP SuccessFactors. A API é orientada a dados. Este API fornece métodos para o acesso ao estilo CRUD (Criar, Ler, Atualizar e Eliminar). A API é melhor usada para solicitações frequentes ou em tempo real para pequenas quantidades de dados. Grandes solicitações de dados são mais bem tratadas por processos FTP em lote. Esta API OData é usada para configurar entidades. Cada módulo do SAP SuccessFactors pode ser acessado usando seu próprio conjunto de entidades.

Os clientes estão muito interessados em integrar vários sistemas juntos, investir em APIs OData fornece um grande retorno sobre o investimento para os clientes que estão dispostos a criar integrações personalizadas para dar suporte às suas necessidades.

APIs OData para recrutamento

Existem várias áreas em Recrutamento onde o OData pode ser usado:

API OData: Entidade de requisição de vaga. Isso pode ser usado nos seguintes casos:

  • Crie uma integração personalizada para criar requisições no RCM a partir do sistema de terceiros
  • Criar uma integração personalizada para enviar informações da requisição juntamente com anexos para um sistema de terceiros
  • Clientes podem atualizar requisições no RCM a partir de um sistema de terceiros
  • Acione o recurso "Convidar a se candidatar". Este recurso moverá os candidatos do status Encaminhado para o status Convidar a se candidatar e enviará um e-mail para os candidatos solicitando que se candidatem a uma requisição de vaga

Isso não substitui a SFAPI e não afeta as integrações existentes com a SFAPI. É uma alternativa melhor à SFAPI porque oferece mais flexibilidade e funcionalidade.

  • API OData: entidade de aplicação

Essa funcionalidade fornece a capacidade de expor a entidade Application via API OData para as operações CREATE e UPDATE. Isso significa que clientes/parceiros podem usar essa API para criar/atualizar informações sobre a entidade Aplicativo. Isso pode ser usado nos seguintes casos:

  • Os clientes podem criar uma integração personalizada para criar aplicativos no RCM a partir de um sistema de terceiros. (ex: o cliente usa um método de fornecimento específico do local e deseja criar candidatos e candidaturas no RCM para fins de rastreamento/relatório/processamento)
  • Os clientes podem criar uma integração personalizada para enviar informações do aplicativo juntamente com anexos para um sistema de terceiros. (ex: o cliente deseja anexar cartas de oferta de outro sistema a aplicativos)
  • Os clientes podem atualizar aplicativos no RCM a partir de um sistema de terceiros
  • Os clientes podem consultar o registro de auditoria de status do candidato. Considere que só são suportadas operações READ

Isso não substitui a SFAPI e não afeta as integrações existentes com a SFAPI. É uma alternativa melhor à SFAPI porque oferece mais flexibilidade e funcionalidade.

  • API OData: Entidade do candidato

A entidade Candidato está disponível por meio da API OData que suporta as operações CREATE, UDPATE e EXPORT. Isso inclui dados básicos do candidato, anexos de candidato (currículo, CV e campos de anexo personalizados) e elementos de experiência. Isso pode ser usado nos seguintes casos:

  • Os clientes podem criar uma integração personalizada para criar perfis de candidato no RCM a partir de um sistema de terceiros
  • Os clientes podem criar uma integração personalizada para enviar informações do candidato junto com anexos e elementos de experiência para um sistema de terceiros
  • Os clientes podem atualizar perfis de candidato usando um sistema de terceiros

Isso não substitui a SFAPI e não afeta as integrações existentes com a SFAPI. É uma alternativa melhor à SFAPI porque oferece mais flexibilidade e funcionalidade.

As seguintes entidades agora estão disponíveis via API OData para fornecer a capacidade de criar integrações personalizadas:

  • Modelos de requisição, modelos de inscrição, modelo de oferta (somente LEITURA)
  • Essas entidades não são legíveis como uma entidade regular, elas são listadas no Dicionário da API OData, com as propriedades do modelo
  • Nova entidade prévia para facilitar a geração de relatórios de perguntas e respostas do aplicativo (LEITURA)
  • JobReqScreeningQuestion - perguntas relacionadas a uma requisição de vaga
  • JobReqScreeningQuestionChoice - as opções possíveis de MULTI_CHOICE e RATING relacionadas a uma pergunta JobReq
  • JobApplicationQuestionResponse - as respostas das perguntas

Aplicação - Portlet de acolhimento (LER/ATUALIZAR)/ Aplicação - Iniciar acolhimento (CREATE)

  • JobApplicationOnboardingData - o portlet de integração de uma candidatura
  • JobApplicationOnboardingStatus - o status de uma admissão de candidatura
  • initiateOnboarding (importação de função para iniciar a admissão)

Aplicação – Portlet de vagas inscritas (LEITURA)

  • Implementado como uma navegação dentro da entidade Candidato. Pode ser encontrado como "jobsApplied" dentro da entidade Candidato.

Central de entrevistas (LEITURA)

  • ApplicationInterview - tem as informações da entrevista relacionadas a uma candidatura
  • InterviewOverallAssessment - tem as classificações gerais e navegação para as avaliações individuais de uma entrevista
  • InterviewIndividualAssessment - tem as informações de classificação e competência de uma avaliação individual de uma entrevista

Aprovação de oferta /UPDATE/CREATE

  • Implementado como JobOffer
  • Anexos, aprovadores, versões (LEITURA)

Carta de oferta (LEITURA/ATUALIZAÇÃO/CRIAÇÃO)

  • Implementado como carta de oferta

sendMailOfferLetter - importação de função para enviar uma carta de oferta por e-mail

Os clientes podem criar integrações personalizadas usando essas entidades. Alguns exemplos são:

  • Perguntas e respostas de pré-seleção de candidatos agora estão disponíveis para serem exportadas e analisadas
  • Os dados da Central de entrevistas agora estão disponíveis para serem exportados e analisados

Todas as APIs OData de recrutamento estão disponíveis no Centro de integração para criar facilmente arquivos simples para consumo e manipulação de dados.

Síntese

  • OData é um protocolo padronizado criado em HTTP e REST para criar APIs de dados uniformes com operações CRUD.

  • A API de requisição de vaga permite que integrações personalizadas criem, atualizem e enviem dados de requisição, além de acionar os recursos "Convidar para se candidatar".

  • As APIs de candidatura e candidato suportam a criação, atualização e exportação de dados de candidaturas e candidatos, incluindo anexos e elementos de antecedentes.

  • Todas as APIs OData de recrutamento se integram ao Centro de integração para facilitar a criação de arquivos simples e a manipulação de dados.