Carregamento de dados (arquivo) data-loading-file

Uso use

A atividade Data loading (File) permite acessar uma fonte de dados externos diretamente e usá-la no Adobe Campaign. De fato, todos os dados necessários para operações de target nem sempre são encontrados no banco de dados do Adobe Campaign: ele pode ser disponibilizado em arquivos externos.

O arquivo a ser carregado pode ser especificado pela transição ou calculado durante a execução dessa atividade. Por exemplo, pode ser a lista de 10 produtos favoritos de um cliente cujas compras são gerenciadas em um banco de dados externo.

A seção superior da janela de configuração dessa atividade permite definir o formato de arquivo. Para fazer isso, use um arquivo de exemplo com o mesmo formato do arquivo a ser importado. Este arquivo pode ser armazenado no local ou no servidor.

CAUTION
Somente os arquivos de estrutura simples são suportados (por exemplo, CSV, TXT e etc.). Não é recomendável usar o formato XML.

Você pode definir um pré-processamento a ser executado durante a importação do arquivo, por exemplo, para não precisar descompactar o arquivo no servidor (e, portanto, economizar espaço para o arquivo descompactado), e incluir a descompactação no processamento de arquivo. Selecione a opção Pre-process the file e escolha uma das três opções: None, Decompression (zcat) ou Decrypt (gpg).

IMPORTANT
Não é possível descompactar arquivos com mais de 4 GB.

Definição do formato de arquivo defining-the-file-format

Quando você carrega um arquivo, o formato da coluna é automaticamente detectado 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 Click here to change the file format… na janela principal da atividade Data loading (file). A janela de detalhes do formato será aberta.

Em seguida, você pode modificar a formatação geral do arquivo, bem como a formatação de cada coluna.

A formatação geral do arquivo permite definir a maneira como as colunas serão reconhecidas (codificação do arquivo, separadores usados, etc.).

A formatação de coluna permite definir o processamento de valor de cada coluna:

NOTE
É possível adicionar quantas colunas quiser. O comprimento máximo dos valores em cada coluna é determinado pelo tipo de dados escolhido.
  • Ignore column: não processa essa coluna durante o carregamento de dados.

  • Data type: especifica o tipo de dados esperado para cada coluna.

  • Allow NULLs: especifica como gerenciar valores vazios.

    • Adobe Campaign default: gera um erro apenas para os campos numéricos, caso contrário, insere um valor NULL.
    • Empty value allowed: autoriza valores vazios. O valor NULL é então inserido.
    • Always populated: gera um erro se um valor estiver vazio.
  • Length: especifica o número máximo de caracteres para o tipo de dados da string.

  • Format: define o formato de data e hora.

  • Data transformation: define se um processo de ocorrência de caractere precisa ser aplicado em uma string.

    • None: a string importada não é modificada.
    • First letter in upper case: a primeira letra de cada palavra da string começa com maiúscula.
    • Upper case: todos os caracteres na string estão em maiúsculas.
    • Lower case: todos os caracteres na string estão em minúsculas.
  • White space management: especifica se determinados espaços precisam ser ignorados em uma string. O valor Ignore spaces permite somente espaços no início e no final de uma string a ser ignorada.

  • Error processings: define o comportamento se um erro for encontrado.

    • Ignore the value: o valor é ignorado. Um aviso é gerado no log de execução do fluxo de trabalho.
    • Reject line: a linha inteira não é processada.
    • Use a default value in case of error: substitui o valor que causa o erro por um valor padrão, definido no campo Default value.
    • Reject the line when there is no remapping value: a linha inteira só será processada se um tiver sido definido para o valor errado (consulte a opção Mapping Mapping abaixo).
    • 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 campo Default value, a menos que um tenha sido definido para o valor incorreto (consulte a opção Mapping Mapping abaixo).
  • Default value: especifica o valor padrão de acordo com o processamento de erros escolhido.

  • Mapping: esse campo está disponível apenas na configuração de detalhe da coluna (acessada por um clique duplo ou através das opções à direita da lista de colunas). Isso transforma determinados valores ao serem importados. Por exemplo, você pode transformar "três" em "3".

Exemplo: coleta de dados e seu carregamento no banco de dados example--collecting-data-and-loading-it-in-the-database

O exemplo a seguir permite coletar um arquivo no servidor todos os dias, carregar seu conteúdo e atualizar os dados no banco de dados, dependendo das informações que ele contém. O arquivo a ser coletado contém informações sobre clientes que podem ter comprado (cerca de 3.000 euros), pediram reembolso em uma compra ou visitaram a loja sem adquirir nada. Dependendo dessas informações, vários processos serão aplicados ao seu perfil no banco de dados.

  1. O coletor de arquivos permite recuperar arquivos armazenados em um diretório, dependendo da frequência fornecida.

    A guia Directory contém informações sobre os arquivos a serem recuperados. Em nosso exemplo, todos os arquivos no formato de texto cujos nomes contêm a palavra 'clientes' e que são armazenados no diretório tmp/Adobe/Data/files do servidor serão recuperados.

    O uso de File collector é detalhado na seção File collector.

    A guia Schedule permite agendar a execução do coletor, ou seja, especificar a frequência com que a presença desses arquivos será verificada.

    Aqui, queremos acionar o coletor todo dia útil às 9:00 PM.

    Para fazer isso, clique no botão Change… localizado na seção inferior direita da ferramenta de edição e configure a programação.

    Para obter mais informações, consulte Scheduler.

  2. Em seguida, configure a atividade de carregamento de dados (arquivo) para indicar como os arquivos coletados devem ser lidos. Para fazer isso, selecione um arquivo de exemplo com a mesma estrutura dos arquivos a serem carregados.

    Aqui, o arquivo contém cinco colunas:

    • a primeira coluna contém um código que coincide com o evento: compra (cerca de 3.000 euros), nenhuma compra ou reembolso em uma ou mais compras.
    • as quatro colunas seguintes contêm o nome, sobrenome, email e número da conta do cliente.

    A configuração de formato do arquivo a ser carregado coincide com aquela definida durante uma importação de dados no Adobe Campaign.

  3. Na atividade de Split, especifique os subconjuntos a serem criados, de acordo com o valor da coluna Evento.

    A atividade de Split é detalhada na seção.

    Para cada subconjunto, especifique um dos valores na coluna Evento.

    A atividade Split conterá as seguintes informações:

  4. Então especifique os processos a serem executados para cada tipo de público. No nosso exemplo, vamos Update the data no banco de dados. Para fazer isso, posicione uma atividade Update data no final de cada transição de saída da atividade Split.

    A atividade Update data está detalhada na seção Update data.

recommendation-more-help
cffff7e4-091f-472e-87ca-52087599f99d