Show Menu
TÓPICOS×

Criação de modelos de workflow para importar dados

Usar um template de importação é uma prática recomendada se você precisar importar arquivos regularmente com a mesma estrutura.
Esse exemplo mostra como predefinir um workflow que pode ser reutilizado para importar perfis provenientes de um CRM no banco de dados do Adobe Campaign.
  1. Crie um novo modelo de workflow a partir de Resources > Templates > Workflow templates .
  2. Adicione as seguintes atividades:
    • Load file : defina a estrutura esperada do arquivo que contém os dados que serão importados.
      Você só pode importar dados de um único arquivo. Se o fluxo de trabalho tiver várias Load file atividades, o mesmo arquivo será usado sempre.
    • Reconciliation : reconcilie os dados importados com os dados do banco de dados.
    • Segmentation : crie filtros para processar registros de forma diferente, sejam eles reconciliados ou não.
    • Deduplication : elimine a duplicação dos dados do arquivo de entrada antes de ele ser inserido no banco de dados.
    • Update data : atualize o banco de dados com os perfis importados.
  3. Configure a atividade Load file :
    • Defina a estrutura esperada carregando um arquivo de amostra. O arquivo de amostra deve conter apenas algumas linhas, mas todas as colunas necessárias para a importação. Verifique e edite o formato de arquivo para verificar se o tipo de cada coluna está definido corretamente: texto, data, inteiro, etc. Por exemplo:
      lastname;firstname;birthdate;email;crmID
      Smith;Hayden;23/05/1989;hayden.smith@mailtest.com;123456
      
      
    • Na seção File to load , selecione Upload a new file from the local machine e deixe o campo em branco. Toda vez que um novo workflow for criado a partir desse modelo, você pode especificar aqui o arquivo desejado, desde que ele corresponda à estrutura definida.
      Você pode usar qualquer uma das opções, mas precisa modificar o template adequadamente. Por exemplo, se você selecionar Use the file specified in the inbound transition , será possível adicionar uma atividade Transfer file antes de recuperar o arquivo para importar de um servidor FTP/SFTP.
      Se quiser que os usuários possam baixar um arquivo que contenha erros que ocorreram durante uma importação, marque a Keep the rejects in a file opção e especifique o File name .
  4. Configure a atividade Reconciliation . A finalidade dessa atividade nesse contexto é identificar os dados de entrada.
    • In the Relations tab, select Create element and define a link between the imported data and the recipients targeting dimension (see Targeting dimensions and resources ). Neste exemplo, o campo personalizado ID do CRM é usado para criar a condição de associação. Use o campo ou uma combinação de campos que você precisa, desde que isso permita identificar registros únicos.
    • Na guia Identification , deixe a opção Identify the document from the working data desmarcada.
  5. Configure a atividade Segmentation para recuperar os recipients reconciliados em uma transição e recipients que não puderam ser reconciliados, mas que tenham dados suficientes em uma segunda transição.
    A transição com recipients reconciliados pode ser usada para atualizar o banco de dados. A transição com recipients desconhecidos pode ser usada para criar novas entradas de recipients no banco de dados se um conjunto mínimo de informações estiver disponível no arquivo.
    Os recipients que não podem ser reconciliados e não têm dados suficientes estão selecionados em uma transição de saída de complemento e podem ser exportados em um arquivo separado ou simplesmente ignorado.
    • Na General guia da atividade, defina o Resource type como Temporary resource e selecione Reconciliation como o conjunto de metas.
    • In the Advanced options tab, check the Generate complement option to be able to see if any record cannot be inserted in the database. Se for necessário, você pode aplicar processamento adicional aos dados complementares: exportação de arquivos, atualização de lista etc.
    • In the first segment of the Segments tab, add a filtering condition on the inbound population to select only records for which the profile's CRM ID is not equal to 0. Dessa forma, os dados do arquivo que são reconciliados com perfis do banco de dados são selecionados nesse subconjunto.
    • Adicione um segundo segmento que selecione registros não reconciliados que tenham dados suficientes para serem inseridos no banco de dados. Por exemplo: endereço de email, nome e sobrenome. Os registros não reconciliados têm o valor da ID CRM do perfil igual a 0.
    • Todos os registros que não estão selecionados nos dois primeiros subconjuntos são selecionados no Complement .
  6. Configure a atividade Update data localizada após a primeira transição de saída da atividade Segmentation configurada anteriormente.
    • Selecione Update como Operation type desde que a transição de entrada contenha apenas os recipients já presentes no banco de dados.
    • Na Identification guia, selecione Using reconciliation criteria e defina uma chave entre Dimension to update - Perfis, neste caso - e o link criado na Reconciliation atividade. Neste exemplo, o campo personalizado ID do CRM é usado.
    • In the Fields to update tab, indicate the fields from the Profiles dimension to update with the value of the corresponding column from the file. Se os nomes das colunas de arquivo forem idênticos ou quase idênticos aos dos campos de dimensão dos recipients, você poderá usar o botão de varinha mágica para combinar os diferentes campos automaticamente.
      Se você planeja enviar emails diretos para esses perfis, certifique-se de incluir um endereço postal, pois essas informações são essenciais para o provedor de mala direta. Verifique também se a Address specified caixa nas informações dos perfis está marcada. Para atualizar essa opção de um fluxo de trabalho, basta adicionar um elemento aos campos a serem atualizados e especificar 1 como Source e selecionar o postalAddress/@addrDefined campo como Destination . Para obter mais informações sobre mala direta e o uso da Address specified opção, consulte este documento .
  7. Configure the Deduplication activity located after the transition containing unreconciled profiles:
    • Na Properties guia, defina o Resource type para o recurso temporário gerado a partir da Reconciliation atividade do fluxo de trabalho.
    • Nesse exemplo, o campo de email é usado para localizar perfis únicos. Você pode usar qualquer campo que você tem certeza que está preenchido e é parte de uma combinação única.
    • Escolha um Deduplication method . Neste caso, o pedido decide automaticamente quais os registros que são mantidos em caso de duplicado.
  8. Configure a atividade Update data , localizada após a atividade Deduplication , configurada anteriormente.
    • Select Insert only as Operation type since the inbound transition only contains profiles not present in the database.
    • Na Identification guia, selecione Using reconciliation criteria e defina uma chave entre Dimension to update - Perfis, neste caso - e o link criado na Reconciliation atividade. Neste exemplo, o campo personalizado ID do CRM é usado.
    • In the Fields to update tab, indicate the fields from the Profiles dimension to update with the value of the corresponding column from the file. Se os nomes das colunas de arquivo forem idênticos ou quase idênticos aos dos campos de dimensão dos recipients, você poderá usar o botão de varinha mágica para combinar os diferentes campos automaticamente.
      Se você planeja enviar emails diretos para esses perfis, certifique-se de incluir um endereço postal, pois essas informações são essenciais para o provedor de mala direta. Verifique também se a Address specified caixa nas informações dos perfis está marcada. Para atualizar essa opção de um fluxo de trabalho, basta adicionar um elemento aos campos a serem atualizados e especificar 1 como Source e selecionar o campo # como Destination . Para obter mais informações sobre mala direta e o uso da Address specified opção, consulte este documento .
  9. Após a terceira transição da atividade Segmentation , adicione uma atividade Extract file e uma atividade Transfer file se desejar acompanhar os dados não inseridos no banco de dados. Configure essas atividades para exportar a coluna necessária e transferir o arquivo em um servidor FTP ou SFTP, onde você pode recuperá-la.
  10. Adicione uma atividade End e salve o template do workflow.
Agora o template pode ser usado e está disponível para cada novo workflow. Basta especificar o arquivo que contém os dados que serão importados na atividade Load file .