-
Customer Experience -
Employee Experience -
Brand Experience -
Core XM -
Design XM
Extrair dados do empregado da tarefa do SuccessFactors
Sobre a extração de dados do colaborador do SuccessFactors
A tarefa Extrair dados do empregado do SuccessFactors automatiza uma exportação de dados do empregado do SuccessFactors. Você pode importar dados principais do colaborador (nome, e-mail, identificador exclusivo), metadados do colaborador (sexo, função, departamento etc.) e dados da hierarquia organizacional (gerente, localização) em uma programação recorrente que você definiu. Depois que seus dados são importados para o Qualtrics, eles precisam ser salvos por meio de uma tarefa de carregador de dados, geralmente a tarefa de carregamento de usuários no diretório EX.
Configuração de uma tarefa de extração de dados do empregado do SuccessFactors
- Clique no menu de navegação no canto superior esquerdo.
- Selecione Workflows.
- Clique em Criar um fluxo de trabalho.
- Determine se o workflow deve ser Programado ou Baseado em eventos. Para uma comparação dessas opções, consulte workflows programados vs. workflows baseados em eventos.
Qdica: Geralmente, recomendamos o uso de um fluxo de trabalho programado para que seus dados de colaborador sejam atualizados em uma cadência regular.
- Se desejar, renomeie seu fluxo de trabalho clicando no nome do fluxo de trabalho na parte superior.
- Determine quando o workflow deve ser executado (se um workflow escalonado) ou o evento que aciona o workflow (se um workflow baseado em eventos) deve ser executado.
- Clique no sinal de mais ( + ) e selecione Tarefa.
- Selecione Extrair dados do colaborador do SuccessFactors.
- Escolha uma conta do SuccessFactors para usar.
- Se você quiser adicionar uma nova conta do SuccessFactors a ser usada, clique em Adicionar nova conta de usuário.
Qdica: Depois de clicar em Adicionar nova conta de usuário, você será direcionado para inserir as informações da sua conta do SuccessFactors. Consulte a localização das informações da sua conta SuccessFactors para obter ajuda na localização dos campos obrigatórios.
- Clique em Seguinte.
- Quatro campos serão mapeados automaticamente para você. Esses campos correspondem a campos de dados principais do funcionário e são geralmente importados para o Qualtrics. Esses campos são o nome, o sobrenome, o endereço de e-mail e o identificador exclusivo do funcionário. Se necessário, você pode remover esses campos do seu mapeamento.
- Para adicionar campos adicionais à importação, clique em Adicionar campo.
Qdica: A plataforma Qualtrics não oferece suporte a empregos simultâneos para um participante individual do SuccessFactors. Se um campo tiver vários valores, o extrator irá extrair o valor com o código “isPrimary” como indicado no SuccessFactors. No momento, não há suporte para a seleção de outros valores. Além disso, se você tiver vários registros para o mesmo colaborador no SuccessFactors, a tarefa Transformação básica deverá ser usada para filtrar quaisquer valores que não sejam o emprego principal.
- Selecione um campo do SuccessFactors clicando na caixa do campo e escolhendo na lista. Você também pode digitar o nome do campo para encontrá-lo mais rapidamente. Você pode pesquisar por nome de campo (se disponível, por exemplo, “Sexo”) ou por caminho de campo no SuccessFactors (por exemplo, personal_information/anivers_name).
Qdica: os campos personalizados podem ser importados inserindo o nome do campo apropriado do SuccessFactors (por exemplo, personal_information/custom_fieldname). Os campos personalizados não serão exibidos nos resultados da pesquisa à medida que você digita.
- Para remover um campo, clique no sinal negativo ( – ) à direita do campo.
- Clique em Seguinte.
- Uma visualização será exibida, mostrando um exemplo do que será importado para cada campo que você selecionou.
- Se a visualização parecer OK, clique em Salvar. Se você precisar fazer alterações em seus campos, clique no botão Voltar.
Após configurar sua tarefa do SuccessFactors, você precisa informar ao Qualtrics onde salvar seus dados com uma tarefa do carregador de dados. Normalmente, esta é a tarefa de carregamento de usuários para o diretório EX.
Localização das informações da sua conta do SuccessFactors
Depois de clicar em Adicionar nova conta de usuário, você verá uma tela para inserir as credenciais OAuth do SuccessFactors. Visite nossa página Configuração de tarefas do SuccessFactors com credenciais OAuth para obter as informações de pré-requisitos necessárias para a configuração.
- Nome: este é o rótulo que você atribui à sua conta. Este campo não é usado para autenticação.
- Nome do usuário: seu ID de usuário SAP.
Advertência: seu nome de usuário e seu ID de usuário SAP podem ser diferentes. A ID do usuário diferencia maiúsculas de minúsculas.
- Chave API, chave privada de certificado X.509: a autenticação do certificado X.509 adiciona uma camada adicional de proteção aos seus dados. Quando você registra um cliente Oauth utilizando este certificado, também é gerada uma chave API.
Qdica: há 2 opções para gerar o certificado e a chave privada. Você pode gerar seu próprio certificado e chave privada, ou a SAP tem a opção de gerar durante o registro do aplicativo cliente OAuth2, que você pode baixar do SuccessFactors. Se você gerar uma chave privada, ela deve estar no formato PKCS8. Para mais informações, consulte a documentação da SAP.
Para mais detalhes sobre este processo, consulte a seguinte documentação SAP:
-
- Registrando seu aplicativo cliente OAuth2
- Criação de um certificado X.509 no SAP SuccessFactors
- Gerando uma asserção SAML
- Solicitando um token de acesso
- Visualização da validade de um token de acesso
Qdica: os últimos 3 documentos desta lista são destinados aos usuários administradores do SuccessFactors ou a qualquer outro usuário com permissão para criar integrações OAuth. Para obter ajuda adicional com a autenticação do certificado, entre em contato com o suporte da SuccessFactors.
- Domínio do centro de dados: seu domínio SuccessFactors.
Qdica: não inclua o http:// no URL.
- ID da empresa: ID da sua empresa no SuccessFactors.
Você pode encontrar alguns destes campos na sua página de login do SuccessFactors:
- Seu nome de usuário é inserido no campo Nome de usuário.
Advertência: seu nome de usuário e seu ID de usuário SAP podem ser diferentes. A ID do usuário diferencia maiúsculas de minúsculas.
- Sua ID da Empresa será exibida acima dos campos de login.
Exemplo: um exemplo de ID da empresa é BenefitsSB.
- O domínio do Centro de dados pode ser encontrado em seu URL depois de fazer login no SuccessFactors.
Qdica: não inclua o http:// no URL.Exemplo: um exemplo de domínio de centro de dados é apisalesdemo4.successfactors.com.
Se você precisar de ajuda para acessar suas informações do SuccessFactors, consulte nossa página Configuração de tarefas do SuccessFactors com credenciais OAuth ou entre em contato com o suporte da SuccessFactors.
Solução de problemas de tarefas do SuccessFactors
Para solucionar problemas de seu fluxo de trabalho, vá para relatórios de fluxos de trabalho e visualize a saída do fluxo de trabalho. Se o seu workflow tiver falhado, isso irá conter informações sobre o motivo pelo qual falhou.
Credenciais de conta incorretas
Consulte Configuração de tarefas do SuccessFactors com credenciais OAuth.
Os campos importados estão em branco
A tarefa de extração de dados do colaborador do SuccessFactors exibe todos os campos não personalizados associados a uma conta do SuccessFactors, mas é possível que o campo selecionado na tarefa não tenha informações associadas a ela no SuccessFactors. Certifique-se de que o caminho do campo selecionado corresponda a um campo preenchido no SuccessFactors. Observe que alguns nomes de campo podem estar associados a várias localizações no SuccessFactors. Por exemplo, “/personal_information/created_by” e “address_information/created_by” são campos diferentes!
Erros de campo comuns
Esta tabela lista erros comuns e suas resoluções. Esses erros são exibidos ao visualizar seus dados importados na tarefa Extrair dados do empregado do SuccessFactors.
| Mensagem de erro | Resolução |
| O pedido de registro de pré-visualização foi bem sucedido, mas foram recebidos zero resultados. | Entre em contato com o suporte da SuccessFactors sobre o motivo pelo qual registros zero estão sendo retornados. |
| Não é possível analisar o caminho do campo {{Field Path Here}} da resposta. O caminho do campo deve ser do tipo booleano ou string. | Esta é uma mensagem de advertência indicando que o caminho do campo não era um booleano ou cadeia no registro de visualização.
Verifique o tipo de campo no dicionário ODATA no SuccessFactors. |
| Erro encontrado ao buscar token OAuth do SuccessFactors: {{Error from SuccessFactors}}. | Erro de credencial ao solicitar token OAuth. O motivo específico estará na mensagem do SuccessFactors.
Motivos conhecidos:
Para resolver esse erro, atualize suas credenciais para que estejam corretas. Consulte Configuração de tarefas do SuccessFactors com credenciais OAuth para obter mais informações. |
| Erro encontrado no SuccessFactors ao buscar o registro de visualização: {{Error from SuccessFactors}}. | Erro na chamada da API OData do SuccessFactors. O motivo específico estará na mensagem do SuccessFactors. Este erro ocorre porque a propriedade não foi encontrada.
Consulte a subseção “Propriedade não encontrada” abaixo para obter mais informações sobre como resolver esse erro. |
| Erro interno inesperado encontrado enquanto buscava registros de pré-visualização do SuccessFactors. | Erro interno do lado da Qualtrics. Entre em contato com o Suporte da Qualtrics. |
Propriedade não encontrada
Se você estiver tentando importar campos personalizados do SuccessFactors, o formato não pode ser validado em nosso menu suspenso de campos. Se você receber um erro inesperado na visualização de sua importação, como “Nomes de propriedades inválidos”, verifique no SuccessFactors se o caminho do campo está correto.
Para pesquisar um campo, vá para a Central do administrador no SuccessFactors e navegue até o Dicionário de dados da API OData.
A partir daqui, vá para a guia Entidade e pesquise o campo que você deseja adicionar. Confirme se o campo existe e se o caminho do campo corresponde ao que você adicionou na tarefa Extrair dados do colaborador do SuccessFactors do Qualtrics. Em geral, “PerPerson” é a entidade base para começar a encontrar o caminho de campo correto. Se o caminho do campo estiver correto e você ainda estiver com o erro, entre em contato com o suporte da SuccessFactors para obter assistência.