---
sourceDocument: Capacidades da Now Platform da Yokohama
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/servicenow-platform

 Release :

    - yokohama

ft:locale :

    - pt-BR

ft:publication_title :

    - Capacidades da Now Platform da Yokohama

ft:clusterId :

    - platcap

bundleId :

    - platcap

workflow :

    - Platform


---

# Fluxo de trabalho de Transferência de arquivos SFTP

# Fluxo de trabalho de Transferência de arquivos SFTP {#ariaid-title1}

* Versão de lançamento: Yokohama
* 
* Atualizado 30 de jan. de 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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 trabalhoEditor de fluxo de trabalho e selecione 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.
{#r_SFTPWorkflow__ul_eks_3cy_mt}

## Variáveis de entrada

{#r_SFTPWorkflow__table_e23_hby_mt__entry__3}

| 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. {#r_SFTPWorkflow__ul_o3q_wnl_2s} 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 {#r_SFTPWorkflow__ul_lyt_t1b_yr} |   |
| 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 {#r_SFTPWorkflow__ul_ir2_frq_wr} | 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](https://www.servicenow.com/docs/access?context=c_AssignCredsOrchActivities&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US) 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. |   |
[Tabela 1. Variáveis de entrada para Fluxo de trabalho de transferência de arquivo SFTP]

{#r_SFTPWorkflow__table_e23_hby_mt}

## 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.
  {#r_SFTPWorkflow__ul_pjd_3gq_yr}
* 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.
{#r_SFTPWorkflow__ul_pqm_mfq_yr}

