Ir para o conteúdo

Atividade de Gravação FTP

Introdução

Uma atividade FTP Write grava dados em um endpoint FTP e deve ser usada como um destino para consumir dados em uma operação ou para ser chamada em um script. Depois de configurar uma conexão FTP, você pode configurar quantas atividades FTP desejar para cada conexão FTP.

Crie uma Atividade FTP

Uma instância de uma atividade é criada a partir de uma conexão usando um tipo de atividade.

Para criar uma instância de uma atividade, arraste o tipo de atividade para a quadro de design ou copie o tipo de atividade e cole-o na quadro de design. Para obter detalhes, consulte Criando uma instância de atividade em Reutilização de componentes.

Uma atividade existente pode ser editada nestes locais:

Configurar uma Atividade de Gravação de FTP

Siga estas etapas para configurar uma atividade FTP Write:

Etapa 1: Insira um Nome, Forneça um Esquema de Solicitação e Especifique as Configurações

atividade de gravação FTP 1

Dica

Campos com ícone de variável ícone de variável suporte usando variáveis globais, variáveis do projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone da variável para exibir uma lista das variáveis existentes para escolher.

  • Nome: Insira um nome a ser usado para identificar a atividade FTP Write. O nome deve ser exclusivo para cada atividade FTP Write e não deve conter barras (/) ou dois pontos (:).

  • Fornecer esquema de solicitação: O esquema de solicitação define a estrutura de dados usada pela atividade FTP Write. A necessidade de um esquema de solicitação depende se a atividade é usada como destino de uma transformação (consulte Uso do esquema). Para obter instruções sobre como concluir esta seção de configuração de atividade, consulte Esquemas definidos em uma atividade.

  • Caminho: Insira um ou mais caminhos válidos. Um caminho deve apontar para um diretório existente no servidor FTP. Por exemplo, um único caminho pode ser /outbound. Vários caminhos podem ser especificados usando valores separados por vírgula. Se vários caminhos forem especificados, o mesmo arquivo será gravado em vários locais. Um exemplo de múltiplos caminhos pode ser user1\path, user2\path.

  • Nome(s) de arquivo(s): Insira o nome do(s) arquivo(s) nos quais você deseja gravar dentro do(s) caminho(s) informado(s) acima. Qualquer uma das palavras-chave do nome do arquivo estão disponíveis para gerar nomes de arquivos exclusivos (por exemplo, result[date][tempo].[ext]). Se especificar dados no formato ZIP, consulte as opções de Compactação descritas abaixo.

  • Usar renomeação de FTP: Selecionada por padrão, esta opção é para que os arquivos usem inicialmente um nome de arquivo temporário que é então renomeado para o nome final. Desmarque a caixa de seleção se esta opção causar problemas.

  • Configurações opcionais: Clique para expandir configurações opcionais adicionais:

    configurações opcionais da atividade de gravação de FTP 1

    • Criar diretórios automaticamente: Mantenha esta caixa de seleção marcada para criar automaticamente quaisquer diretórios que ainda não existam no caminho de destino.

      Aviso

      É um problema conhecido que a criação automática de diretórios funciona de forma inconsistente. Dependendo do servidor FTP específico envolvido, o diretório pode não ser criado. Se esta opção for usada, você deverá confirmar se o diretório foi criado antes do uso em produção.

    • Não criar arquivos vazios: Marque esta caixa de seleção para ignorar a criação do arquivo de destino se não houver dados de destino.

    • Anexar ao arquivo: Marque esta caixa de seleção para anexar ao arquivo de destino existente em vez de sobrescrever. Observe que as conexões SFTP não suportam a capacidade de anexar arquivos, o que é uma limitação do SFTP.

    • Escrever cabeçalhos: Marque esta caixa de seleção se estiver usando um destino de texto simples e quiser escrever cabeçalhos (nomes de colunas/campos) na primeira linha.

    • Tipo de fim de linha: Especifique como escrever quebras de linha ao gravar em um destino. Observe que os caracteres de fim de linha nos próprios dados não são convertidos. As opções são as seguintes:

      • Padrão: Caracteres de fim de linha padrão para a plataforma em que o agente está sendo executado.

      • Windows: CRLF (ASCII 13 e ASCII 10).

      • Unix: LF (ASCII 10).

    • Codificação de caracteres: Especifique a codificação de caracteres para definir uma codificação de caracteres específica para o arquivo de destino. Se você deixar o campo em branco, o Harmony tentará detectar a codificação. Se quiser substituir o padrão, você pode escolher qualquer um dos tipos de codificação listados em Codificações de caracteres suportadas.

    • Pasta de sucesso/erro: Disponível apenas para uso com Agentes Privados onde arquivos locais estão habilitados, essas opções são usadas para arquivar uma cópia de todos os arquivos processados. Isso pode ser usado no lugar da opção Após Processamento para Renomear Arquivo na origem do arquivo para permitir que você grave em um local separado em vez de em uma subpasta no mesmo local.

      • Usar pasta de sucesso: Marque esta caixa de seleção para gravar um arquivo na pasta especificada após o processamento bem-sucedido no caminho de destino principal. Se gravar um arquivo em vários caminhos, a operação será bem-sucedida somente se todos os caminhos forem bem-sucedidos. Se esta caixa de seleção estiver marcada, forneça também a Pasta de sucesso no caminho absoluto na máquina do Agente Privado.

      • Usar pasta de erros: Marque esta caixa de seleção para gravar um arquivo na pasta especificada após um processamento malsucedido. Se pelo menos um caminho não tiver êxito, o arquivo será gravado nesta pasta. Se esta caixa de seleção estiver marcada, forneça também a Pasta de erros no caminho absoluto na máquina do Agente Privado.

        Cuidado

        Um arquivo será gravado somente se a falha for devido a erros no processamento da atividade FTP Write, como permissões de gravação insuficientes para a atividade. Um arquivo não é gravado se, por exemplo, a conexão FTP não for bem-sucedida, causando falha em toda a operação.

      Importante

      Os caminhos absolutos para as pastas de sucesso e erro estão localizados no Agente Privado, não no servidor FTP.

      Ao usar palavras-chave de nome de arquivo nesses campos, as palavras-chave não são resolvidas. Para obter uma solução alternativa, consulte Limitação e solução alternativa em Palavras-chave do nome do arquivo. Usando asteriscos (*) e outros caracteres de nome de arquivo normalmente não suportados causarão falha na operação.

      Os arquivos são nomeados conforme especificado no campo Nome(s) de arquivo acima, com um sublinhado final e um carimbo de data/hora adicionado. Se já existir um arquivo com o mesmo nome nessa pasta, um sublinhado adicional e um contador serão adicionados.

      Por exemplo, se um arquivo chamado data.csv for processado com sucesso, uma cópia chamada data.csv_2018-01-01_12-00-00-000 pode ser gravado na pasta especificada como pasta de sucesso. Se tal arquivo já existir de uma execução anterior, um novo arquivo data.csv_2018-01-01_12-00-00-000_1 seria adicionado. De maneira semelhante, se uma pasta de erro for especificada, todos os arquivos que falharem serão gravados em um arquivo na pasta de erro.

    • Compactação: Marque a caixa de seleção Compactar arquivos de destino se desejar que os dados de destino sejam compactados. Estas opções ficam disponíveis:

      • Formato: Use o menu suspenso para selecionar o formato de compactação desejado. Atualmente, apenas o formato ZIP é compatível.

      • Nomes de arquivos no(s) arquivo(s): Insira o nome do(s) arquivo(s) de destino a serem compactados no arquivo. Qualquer uma das palavras-chave do nome do arquivo estão disponíveis para gerar nomes de arquivos exclusivos. Os arquivos são gravados automaticamente no arquivo no nível raiz.

        Dica

        Para manter os nomes de arquivo no arquivo iguais aos nomes de arquivo definidos no destino, insira [file].[ext].

      • Modo: Por padrão, o modo Overwrite substitui o arquivo existente. Este é o único modo disponível.

      • Senha: Para criptografar o arquivo, digite a senha desejada.

      • Modo de criptografia: Se uma senha for fornecida, use o menu suspenso para selecionar entre os dois modos de criptografia disponíveis: AES e ZIP padrão.

    • Tipo de transferência: Se os arquivos forem baseados em ASCII, escolha o botão de opção ASCII tipo de transferência. Para todos os outros tipos de arquivo, escolha o tipo de transferência Binário. Binário é o padrão e geralmente funciona melhor.

  • Salvar e Sair: Se ativado, clique para salvar a configuração desta etapa e feche a configuração da atividade.

  • Próximo: Clique para armazenar temporariamente a configuração desta etapa e prosseguir para a próxima etapa. A configuração não será salva até que você clique no botão Concluído na última etapa.

  • Descartar alterações: Após fazer as alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Etapa 2: Revise os Esquemas de Dados

