Extrair dados da tarefa do Salesforce
Sobre a tarefa Extrair dados do Salesforce
A tarefa Extrair dados do Salesforce importa dados da sua instância do Salesforce para usar no Qualtrics. Na primeira execução, a tarefa importará todos os registros de objeto e, nas execuções subsequentes, ela obterá registros novos ou atualizados desde a última execução. Depois que os dados forem importados para a Qualtrics, use uma tarefa de carregador de dados para salvar os dados na área desejada na plataforma.
Produção vs. Tarefas de sandbox
Existem 2 tarefas de extração de dados do Salesforce:
- Extrair dados do Salesforce: conecte-se a uma conta de produção do Salesforce para importar dados de conta e contato do cliente.
- Extrair dados do Salesforce (Sandbox): conecte-se a uma conta sandbox do Salesforce para testar fluxos de trabalho antes da implementação na produção.
Attention: Sandbox connections are supported when you add an account in the Extract data from Salesforce task. The Extract data from Salesforce (Sandbox) task is no longer supported and will not be available in the near future.
A Qualtrics fornece uma versão sandbox dessa tarefa para que você possa testar e aperfeiçoar seus fluxos de trabalho antes de executá-los com dados reais do cliente. Confira esta página de suporte do Salesforce para saber mais sobre ambientes sandbox.
Configuração de uma tarefa de extração de dados do Salesforce
Enquanto esta seção se concentra na versão de produção da tarefa, as etapas são as mesmas para a versão sandbox.
- Criar um fluxo de trabalho ETL.
- Selecione Fonte de dados (extrator ETL).
- Selecione a tarefa Extrair dados do Salesforce.
- Selecione a conta do Salesforce da qual os dados serão importados.
Qdica: Todas as contas da Salesforce conectadas anteriormente, bem como as contas configuradas pelos Administradores da marca, estarão disponíveis aqui.Atenção: você pode ter até cinco conexões externas com sua conta do Salesforce para esta tarefa. Se você adicionar mais de cinco conexões, a conexão mais antiga será cortada. - Se você quiser adicionar uma nova conta do Salesforce, clique em Adicionar conta de usuário.
- Clique em Seguinte.
- Clique em Adicionar objeto.
- Selecione o objeto que você deseja adicionar. Você pode adicionar vários objetos.
Atenção: os únicos objetos disponíveis para utilização são Conta, Membro da equipe da conta, Contato e Oportunidade.Qdica: Se você não tiver nenhum objeto aqui, a conexão entre sua conta do Salesforce e a Qualtrics será inválida ou expirada. Volte para a tela de seleção de conta clicando em Voltar e adicione novas credenciais Salesforce.
- Selecione um objeto que você adicionou para iniciar o mapeamento de campos.
- Se desejar, use o menu suspenso da lista Salesforce para limitar quais objetos são importados com base nos critérios de filtro da lista no Salesforce (chamado de visão de lista em Salesforce). Se nenhuma opção for selecionada, todos os objetos associados serão importados.
- Clique no campo Adicionar.
- Use o menu suspenso Selecionar campo para selecionar um campo a ser mapeado. Repita essas etapas para quantos campos forem necessários.
Atenção: os campos compostos do Salesforce não podem ser importados para a Qualtrics.
- Para remover um campo de seu mapeamento, clique no ícone da lixeira.
- Se estiver importando vários objetos, repita as etapas de mapeamento acima para mapear seus campos para cada objeto.
- Clique em Salvar quando terminar.
Depois de extrair dados do Salesforce, você deve informar à Qualtrics onde salvar os dados com uma tarefa de carregador de dados. Consulte Tarefas de carregador disponíveis para obter mais informações.
Solução de problemas
Se o fluxo de trabalho não for concluído, vá para o relatório & histórico para obter mais informações sobre a falha. Esta seção abrange erros comuns e a respectiva resolução para a tarefa de extração de dados da Salesforce.
“Suas credenciais para o Salesforce são inválidas, reconecte”
As credenciais utilizadas com a tarefa são inválidas e precisam ser inseridas novamente. Para corrigir esse problema, edite a tarefa que falhou e escolha outra credencial válida ou adicione uma nova.
“ListView {{listviewId}} para sObject {{sObjectName}} não existe”
A lista utilizada na tarefa não está acessível ao usuário ou foi eliminada. Para corrigir este problema, processe a tarefa que falhou e selecione o objeto que tem uma lista inválida. Em seguida, selecione uma nova lista para utilizar.
O campo {{listviewId}} na mensagem de erro contém o ID da lista em Salesforce e o campo {{sObjectName}} é o nome do objeto no Salesforce.
O objeto {{sObjectName}} não existe
O objeto utilizado com a tarefa não está acessível ao usuário ou foi eliminado. Para corrigir este problema, processe a tarefa que falhou, remova o objeto inválido e grave a tarefa.
O campo {{sObjectName}} na mensagem de erro contém o nome do objeto em Salesforce.
O campo {{fieldName}} em sObject {{sObjectId}} não existe
O campo utilizado na tarefa não está acessível ao usuário ou foi eliminado. Para corrigir esse problema, edite a tarefa que falhou, remova o campo inválido e salve a tarefa.
O campo {{fieldName}} na mensagem de erro contém o nome do campo em Salesforce e o campo {{sObjectId}} é o ID do objeto no Salesforce.
Não foi possível determinar isolamento de dados
Se esse erro ocorrer, entre em contato com o suporte da Qualtrics.
Ocorreu um erro inesperado
Se esse erro ocorrer, entre em contato com o suporte da Qualtrics.
An error occurred with Sandbox
If there are any errors with Sandbox, it is recommended to use a non-Sandbox version in order to resolve the issue. Sandbox environments are intended for testing purposes, and won’t always perform the same as non-Sandbox environments.