Atividade de exclusão em massa ou exclusão definitiva em massa do Salesforce

Introdução

Uma atividade Bulk Delete ou Bulk Hard Delete do Salesforce exclui um grande número de registros existentes em um endpoint do Salesforce e tem a intenção de ser usada como um alvo para consumir dados em uma operação. Após configurar uma conexão do Salesforce, você pode configurar quantas atividades do Salesforce quiser para cada conexão do Salesforce.

A diferença entre uma exclusão e uma exclusão definitiva é que, com uma exclusão, os registros excluídos são armazenados na Lixeira do Salesforce. Com uma exclusão definitiva, os registros se tornam imediatamente qualificados para exclusão. A Lixeira do Salesforce permite que você visualize e restaure registros excluídos recentemente por 15 dias antes de serem excluídos permanentemente. Há um limite para o tamanho da Lixeira do Salesforce; uma vez excedido, os registros podem se tornar automaticamente qualificados para exclusão. Consulte a documentação do Salesforce para mais detalhes.

As atividades Exclusão em massa e Exclusão definitiva em massa são mais rápidas e dimensionam melhor do que as atividades de exclusão não em massa do Salesforce, mas deve ser usado somente se você não precisar usar uma transformação para alterar dados antes de atingir seu destino. (As atividades em massa do Salesforce não podem ser usadas com transformações.)

O conector Salesforce oferece suporte à API em massa do Salesforce. Para obter mais informações, consulte Pré-requisitos e versões de API com suporte.

Criar uma atividade do Salesforce

Uma instância de uma atividade é criada a partir de uma conexão usando um tipo de atividade.

Para criar uma instância de uma atividade, arraste o tipo de atividade para a quadro de design ou copie o tipo de atividade e cole-o na quadro de design. Para obter detalhes, consulte Criando uma instância de atividade em Reutilização de componentes.

Uma atividade existente pode ser editada a partir destes locais:

• A quadro de design (veja menu de ações do componente em Tela de design).
• A aba Componentes do painel do projeto (consulte menu de ações do componente na aba Componentes do painel Projeto).

Configurar uma atividade de exclusão em massa ou exclusão definitiva em massa do Salesforce

As etapas para configurar uma atividade Bulk Delete ou Bulk Hard Delete do Salesforce são as mesmas. Siga estas etapas para configurar qualquer uma dessas atividades:

• Etapa 1: Insira um nome e selecione um objeto Forneça um nome para a atividade e selecione o objeto a ser usado na exclusão em massa ou na exclusão definitiva de dados em massa.
• Etapa 2: Forneça o esquema de resposta Carregue ou selecione um arquivo CSV. Isso fornecerá o esquema a ser usado na etapa final.
• Etapa 3: Cabeçalhos do mapa Mapeie os cabeçalhos do arquivo de origem fornecidos pelo arquivo CSV com os campos desejados do Salesforce dos registros que devem ser excluídos em massa ou excluídos definitivamente em massa.

Etapa 1: insira um nome e selecione um objeto

Nesta etapa, você fornece um nome para a atividade e seleciona o objeto a ser usado na exclusão em massa ou na exclusão definitiva de dados em massa.

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

• Selecione a referência do objeto: Use o menu suspenso para selecionar um objeto padrão ou personalizado do Salesforce para excluir em massa ou excluir permanentemente os dados em massa. Insira o valor de qualquer coluna na caixa de pesquisa para filtrar a lista de objetos. A pesquisa não diferencia maiúsculas de minúsculas.

  Nota

  Se a lista não for preenchida com objetos disponíveis, observe as seguintes dicas de solução de problemas:

  • A conexão Salesforce pode não ser bem-sucedido. Certifique-se de que você está conectado reabrindo a conexão e testando novamente as credenciais.

  • Uma senha do Salesforce que usa caracteres ASCII estendidos, como £, pode causar o seguinte erro ao buscar dados durante a configuração da atividade:

    Invalid username, password, security token; or user locked out. [INVALID_LOGIN]
    

    Neste caso, o teste de conexão ainda pode ser bem-sucedido. Se você receber este erro durante a configuração da atividade e estiver usando caracteres especiais na senha, tente alterar a senha.

• Atualizar: Clique no ícone de atualizaçãopara recarregar objetos do endpoint do Salesforce. Isso pode ser útil se você adicionou objetos recentemente ao Salesforce.

• Salvar e sair: Se habilitado, clique para salvar a configuração desta etapa e fechar a configuração da atividade.

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

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

Etapa 2: Forneça o esquema de resposta

Nesta etapa, carregue ou selecione um arquivo CSV. O arquivo CSV fornecerá o esquema a ser usado em Etapa 3: Mapear cabeçalhos.