atividade de gravação FTP 2

  • Esquema de dados: Se fornecido durante a configuração da atividade, o esquema de dados da solicitação será exibido. Se a operação usar uma transformação, os esquemas de dados serão exibidos novamente posteriormente durante o mapeamento da transformação, onde você pode mapear campos de destino usando objetos de origem, scripts, variáveis, valores personalizados e muito mais. Você também pode definir esquemas diretamente em uma transformação.

  • Adicionar plug-in(s): Plugins são aplicativos fornecidos pelo Jitterbit ou pelo usuário que ampliam os recursos nativos do Harmony. Para aplicar um plugin à atividade, clique para expandir esta seção e marque a caixa de seleção ao lado do plugin a ser usado. Para obter instruções adicionais sobre o uso de plug-ins, incluindo detalhes sobre como definir quaisquer variáveis necessárias usadas pelo plug-in, consulte Plugins adicionados a uma atividade.

  • Voltar: Clique para armazenar temporariamente a configuração desta etapa e retornar à etapa anterior.

  • Concluído: Clique para salvar a configuração de todas as etapas e fechar a configuração da atividade.

  • Descartar alterações: Após fazer as alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Próximos Passos

Depois de configurar uma atividade FTP Write, você poderá usá-la em uma operação ou script conforme descrito abaixo.

