Ir para o conteúdo

Transforme as suas conexões em um bônus de fim de ano com o nosso novo Programa de Indicação de Clientes! Saiba mais

✕

Atividade de leitura de FTP

Introdução

Uma atividade de leitura de FTP, usando sua conexão FTP, lê dados de um endpoint FTP e deve ser usado como uma fonte para fornecer dados a uma operação ou para ser chamado em um script.

Criar uma atividade de leitura de FTP

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

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 Criar uma instância de atividade ou ferramenta em Reutilização de componentes.

Uma atividade de leitura de FTP existente pode ser editada nestes locais:

Configurar uma atividade de leitura FTP

Siga estas etapas para configurar uma atividade de leitura de FTP:

Etapa 1: insira um nome, forneça um esquema de resposta e especifique as configurações

Atividade de leitura FTP 1

Dica

Campos com í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 para identificar a atividade de Leitura de FTP. O nome deve ser exclusivo para cada atividade de Leitura de FTP e não deve conter barras (/) ou dois pontos (:).

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

  • Caminho: Insira um único caminho válido. Um caminho deve apontar para um diretório existente no servidor FTP. Por exemplo, /inbound.

    Cuidado

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

  • Obter arquivos: Insira o nome do(s) arquivo(s) que deseja ler no caminho informado acima. Este campo também pode incluir um asterisco (*) para usar como curinga (por exemplo, *.dat ou *.*) ou um ponto de interrogação (?) para corresponder exatamente a um caractere (por exemplo, file?.txt). O uso de curingas é independente da opção Usar expressão regular descrita abaixo. Se estiver especificando dados em formato ZIP para serem descompactados e lidos automaticamente, consulte as opções de Compressão descritas abaixo.

    Dica

    Se estiverem 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 a acima na cadeia de uma atividade de leitura de FTP.

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

    Atividade de leitura FTP 1 configurações opcionais

    • Opções de filtro de arquivo: Essas opções afetam como a entrada inserida no campo Obter arquivos acima é interpretada:

      • Ignorar maiúsculas e minúsculas: Marque esta caixa de seleção se você tiver inserido uma entrada no campo Obter arquivos acima que deve ser interpretada como insensível a maiúsculas e minúsculas.

      • Usar expressão regular: Marque esta caixa de seleção se você inseriu uma entrada no campo Obter arquivos acima que deve ser interpretada como uma expressão regular. Esta opção é independente do uso de curingas descrito em Obter arquivos acima.

    • Listar apenas nomes de arquivos: Marque esta caixa se desejar listar apenas nomes de arquivos (usando o comando FTP NLST em vez de LIST). Tente esta opção se o Harmony não conseguir analisar a listagem de diretórios FTP enviada pelo servidor FTP.

      Dica

      Se estiverem 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 a acima na cadeia de uma atividade de leitura de FTP.

    • Codificação de Caracteres: Especifique a codificação de caracteres para definir uma codificação de caracteres específica para o arquivo de origem. Se você deixar o campo em branco, o Harmony tentará detectar a codificação. Se desejar 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: Estas opções são usadas para arquivar uma cópia de todos os arquivos processados. Elas podem ser usadas no lugar da opção Após Processamento para Renomear Arquivo na origem do arquivo, permitindo 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 estiver gravando 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, informe também a Pasta de Sucesso no Caminho Absoluto na máquina do agente privado.

      • Usar Pasta de Erro: 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 for bem-sucedido, o arquivo será gravado nesta pasta. Se esta caixa de seleção estiver marcada, informe também a Pasta de Erro no Caminho Absoluto na máquina do agente privado.

        Cuidado

        Um arquivo será gravado somente se a falha for causada por erros no processamento da atividade de Leitura FTP. Um arquivo não será gravado se, por exemplo, a conexão FTP não for bem-sucedida, causando a falha de 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 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 farão com que a operação falhe.

      Os arquivos são nomeados conforme especificado no campo Obter arquivos 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 serão adicionados.

      Por exemplo, se um arquivo chamado data.csv é processado com sucesso, uma cópia chamada data.csv_2018-01-01_12-00-00-000 pode ser gravado 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 seriam adicionados. De forma semelhante, se uma pasta de erro for especificada, quaisquer arquivos que falharem serão gravados em um arquivo na pasta de erro.

    • Após o Processamento: Se desejar executar outras ações após o processamento dos dados, estas opções estão disponíveis:

      • Excluir Arquivo: Marque esta caixa de seleção se desejar que os arquivos que foram processados com sucesso sejam excluídos. Quando esta opção é selecionada, a opção Renomear arquivo abaixo é preenchida automaticamente com /\delete/\ para indicar que os arquivos processados serão excluídos e, portanto, renomear um arquivo não se aplica. Desmarcar Excluir Arquivo também limpa o campo Renomear arquivo.

      • Renomear arquivo: Insira um nome se desejar renomear os arquivos após o processamento. Qualquer uma das palavras-chave de nome de arquivo estão disponíveis para gerar nomes de arquivo exclusivos para os dados de origem após o processamento. Observe que o campo Renomear arquivo não estará disponível se Excluir arquivo estiver selecionado. Além disso, ativar a opção Excluir arquivo acima apaga qualquer entrada inserida no campo Renomear arquivo.

        !!! tip "Dica" Se você quiser arquivar a fonte do arquivo em um local separado em um agente privado, consulte também a opção Pasta de sucesso/erro na Atividade de gravação FTP configuração.

    • Arquivo de gatilho: Disponível apenas para uso com agentes privados onde arquivos locais estão habilitados, um arquivo de gatilho é um arquivo que deve estar presente antes que um arquivo de origem seja recuperado por uma operação para processamento. A presença de um arquivo de gatilho indica que um arquivo de origem está pronto para ser lido e não está em processo de gravação por uma operação anterior.

      • Usar Gatilho: Marque esta caixa de seleção se desejar que o sistema procure um arquivo de gatilho antes de processar os arquivos de origem. Observação: ao usar um arquivo de gatilho:

        • A operação realiza uma pesquisa, procurando o arquivo de gatilho. O intervalo de tempo da pesquisa é fixo em um segundo.

        • O arquivo de gatilho é excluído quando o processamento é iniciado.

        • Se o arquivo de gatilho não for encontrado, a operação continuará tentando encontrá-lo até que o tempo limite da operação se esgote.

        • Definir um arquivo de gatilho bloqueia qualquer operação ou script que use a origem até que a condição do arquivo de gatilho seja satisfeita ou o tempo limite da operação seja atingido.

      • Caminho absoluto do arquivo: Insira o caminho absoluto do arquivo na máquina do agente privado onde o arquivo de gatilho reside. Selecione um arquivo que atenda a estes critérios:

        • O arquivo pode ser de qualquer tipo e pode conter qualquer coisa como conteúdo; somente a presença do arquivo define o comportamento do arquivo de gatilho.

        • O uso de curingas não é permitido.

        • O arquivo de gatilho não pode ser o mesmo arquivo que um arquivo de origem que está sendo processado.

        Nota

        Ao usar palavras-chave de nome de arquivo neste campo, as palavras-chave não são resolvidas. Para uma solução alternativa, consulte Limitação e solução alternativa em Palavras-chave do nome do arquivo.

    • Ignorar Linhas: Se houver cabeçalhos e/ou rodapés nos dados de origem, insira o número de linhas a serem ignoradas nos campos Primeiro e Sobrenome.

      Nota

      Esta configuração não entra em vigor quando uma atividade de leitura de FTP é referenciada de um script usando o ReadFile ou WriteFile funções.

    • Compressão: Se os dados de origem estiverem em um formato compactado, selecione Os dados de origem estão compactados. As seguintes opções ficam disponíveis:

      • Formato: Use o menu suspenso para selecionar o formato dos dados compactados. Atualmente, apenas o formato ZIP é suportado.

      • Senha: Se o arquivo estiver criptografado, digite a senha.

        !!! note "Nota" O Harmony suporta somente a leitura do diretório raiz de um arquivo criptografado.

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

  • Salvar e sair: Se habilitado, clique para salvar a configuração desta etapa e fechar a configuração da atividade.

  • Próximo: Clique para armazenar temporariamente a configuração desta etapa e prosseguir para a próxima. 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 solicitará que você confirme se deseja descartar as alterações.

