Show Menu
TÓPICOS×

Carregar arquivo

Descrição

A Load file atividade permite importar dados em um formulário estruturado para usá-los no Adobe Campaign. Os dados são importados temporariamente e outra atividade é necessária para integrá-los definitivamente ao banco de dados do Adobe Campaign.

Contexto de utilização

A forma como os dados serão extraídos é definida quando a atividade é configurada. O arquivo a ser carregado pode ser uma lista de contatos, por exemplo.
Somente os arquivos de estrutura "simples" são considerados, como arquivos .txt, .csv etc., por exemplo.
É possível:
  • Use a estrutura de arquivos para aplicá-la aos dados de outro arquivo (recuperados usando a Transfer file atividade) ou
  • Use a estrutura e os dados do arquivo para importá-los para o Adobe Campaign.

Configuração

A configuração da atividade envolve duas etapas. Primeiro, é necessário definir a estrutura de arquivos esperada carregando um arquivo de amostra. Quando isso for feito, você poderá especificar a origem do arquivo cujos dados serão importados.
Os dados do arquivo de amostra são usados para configurar a atividade, mas não são importados. Recomendamos usar um arquivo de amostra contendo poucos dados.
  1. Arraste e solte uma Load file atividade em seu fluxo de trabalho.
  2. Selecione a atividade e abra-a usando o botão das ações rápidas que aparecem.
  3. Carregue o arquivo de amostra que permitirá que você defina a estrutura esperada ao importar o arquivo final.
    Depois que o arquivo de dados é carregado, duas novas guias são exibidas na atividade: File structure e Column definition .
  4. Vá até a File structure guia para exibir a estrutura que é detectada automaticamente do arquivo de amostra.
    Se a estrutura do arquivo foi detectada incorretamente, você tem várias opções para corrigir possíveis erros:
    • Você pode optar por usar a estrutura de outro arquivo selecionando a Detect structure from a new file opção.
    • Você pode modificar os parâmetros de detecção padrão para adaptá-los ao seu arquivo. O File type campo permite especificar se o arquivo que você deseja importar é composto de colunas com comprimento fixo. Nesse caso, você também deve especificar o número máximo de caracteres para cada coluna na Column definition guia.
      Todas as opções de detecção necessárias para recuperar corretamente os dados do arquivo são agrupadas em File format . Você pode modificá-las e detectar novamente a estrutura do último arquivo carregado na atividade levando em conta essas novas configurações. Para fazer isso, use o Apply configuration botão. Por exemplo, você pode especificar um separador de coluna diferente.
      Esta operação leva em conta o último arquivo que foi carregado na atividade. Se o arquivo detectado for grande, a visualização de dados mostrará apenas as primeiras 30 linhas.
      Na File format seção, a Check columns from file against column definitions opção permite verificar se as colunas do arquivo que você está carregando correspondem à definição da coluna.
      Se o número e/ou o nome das colunas não corresponderem à definição da coluna, uma mensagem de erro será exibida ao executar o fluxo de trabalho. Se a opção não estiver ativada, os avisos serão exibidos no arquivo de log.
  5. Vá até a Column definition guia para verificar o formato de dados para cada coluna e ajuste os parâmetros, se necessário.
    A Column definition guia permite especificar com precisão a estrutura de dados de cada coluna para importar dados que não contenham erros (por exemplo, usando o gerenciamento nulo) e fazer com que eles correspondam aos tipos que já estão presentes no banco de dados do Adobe Campaign para operações futuras.
    Por exemplo, você pode alterar o rótulo de uma coluna, selecionar seu tipo (string, número inteiro, data etc.)  ou até mesmo especifique o processamento de erros.
    For more information, refer to the Column format section.
  6. Na Execution guia, especifique se o arquivo deve ser processado para carregar dados:
    • Vem de uma transição de entrada no fluxo de trabalho.
    • É aquele que você carregou durante a etapa anterior.
    • É um novo arquivo para carregar a partir do computador local. A Upload a new file from local machine opção será exibida se o upload de um primeiro arquivo já tiver sido definido no fluxo de trabalho. Isso permite que você carregue outro arquivo para ser processado se o arquivo atual não atender às suas necessidades.
  7. Se o arquivo do qual você deseja carregar os dados for compactado em um arquivo GZIP (.gz), selecione a Decompression opção no Add a pre-processing step campo. Isso permite descompactar o arquivo antes de carregar os dados. Essa opção só estará disponível se o arquivo for proveniente da transição de entrada da atividade.
  8. A Keep the rejects in a file opção permite baixar um arquivo que contém erros que ocorreram durante a importação e aplicar a ele uma etapa de pós-processamento. Quando a opção é ativada, a transição de saída é renomeada como "Rejeitos".
    A Add date and time to the file name opção permite que você adicione um carimbo de data e hora ao nome do arquivo que contém os rejeitos.
  9. Confirme a configuração da atividade e salve o fluxo de trabalho.
