Crie uma Fonte de Site FTP¶

Introdução¶

Uma fonte de site FTP pode ler de um servidor FTP com opções como pastas de sucesso/erro e um arquivo de acionamento.

Pré-requisito¶

Antes de poder usar as pastas de sucesso/erro e o recurso de arquivo acionador de uma fonte de site FTP (consulte a seção Opções abaixo), você deve ter habilitado o Local File Location em seu Jitterbit Agente Privado. Consulte Ativar localização de arquivo local para detalhes.

Crie uma Fonte de Site FTP¶

Você pode optar por criar uma nova fonte de site FTP por conta própria ou dentro de uma operação existente. Para obter mais informações sobre como as fontes funcionam nas operações, consulte Criando uma operação.

Crie uma Nova Fonte de Site FTP Como Fonte Independente¶

Dentro do seu projeto no Jitterbit Design Studio, você cria uma nova fonte de site FTP por qualquer um dos seguintes:

• Vá para Arquivo > Novo > Nova Fonte; ou

• Na árvore à esquerda, clique com o botão direito em Fontes e selecione Nova Fonte; ou

• Na barra de ferramentas superior, clique no ícone verde da fonte .

No pop-up, selecione Site FTP como tipo:

Sua nova fonte aparece em sua própria aba Nova Fonte no painel direito da janela.

Criar Nova Fonte de Site FTP em uma Operação Existente¶

Uma origem geralmente é criada por padrão quando você cria uma nova operação. (A exceção é uma operação que consiste apenas em um script.) Com uma operação existente, você pode especificar o tipo de sua origem:

• Clicar duas vezes no ícone da fonte; no pop-up, selecione Criar nova fonte; ou

• Clicar com o botão direito no ícone da fonte e selecionar Criar Nova Fonte.

Na tela de configuração exibida, use o menu suspenso Tipo para selecionar Site FTP, conforme mostrado acima.

Usar Fonte de Site FTP Existente em uma Operação Existente¶

Para usar uma origem de site FTP existente em uma operação existente com uma origem, você pode defini-la por qualquer um dos seguintes:

• Dentro da operação, clicar duas vezes no ícone da fonte, e no popup resultante, selecionar a fonte do Site FTP desejado na lista; ou

• Dentro da operação, clicar com o botão direito do mouse no ícone da fonte, escolher Selecionar Fonte Existente, e no popup resultante, selecionar a fonte do Site FTP desejada na lista; ou

• Arrastar a fonte do Site FTP desejado da árvore à esquerda e soltá-la no ícone da fonte existente da operação.

Configurar uma Fonte de Site FTP¶

Depois de criar uma fonte de site FTP, a tela de configuração será aberta na visualização principal do Design Studio. Você pode retornar à tela de configuração a qualquer momento clicando duas vezes no ícone da fonte na operação ou clicando duas vezes na fonte na árvore à esquerda.

Configuração Básica¶

A tela de configuração será semelhante a este exemplo:

• Nome: Insira um nome exclusivo e apropriado para a fonte.
• Tipo: Use o menu suspenso para selecionar Site FTP, se ainda não estiver especificado.

• Parâmetros de conexão: Especifique os detalhes da sua conexão FTP:

  • Host: Insira um local de servidor FTP válido para sua origem, como ftp.example.com. (Obrigatório.)
  • Usar porta padrão: As portas padrão são 21 para FTP/FTPS e 22 para SFTP/SCP. Para portas diferentes, desmarque a caixa de seleção Usar porta padrão e insira uma porta para usar no campo Porta.
  • Caminho: Insira um único caminho válido. Um caminho deve apontar para um diretório existente no servidor FTP, como /inbound/.
  • Login e Senha: Digite um nome de usuário (obrigatório) e uma senha (se aplicável) que permitirão o acesso ao servidor FTP. Deixe a senha em branco se nenhuma senha for necessária.

  • Obter arquivos: Insira o nome do(s) arquivo(s) de origem que você deseja ler no diretório especificado em Caminho. Este campo também pode incluir um asterisco * para usar como curinga (por exemplo, *.txt ou *.*) ou um ponto de interrogação ? para corresponder exatamente a um caractere (por exemplo, file?.txt). Variáveis também podem ser usadas neste campo. Se especificar um arquivo compactado (ZIP), consulte a seção "Compressão" dos parâmetros de conexão adicionais em Opções abaixo. O arquivo compactado pode ser descompactado e lido automaticamente. (Obrigatório.)

    Dica

    Se você estiver faltando arquivos conhecidos ou se os nomes dos arquivos tiverem informações extras anexadas a eles após recuperá-los do endpoint, defina jitterbit.source.ftp.enable_regex_parser para true acima na cadeia de leitura de arquivos do endpoint.

  • Opções de Filtro: Permite especificar se as maiúsculas e minúsculas do nome do arquivo devem ser ignoradas ou se as informações de Obter Arquivos devem ser tratadas como uma expressão regular

