-
Qualtrics Platform -
Customer Journey Optimizer -
XM Discover -
Qualtrics Social Connect
Extrair dados de Colaborador da Tarefa SuccessFactors
Sobre a extração de dados de Colaborador do SuccessFactors
A tarefa Extract Colaborador Data from SuccessFactors automatiza uma exportação de dados de colaborador do SuccessFactors. Você pode importar dados essenciais de colaborador (nome, e-mail, identificador exclusivo), metadados colaborador (sexo, função, departamento etc.) e dados de hierarquia organizacional (gerente, local) em uma programação recorrente definida por você. Depois que seus dados são importados para o Qualtrics, eles precisam ser salvos usando uma tarefa do carregador de dados, geralmente a tarefa carregar usuários no diretório EX.
Configuração de uma Tarefa de extração de dados de Colaborador do SuccessFactors
- Criar um fluxo de trabalho de ETL .
- Selecione Fonte de dados (extrator ETL).
- Selecione Extrair dados de colaborador do SuccessFactors.
- Escolha uma conta do SuccessFactors para usar.
- Se quiser adicionar uma nova conta do SuccessFactors para usar, clique em Adicionar nova conta de usuário.
Qdica: depois de clicar em Add new user conta(Adicionar nova conta de usuário), você será direcionado para inserir as informações da sua conta do SuccessFactors. Consulte como encontrar as informações de sua conta do 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 aos principais campos de dados colaborador e são comumente importados para o Qualtrics. Esses campos são o nome, o sobrenome, o endereço de e-mail e o identificador exclusivo do colaborador. Se necessário, você pode remover esses campos do seu mapeamento.
- Para adicionar outros campos para importação, clique em Add Field (Adicionar campo).
Qdica: A plataforma Qualtrics não suporta múltiplos empregos para um participante individual do SuccessFactors. Se um campo tiver vários valores, o extrator extrairá o valor que foi modificado mais recentemente. Atualmente, não oferecemos suporte à seleção de outros valores. Além disso, se houver vários registros para o mesmo colaborador no SuccessFactors, a tarefa Transformação básica deverá ser usada para filtro todos os valores que não sejam o emprego principal.
- Selecione um campo do SuccessFactors clicando na caixa do campo e escolhendo-o na lista. Você também pode digitar o nome do campo para encontrá-lo mais rapidamente. Você pode pesquisar pelo nome do campo (se disponível, por exemplo, “Gender”) ou pelo caminho do campo no SuccessFactors (por exemplo, personal_information/birth_name).
Qdica: os campos personalizados podem ser importados inserindo o nome de campo apropriado do SuccessFactors (por exemplo, personal_information/custom_fieldname). Os campos personalizados não aparecerão nos resultados da pesquisa à medida que você digitar. Os campos personalizados devem ter um subcampo “lastModifiedDateTime” para serem importados.
- Para remover um campo, clique no sinal de menos ( – ) à direita do campo.
- Clique em Seguinte.
- Uma visualização será exibida, mostrando um exemplo do que será importado para cada campo selecionado.
- Se a visualização estiver correta, clique em Salvar. Se você precisar fazer alterações em seus campos, clique no botão Voltar .
Depois de configurar sua tarefa do SuccessFactors, você deve informar ao Qualtrics onde salvar seus dados com uma tarefa do carregador de dados. Normalmente, essa é a tarefa carregar usuários no diretório EX.
Como encontrar as informações de sua Conta do SuccessFactors
Depois de clicar em Add new user conta (Adicionar nova conta de usuário), você verá uma tela para inserir as credenciais OAuth do SuccessFactors. Visite nossa página Configurando SuccessFactors Tasks com credenciais OAuth para obter informações sobre os pré-requisitos necessários para a configuração.
- Nome: Esse é o rótulo que você dá à sua conta. Esse campo não é usado para autenticação.
- Nome de usuário: seu ID de usuário SAP.
Aviso: Seu nome de usuário e seu SAP User ID podem ser diferentes. O ID do usuário diferencia maiúsculas de minúsculas.
- Chave API, chave privada do certificado X.509: A autenticação do certificado X.509 acrescenta uma camada adicional de proteção aos seus dados. Quando você registrar um cliente Oauth usando esse certificado, uma chave API também será gerada.
Qdica: Há duas opções para gerar o certificado e a chave privada. Você pode gerar seu próprio certificado e chave privada, ou a SAP tem uma opção para gerar durante o registro do aplicativo cliente OAuth2, que pode ser baixado do SuccessFactors. Se você gerar uma chave privada, ela deverá estar no formato PKCS8. Para obter mais informações, consulte a documentação da SAP.
Para obter mais detalhes sobre esse processo, consulte a seguinte documentação da SAP:
-
- Registro do aplicativo cliente OAuth2
- Criação de um certificado X.509 no SAP SuccessFactors
- Geração de uma declaração SAML
- Solicitação de um token de acesso
- Visualização da validade de um token de acesso
Qdica: os três últimos documentos desta lista destinam-se a 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 de certificados, entre contato o suporte do SuccessFactors.
- Domínio do datacenter: Seu domínio do SuccessFactors.
Qdica:não inclua o endereço http:// no URL.
- ID da empresa: o ID de sua empresa SuccessFactors.
Você pode encontrar alguns desses campos em sua página de login do SuccessFactors:
- Seu nome de usuário é inserido no campo de nome de usuário.
Aviso: Seu nome de usuário e seu SAP User ID podem ser diferentes. O ID do usuário diferencia maiúsculas de minúsculas.
- O ID de sua empresa aparecerá acima dos campos de login.
Exemplo: Um exemplo de ID de empresa é BenefitsSB.
- O domínio do seu Datacenter pode ser encontrado em seu URL após o login no SuccessFactors.
Qdica:não inclua o endereço http:// no URL.Exemplo: Um exemplo de domínio de data center é apisalesdemo4.successfactors.com.
Se precisar de ajuda para acessar suas informações do SuccessFactors, consulte nossa página Configurando tarefas do SuccessFactors com credenciais OAuth ou contato o suporte do SuccessFactors.
Solução de problemas das tarefas do SuccessFactors
Para solucionar problemas em seu fluxo de trabalho, vá para relatórios de fluxos de trabalho e visualize a saída de seu fluxo de trabalho. Se o seu fluxo de trabalho falhar, isso conterá informações sobre o motivo da falha.
Credenciais Conta incorretas
Consulte Configuração de tarefas do SuccessFactors com credenciais OAuth.
Os campos importados estão em branco
A tarefa extrair dados de 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 ele no SuccessFactors. Certifique-se de que o caminho do campo que você selecionou corresponda a um campo preenchido no SuccessFactors. Observe que alguns nomes de campo podem estar associados a vários locais no SuccessFactors. Por exemplo, “/personal_information/created_by” e “address_information/created_by” são campos diferentes!
Erros comuns de campo
Esta tabela lista erros comuns e suas resoluções. Esses erros aparecem ao visualizar seus dados importados na tarefa de extração de dados de colaborador do SuccessFactors.
| Mensagem de erro | Resolução |
| O pedido de registro de pré-visualização foi bem sucedido, mas foram recebidos zero resultados. | Contato o suporte do SuccessFactors para saber por que zero registros estão sendo retornados. |
| Não foi possível analisar o caminho do campo {{Field Path Here}} da resposta. O caminho do campo deve ser do tipo booleano ou string. | Essa é uma mensagem de aviso que indica que o caminho do campo não era um Boolean ou String no registro de visualização.
Verifique o tipo de campo no Dicionário ODATA no SuccessFactors. |
| Erro encontrado ao buscar o token OAuth do SuccessFactors: {{Error from SuccessFactors}}. | Erro de credencial ao solicitar o token OAuth. O motivo específico estará na mensagem do SuccessFactors.
Razões conhecidas:
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 API OData do SuccessFactors. O motivo específico estará na mensagem do SuccessFactors. Esse erro ocorre porque a propriedade não pode ser 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 da Qualtrics. Entre contato suporte da Qualtrics. |
Propriedade não encontrada
Se você estiver tentando importar campos personalizados do SuccessFactors, o formato não poderá ser validado em nosso menu suspenso de campos. Se você receber um erro inesperado ao visualizar a importação, como “Nomes de propriedades inválidos”, verifique no SuccessFactors se o caminho do campo está correto.
Para procurar um campo, acesse o Admin Center no SuccessFactors e navegue até seu Dicionário de dados API OData.
A partir daí, vá para a guia Entity (Entidade) e procure o campo que deseja adicionar. Confirme se o campo existe e se o caminho do campo corresponde ao que você adicionou na tarefa Qualtrics Extract Colaborador Data from SuccessFactors. Em geral, “PerPerson” é a entidade base para começar a encontrar o caminho correto do campo. Se o caminho do campo estiver correto e ainda estiver ocorrendo o erro, entre em contato com o suporte do SuccessFactors para obter ajuda.