Se ocorrer algum erro com a atividade após a execução do fluxo de trabalho, consulte os registros para obter mais detalhes sobre os valores incorretos no arquivo. For more on workflows logs, refer to this section

Formato de coluna

Quando você carrega um arquivo de amostra, o formato da coluna é detectado automaticamente com os parâmetros padrão para cada tipo de dados. Você pode modificar esses parâmetros padrão para especificar os processos específicos a serem aplicados aos seus dados, principalmente quando há um erro ou um valor vazio.
Para fazer isso, selecione uma Edit properties das ações rápidas da coluna cujo formato você deseja definir. A janela de detalhes do formato da coluna será aberta.
Em seguida, é possível modificar a formatação de cada coluna.
A formatação de coluna permite definir o processamento de valor de cada coluna:
  • Ignore column : não processa esta coluna durante o carregamento de dados.
  • Data type : especifica o tipo de dados esperado para cada coluna.
  • Format and separators , Propriedades : especifique as propriedades de um texto, a hora, a data e o formato de valor numérico, bem como o separador especificado pelo contexto da coluna.
    • Maximum number of characters : especifica o número máximo de caracteres para colunas de tipo de string.
      Esse campo deve ser preenchido ao carregar arquivos compostos de colunas com comprimento fixo.
    • Letter case management : define se um processo de caso de caractere precisa ser aplicado aos dados de Texto .
    • White space management : especifica se determinados espaços precisam ser ignorados em uma string para dados de Texto .
    • Time format , Date format : especifique o formato dos dados de Data , Hora e Data e Hora .
    • Format : permite que você defina o formato dos valores numéricos para Inteiro e dados de número flutuante.
    • Separator : define o separador especificado pelo contexto da coluna (separador de milhares ou separador decimal para valores numéricos, separador para datas e hora) para dados de Data , Hora , Data e hora , Número inteiro e Número flutuante.
  • Remapping of values : esse campo só está disponível na configuração detalhada da coluna. Isso permite transformar certos valores quando eles são importados. Por exemplo, você pode transformar "três" em "3".
  • Error processing : define o comportamento se um erro for encontrado.
    • Ignore the value : o valor é ignorado. Um aviso é gerado no log de execução do workflow.
    • Reject the line : a linha inteira não é processada.
    • Use a default value : substitui o valor que causa o erro por um valor padrão, definido no Default value campo.
    • Use a default value in case the value is not remapped : substitui o valor que causa o erro por um valor padrão, definido no Default value campo, a menos que um mapeamento tenha sido definido para o valor errado (consulte a Remapping of values opção acima).
    • Reject the line when there is no remapping value : a linha inteira não é processada a menos que um mapeamento tenha sido definido para o valor errado (consulte a Remapping of values opção acima).
    Error processing refere-se a erros referentes a valores no arquivo importado. Por exemplo, um tipo de dados com falha foi encontrado ("quatro" em letras para uma coluna "Número inteiro"), uma string contendo mais caracteres do que o número máximo autorizado, uma data com separadores com falha etc. No entanto, essa opção não diz respeito a erros gerados pelo gerenciamento de valores vazio.
  • Default value : especifica o valor padrão de acordo com o processamento de erros escolhido.
  • Empty value management : especifica como gerenciar valores vazios durante o carregamento de dados.
    • Generate an error for numerical fields : gera um erro apenas para os campos numéricos; caso contrário, insere um valor NULL.
    • Insert NULL in the corresponding field : autoriza valores vazios. O valor NULL é então inserido.
    • Generate an error : gera um erro se um valor estiver vazio.