• Testar conexão: Clique no testará a fonte do site FTP; ele falhará se uma conexão com o hospedar não puder ser feita ou se o caminho não for válido para localizar arquivos. Uma lista de arquivos que correspondem ao padrão especificado em Get Files será retornada.

• Clique no botão Salvar na barra de ferramentas principal ou na barra de ferramentas do destino para salvar a configuração.

Opções¶

Parâmetros de conexão adicionais podem ser especificados clicando em Opções na parte inferior da seção Parâmetros de conexão:

• Listar apenas nomes de arquivos: Marque esta caixa para listar apenas nomes de arquivos (ele usa o comando FTP NLST em vez de LIST). Tente fazer isso se o Jitterbit não conseguir analisar a listagem de diretórios FTP enviada de volta pelo servidor FTP.

  Dica

  Se você estiver faltando arquivos conhecidos ou se os nomes dos arquivos tiverem informações extras anexadas a eles após recuperá-los do endpoint, defina jitterbit.source.ftp.enable_regex_parser para true acima na cadeia de leitura de arquivos do endpoint.

• Modo Passivo: Deixe esta caixa marcada para usar o método "PASV" do servidor FTP para recuperar arquivos. Quando esta opção estiver habilitada, o agente abrirá uma conexão de controle com o servidor FTP, informará ao servidor FTP para esperar uma segunda conexão e, em seguida, abrirá a conexão de dados com o próprio servidor FTP em uma porta de número alto escolhida aleatoriamente. Isso funciona com a maioria dos firewalls, a menos que o firewall restrinja conexões de saída em portas com números altos.

• Codificação de caracteres: Usado para especificar uma codificação de caracteres para o(s) arquivo(s) de origem. Se deixado em branco, o Jitterbit tentará detectar a codificação. Para especificar uma codificação diferente daquela padrão, insira uma das codificações suportadas descritas em Codificação de caracteres.
• Tempo limite de transferência: Especifique o número de segundos após os quais uma transferência FTP atingirá o tempo limite. Por padrão, esse número é 14.400 segundos ou 4 horas.

• Pasta de sucesso/erro: Especifica se as pastas de sucesso e/ou erro serão usadas para arquivar uma cópia de todos os arquivos processados.

  • Se uma pasta de sucesso for especificada, após o processamento bem-sucedido da fonte, uma cópia do arquivo será gravada em um arquivo nessa pasta.
  • O arquivo terá o mesmo nome especificado no campo Obter arquivos acima, mas 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.
  • 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 na máquina do Agente Privado. 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 Erros na máquina do Agente Privado.

  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.

• Arquivo Trigger: Especifica se um arquivo trigger iniciará o processamento do(s) arquivo(s) de origem. O arquivo acionador é excluído quando o processamento é iniciado.

  • Depois de marcar a caixa de seleção Use Trigger, especifique um Caminho de arquivo absoluto para um arquivo cuja presença acionará o processamento.
  • Variáveis (embora não curingas) podem ser usadas neste campo.
  • Como o arquivo acionador é excluído quando o processamento é iniciado, o arquivo acionador não pode ser o mesmo arquivo que um arquivo de origem que está sendo processado.
  • A operação fará uma sondagem, procurando o arquivo acionador. O intervalo de tempo de votação é fixado em um segundo.
  • O arquivo acionador é excluído quando o processamento é iniciado.
  • Se o arquivo do gatilho não for encontrado, a operação continuará tentando encontrar o arquivo do gatilho até que a operação expire.
  • Definir um arquivo acionador bloqueia qualquer operação ou script que use a origem até que a condição do arquivo acionador seja satisfeita ou a operação expire.

