Transferir arquivo
- Aplica-se a:
- Campaign v8 Web User Interface
A atividade Transferir arquivo é uma atividade de Gerenciamento de Dados. Ele permite receber ou enviar arquivos, testar a presença de arquivos ou listar arquivos em um servidor. O protocolo usado pode ser o protocolo servidor para servidor ou o protocolo HTTP.
NOTESiga as etapas detalhadas abaixo para configurar a atividade Transferir arquivo.
Escolher o protocolo e a operação de transferência
-
Adicione uma atividade Transferir arquivo ao fluxo de trabalho e especifique o tipo de transferência a ser executado, dependendo do protocolo que deseja usar:
- Para protocolo HTTP, selecione Download da Web. Isso permite executar uma operação GET ou POST para baixar um arquivo em uma URL explícita, uma conta externa ou uma instância do Adobe Campaign.
- Para outros protocolos servidor a servidor e ações relacionadas, selecione Transferência de arquivos.
-
Selecione a ação a ser executada com a atividade. As ações disponíveis dependem do tipo de transferência selecionado. Expanda as seções abaixo para obter mais informações.
Ações disponíveis com atividades do tipo transferência de arquivos- Download de arquivo: baixar um arquivo do servidor.
- Carregamento de arquivo: carregar um arquivo no servidor.
- Teste para ver se o arquivo existe: verifique se um determinado arquivo está presente no servidor. Gera duas transições de saída após a atividade: "File exists" e "File does not exist".
- Lista de arquivos: lista todos os arquivos disponíveis no servidor.
Ações disponíveis com atividades do tipo download da Web- Transferência simples (GET): recuperar um arquivo.
- Transferir usando um formulário (POST): carregar um arquivo e parâmetros adicionais.
-
Por padrão, para ações de upload de arquivo, a atividade usa o arquivo especificado na atividade anterior. Para usar um arquivo diferente, desative a opção Usar arquivo da atividade anterior e clique no botão Adicionar arquivo.
No campo Source, insira o nome de arquivo desejado ou use o editor de expressão para calcular o nome de arquivo usando variáveis de evento. Saiba como trabalhar com variáveis de evento e o editor de expressão. Repita a operação para adicionar quantos arquivos forem necessários.
Definir o destino da transferência
-
Na seção Servidor remoto, especifique o servidor a ser conectado usando um destes métodos:
- Usar parâmetros de conexão definidos em uma conta externa: conecte-se a um servidor usando os parâmetros de conexão de uma conta externa. No campo Pasta do servidor, especifique o caminho para o arquivo (ou para a pasta para ações de listagem de arquivos).
- Configuração rápida: insira a URL do arquivo (ou pasta para ações de listagem de arquivos).
- Instância do Adobe Campaign (atividades do tipo download da Web): baixe um arquivo de um servidor de instâncias do Adobe Campaign.
-
Para ações POST de download da Web, você pode passar parâmetros adicionais com a operação. Para fazer isso, clique no botão Adicionar parâmetro e especifique o nome e o valor dos parâmetros. Você pode adicionar quantos parâmetros forem necessários.
-
Por padrão, para o upload de arquivos, os arquivos carregados em um servidor são salvos automaticamente. Se você não quiser manter este histórico, desative a opção Manter histórico de arquivos enviados.
Configurações de histórico
Executar uma atividade Transferir arquivo armazena os arquivos enviados ou baixados em uma pasta dedicada. Uma pasta é criada para cada atividade Transferir arquivo de um fluxo de trabalho. Por padrão, os arquivos são salvos no diretório de armazenamento padrão da pasta de instalação do Adobe Campaign (/vars) antes de serem processados. Para usar uma pasta específica, desative a opção Usar um diretório de armazenamento padrão e insira o caminho do diretório.
É importante limitar o tamanho dessa pasta para preservar o espaço físico no servidor. Para fazer isso, defina um número máximo de arquivos ou o tamanho total da pasta da atividade. Por padrão, 100 arquivos e 50 MB são autorizados.
Toda vez que a atividade é executada, a pasta é verificada da seguinte maneira:
- Somente os arquivos criados mais de 24 horas antes da execução da atividade são considerados.
- Se o número de arquivos considerados exceder o valor do campo Número de arquivos, os arquivos mais antigos serão excluídos até que o número máximo de arquivos permitidos seja atingido.
- Se o tamanho total dos arquivos considerados exceder o valor do parâmetro Tamanho máximo (em MB), os arquivos mais antigos serão excluídos até que o tamanho máximo permitido seja atingido.
CAUTIONOpções avançadas e de gerenciamento de erros
-
Nas Opções avançadas, opções adicionais estão disponíveis com base no tipo de atividade que você está configurando. Expanda as seções abaixo para obter mais informações.
Opções adicionais para atividades do tipo transferência de arquivos- Excluir os arquivos de origem após a transferência: apagar os arquivos de origem após uma transferência bem-sucedida.
- Exibir os logs de sessão: quando esta opção é ativada, as informações relacionadas à operação de transferência são exibidas nos logs de fluxo de trabalho após a execução do fluxo de trabalho.
- Listar todos os arquivos (Ações de listagem de arquivos): esta opção indexa todos os arquivos presentes no servidor na variável de evento
vars.filenames, na qual os nomes dos arquivos são separados pelos caracteresn. Saiba como trabalhar com variáveis de evento
Opções adicionais para atividades do tipo download da Web- Seguir redirecionamentos: o redirecionamento de arquivo permite usar substituições para direcionar a entrada ou saída de dados para um dispositivo de tipo diferente.
- Adicionar os cabeçalhos HTTP ao arquivo: em alguns casos, talvez você queira adicionar outros cabeçalhos HTTP a um arquivo. Normalmente, esses cabeçalhos serão usados para fornecer informações adicionais para fins de solução de problemas, para Compartilhamento de recursos entre origens (CORS) ou para definir diretivas específicas de armazenamento em cache.
- Ignorar o código de retorno HTTP: códigos de retorno HTTP, também conhecidos como códigos de status HTTP, indicam o resultado de uma solicitação HTTP.
-
A opção Process errors permite ativar uma transição de saída "Error" após a atividade se ocorrer algum erro durante a transferência.
Além disso, para atividades do tipo Transferência de arquivos, a opção Arquivo ausente permite ativar uma transição de saída "Nenhum arquivo" após a atividade, se o arquivo não estiver disponível no caminho especificado.