Atividade de Exclusão do Salesforce

Introdução

Uma atividade de Exclusão do Salesforce, utilizando sua conexão do Salesforce, exclui dados no Salesforce e é destinada a ser usada como um destino para consumir dados em uma operação.

Criar uma atividade de Exclusão do Salesforce

Uma instância de uma atividade de Exclusão do Salesforce é criada a partir de uma conexão do Salesforce usando seu tipo de atividade Exclusão.

Para criar uma instância de uma atividade, arraste o tipo de atividade para a tela de design ou copie o tipo de atividade e cole-o na tela de design. Para detalhes, veja Criar uma instância de atividade ou ferramenta em Reutilização de componentes.

Uma atividade de Exclusão do Salesforce existente pode ser editada a partir destes locais:

• A tela de design (veja Menu de ações do componente em Tela de design).

• A aba Componentes do painel do projeto (veja Menu de ações do componente em Aba Componentes do painel do projeto).

Configurar uma atividade de Exclusão do Salesforce

Siga estas etapas para configurar uma atividade de Exclusão do Salesforce:

• Etapa 1: Insira um nome
  Forneça um nome para a atividade.

• Etapa 2: Revise os esquemas de dados
  Quaisquer esquemas de solicitação ou resposta gerados a partir do endpoint são exibidos.

Etapa 1: Insira um nome

Neste passo, você fornece um nome para a atividade.

• Nome: Insira um nome para identificar a atividade Excluir do Salesforce. O nome deve ser exclusivo para cada atividade Excluir do Salesforce e não deve conter barras (/) ou dois pontos (:).

• Salvar e Sair: Se habilitado, clique para salvar a configuração deste passo e fechar a configuração da atividade.

• Próximo: Clique para armazenar temporariamente a configuração deste passo e continuar para o próximo passo. A configuração não será salva até que você clique no botão Concluído no último passo.

• Descartar Alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em qualquer passo. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Passo 2: Revisar os esquemas de dados

Neste passo, quaisquer esquemas de solicitação ou resposta gerados a partir do endpoint são exibidos:

• Esquema de Dados: Os esquemas de dados de solicitação e resposta são exibidos. Dentro do nó ids no lado da solicitação da estrutura, há um valor de texto representado por um campo, que é destinado a ser usado para fornecer o(s) ID(s) do registro do Salesforce. Mais tarde, durante o processo de mapeamento de transformação, você pode mapear para os ids no lado de destino para fornecer o(s) ID(s) do registro do Salesforce a serem excluídos.

  A versão da API do Salesforce que é usada depende da versão do agente Jitterbit que você está utilizando. Consulte Pré-requisitos e versões de API suportadas para links à documentação sobre os campos do esquema.

  Nota

  Para atualizar um esquema de dados em uma atividade existente, você deve avançar por cada passo de configuração da atividade novamente, fazendo pelo menos uma alteração (como adicionar e remover um caractere do final do nome da atividade) para forçar uma atualização do esquema.

• Voltar: Clique para armazenar temporariamente a configuração deste passo e retornar ao passo anterior.

• Finalizado: Clique para salvar a configuração de todas as etapas e fechar a configuração da atividade.

• Descartar Alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em qualquer etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.

Próximas etapas

Após configurar uma atividade Excluir do Salesforce, você pode usá-la dentro de uma operação conforme descrito abaixo. Após executar uma operação contendo uma atividade do Salesforce em um agente privado, você pode baixar os arquivos de sucesso e falha da operação.

Completar a operação

Após configurar uma atividade Excluir do Salesforce, complete a configuração da operação adicionando e configurando outras atividades ou ferramentas como etapas da operação. Você também pode configurar as configurações da operação, que incluem a capacidade de encadear operações que estão no mesmo ou em diferentes fluxos de trabalho.

As ações do menu para uma atividade estão acessíveis a partir do painel do projeto e da tela de design. Para detalhes, veja Menu de ações da atividade em Conceitos básicos do conector.

Atividades Excluir do Salesforce podem ser usadas como um destino com esses padrões de operação:

• Padrão de transformação
• Padrão de arquivo de dois destinos (como o primeiro destino apenas)
• Padrão de duas transformações (como o primeiro ou segundo destino)

Operações que contêm uma atividade do Salesforce podem ter apenas uma atividade do Salesforce e não podem conter outras atividades, exceto aquelas associadas aos conectores de API, Banco de Dados, Compartilhamento de Arquivos, FTP, HTTP, Armazenamento Local, Armazenamento Temporário, ou Variável.

Uma atividade do Salesforce pode ser usada como um passo de operação em apenas uma única operação. Ou seja, você não pode referenciar a mesma atividade várias vezes dentro de outras operações. Em vez disso, você pode fazer uma cópia de uma atividade do Salesforce para usar em outros lugares (veja Reutilização de componentes).

Outros padrões não são válidos ao usar atividades de Delete do Salesforce. Consulte os padrões de validação na página Validade da operação.

Dentro de uma transformação, se usar a opção de espelhar um esquema fornecido por uma atividade do Salesforce que não seja em massa, o esquema espelhado resultante será criado automaticamente com um nó raiz adicional chamado records, com o(s) nó(s) filho(s) espelhando o esquema. Quando os campos dentro do(s) nó(s) filho(s) são mapeados, o nó se torna um nó de loop para permitir que todos os registros sejam percorridos (veja Nós de loop em Estruturas de dados).

Operações que usam atividades do Salesforce também podem ter ações de operação configuradas para serem acionadas em um erro SOAP — um erro resultante de um formato de mensagem incorreto, processamento de cabeçalho ou incompatibilidade. As ações de operação podem ser configuradas para executar uma operação ou enviar um email após a ocorrência de um erro SOAP. Para instruções sobre como acionar uma ação em erro SOAP, consulte Ações de operação.

Para usar a atividade com funções de script, escreva os dados em um local temporário e, em seguida, use esse local temporário na função de script.

Quando estiver pronto, implante e execute a operação e valide o comportamento verificando os logs da operação.

Visualizar arquivos de sucesso e falha

Se você estiver executando uma operação contendo uma atividade do Salesforce em um agente privado, os arquivos de sucesso e falha estão disponíveis para download na página Operações em Tempo de Execução do Console de Gerenciamento. Selecione a operação relevante na tabela Operações em Tempo de Execução e clique na aba Logs de Atividade na seção inferior da tela para exibir os links de download para os arquivos, se disponíveis:

• Baixar Arquivo de Sucesso: Se você estiver executando a operação em um agente privado, clique no link Baixar para salvar os registros de sucesso como um arquivo CSV.

• Baixar Arquivo de Falha: Se você estiver executando a operação em um agente privado, clique no link Baixar para salvar os registros de falha como um arquivo CSV.