Configurar o spoke do SuccessFactors v3.xx

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 5 min. de leitura

    • Integre a instância ServiceNow à sua instância SuccessFactors spoke usando credenciais básicas.

    Antes de Iniciar

    • Solicitar uma assinatura de Integration Hub.
    • Ative o SuccessFactors spoke.
    • Habilite estas propriedades do sistema:
      • glide.pf.rest.response_payload_max_size: o valor máximo é 10240.
      • com.snc.process_flow.reporting.serialized.val_size_limit: o valor máximo é 16384.
      • com.glide.transform.json.max-partial-length: o valor máximo é 65536.
    • Função necessária: administrador
    Nota:
    A SuccessFactors descontinuará a autenticação básica até nov de 2026 e, portanto, todos devem usar o OAuth SAML, que é compatível com SuccessFactors spoke v4.5.0.
    • Se você estiver instalando o SuccessFactors spoke pela primeira vez, instale SuccessFactors spoke v4.5.0. Para obter mais informações sobre como configurar SuccessFactors spoke v4.5.0, Configurar SuccessFactors spoke v4.xx.
    • Se você estiver usando uma versão anterior do SuccessFactors spoke, migre para SuccessFactors spoke v4.5.0. Para obter mais informações, consulte Migrar para SuccessFactors spoke v4.5.0.

    Criar registro de credencial para a API OData

    Crie o registro de credencial para as APIs do OData em SuccessFactors. O alias de conexão e credencial SuccessFactors spoke usa essas credenciais para autorizar ações usando a API OData.

    Procedimento

    1. Navegar até Conexões e Credenciais > Credenciais.
    2. Clique em Nova.
      O sistema exibe a mensagem Que tipo de credenciais você deseja criar?.
    3. Selecione Credenciais de autenticação básica.
      Um formulário em branco de credenciais de autenticação básica será exibido.
    4. No formulário, preencha estes valores.
      Campo Valor necessário
      Nome Nome para identificar exclusivamente o registro. Por exemplo, insira SAPSF OData Credentials.
      Nome de usuário Nome de usuário com a permissão da API OData neste formato:<username> @<SAP-SuccessFactors-CompanyID> .
      Senha Senha associada.
      Ativo Opção de usar ativamente o registro de credencial.
      Ordem A ordem na qual aplicar esta credencial. Por exemplo: insira 100.
    5. Clique em Enviar.

    Resultado

    O registro de credencial para autorizar ações usando a API OData é criado.

    Criar registro de credencial para a SOAP API

    Crie o registro de credencial para as SOAP APIs em SuccessFactors. O alias de conexão e credencial SuccessFactors spoke usa essas credenciais para autorizar ações usando as SOAP APIs.

    Procedimento

    1. Navegar até Conexões e Credenciais > Credenciais.
    2. Clique em Nova.
      O sistema exibe a mensagem Que tipo de credenciais você deseja criar?.
    3. Selecione Credenciais SOAP da SuccessFactors.
      Um formulário em branco de Credenciais SOAP da SuccessFactors é exibido.
    4. No formulário, preencha estes valores.
      Campo Valor necessário
      Nome Nome para identificar exclusivamente o registro. Por exemplo, insira SAPSF Comp Emp Credentials.
      Nome de usuário Nome de usuário com a permissão SOAP API.
      Senha Senha associada.
      Ativo Opção de usar ativamente o registro de credencial.
      Ordem A ordem na qual aplicar esta credencial. Por exemplo: insira 100.
    5. Clique em Enviar.

    Resultado

    O registro de credencial para autorizar ações usando a SOAP API foi criado.

    Criar registro de conexão para a API OData

    Crie um registro de conexão para a API OData em SuccessFactors. O alias de conexão e credencial SuccessFactors spoke usa essas conexões para executar ações em SuccessFactors.

    Procedimento

    1. Navegar até Conexões e Credenciais > Aliases de conexão e credenciais.
    2. Aberto para o registro da API SuccessFactors OData, por exemplo, SuccessFactors_Odata.
    3. Na guia Conexões, clique em Novo.
      O sistema exibe um formulário de conexão HTTP(s) em branco.
    4. No formulário, preencha estes valores.
      Tabela 1. Formulário de conexão HTTP
      Campo Descrição
      Nome Nome para identificar exclusivamente o registro. Por exemplo, SF_REST.
      Credencial Registro de credencial que você criou para a API OData. Por exemplo, SAPSF OData Credentials.
      URL de conexão SuccessFactors URL raiz do serviço. Por exemplo, https://apisalesdemo4.successfactors.com/odata/v2.
      Nota:
      Se você estiver usando uma conta do SAP Cloud, consulte Lista de servidores de API do SAP SuccessFactors no Portal de ajuda do SAP para selecionar o endpoint correto necessário para direcionar o servidor de API.
      Ativo Opção para usar ativamente o registro de conexão.
    5. Clique em Enviar.

    Resultado

    O registro de conexão da API OData em SuccessFactors foi criado.

    Criar registro de conexão para a SOAP API

    Crie um registro de conexão para a SOAP API em SuccessFactors. O alias de conexão e credencial SuccessFactors spoke usa essas conexões para executar ações em SuccessFactors.

    Procedimento

    1. Navegar até Conexões e Credenciais > Aliases de conexão e credenciais.
    2. Aberto para o registro da API SOAP SuccessFactors, por exemplo, SuccessFactors_Comp_Emp.
    3. Na guia Conexões, clique em Novo.
      O sistema exibe um formulário de conexão HTTP(s) em branco.
    4. No formulário, preencha estes valores.
      Tabela 2. Formulário de conexão HTTP
      Campo Descrição
      Nome Nome para identificar exclusivamente o registro. Por exemplo, SF_REST.
      Credencial Registro de credencial que você criou para a SOAP API. Por exemplo, SAPSF Comp Emp Credentials.
      URL de conexão SuccessFactors URL de conexão. Por exemplo, https://salesdemo4.successfactors.com/sfapi/v1/soap.
      Nota:
      Se você estiver usando uma conta do SAP Cloud, consulte Lista de servidores de API do SAP SuccessFactors no Portal de ajuda do SAP para selecionar o endpoint correto necessário para direcionar o servidor de API.
      Ativo Opção para usar ativamente o registro de conexão.
    5. Na guia Atributos, forneça estes campos.
      Campo Descrição
      ID da empresa ID imutável da empresa da sua instância SuccessFactors.
      Tempo limite de fluxo (segundos) Tempo máximo em segundos até o qual os dados podem ser recebidos de SuccessFactors durante a execução do fluxo. Se o tempo necessário para recuperar dados do SuccessFactors exceder a duração do tempo limite, o fluxo ou subfluxo será cancelado. O valor padrão é 30.
    6. Clique em Enviar.

    Resultado

    O registro de conexão da SOAP API em SuccessFactors foi criado.

    Sincronizar dados entre SuccessFactors e ServiceNow

    Personalize os fluxos de amostra de acordo com seu requisito para sincronizar dados entre as instâncias SuccessFactors e ServiceNow.

    Entidade pendente

    O SuccessFactors spoke fornece fluxos de amostra para sincronizar dados bidirecionalmente para a entidade pendente. O fluxo de amostra, Executar fluxo de integração do SuccessFactors, pode ser personalizado para recuperar dados de SuccessFactors, enquanto os fluxos Criar tarefas pendentes e Atualizar tarefas pendentes criam ou atualizam os registros pendentes em SuccessFactors quando ocorrem eventos em ServiceNow. Ao personalizar os fluxos de amostra, certifique-se de fornecer gatilhos apropriados para recuperar e salvar atualizações futuras usando mapas de transformação.

    Outras entidades padrão

    Para essas entidades, o fluxo de amostra, Executar fluxo de integração de SuccessFactors, pode ser personalizado para recuperar dados de SuccessFactors:
    • Departamento
    • Local
    • Perfil do Trabalho
    • Perfil dos trabalhadores
    • Perfil de trabalhadores efetivos
    • Histórico de trabalho, incluindo atribuições secundárias

    Para criar ou atualizar registros em SuccessFactors para essas entidades quando ocorrem eventos em ServiceNow:

    • Crie fluxos ou subfluxos de acordo com sua escolha ou personalize os fluxos e subfluxos de amostra.
    • Use ações de Recuperação de metadados e Gestão de registros em seus fluxos.
    • Certifique-se de fornecer gatilhos apropriados para recuperar e salvar atualizações futuras usando mapas de transformação.

    Outras SuccessFactors entidades

    Dependendo das SuccessFactors permissões e configurações, você também pode sincronizar dados de outras entidades de acordo com seus requisitos.