Criar um destino de site FTP no Jitterbit Design Studio

Introdução

Um destino de Site FTP pode ser usado para gravar em um servidor FTP com opções como pastas de sucesso/erro.

Pré-requisito

Antes de usar o recurso de pastas de sucesso/erro de um destino de Site FTP (veja as Opções abaixo), você deve ter habilitado a Local File Location em seu agente privado Jitterbit. Consulte Habilitando a localização de arquivos locais para mais detalhes.

Criar um destino de site FTP

Você pode optar por criar um novo destino de Site FTP por conta própria ou dentro de uma operação existente. Para detalhes sobre como os destinos funcionam dentro das operações, consulte Criando uma operação.

Criar novo destino de site FTP como um destino autônomo

Dentro do seu projeto no Jitterbit Design Studio, você cria um novo destino de Site FTP de qualquer uma das seguintes maneiras:

• Vá para Arquivo > Novo > Novo Destino; ou

• No painel à esquerda, clique com o botão direito em Destinos e selecione Novo Destino; ou

• Na barra de ferramentas superior, clique no ícone de destino azul .

Na janela pop-up, selecione Site FTP como o tipo:

Seu novo alvo aparece em sua própria aba Novo Alvo no painel direito da janela.

Criar um novo alvo de site FTP em uma operação existente

Um alvo é geralmente criado 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 seu alvo por:

• Clicando duas vezes no ícone do alvo; na janela pop-up, selecione Criar Novo Alvo; ou

• Clicando com o botão direito no ícone do alvo e selecionando Criar Novo Alvo.

Na tela de configuração que aparece, use o dropdown Tipo para selecionar Site FTP, conforme mostrado acima.

Usar um alvo de site FTP existente em uma operação existente

Para usar um alvo de Site FTP existente em uma operação existente com um alvo, você pode configurá-lo de qualquer uma das seguintes maneiras:

• Dentro da operação, clicando duas vezes no ícone do alvo e, na janela pop-up resultante, selecionando o alvo de Site FTP desejado na lista; ou

• Dentro da operação, clicando com o botão direito no ícone do alvo, escolhendo Selecionar Alvo Existente e, na janela pop-up resultante, selecionando o alvo de Site FTP desejado na lista; ou

• Arrastando o alvo de Site FTP desejado da árvore à esquerda e soltando-o sobre o ícone do alvo existente da operação.

Configurar um alvo de site FTP

Depois de criar um alvo 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 do alvo na operação ou clicando duas vezes no alvo na árvore à esquerda.

Configuração básica

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

• Nome: Insira um nome apropriado e único para o destino.
• Tipo: Use o menu suspenso para selecionar FTP Site, se ainda não estiver especificado.
• Parâmetros de Conexão: Especifique os detalhes para a conexão do seu FTP Site:

• 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 Usar porta padrão e insira uma porta a ser utilizada no campo Porta.
  • Caminho(s): Insira um ou mais caminhos válidos. O caminho deve apontar para um diretório existente no servidor FTP, como /incoming/. Vários caminhos podem ser especificados usando valores delimitados por vírgula. Se vários caminhos forem especificados, o mesmo arquivo será gravado em vários locais.
  • Login e Senha: Insira um nome de usuário (obrigatório) e senha (se aplicável) que permitirá o acesso ao servidor FTP. Deixe a senha em branco se nenhuma senha for necessária.

• Nome do(s) Arquivo(s): Insira o nome desejado para o(s) arquivo(s) de destino. Variáveis 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 será gravado automaticamente no arquivo no nível raiz. (Obrigatório.)

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

    Cuidado

    Usar a opção Usar Renomear FTP ao gravar em um servidor SFTP em uma operação de arquivo não é funcional.

• Testar Conexão: Clicar no botão testará o destino do FTP Site; ele falhará se o diretório especificado não existir. Não testa se o usuário especificado tem permissão de gravação no diretório.

• 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:

• Modo Passivo: Mantenha esta caixa marcada para usar o método "PASV" do servidor FTP para recuperar arquivos. Quando esta opção está 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 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 de número alto.

• Criar Diretórios Automaticamente: Cria 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 utilizada, você deve confirmar que o diretório foi criado antes do uso em produção.

