Spoke do SuccessFactors

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 15 min. de leitura
  • O SuccessFactors spoke foi criado pela Bristlecone, Inc. Gerencie dados e entidades em SuccessFactors de sua instância ServiceNow.

    Solicitar apps na Store

    Acesse o site ServiceNow Store para ver todos os aplicativos disponíveis e obter informações sobre como enviar solicitações para a loja. Para obter informações sobre notas de versão cumulativa para todos os aplicativos liberados, consulte as ServiceNow Store notas de versão do histórico de versão. A partir de 1º de março de 2022, todos os spokes do SAP estarão disponíveis somente na Store.

    Assinatura do IntegrationHub

    Este spoke requer uma assinatura do Hub de integração. Para obter mais informações, consulte Cronogramas jurídicos - Visão geral do IntegrationHub.

    Versão do spoke

    SuccessFactors spoke v4.2.2 é a versão mais recente.

    Dependências do spoke

    Se você estiver tendo problemas para instalar o aplicativo, verifique se estes plug-ins dependentes estão instalados:

    • Objeto complexo (com.glide.cobject)
    • Tempo de execução do ServiceNow IntegrationHub (com.glide.hub.integration.runtime)
    • ServiceNow Flow Designer - Entradas dinâmicas (com.glide.hub.dynamic_inputs)
    • Etapa de ação do ServiceNow IntegrationHub — REST (com.glide.hub.action_step.rest)
    • Etapa de ação do ServiceNow IntegrationHub - SOAP (com.glide.hub.action_step.soap)
    • Modelo de ação do ServiceNow IntegrationHub — fluxo de dados (com.glide.hub.action_type.datastream)
    • Etapa de ação do ServiceNow IntegrationHub - Analisador de XML (com.glide.hub.action_step.xmlparser)
    • ServiceNow Flow Designer - Saídas dinâmicas (com.glide.hub.dynamic_outputs)
    • Tabelas remotas (com.glide.script.vtable)
    Nota:
    Alguns desses plug-ins são recursos licenciáveis e exigem uma licença apropriada, se usados fora da implementação do spoke. Para obter informações sobre licenças, entre em contato com o gerente da sua conta.

    Fluxos de spoke

    O SuccessFactors spoke fornece fluxos de amostra no estado de rascunho para demonstrar a automação das tarefas SuccessFactors. Para personalizar um fluxo de amostra, copie-o para um novo escopo da aplicação. Os fluxos de amostra disponíveis incluem:
    Fluxo Descrição
    Criar tarefas pendentes Cria um registro de tarefa pendente em SuccessFactors.
    Atualizar pendente Atualiza os detalhes do registro de tarefas pendente especificado em SuccessFactors.
    Executar fluxo de integração do SuccessFactors Recupera dados inteiros ou somente atualizações feitas após a última atualização, para as entidades selecionadas, de SuccessFactors para sua instância ServiceNow. Por padrão, você pode recuperar dados dessas entidades em SuccessFactors:
    • Departamento
    • Local
    • Perfil do Trabalho
    • Perfil dos trabalhadores
    • Perfil de trabalhadores efetivos
    • Histórico de trabalho, incluindo atribuições secundárias
    • Tarefa pendente
    Nota:
    Os fluxos Criar tarefas pendentes e Atualizar tarefas pendentes demonstram o gerenciamento de registros pendentes quando ocorrem eventos em ServiceNow. Você pode personalizar esses fluxos de acordo com seu requisito para gerenciar registros de outras entidades da sua instância ServiceNow.

    Subfluxos do spoke

    O SuccessFactors spoke fornece subfluxos de amostra no estado de rascunho para demonstrar a automação das tarefas SuccessFactors. Para personalizar um subfluxo de amostra, copie-o para um novo escopo da aplicação. Os fluxos de amostra disponíveis incluem:
    Subfluxo Descrição
    Recuperar departamentos Recupera os dados do departamento de SuccessFactors e os armazena na tabela de preparação de departamentos do SuccessFactors.
    Recuperar perfis de trabalhador efetivo Recupera os dados de perfis de trabalhadores efetivos de SuccessFactors e os armazena na tabela de preparação de perfis de trabalhadores do SuccessFactors.
    Recuperar histórico completo de trabalhos, incluindo atribuições secundárias

    Recupera todos os dados de histórico de trabalho primário e secundário de SuccessFactors.

    Recuperar perfis de trabalho Recupera os dados do perfil de trabalho de SuccessFactors e os armazena na tabela de preparação de perfis de trabalho do SuccessFactors.
    Recuperar locais Recupera os dados de local de SuccessFactors e os armazena na tabela de preparação de locais do SuccessFactors.
    Recuperar tarefas pendentes Recupera os dados de tarefas pendentes de SuccessFactors e os armazena na tabela de preparação de tarefas de entrada do SuccessFactors.
    Recuperar perfis de trabalhador Recupera os dados de perfis de trabalhador de SuccessFactors e os armazena na tabela de preparação de perfis de trabalhador da SuccessFactors.
    Executar serviço do SuccessFactors Recupera dados inteiros ou somente atualizações feitas no último tempo de execução bem-sucedido para as entidades selecionadas.
    Processar webhooks do SuccessFactors Processa o evento de webhook do SAP SuccessFactors. Para obter mais informações sobre como configurar os webhooks, consulte Configurar webhook para o SuccessFactors spoke.

    Ações do spoke

    O SuccessFactors spoke fornece ações para automatizar tarefas SuccessFactors quando ocorrem eventos em ServiceNow. As ações disponíveis incluem:
    Nota:
    • Para impedir que usuários não autorizados acessem os dados confidenciais, a funcionalidade hasRole foi implementada para as ações confidenciais do spoke do SuccessFactors. Como resultado, os usuários sem a função de Administrador do sistema não poderão executar as ações com sucesso se não tiverem a função de Administrador do spoke do SuccessFactors. Isso se aplica ao spoke do SuccessFactors v3.1.5 e v4.0.3 do spoke, respectivamente. Para obter mais informações, consulte o artigo da base de conhecimento Detalhes da correção do spoke hasRole da SuccessFactors no NOW Support.
    • Para impedir que usuários não autorizados gerem relatórios para tabelas spoke do SuccessFactors, as ACLs report_view são incorporadas à função de administrador do spoke. Portanto, o usuário deve ter a função de administrador do spoke do SuccessFactors para gerar um relatório.
    Categoria Ação Descrição
    Gestão de funcionários Informações de endereço do funcionário Recupera as informações de endereço do funcionário especificado.
    Remuneração anual do funcionário Recupera os detalhes da remuneração anual do funcionário especificado.
    Detalhes de remuneração de funcionários Recupera detalhes de remuneração do funcionário especificado.
    Documentos de funcionário Recupera todos os documentos visíveis do funcionário especificado.
    Detalhes do método de pagamento do funcionário Recupera os detalhes sobre o método de pagamento do funcionário especificado.
    Folga do funcionário Recupera as folgas do funcionário especificado.
    Saldos de folga dos funcionários Recupera os detalhes do saldo de folgas do funcionário especificado.
    Meus detalhes do registro de horas Recupera os detalhes da planilha de horas do funcionário especificado.
    Mudar funções do usuário Adiciona o usuário ao grupo de permissão fornecido.
    Detalhes de todos os métodos de pagamento do funcionário Recupera detalhes de todos os métodos de pagamento do funcionário especificado.
    Remunerações recorrentes de funcionários Gerencia o componente recorrente da remuneração de um funcionário especificado.
    Obter inscrições em benefícios de funcionários Recupera detalhes das inscrições de benefícios do funcionário especificado durante um período específico.
    Desligar um funcionário Aciona o processo de rescisão do funcionário especificado.
    Mudança da org. Altera as informações relacionadas à organização do funcionário especificado.
    Relatar não comparecimentos Relata o não comparecimento do funcionário especificado.
    Estrutura do relatório Recupera a estrutura de subordinação do funcionário especificado.
    Solicitar licença Aplica uma solicitação de licença ao funcionário especificado.
    Atualizar endereço do funcionário Atualiza o endereço do funcionário especificado.
    Atualizar informações pessoais do funcionário Atualiza as informações pessoais do funcionário especificado.
    Atualizar informações pessoais do funcionário - Global Atualiza as informações globais do funcionário especificado.
    Atualizar datas de início do funcionário Atualiza a data de início do emprego do funcionário especificado.
    Dados básicos de RH Login no SuccessFactors Faz login em SuccessFactors e recupera o ID da sessão.
    Recuperar informações do emprego atual Recupera as informações de emprego atual de SuccessFactors.
    Recuperar departamentos Recupera os dados do departamento de SuccessFactors.
    Recuperar histórico completo de trabalhos, incluindo atribuições secundárias

    Recupera os dados completos do histórico de trabalho, incluindo atribuições secundárias de SuccessFactors.

    Recuperar IDs de trabalhador efetivo Recupera o ID de perfis de trabalhador efetivo de SuccessFactors.
    Recuperar perfis por ID de pessoa Recupera os dados de perfis de trabalhador por ID de pessoa de SuccessFactors.
    Recuperar perfis de trabalhador efetivo Recupera os dados de perfis de trabalhadores efetivos de SuccessFactors.
    Recuperar histórico de trabalhos, incluindo atribuições secundárias (obsoleto)

    Recupera os dados do histórico de trabalho, incluindo atribuições secundárias de SuccessFactors.

    Recuperar perfis de trabalho Recupera os dados do perfil de trabalho de SuccessFactors.
    Recuperar locais Recupera os dados de local de SuccessFactors.
    Recuperar perfis de trabalhador Recupera os dados de perfis do trabalhador de SuccessFactors.
    Obter calendário de férias Recupera o calendário de feriados de um país.
    Recuperação de Metadados
    Nota:
    Para executar as ações de metadados criáveis, excluíveis, atualizáveis e de lista, crie uma propriedade do sistema com Nome como com.glide.attachment.max_get_size no escopo Global e defina seu Valor como 20000000.
    Obter campos de saída dinâmica Cria uma estrutura de saída dinâmica para mapeamento de campos em resposta para a entidade fornecida.
    Obter entidades - criável Recupera as entidades para as quais a operação de criação é compatível.
    Obter entidades - Excluível Recupera as entidades para as quais a operação de exclusão é compatível.
    Obter entidades - atualizável Recupera entidades para as quais a operação de atualização é compatível.
    Obter lista de entidades Recupera a lista de todas as entidades.
    Obter campos - criável Recupera todas as propriedades de não navegação criáveis em uma entidade.
    Obter campos - atualizável Recupera todos os campos atualizáveis de não navegação em uma entidade.
    Obter campos-chave Recupera todos os campos de chave na entidade especificada.
    Obter campos obrigatórios - criáveis Recupera todos os campos inseríveis necessários na entidade especificada.
    Obter campos pendentes atualizáveis Recupera a lista de campos atualizáveis na tabela de preparação de tarefas pendentes de saída.
    Obter posições disponíveis Recupera todas as posições disponíveis para determinado código de empresa e local.
    Obter unidades de negócios Recupera todas as unidades de negócios disponíveis em SuccessFactors.
    Obter empresas Recupera todas as empresas ativas disponíveis em SuccessFactors.
    Obter países Recupera todos os países disponíveis em SuccessFactors.
    Obter código do país Recupera o código de um país.
    Obter grupos de permissões dinâmicas Recupera todos os grupos de permissões dinâmicas disponíveis.
    Obter motivos do evento por ID de evento Recupera todos os motivos do evento para o ID de evento especificado.
    Obter informações globais por entidade Recupera metadados da entidade especificada para buscar as informações globais.
    Obter países compatíveis com informações pessoais globais Recupera detalhes dos países que oferecem suporte à criação e modificação das informações globais pessoais.
    Obter locais por código da empresa Recupera todos os locais ativos de SuccessFactors para o código da empresa especificado.
    Obter grupos de pessoas por ID de grupo Recupera todos os grupos de pessoas com apenas a categoria de nome de usuário para o grupo especificado.
    Obter opções da lista de seleção Recupera todas as opções de lista de seleção disponíveis para o ID de lista de seleção especificado.
    Obter opções da lista de seleção por país Recupera as opções da lista de seleção do país especificado.
    Obter componentes de pagamento recorrente definidos para o funcionário Recupera componentes de pagamento recorrente e informações relevantes do funcionário especificado.
    Obter campos obrigatórios - criáveis Recupera todos os campos inseríveis necessários na entidade especificada.
    Obter tipos de tempo por ID de usuário Recupera todos os tipos de tempo disponíveis do funcionário especificado no SAP SuccessFactors.
    Obter campos pendentes atualizáveis Recupera a lista de campos atualizáveis na tabela Preparação de tarefas de saída da SuccessFactors.
    Gestão de registros Criar registro Cria um registro em SuccessFactors.
    Excluir registro Exclui o registro especificado em SuccessFactors.
    Executar entidade por URL Usa a URL de navegação como entrada e fornece a resposta para essa URL de navegação.
    Obter registro Recupera o registro da entidade selecionada e dos campos de chave fornecidos.
    Atualizar Registro Atualiza os detalhes do registro especificado.
    Tarefas pendentes Criar tarefas pendentes Crie um registro de tarefa pendente em SuccessFactors.
    Obter tarefas pendentes por ID Obtenha detalhes de uma tarefa pendente de SuccessFactors.
    Recuperar tarefas pendentes Recupera os dados de tarefas pendentes de SuccessFactors, exceto aqueles com ID de categoria como 57.
    Atualizar pendente Atualiza os detalhes do registro de tarefas especificado.
    Gestão de usuários Pesquisar atividade do usuário Recupera a hora da última atividade dos seus usuários SAP SuccessFactors.
    Pesquisar SFTP de atividade do usuário Recupera a hora da última atividade dos usuários SAP SuccessFactors buscando o relatório publicado em um local do protocolo de transferência de arquivo SSH (SFTP).
    Pesquisar usuários Recupera a lista de SAP SuccessFactors usuários.
    Suspender usuário Suspende uma conta de usuário.
    Categoria de utilitário Chamar um subfluxo do SuccessFactors Executa o subfluxo de spoke SuccessFactors especificado de forma síncrona.
    Chamar execução de subfluxo de serviço do SuccessFactors Executa o subfluxo Executar serviço do SuccessFactors de forma assíncrona.
    Verificar status do fluxo Verifica se o contexto do fluxo está em execução.
    Obter data da última execução Recupera a data e a hora da última execução do fluxo.
    Atualizar registro na tabela de preparação de tarefas pendentes de saída Atualiza os detalhes do registro pendente especificado na tabela de preparação de tarefas pendentes de saída da SuccessFactors.
    Nota:
    Somente um usuário administrador pode executar esta ação.
    Gestão de objetivos Pesquisar objetivos por ID de usuário Recupera informações de objetivos do SuccessFactors para o ID de usuário especificado.
    Nota:
    Somente um usuário administrador pode executar esta ação.
    Gestão de vagas Pesquisar anexo por ID Recupera o conteúdo do anexo e o armazena na fonte de dados Anexos do SuccessFactors para o ID de anexo especificado.

    Para acessar os anexos, navegue até Todos > Conjuntos para importação do sistema > Administração > Fontes de dados e abra o registro, SuccessFactors Attachments. Os arquivos necessários estão anexados a este registro de fonte de dados.

    Nota:
    Somente um usuário administrador pode executar esta ação.
    Pesquisar candidato por ID Recupera informações do candidato do SuccessFactors para o ID de candidato especificado.
    Nota:
    Somente um usuário administrador pode executar esta ação.
    Pesquisar fluxo de candidaturas ao trabalho Recupera informações da candidatura de trabalho do SuccessFactors.
    Nota:
    Somente um usuário administrador pode executar esta ação.
    Pesquisar fluxo de códigos de trabalho Recupera informações de nível de trabalho, tipo de emprego e tipo de trabalho do SuccessFactors.
    Nota:
    Somente um usuário administrador pode executar esta ação.
    Pesquisar requisição de trabalho por ID Recupera detalhes da requisição de trabalho para o ID de requisição especificado.
    Nota:
    • Crie uma cópia da ação Pesquisar requisição de trabalho por ID se o atributo de API de ID de nível de trabalho e ID de tipo de emprego estiver configurado com outros atributos personalizados, exceto customString3 e customString4, e modifique o script de pós-processamento com o caminho do atributo de API esperado.
    • Somente um usuário administrador pode executar esta ação.
    Pesquisar fluxo de publicações de requisição de trabalho Recupera informações de publicação de trabalho do SuccessFactors.
    Nota:
    Somente um usuário administrador pode executar esta ação.
    Pesquisar fluxo de trabalhos de funcionários Recupera informações de todos os trabalhos de funcionários do SuccessFactors.
    Pesquisar fluxo de perfis de trabalho Recupera informações de perfis de trabalho do SuccessFactors.
    Nota:
    Se uma ação de spoke exigir data ou hora como entrada, certifique-se de fornecer o valor somente no fuso horário GMT.

    Módulos de spoke

    O spoke SuccessFactors adiciona uma aplicação SuccessFactors à sua instância ServiceNow. A aplicação SuccessFactors tem estes módulos.
    Módulo Descrição
    Tabela de preparação de departamento Exibe os dados do departamento recuperados de SuccessFactors.
    Tabela de preparação de locais Exibe os dados de local recuperados de SuccessFactors.
    Tabela de preparação do perfil do trabalho Exibe os dados de perfil de trabalho recuperados de SuccessFactors.
    Tabela de preparação de perfis de trabalhador Exibe os dados de perfil do trabalhador recuperados de SuccessFactors.
    Tabela de preparação de tarefas pendentes Exibe os registros de tarefas pendentes recuperados de SuccessFactors.
    Tabela de preparação de tarefas pendentes de saída Exibe os registros de tarefas pendentes criados em ServiceNow.

    Quando um registro de tarefas pendentes é criado ou atualizado em ServiceNow, o fluxo Criar tarefas pendentes ou Atualizar tarefas pendentes é acionado e o mesmo registro é criado ou atualizado em SuccessFactors. Todos os detalhes do registro associado são recuperados de SuccessFactors e salvos nesta tabela de preparação. Se o fluxo falhar ao criar ou atualizar o registro em SuccessFactors, o registro associado ou as atualizações em ServiceNow também serão excluídos.

    Informações e histórico de trabalho do funcionário Exibe as informações de trabalho e o histórico de trabalhos de todos os usuários.
    Exibir meu saldo de folgas Exibe o saldo de folgas do usuário conectado.
    Exibir detalhes da minha folga Exibe detalhes das solicitações de licença do usuário conectado.
    Registro do Webhook Exibe a lista de registros de webhook. O administrador deve criar o registro do webhook aqui. Para obter mais informações, consulte Configurar webhook para o SuccessFactors spoke.
    Exibir detalhes do registro de horas do último mês Exibe detalhes do registro de horas do mês anterior do usuário conectado.
    Exibir meu perfil do trabalhador Exibe os detalhes do perfil do trabalhador do usuário conectado.
    Exibir meu calendário de férias Exibe o calendário de feriados aplicável ao usuário conectado.
    Exibir minha estrutura de relatório Exibe os detalhes da estrutura de relatório do usuário conectado.
    Visualizar minha informação de depósito direto Exibe os detalhes do depósito direto do usuário conectado.
    Exibir minhas recompensas totais Exibe o total de gratificações do usuário conectado.

    Para recuperar os dados, execute Executar fluxo de integração de SuccessFactors. Os dados nas tabelas de preparação ficam disponíveis por 7 dias. Durante esse período, você deve usar mapas de transformação para salvar esses dados nas tabelas de destino ServiceNow necessárias de acordo com seus requisitos.

    Mapas de transformação do spoke

    O SuccessFactors spoke fornece mapas de transformação de exemplo no estado inativo e tabelas de destino de exemplo associadas para demonstrar o uso de mapas de transformação para salvar dados SuccessFactors em suas tabelas ServiceNow. Você pode usar esses mapas de transformação de amostra e tabelas de destino como referência para criar mapas de transformação de acordo com seus requisitos.

    Para obter mais informações, consulte Mapas de transformação.

    Funções do usuário do spoke

    Essas funções de usuário estão disponíveis junto com o spoke:
    • Administrador do SuccessFactors (sn_successfactors.SuccessFactors Admin): os usuários com esta função têm acesso a todos os módulos e tabelas do spoke.
    • Dados privados de SuccessFactors (sn_successfactors.SuccessFactors Private Data): usuários com esta função têm acesso aos dados nestes módulos spoke:
      • Visualizar minha informação de depósito direto
      • Exibir minhas recompensas totais
    • Dados públicos do SuccessFactors (sn_successfactors.SuccessFactors Public Data): os usuários com esta função têm acesso aos dados nestes módulos spoke:
      • Exibir meu saldo de folgas
      • Exibir detalhes da minha folga
      • Exibir detalhes do registro de horas do último mês
      • Exibir meu perfil do trabalhador
      • Exibir meu calendário de férias
      • Exibir minha estrutura de relatório

    Requisitos de aliases de conexão e credencial

    Integration Hub usa aliases para gerenciar informações de conexão e credenciais. O uso de um alias elimina a necessidade de configurar várias credenciais e perfis de informações de conexão ao usar vários ambientes. Se as informações de conexão ou de credencial forem alteradas, não será necessário atualizar nenhuma ação que use a conexão. Para obter mais informações, consulte Connections and Credentials.

    Dois aliases de conexão e credencial estão disponíveis com o SuccessFactors spoke. Um para a API SOAP e outro para a API OData.

    Para obter informações sobre como configurar o spoke, consulte Configurar SuccessFactors spoke v4.xx.