Conclua a Operação

Depois de configurar uma atividade FTP Write, conclua a configuração da operação adicionando e configurando outras atividades, transformações ou scripts como etapas da operação. Você também pode definir as configurações de operação de uma operação, que incluem a capacidade de encadear operações que estejam no mesmo fluxo de trabalho ou em workflows diferentes.

Depois que uma atividade FTP Write for criada, as ações de menu para essa atividade estarão acessíveis no painel do projeto nas guias Workflows ou Componentes e na quadro de design. Consulte Menu Ações de Atividade para detalhes.

As atividades FTP Write podem ser usadas como destino com estes padrões de operação:

Outros padrões não são válidos usando atividades FTP Write. Veja os padrões de validação na página Validade da Operação página.

Um caso de uso típico é usar uma atividade FTP Write no Transformação Pattern. Neste exemplo, a atividade de consulta de banco de dados (Query Request) fornece dados para a operação que são então recebidos pela transformação (Database to FTP). A atividade FTP Write (Write Response) é usada como alvo, recebendo dados dentro da operação:

operação de atividade de gravação FTP 1

Quando estiver pronto, implantar e execute a operação e valide o comportamento verificando os logs de operação.

Usando Atividades FTP em Scripts

As atividades FTP Write também podem ser referenciadas em um script para uso com funções de script que usam um targetId como parâmetro, incluindo estes:

Funções de Jitterbit Script

  • ArchiveFile
  • FlushAllFiles
  • FlushFile
  • WriteFile

Funções JavaScript Jitterbit

  • Jitterbit.WriteFile

Para obter mais detalhes sobre como referenciar atividades em scripts, consulte Endpoints em Jitterbit Script ou Endpoints em JavaScript.