Show Menu
TÓPICOS×

Carregar arquivo

Descrição

Lembre-se dos limites de armazenamento SFTP, Armazenamento DB e perfil ativo conforme o contrato do AdobeCampaign, ao usar essa funcionalidade.
A Load file atividade permite importar dados em um formulário estruturado para usá-los no Adobe Campaign. Os dados são temporariamente importados 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 for configurada. O arquivo a ser carregado pode ser uma lista de contatos, por exemplo.
Somente arquivos de estrutura "simples" são considerados, como arquivos .txt, .csv etc., por exemplo.
É possível:
  • Use a estrutura do arquivo para aplicá-lo aos dados de outro arquivo (recuperados usando a Transfer file atividade) ou
  • Use a estrutura e os dados do arquivo para importá-lo para o Adobe Campaign.
Tópicos relacionados:

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 no 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 visualização da 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 pré-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 do atividade.
    O Add a pre-processing step campo também permite descriptografar um arquivo antes de importá-lo para o banco de dados. Para obter mais informações sobre como trabalhar com arquivos criptografados, consulte esta seção
  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 "Rejeita".
    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 que estão 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 essa 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 campo Default value .
    • 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.