Ir para o conteúdo

Atividade de Gravação FTP no Jitterbit Studio

Introdução

Uma atividade de FTP Gravação, utilizando sua conexão FTP, grava dados em um endpoint FTP e é destinada a ser usada como um alvo para consumir dados em uma operação ou para ser chamada em um script.

Criar uma atividade de FTP Gravação

Uma instância de uma atividade de FTP Gravação é criada a partir de uma conexão FTP usando seu tipo de atividade Gravação.

Para criar uma instância de uma atividade, arraste o tipo de atividade para a tela de design ou copie o tipo de atividade e cole-o na tela de design. Para detalhes, veja Criar uma instância de atividade ou ferramenta em Reutilização de componentes.

Uma atividade de FTP Gravação existente pode ser editada a partir destes locais:

Configurar uma atividade de FTP Gravação

Siga estas etapas para configurar uma atividade de FTP Gravação:

Etapa 1: Insira um nome, forneça um esquema de solicitação e especifique as configurações

Dica

Campos com um ícone de variável suportam o uso de variáveis globais, variáveis de projeto e variáveis Jitterbit. Comece digitando um colchete quadrado aberto [ no campo ou clicando no ícone de variável para exibir um menu listando as variáveis existentes para escolher.

  • Menu de endpoint: Se você tiver vários endpoints do mesmo tipo de conector configurados, um menu na parte superior da tela exibe o nome do endpoint atual. Clique no menu para alternar para um endpoint diferente. Para mais informações, veja Alterar o endpoint atribuído em Telasa de configuração.

    • Editar endpoint: Aparece quando você passa o mouse sobre o nome do endpoint atual. Clique para editar a configuração de conexão do endpoint atualmente selecionado.

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

  • Fornecer esquema de solicitação: O esquema de solicitação define a estrutura dos dados que são usados pela atividade FTP Gravar. Se um esquema de solicitação é necessário depende se a atividade é usada como o alvo de uma transformação (veja Uso de esquema). Para instruções sobre como completar esta seção da configuração da 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 vários caminhos pode ser user1\path, user2\path.

    Cuidado

    Variáveis globais com valores padrão não são substituídas neste campo com agentes da versão 11.38 e anteriores.

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

  • Usar Renomeação 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 de seleção se esta opção causar problemas.

    Importante

    Usar a opção Usar Renomeação FTP ao gravar em um servidor SFTP em uma operação de padrão de arquivo requer agentes na versão 11.56 ou posterior. A versão do agente 11.56 ou posterior também é recomendada se esta opção não responder como esperado com um servidor FTP.

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

    • 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 maneira inconsistente. Dependendo do servidor FTP em questão, o diretório pode não ser criado. Se esta opção for usada, você deve confirmar que o diretório foi criado antes do uso em produção.

    • Não Criar Arquivos Vazios: Selecione esta caixa de seleção para pular a criação do arquivo de destino se não houver dados de destino.

    • Anexar ao Arquivo: Selecione esta caixa de seleção para anexar ao 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.

    • Escrever Cabeçalhos: Selecione esta caixa de seleção se você estiver usando um destino de texto simples e quiser escrever cabeçalhos (nomes de coluna/campo) na primeira linha.

    • Tipo de Quebra de Linha: Especifique como escrever quebras de linha ao gravar em um destino. Observe que os caracteres de fim de linha nos dados em si 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 você quiser sobrescrever o padrão, pode escolher entre 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 fonte de arquivo para permitir que você grave em um local separado em vez de em uma subpasta no mesmo local.

    -   **Usar Pasta de Sucesso:** Selecione 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 é bem-sucedida apenas se todos os caminhos forem bem-sucedidos. Se esta caixa de seleção estiver marcada, forneça também a **Pasta de Sucesso em Caminho Absoluto** na máquina do agente privado.

-   **Usar Pasta de Erro:** Selecione esta caixa de seleção para gravar um arquivo na pasta especificada após um processamento malsucedido. Se pelo menos um caminho for malsucedido, o arquivo é gravado nesta pasta. Se esta caixa de seleção estiver marcada, forneça também a **Pasta de Erro em Caminho Absoluto** na máquina do agente privado.

    !!! caution "Cuidado"
        Um arquivo é gravado apenas se a falha for devido a erros no processamento da atividade de Gravação FTP, como permissões de gravação insuficientes para a atividade. Um arquivo não é gravado se, por exemplo, a conexão FTP for malsucedida, fazendo com que toda a operação falhe.

!!! important "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](/pt/integration-studio/design/variables/filename-keywords/#filenamekeywords-limitations) em [Palavras-chave de nome de arquivo](/pt/integration-studio/design/variables/filename-keywords). O uso de asteriscos (`*`) e outros caracteres de nome de arquivo tipicamente não suportados fará com que a operação falhe.

Os arquivos são nomeados conforme especificado no campo **Nome(s) do Arquivo** acima, 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 sã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 gravada na pasta especificada como a 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 são gravados em um arquivo na pasta de erro.

    • Compressão: Selecione a caixa de seleção para Compactar Arquivos de Destino se você quiser que os dados de destino sejam compactados. Essas opções ficam disponíveis:

      • Formato: Use o menu suspenso para selecionar o formato de compressão desejado. Atualmente, apenas o formato ZIP é suportado.

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

        Dica

        Para manter o(s) nome(s) do arquivo no arquivo o mesmo que o(s) nome(s) do arquivo definidos no destino, insira [file].[ext].

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

      • Senha: Para criptografar o arquivo, insira 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 do tipo de transferência ASCII. 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 & Sair: Se habilitado, clique para salvar a configuração para esta etapa e fechar a configuração da atividade.

  • Próximo: Clique para armazenar temporariamente a configuração para esta etapa e continuar 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 alterações, clique para fechar a configuração sem salvar as alterações feitas em qualquer etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.

Etapa 2: Revisar os esquemas de dados

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

  • Adicionar plugin(s): Plugins são aplicativos fornecidos pela Jitterbit ou pelo usuário que estendem as capacidades nativas do Harmony. Para aplicar um plugin à atividade, clique para expandir esta seção e selecione a caixa de seleção ao lado do plugin a ser utilizado. Para instruções adicionais sobre como usar plugins, incluindo detalhes sobre a configuração de quaisquer variáveis necessárias usadas pelo plugin, 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 alterações, clique para fechar a configuração sem salvar as alterações feitas em qualquer etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.

Próximas etapas

Após configurar uma atividade de FTP Gravar, você pode usá-la dentro de uma operação ou script, conforme descrito abaixo.

Completar a operação

Após configurar uma atividade de FTP Gravar, complete a configuração da operação adicionando e configurando outras atividades ou ferramentas como etapas da operação. Você também pode configurar as configurações da operação, que incluem a capacidade de encadear operações que estão no mesmo ou em diferentes fluxos de trabalho.

Uma vez que uma atividade FTP Write foi criada, as ações do menu para essa atividade estão acessíveis no painel do projeto, tanto nas abas Workflows quanto Components, e a partir da tela de design. Veja o menu de ações da atividade para mais detalhes.

Atividades FTP Write podem ser usadas como um alvo com esses 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 de Validade da Operação.

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

Use atividades FTP em scripts

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

Funções de Script do Jitterbit

  • ArchiveFile
  • FlushAllFiles
  • FlushFile
  • WriteFile

Funções Jitterbit em JavaScript

  • Jitterbit.WriteFile

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