Exemplo 1: Atualização do banco de dados

A atividade do arquivo de carregamento estrutura principalmente os dados de uma atividade de arquivo de transferência para integrá-los aos dados existentes.
O exemplo a seguir mostra o resultado de uma atividade de arquivo de carregamento automaticamente baixada por meio de uma atividade de arquivo de transferência, seguido por uma atividade de dados de atualização. Esse fluxo de trabalho tem como objetivo aprimorar o banco de dados do Adobe Campaign com novos perfis ou atualizar perfis existentes usando os dados recuperados do arquivo importado.
  1. Arraste e solte uma Transfer file atividade em seu fluxo de trabalho e configure-a de uma forma que recupere o arquivo que você deseja.
  2. Arraste e solte uma Load file atividade em seu fluxo de trabalho e coloque-a após a Transfer file atividade.
  3. Selecione a atividade e abra-a usando o botão das ações rápidas que aparecem.
  4. Na File to load seção da Execution guia, marque a Use the file specified in the inbound transition opção.
  5. Configure sua atividade conforme especificado anteriormente.
  6. Arraste e solte uma Update data atividade em seu fluxo de trabalho e coloque-a após a Load file atividade e configure-a. Consulte Atualizar dados .
Depois que o fluxo de trabalho é iniciado, os dados do arquivo carregado são extraídos e, em seguida, usados para enriquecer o banco de dados do Adobe Campaign.

Exemplo 2: Envio de um email com campos aprimorados

A atividade de carregamento de arquivo também permite enviar um email enriquecido com dados adicionais de um arquivo externo no mesmo fluxo de trabalho.
O exemplo abaixo mostra como enviar um email usando dados adicionais recuperados de um arquivo externo por meio da atividade de carregamento do arquivo. Neste exemplo, o arquivo externo contém uma lista de perfis com seu número de conta associado. Você deseja importar esses dados para enviar um email para cada perfil com o número da conta.
  1. Arraste e solte uma Query atividade em seu fluxo de trabalho e abra-a para definir o destino principal.
  2. Arraste e solte uma Load file atividade para atribuir alguns dados a um perfil. Neste exemplo, carregue um arquivo contendo números de conta correspondentes a alguns perfis do banco de dados.
  3. Arraste e solte uma Enrichment atividade em seu fluxo de trabalho e vincule o arquivo de carregamento e as atividades de consulta a ela.
  4. Na Advanced relations guia da atividade de enriquecimento, selecione 0 or 1 cardinality simple link e defina os campos a serem usados para reconciliação. Aqui, usamos o sobrenome para reconciliar os dados com os perfis do banco de dados.
  5. Na Additional data guia, selecione os elementos que deseja usar no seu email. Aqui, selecione Número da conta (coluna do arquivo que você recuperou por meio da atividade do arquivo de carregamento).
    Para obter mais informações, consulte a seção Enriquecimento .
  6. Arraste e solte uma Segmentation atividade em seu fluxo de trabalho e abra-a para refinar a meta principal.
    Para obter mais informações, consulte a seção Segmentação .
  7. Arraste e solte uma Email delivery atividade em seu fluxo de trabalho e abra-a.
  8. Adicione um campo de personalização e selecione os dados adicionais definidos na atividade de enriquecimento (aqui Número de conta) do Additional data (targetData) nó. Isso permite recuperar dinamicamente o número de conta de cada perfil no conteúdo de email.
  9. Salve o email e inicie o fluxo de trabalho.
O email é enviado para o destino. Cada perfil recebe o email com o número de conta correspondente.