Fluxo de trabalho de Transferência de arquivos SFTP

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 7 min. de leitura

    • O pacote de atividades de Transferência de arquivos SFTP inclui um fluxo de trabalho com escopo que usa várias atividades para gerenciar arquivos em servidores SFTP.

    A contagem máxima de atividades para o fluxo de trabalho de Transferência de arquivos SFTP está definida como 10.000. Isso permite que o fluxo de trabalho mova até 1000 arquivos de um servidor para outro.

    Acesso ao fluxo de trabalho

    • Navegar até Fluxo de trabalho > Editor de fluxo de trabalho e selecione a guia Fluxos de trabalho.
    • Clique no fluxo de trabalho de Transferência de arquivos SFTP para abri-lo.
    • Clique em um fluxo de trabalho para abri-lo e clique no ícone de informações no cabeçalho do fluxo de trabalho para exibir a caixa de diálogo de propriedades.

    Variáveis de entrada

    Tabela 1. Variáveis de entrada para Fluxo de trabalho de transferência de arquivo SFTP
    Variável Descrição Valor padrão
    Host de origem Nome ou endereço IP do servidor que contém os arquivos que você deseja mover.
    Porta de origem Número da porta a ser usada para se comunicar com o servidor de origem. 22
    Diretório de origem Caminho completo para o diretório onde os arquivos de origem estão localizados.
    Arquivos de origem Nomes dos arquivos de origem específicos a serem movidos. Separe os nomes de arquivo nesta lista com ponto e vírgula. Este campo oferece suporte ao uso de curingas. Para obter informações sobre como os valores neste campo são afetados pelas opções em outros campos, consulte a seção abaixo da tabela.
    Arquivos excluídos Nomes de arquivos de origem específicos a serem excluídos da movimentação. O sistema move todos os outros arquivos encontrados no diretório ou nas subpastas de origem. Separe os nomes de arquivo nesta lista com ponto e vírgula. Este campo oferece suporte ao uso de curingas. Para obter informações sobre como os valores neste campo são afetados pelas opções em outros campos, consulte a seção abaixo da tabela.
    Host de destino Nome ou endereço IP do servidor para o qual os arquivos estão sendo movidos.
    Porta de destino Número da porta a ser usada na comunicação com o host de destino. 22
    Formato de Data e hora Formato de carimbo de data/hora a ser aplicado quando a variável $ [DateTime] é usada no diretório de destino ou no campo Arquivos de destino. O sistema usa a hora atual da instância para criar valores de carimbo de data/hora. aaaa-MM-dd
    Diretório de meta Caminho para o diretório no host de destino para onde os arquivos estão sendo movidos. Você pode especificar um diretório de destino cujo nome inclui o carimbo de data/hora, adicionando a variável $ [DateTime] ao nome do diretório. Por exemplo, você pode inserir este caminho para um diretório de destino: /user/jacinto.gawron/documents/projects_$[DateTime]. Isso apresenta o diretório projects_20150505. Quando a variável de carimbo de data/hora é usada, o sistema usa o formato especificado no campo Formato de data/hora.
    Arquivo de destino Formato a ser usado para nomes de arquivo de destino quando um carimbo de data/hora for adicionado. Você pode configurar o sistema para adicionar o carimbo de data / hora como um prefixo ao nome do arquivo ou inserir o carimbo de data/hora no nome, usando estas variáveis:
    • $ [DateTime]: carimbo de data/hora atual, usando o formato definido no campo Formato de data/hora.
    • $ [SourceFile]: nome de arquivo completo.
    • $ [SourceFile: Base]: nome do arquivo base sem a extensão.
    • $ [SourceFile: Ext]: somente extensão de arquivo.

    Um nome de arquivo de destino com o carimbo de data/hora adicionado como um prefixo é expresso como: $ [DateTime] _ $ [SourceFile]. Isso produz um nome de arquivo semelhante a este: 20150505_file1.txt

    Um nome de arquivo de destino com o carimbo de data/hora adicionado como um prefixo é expresso como: $[SourceFile:Base]_$[DateTime]$[SourceFile:Ext]. Isso produz um nome de arquivo semelhante a este: file1_20150505.txt
    Aplicar condições de movimentação Caixa de seleção para aplicar condições à transferência de arquivos. Se esta caixa de seleção estiver marcada, serão exibidos campos adicionais para definir as condições. falso
    Tamanho de arquivo mínimo, em bytes Condição que define o requisito de tamanho mínimo de um arquivo de destino. Esta configuração pode ajudar a determinar se o arquivo é válido. Este campo aparece quando a caixa de seleção Aplicar condições de movimentação está marcada. 0
    Tamanho máximo de arquivo, em bytes Condição que define o requisito de tamanho máximo de um arquivo de destino. Este campo aparece quando a caixa de seleção Aplicar condições de movimentação está marcada. -1
    O arquivo não é mais antigo que Condição que define a data mais antiga aceitável para o intervalo de idade deste arquivo. O intervalo começa à 00:00 (meia-noite) na data especificada. Este campo aparece quando a caixa de seleção Aplicar condições de movimentação está marcada.
    O arquivo não é mais recente que Condição que define a data mais recente aceitável para o intervalo de idade deste arquivo. O intervalo termina às 23:59 da data especificada. Este campo aparece quando a caixa de seleção Aplicar condições de movimentação está marcada.
    Incluir subpastas Caixa de seleção para mover os arquivos das subpastas no diretório de origem. Para obter informações sobre como a sua seleção afeta outros campos no formulário, acompanhe a seção abaixo da tabela.
    Ordem de movimentação Ordem na qual os arquivos serão movidos da origem para o destino. As opções possíveis são:
    • Nenhuma (a mesma ordem dos arquivos no diretório de origem)
    • Por carimbo de data/hora
    • Por nome de arquivo
    • Por tamanho de arquivo
    Ordem de classificação Ordem na qual os arquivos são classificados no diretório de destino, usando a opção selecionada no campo Ordem de movimentação. As opções de classificação são Crescente e Decrescente. desc
    Número máximo de novas tentativas Número de tentativas que a atividade pode fazer para se conectar ao host de destino ou para mover um arquivo antes do tempo limite. Quando o limite de novas tentativas para mover um arquivo ou para se conectar ao host é excedido, o sistema registra uma falha. Se o número máximo de falhas não for excedido, o sistema tentará se conectar novamente ou mover o próximo arquivo nomeado. 2
    Tempo entre novas tentativas, em segundos Tempo, em segundos, entre as tentativas de repetição de conexão com o destino ou de início da movimentação de um arquivo. 10
    Número máximo de falhas Número aceitável de vezes que o sistema pode falhar ao se conectar ao host de destino ou ao mover um arquivo antes de parar de tentar. Ocorre uma falha quando o número de novas tentativas configuradas é excedido. Usando as configurações padrão, ocorre falha quando o sistema não pode se conectar ao destino ou mover um arquivo após duas tentativas. 0
    Ação de arquivo duplicada Ação a ser tomada se um arquivo que está sendo movido já existir no diretório de destino. As opções são:
    • Sobrescrever se o arquivo existe (padrão)
    • Renomear com índice
    • Não mover
    		 overwrite
    Preservar atributos do arquivo Caixa de seleção para usar o carimbo de data/hora e as informações de modo dos arquivos de origem para os arquivos copiados. Se esta caixa de seleção estiver desmarcada, os arquivos copiados terão um carimbo de data/hora e modo atuais.
    Nota:
    Este carimbo de data/hora é um atributo de arquivo e não é anexado ao nome do arquivo.
    		 falso
    Em caso de sucesso, remover arquivos da origem Caixa de seleção para excluir arquivos originais do diretório de origem quando eles forem copiados para o novo local. Desmarque esta caixa de seleção para manter os arquivos de origem em seu local atual no host de origem. falso
    Em caso de falha, manter arquivos movidos no destino Caixa de seleção para manter todos os arquivos no destino que foram movidos com sucesso, mesmo se a operação de transferência de arquivos inteira terminar com falha. Se esta caixa de seleção estiver desmarcada, o sistema removerá todos os arquivos transferidos com êxito do destino quando ocorrer uma falha geral. verdadeiro
    Marcador de credencial para origem Os aliases de credencial das atividades de Orquestração nesta atividade devem ser usados para executar comandos SSH no host de origem.
    Marcador de credencial para destino Marcador de credencial específico que esta atividade deve usar para executar comandos SSH no host de destino.

    Lógica de seleção de arquivo

    Ao selecionar os arquivos a serem movidos do host de origem, o sistema usa esta lógica:
    • Se os campos Arquivos de origem e Arquivos excluídos estiverem vazios, o sistema moverá todos os arquivos no diretório de origem.
    • Quando a caixa de seleção Incluir subpastas está marcada, existem as seguintes dependências:
      • Se nenhum arquivo for especificado nos campos Arquivos de origem e Excluir arquivos, o sistema moverá todos os arquivos no diretório de origem e todos os arquivos em todas as subpastas do diretório de origem.
      • Se o campo Arquivos de origem contiver nomes de arquivo, o sistema moverá esses arquivos de seu local no diretório de origem ou em qualquer uma de suas subpastas.
      • Se o campo Excluir arquivos contiver nomes de arquivo, o sistema moverá esses arquivos de seu local no diretório de origem ou em qualquer uma de suas subpastas exceto os arquivos a serem excluídos.
    • Quando a caixa de seleção Incluir subpastas estiver desmarcada, o sistema procurará somente no diretório de origem os arquivos a serem movidos ou excluídos.