• Fornecer esquema de solicitação: Um arquivo CSV carregado ou existente define o esquema que é usado na solicitação. Este esquema é usado como parte da atividade em massa do Salesforce para criar mapeamentos na próxima etapa. Selecione uma das duas opções abaixo.

  Nota

  Os esquemas para atividades em massa do Salesforce sempre fazem parte da atividade e nunca podem ser definidos em uma transformação, pois as transformações não podem ser usadas em uma operação que tenha uma atividade em massa do Salesforce.

  • Usar esquema salvo: Escolha esta opção para selecionar um esquema CSV existente que foi definido anteriormente no projeto atual.

    • Esquemas salvos: Use o menu suspenso para selecionar um esquema existente para reutilizar.

    • Exibir esquema: Depois que um esquema carregado existente for selecionado, você pode visualizar o esquema diretamente na área de texto abaixo do menu suspenso. Embora um esquema salvo não seja editável, esta área de texto pode ser copiada usando Control+C (Windows ou Linux) ou Command+C (macOS). Esta área de texto é apenas para a exibição de esquemas carregados existentes e não para flat, hierárquico, ou espelhado esquemas personalizados.

    • Validação: As informações de validação são fornecidas abaixo da área de texto e são baseadas na extensão de arquivo do esquema salvo.

  • Fornecer novo esquema: Escolha esta opção para definir um novo esquema carregando um arquivo ou inserindo um manualmente na área de texto.

    • Nome do esquema: Insira um nome para o esquema na caixa de texto superior, incluindo a extensão do arquivo. Se nenhuma extensão de arquivo for fornecida, o arquivo será tratado como CSV por padrão. Se você estiver carregando um arquivo, pode deixar em branco, pois o nome é preenchido assim que o arquivo é carregado.

    • Carregar arquivo: Clique neste botão para abrir uma caixa de diálogo onde você pode carregar um esquema de um arquivo que pode ser acessado na máquina atual:

      

      • Arquivo: Use o botão Navegar para encontrar localmente um arquivo simples que ainda não foi usado no projeto atual. Arquivos de até 5 MB de tamanho podem ser carregados.

        !!! warning "Aviso" Se você tentar carregar um arquivo com o mesmo nome de um arquivo existente já definido no projeto, uma caixa de diálogo perguntará se você deseja substituir o arquivo existente. Se você clicar em Continuar, o arquivo será substituído pelo novo arquivo com o mesmo nome em todos os lugares onde ele for usado no projeto. Se você não quiser substituir o arquivo, clique em Cancelar e, em seguida, modifique manualmente o arquivo para que ele tenha um nome que ainda não esteja sendo usado, depois tente carregá-lo novamente.

      • Carregar: Clique neste botão para carregar o esquema do arquivo. Observe que alguns dados podem ser convertidos durante o processamento, conforme descrito em Processamento de esquema.

      • Cancelar: Clique em Cancelar para fechar a caixa de diálogo Carregar arquivo de esquema sem salvar.

    • Visualizar/editar esquema: Depois que um esquema é carregado, você pode visualizá-lo ou editá-lo diretamente na área de texto abaixo do botão Carregar arquivo. Outra opção é inserir ou colar manualmente um esquema nessa área sem carregar um esquema de um arquivo.

    • Validação: Conforme você edita um esquema, as informações de validação serão fornecidas abaixo da área de texto, com quaisquer erros relatados uma linha por vez. Ou seja, após resolver um erro em uma linha, erros de sintaxe adicionais para resolver podem ser relatados para linhas subsequentes. A validação é baseada na extensão de arquivo do esquema fornecido.

• Voltar: Clique para armazenar temporariamente a configuração desta etapa e retornar à etapa anterior.

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

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

Etapa 3: Cabeçalhos do mapa

Nesta etapa, você mapeia os cabeçalhos do arquivo de origem do arquivo CSV fornecido em Etapa 2: fornecer o esquema de resposta para os campos desejados do Salesforce dos registros que devem ser excluídos em massa ou excluídos definitivamente em massa.