Etapa 2: Revise os esquemas de dados

Atividade de leitura FTP 2

  • Esquema de Dados: Se fornecido durante a configuração da atividade, o esquema de dados de resposta 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 plugin(s): Plugins são aplicativos Jitterbit ou fornecidos pelo usuário que estendem 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 plugins, incluindo detalhes sobre como definir as 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 as alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicitará que você confirme se deseja descartar as alterações.

Próximos passos

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

Concluir a operação

Após configurar uma atividade de Leitura de FTP, conclua 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 de uma operação, que incluem a capacidade de encadear operações que estejam no mesmo fluxo de trabalho ou em workflows diferentes.

As ações de menu de uma atividade podem ser acessadas no painel do projeto e na quadro de design. Para obter detalhes, consulte menu de ações da atividade em Noções básicas do conector.

Atividades de Leitura FTP podem ser usadas como uma fonte com estes padrões de operação:

Outros padrões não são válidos usando atividades de leitura de FTP. Consulte os padrões de validação em Validade da operação página.

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

Dica

Se estiverem 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 a acima na cadeia de uma atividade de FTP Leitura.

Usar atividades FTP em scripts

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

Funções de Jitterbit Script

  • ArchiveFile
  • Base64EncodeFile
  • DeleteFile
  • DeleteFiles
  • DirList
  • FileList
  • ReadFile

Funções Jitterbit JavaScript

  • Jitterbit.ReadFile

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