• Escrever Cabeçalhos: Se marcado e um destino de texto plano, um cabeçalho de nomes de coluna/campo será escrito como a primeira linha.

• Não Criar Arquivos Vazios: Se marcado, a criação do arquivo de destino será pulada se não houver dados de destino.
• Anexar ao Arquivo: Se marcado, os dados serão anexados a um arquivo de destino existente em vez de sobrescrever. Observe que conexões SFTP não suportam a capacidade de anexar a arquivos, o que é uma limitação do SFTP.

• Tipo de Quebra de Linha: Determina como o Jitterbit escreve quebras de linha ao escrever para um destino. Observe que os caracteres de fim de linha nos dados não serão convertidos. Opções disponíveis:

  • 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: Usado para especificar uma codificação de caracteres para o arquivo de destino. Se deixado em branco, o Jitterbit tentará detectar a codificação. Para especificar uma codificação diferente da padrão, insira uma das codificações suportadas descritas em Codificações de caracteres suportadas.

• Pasta de Sucesso/Erro: Especifica se 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, ao processar com sucesso o alvo, uma cópia do arquivo será gravada em um arquivo nessa pasta.

• O arquivo terá o mesmo nome que o especificado no campo Nome(s) do arquivo acima, mas com um sublinhado final e um carimbo de data/hora adicionados. Se já houver 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 poderá ser gravada 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, quaisquer arquivos que falharem serão gravados em um arquivo na Pasta de Erro.

  Importante

  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 uma solução alternativa, veja Limitação e solução alternativa em Palavras-chave de nome de arquivo. Usar asteriscos (*) e outros caracteres de nome de arquivo tipicamente não suportados fará com que a operação falhe.

• Compressão: Se a caixa de seleção para Compactar arquivos de destino estiver selecionada, os arquivos de destino serão compactados usando o formato ZIP. Opções adicionais são:

  • Nome(s) do arquivo no arquivo: Aceita variáveis e palavras-chave de nome de arquivo. Para manter o nome do arquivo no arquivo igual ao nome do arquivo definido no alvo, use um formato de [file].[ext] conforme mostrado acima.
  • Modo: Não aplicável para alvos de Site FTP.
  • Senha: Para arquivos criptografados, forneça uma senha.
  • Modo de criptografia: Se uma senha for fornecida, há dois modos de criptografia disponíveis: AES e ZIP Padrão.

• Configurações de Proxy: Use o menu suspenso para selecionar uma dessas opções para um proxy personalizado para o host 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 estão ativadas, utilizando 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 tem o mesmo resultado que a configuração Desativar.

• Personalizado: As configurações de proxy estão ativadas 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, esses campos ficam disponíveis:

  ![attachment](/_download/attachments/55148712/image2016-12-19%20141147.png)
  
  Veja [Habilitando proxy para agentes privados](/pt/agent/proxy/) para 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 arquivos, escolha Binário. Binário é o padrão e geralmente funciona melhor.

• Opções de Segurança: Essas opções estão disponíveis:

• FTP Inseguro: Isso usa FTP normal não criptografado e não é seguro, pois as senhas são enviadas em texto claro 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 que uma transferência de arquivo comece. Quando esta opção é selecionada, você pode definir o Modo de Autenticação preferido (seja TLS ou SSL) e essas Opções de SSL:

    • Tentar SSL: Isso tenta iniciar uma transferência criptografada por TLS/SSL. Se isso falhar, o FTP não criptografado será usado.
    • Exigir TLS/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 senhas seja criptografada. A transferência em si não será criptografada, mas pelo menos a senha não é enviada em texto claro. Se os dados em si não forem sensíveis ou já estiverem criptografados, você pode usar esta opção. Se o servidor não suportar FTPS, a transferência falhará.
    • Exigir TLS/SSL para toda transferência de dados: Esta opção exige que tanto a conexão de controle quanto 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 utiliza 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 utiliza o protocolo SFTP em vez de FTP. Esta opção só pode 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 ao SFTP com chaves SSH. Observe que SFTP e FTP/FTPS são protocolos diferentes e utilizam portas padrão diferentes.