Criação de modelos de fluxo de trabalho para importar dados import-workflow-template
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.
-
Crie um novo modelo de workflow a partir de Resources > Templates > Workflow templates.
-
Adicione as seguintes atividades:
-
Load file: defina a estrutura esperada do arquivo que contém os dados que serão importados.
note note NOTE Só é possível importar dados de um único arquivo. Se o fluxo de trabalho tiver várias atividades Load file, 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.
-
-
Configure a atividade Load file:
-
Definir a estrutura esperada fazendo upload de 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:
code language-none 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 baixem um arquivo contendo erros que ocorreram durante uma importação, marque a opção Keep the rejects in a file e especifique o File name.
-
-
Configure a atividade Reconciliation. A finalidade dessa atividade nesse contexto é identificar os dados de entrada.
- Na guia Relations, selecione Create element e defina um vínculo entre os dados importados e o targeting dimension do recipient (consulte Targeting dimensions e recursos). 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.
-
Configure a atividade Segmentation para recuperar os destinatários reconciliados em uma transição e destinatários que não puderam ser reconciliados, mas que tenham dados suficientes em uma segunda transição.
A transição com destinatários reconciliados pode ser usada para atualizar o banco de dados. A transição com destinatários desconhecidos pode ser usada para criar novas entradas de destinatários no banco de dados se um conjunto mínimo de informações estiver disponível no arquivo.
Os destinatários 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 guia General da atividade, defina o Resource type como Temporary resource e selecione Reconciliation como o conjunto direcionado.
-
Na guia Advanced options, marque a opção Generate complement para ver se algum registro não pode ser inserido no banco de dados. Se for necessário, você pode aplicar processamento adicional aos dados complementares: exportação de arquivos, atualização de lista etc.
-
No primeiro segmento da guia Segments, adicione uma condição de filtragem no público de entrada para selecionar apenas registros para os quais a ID de CRM do perfil não for igual a 0. Dessa forma, os dados do arquivo reconciliado com perfis do banco de dados são selecionados nesse subconjunto.
-
Adicione um segundo segmento que seleciona 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 do CRM do perfil igual a 0.
-
Todos os registros que não estão selecionados nos dois primeiros subconjuntos são selecionados no Complement.
-
-
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 destinatários já presentes no banco de dados.
-
Na guia Identification, selecione Using reconciliation criteria e defina uma chave entre Dimension to update - Perfis neste caso - e o link criado na atividade Reconciliation. Neste exemplo, o campo personalizado ID do CRM é usado.
-
Na guia Fields to update, indique os campos da dimensão Perfis a serem atualizados com o valor da coluna correspondente no arquivo. Se os nomes das colunas de arquivo forem idênticos ou quase idênticos aos dos campos de dimensão dos destinatários, você poderá usar o botão de varinha mágica para combinar os diferentes campos automaticamente.
note note NOTE Se você planeja enviar correspondência direta para esses perfis, inclua um endereço postal, pois essas informações são essenciais para o provedor de correspondência direta. Verifique também se a caixa Address specified nas informações dos seus perfis está marcada. Para atualizar esta opção de um fluxo de trabalho, basta adicionar um elemento aos campos a serem atualizados, especificar 1 como Source e selecionar o campo postalAddress/@addrDefined
como Destination. Para obter mais informações sobre correspondência direta e o uso da opção Address specified, consulte este documento.
-
-
Configure a atividade Deduplication localizada após a transição que contém perfis não reconciliados:
-
Na guia Properties, defina o Resource type para o recurso temporário gerado a partir da atividade Reconciliation 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. Nesse caso, o aplicativo decide automaticamente quais registros são mantidos em caso de duplicatas.
-
-
Configure a atividade Update data, localizada após a atividade Deduplication, configurada anteriormente.
-
Selecione Insert only como Operation type desde que a transição de entrada contenha apenas perfis não presentes no banco de dados.
-
Na guia Identification, selecione Using reconciliation criteria e defina uma chave entre Dimension to update - Perfis neste caso - e o link criado na atividade Reconciliation. Neste exemplo, o campo personalizado ID do CRM é usado.
-
Na guia Fields to update, indique os campos da dimensão Perfis a serem atualizados com o valor da coluna correspondente no arquivo. Se os nomes das colunas de arquivo forem idênticos ou quase idênticos aos dos campos de dimensão dos destinatários, você poderá usar o botão de varinha mágica para combinar os diferentes campos automaticamente.
note note NOTE Se você planeja enviar correspondência direta para esses perfis, inclua um endereço postal, pois essas informações são essenciais para o provedor de correspondência direta. Verifique também se a caixa Address specified nas informações dos seus perfis está marcada. Para atualizar esta opção de um fluxo de trabalho, basta adicionar um elemento aos campos a serem atualizados, especificar 1 como Source e selecionar o campo [postalAddress/@addrDefined] como Destination. Para obter mais informações sobre correspondência direta e o uso da opção Address specified, consulte este documento.
-
-
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.
-
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.