• Map Headers: Esta etapa é usada para mapear campos por coluna no arquivo de origem para aqueles na atividade de destino em massa do Salesforce. Para concluir um mapeamento, arraste um campo de origem à esquerda para um campo de destino à direita. Quando os campos são mapeados, o fundo fica laranja e uma linha é desenhada entre os campos mapeados. Para remover um mapeamento, clique no campo de origem ou no campo de destino.

  • Cabeçalhos do arquivo de origem: O lado esquerdo mostra os cabeçalhos das colunas no arquivo fornecido na etapa anterior.

    • Pesquisar: Insira qualquer valor de coluna na caixa de pesquisa para filtrar a lista de cabeçalhos. A pesquisa não diferencia maiúsculas de minúsculas.

    • Importar mapeamento: Para importar um mapeamento que foi exportado anteriormente, clique no link Importar mapeamento e forneça informações na caixa de diálogo:

      

      • Tipo de arquivo: Use o menu suspenso para selecionar o formato do arquivo de mapeamento:

        • JDL: Selecione JDL para usar um arquivo que foi exportado de uma operação de processo em massa do Design Studio (da opção Design Studio para Salvar mapeamentos em arquivo descrito em Mapeamento de Transformação em Assistente de processo em massa do Salesforce para ação de upsert).
        • JSON: Selecione JSON para usar um arquivo que foi exportado de Integration Studio usando o link Exportar Mapeamento descrito abaixo.

      • Arquivo: Clique no botão Navegar à direita para selecionar um arquivo que contenha o mapeamento.

      • Carregar: Após selecionar um arquivo, clique em Carregar para carregar o mapeamento.

        !!! warning "Aviso" O mapeamento carregado substitui quaisquer mapeamentos existentes, se presentes.

      • Cancelar: Clique em Cancelar para fechar o diálogo de importação sem carregar um mapeamento.

    • Exportar mapeamento: Para exportar um mapeamento existente, clique no link Exportar mapeamento. Isso inicia o processo de download no seu navegador. O arquivo exportado está no formato JSON. Cada mapeamento de campo inclui o nome do campo de origem, o nome do campo de destino e o índice de origem.

      Nota

      Os mapeamentos de atividades em massa exportados não podem ser importados, como mapeamentos de transformação e pode ser importado somente usando o link Importar Mapeamento descrito acima.

  • Campos do Salesforce: O lado direito mostra os nomes das colunas no Salesforce que estão disponíveis para serem mapeadas.

    • Pesquisar: Insira qualquer valor de coluna na caixa de pesquisa para filtrar a lista de cabeçalhos. A pesquisa não diferencia maiúsculas de minúsculas.
    • Automap: Clique no link Automap para mapear nomes de campos de origem e destino que sejam correspondência exata (independentemente de maiúsculas e minúsculas) e tenham tipos de dados idênticos. Os campos que são mapeados automaticamente são adicionais a quaisquer mapeamentos existentes, que são deixados no lugar.
    • Recomeçar: Clique no link Recomeçar para limpar todos os mapeamentos.
  • Voltar: Clique para armazenar temporariamente a configuração desta etapa e retornar à etapa anterior.
  • Concluído: 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 nenhuma etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.

Próximos passos

Após configurar uma atividade Bulk Delete ou Bulk Hard Delete 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.

Concluir a operação

Após configurar uma atividade Bulk Delete ou Bulk Hard Delete do Salesforce, conclua a configuração da operação adicionando e configurando outras atividades ou scripts como etapas da operação. Você também pode configurar as configurações de operação de uma operação, que incluem a capacidade de encadear operações que estejam no mesmo fluxo de trabalho ou em workflows diferentes.

Depois que uma atividade Exclusão em massa ou Exclusão definitiva em massa do Salesforce for criada, as ações de menu para essa atividade serão acessíveis no painel do projeto nas guias Workflows ou Componentes e na quadro de design. Consulte menu de ações da atividade para mais detalhes.

As atividades Exclusão em massa ou Exclusão definitiva do Salesforce podem ser usadas como um alvo com este padrão de operação:

• Padrão de segmentação em massa do Salesforce

Uma atividade do Salesforce pode ser usada como uma etapa 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 outro lugar (consulte Reutilização de componentes).

Outros padrões não são válidos usando as atividades Bulk Delete ou Hard Delete do Salesforce. Veja os padrões de validação em Validade da operação página.

Além disso, a fonte baseada em arquivo usada na operação deve usar um formato de arquivo simples com um cabeçalho e somente estes tipos de dados:

• Base64
• Booleano
• Formatos de data
• Dobro
• Inteiro
• ID do Salesforce
• Corda

As operações que usam atividades do Salesforce também podem ter ações de operação configuradas para disparar em uma falha de 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 uma falha de SOAP. Para obter instruções sobre como disparar uma ação em uma falha de SOAP, consulte Ações de operação.

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

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

Exibir 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 de tempo de execução do Management Console. Selecione a operação relevante na tabela Operações de tempo de execução e clique na aba Registros de atividades na seção inferior da tela para exibir 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 Download para salvar os registros de sucesso como um arquivo CSV.

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