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.
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.
- 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 Fluxos de trabalho programados vs. Workflows baseados em eventos.
Qdica: Na maioria das vezes, você usará um fluxo de trabalho programado para garantir que seus dados estejam atualizados regularmente.
- Dê um nome ao seu fluxo de trabalho clicando no nome do fluxo de trabalho na parte superior.
- Determine o acionador para o seu workflow que determina o que causa o acionamento do workflow. Você fará aqui depende de se selecionou um workflow baseado em eventos ou programado. Consulte Fluxos de trabalho programados vs. fluxos de trabalho baseados em eventos para obter mais informações.
- Clique no sinal de mais ( + ) e selecione Tarefa.
- 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.Qdica: Se estiver mapeando contas, siga o guia do Centro de comandos de gerenciamento de contas para obter um passo a passo sobre mapeamento de campos de conta.
- 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.