• Após Processamento:

  • Se a caixa de seleção Excluir arquivo estiver marcada, os arquivos de origem serão excluídos após serem processados.
  • Se um valor for especificado no campo Renomear arquivo, o arquivo será renomeado usando o padrão fornecido. Variáveis podem ser usadas neste campo.
  • Somente uma opção de exclusão ou renomeação é aceita; se a caixa de seleção Excluir arquivo estiver marcada, Renomear arquivo será desativado e ignorado. Se Renomear arquivo estiver vazio, ele será ignorado. Se deixado como padrão, nenhum pós-processamento dos arquivos de origem ocorrerá.

• Ignorar Linhas: Os números indicados da primeira e da última linha que devem ser ignorados para cada arquivo. Se houver cabeçalhos ou rodapés a serem ignorados, insira o número de linhas nos campos Primeiro e Último conforme apropriado.

• Compressão: Se a caixa de seleção Os dados de origem estão comprimidos estiver marcada, os arquivos de origem serão descompactados usando o formato ZIP. Uma Senha (para arquivos criptografados) pode ser especificada. Somente a leitura do diretório raiz do arquivo é suportada.

• Configurações de proxy: Use o menu suspenso para selecionar uma destas opções para um proxy personalizado para o hospedar FTP:

  • Desativar: As configurações de proxy estão desativadas para esta fonte específica, ignorando a Configuração de proxy do Agente se existir.
  • Padrão: As configurações de proxy são habilitadas usando a Configuração de proxy do Agente se existir. Se as configurações de proxy não forem especificadas na configuração do Agente, a configuração Padrão terá o mesmo resultado que a configuração Desativar.

  • Personalizado: As configurações de proxy são habilitadas para esta fonte específica usando informações personalizadas fornecidas aqui. Esta opção ignora a configuração de proxy do Agente se existir. Quando Personalizado é selecionado, estes campos ficam disponíveis:

    

    Consulte Ativando proxy para Agentes Privados para obter detalhes sobre esses campos.

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

• Opções de segurança: Estas opções estão disponíveis:

• FTP inseguro: Usa FTP normal não criptografado e não é seguro, pois as senhas são enviadas em texto não criptografado pela rede. Use apenas em um ambiente seguro. (Padrão.)

  • FTPS explícito: Esta opção usa FTP explícito com SSL, exigindo que o cliente FTP solicite informações de segurança antes do início de uma transferência de arquivo. Quando esta opção é selecionada, você pode definir o Modo de autenticação preferido (TLS ou SSL) e estas Opções de SSL:

    • Tentar SSL: Isso tenta iniciar uma transferência criptografada por TLS/SSL. Se isso falhar, será usado FTP não criptografado.
    • ExigirTLS/SSL para conexão de controle: Com esta opção, a conexão de controle FTP inicial é criptografada usando TLS/SSL para garantir que a troca de senha seja criptografada. A transferência em si não será criptografada, mas pelo menos a senha não será enviada em texto não criptografado. Se os dados em si não forem confidenciais ou já estiverem criptografados, você poderá usar esta opção. Se o servidor não suportar FTPS, a transferência falhará.
    • Exigir TLS/SSL para todas as transferências de dados: Esta opção requer que a conexão de controle e a conexão de dados sejam criptografadas usando TLS/SSL. Se o servidor não suportar SSL, a transferência falhará.

  • FTPS implícito: Esta opção usa FTPS implícito ( FTP implícito com TLS/SSL), exigindo uma conexão TLS/SSL antes da transferência de arquivos.

  • SFTP: Esta opção usa o protocolo SFTP em vez de FTP. Esta opção só poderá ser usada se você estiver se conectando a um servidor SFTP. Arquivos de chave pública e privada para SFTP podem ser configurados na seção SSH do arquivo de configuração do Agente, conforme descrito em Conectar-se ao SFTP com chaves SSH. Observe que SFTP e FTP/FTPS são protocolos diferentes e usam portas padrão diferentes.