Upload Storage File

Atividade Upload Storage File que carrega um arquivo para um Bucket de Armazenamento especificado no Orchestrator.

UiPath.Core.Activities.Storage.UploadStorageFile

Description

Carrega um arquivo para um Bucket de Armazenamento especificado no Orchestrator.

Observação:

Permissões do Orchestrator

Essa atividade é executada na conta do Orchestrator do robô que a executa. Ele deve conter as seguintes permissões de função do Orchestrator na pasta de destino:

• Storage Buckets.View: usado para resolver o problema do bucket de armazenamento
• Storage Files.Create: usado para carregar ou gravar arquivos no bucket
• Folders.View: usado para navegar e selecionar a pasta do Orchestrator

Em projetos do Windows e multiplataforma com System 26.10.0 ou posterior, a atividade armazena o arquivo carregado com seu tipo de conteúdo (tipo MIME). O tipo de conteúdo é extraído da extensão do nome do arquivo carregado, depois do tipo que o recurso de arquivo relata e, em seguida, da extensão do arquivo local.

Os seguintes buckets não mantêm o tipo de conteúdo, porque o Orchestrator o descarta:

• Buckets do sistema de arquivos local
• Buckets criptografados no local
• Buckets do MinIO

Compatibilidade do projeto

Windows - Legada | Windows | Multiplataforma

Configuração multiplataforma

• Caminho da pasta do Orchestrator— O caminho para a Pasta do Orchestrator que você quer usar com esta atividade. Se deixado vazio, a pasta atual do Orchestrator será usada. Este campo é compatível apenas com strings e variáveis String . Use / como um separador de subpasta para especificar a pasta desejada.
• Nome do bucket de armazenamento— O nome do bucket de armazenamento para onde você deseja carregar o arquivo. Este campo é obrigatório. Este campo é compatível apenas com strings e variáveis String .
• Arquivo— O caminho completo do arquivo que você deseja carregar para o Bucket de Armazenamento mencionado. Você pode alternar entre usar um caminho local ou uma variável do tipo IResource . Se você estiver usando um caminho local, é recomendável usar caminhos de pastas relativos devido à estrutura de arquivos diferente entre máquinas Windows e Linux ao executar um projeto. Exemplo: newFolder/newFileName.txt.
• Caminho de destino— O caminho no bucket de armazenamento onde o arquivo é carregado, incluindo o nome do arquivo. Um valor que termina com / é usado como uma pasta, como é qualquer valor quando o Nome do arquivo carregado é definido, e o nome do arquivo vem do Nome do arquivo carregado ou do arquivo de origem. Um valor vazio carrega o arquivo para a raiz do bucket.
• Nome do arquivo carregado— O nome do arquivo no bucket de armazenamento. Quando definido, ele é anexado ao Caminho de destino, que é usado como uma pasta. Se deixado em branco, o nome vem do Caminho de destino ou, quando este for uma pasta ou vazio, do arquivo de origem.

Observação:

No designer, o Caminho de destino oferece uma lista pesquisável das pastas do bucket, com entradas terminando em /, como archive/, e a atualiza quando a pasta do Orchestrator ou o bucket for alterado. Você ainda pode digitar um valor ou uma expressão. Em soluções do Studio Web, o campo é texto simples sem lista.

¹Para projetos multiplataforma criados no Studio Web como parte de uma solução, o campo Caminho da pasta do Orchestrator está indisponível. Se a atividade tinha um caminho de pasta antes de se tornar parte da solução, o campo será exibido como somente leitura, e essa pasta substituirá o recurso da solução. Selecionar o recurso novamente removerá a pasta.

²Para projetos multiplataforma criados no Studio Web como parte de uma solução, o campo nome fornece opções para Definir novos recursos do Orchestrator, como filas, ativos ou buckets de armazenamento, durante o período de design, ou Abrir o Orchestrator para gerenciamento de recursos.

Opções avançadas

Outros

• Tempo limite (milissegundos)— Especifica o tempo (em milissegundos) a ser aguardado para que o Orchestrator responda ou para que a transferência do arquivo faça progresso, antes que um erro seja gerado. Ele não limita o tempo de transferência total; portanto, arquivos grandes em conexões lentas ainda são concluídos. O valor padrão é 300.000 milissegundos (5 minutos). A abertura de uma conexão é sempre limitada a 30 segundos.

  Observação:

  Em um tempo limite, a atividade falha com um TimeoutException carregando o código de erro Orchestrator_Sys_Timeout, então Continuar com erro e Repetir escopo se aplicam como a qualquer outro erro. Um valor de 0 ou um número negativo é substituído por 30 segundos, e o cancelamento do trabalho é relatado como um cancelamento em vez de um tempo limite.

  Quando o Orchestrator serve o próprio conteúdo do arquivo em vez de entregar um URL de provedor, que é o caso do armazenamento gerenciado pelo Orchestrator com a Features.Buckets.StorageOffloadRequiresAuth funcionalidade habilitada, o upload também deve terminar no total dentro desse valor.

• Continuar ao ocorrer erro— Especifica se a automação deve continuar mesmo quando a atividade gera um erro. Este campo só aceita valores booleanos (True, False). O valor padrão é False. Como resultado, se o campo estiver em branco e um erro for lançado, a execução do projeto será interrompida. Se o valor for definido como True, a execução do projeto continua independentemente de qualquer erro.

  Observação:

  Se esta atividade estiver incluída na atividade Try Catch e o valor da propriedade ContinuarComErro for True, nenhum erro será capturado quando o projeto for executado.

Windows - Legada, Configuração do Windows

• Caminho de destino— Apenas projetos do Windows. O caminho no bucket de armazenamento em que o arquivo é carregado, incluindo o nome do arquivo. Um valor que termina com / é usado como uma pasta, como é qualquer valor quando o Nome do arquivo carregado é definido, e o nome do arquivo vem do Nome do arquivo carregado ou do arquivo de origem. Um valor vazio carrega o arquivo para a raiz do bucket. Esse campo é compatível apenas com strings e variáveis String .
• Nome do arquivo carregado— apenas projetos do Windows. O nome do arquivo no bucket de armazenamento. Quando definido, ele é anexado ao Caminho de destino, que é usado como uma pasta. Se deixado em branco, o nome vem do Caminho de destino ou, quando este for uma pasta ou vazio, do arquivo de origem. Se o arquivo de destino já existir, ele será substituído.
• Destino— Windows - Projetos legados apenas. O caminho em que você deseja carregar o arquivo no Bucket de Armazenamento. O separador de diretórios é \. Se o arquivo de destino já existir, ele será substituído. Esse campo é compatível apenas com strings e variáveis String .
• Arquivo— O caminho completo do arquivo que você deseja carregar para o bucket de Armazenamento indicado no campo Nome do Bucket de Armazenamento . Este campo é compatível com variáveis do tipo IResource . Use esse campo quando o arquivo for obtido dinamicamente durante a execução, como um anexo de um email.
• Caminho — O caminho local completo para o arquivo que você quer carregar para o Bucket de Armazenamento especificado. Caminhos relativos são resolvidos com base no diretório de execução em runtime. Este campo é compatível apenas com strings e variáveis String . Use este campo quando o arquivo estiver localizado na pasta do projeto.
• Nome do bucket de armazenamento— O nome do bucket de armazenamento para onde você deseja carregar o arquivo. Este campo é obrigatório. Este campo é compatível apenas com strings e variáveis String .
  Importante:

  Você deve usar um desses campos, já que eles são mutuamente exclusivos. Ao especificar um caminho local, sempre use caminhos de pasta relativos para garantir a compatibilidade entre diferentes estruturas de arquivos nos sistemas Windows e Linux. Por exemplo: newFolder/newFileName.txt.

Painel de Propriedades

Comum

• Continuar ao ocorrer erro— Especifica se a automação deve continuar mesmo quando a atividade gera um erro. Este campo só aceita valores booleanos (True, False). O valor padrão é False. Como resultado, se o campo estiver em branco e um erro for lançado, a execução do projeto será interrompida. Se o valor for definido como True, a execução do projeto continua independentemente de qualquer erro.

  Observação:

  Se esta atividade estiver incluída na atividade Try Catch e o valor da propriedade ContinuarComErro for True, nenhum erro será capturado quando o projeto for executado.

• NomeDaExibição — O nome de exibição da atividade.

• Tempo limite (milissegundos)— Especifica o tempo (em milissegundos) a ser aguardado para que o Orchestrator responda ou para que a transferência do arquivo faça progresso, antes que um erro seja gerado. Ele não limita o tempo de transferência total; portanto, arquivos grandes em conexões lentas ainda são concluídos. O valor padrão é 300.000 milissegundos (5 minutos). A abertura de uma conexão é sempre limitada a 30 segundos.

  Observação:

  Em um tempo limite, a atividade falha com um TimeoutException carregando o código de erro Orchestrator_Sys_Timeout, então Continuar com erro e Repetir escopo se aplicam como a qualquer outro erro. Um valor de 0 ou um número negativo é substituído por 30 segundos, e o cancelamento do trabalho é relatado como um cancelamento em vez de um tempo limite.

  Quando o Orchestrator serve o próprio conteúdo do arquivo em vez de entregar um URL de provedor, que é o caso do armazenamento gerenciado pelo Orchestrator com a Features.Buckets.StorageOffloadRequiresAuth funcionalidade habilitada, o upload também deve terminar no total dentro desse valor.

De

• Arquivo— O caminho completo do arquivo que você deseja carregar para o bucket de Armazenamento indicado no campo Nome do Bucket de Armazenamento . Este campo é compatível com variáveis do tipo IResource . Use esse campo quando o arquivo for obtido dinamicamente durante a execução, como um anexo de um email.
• Caminho — O caminho local completo para o arquivo que você quer carregar para o Bucket de Armazenamento especificado. Caminhos relativos são resolvidos com base no diretório de execução em runtime. Este campo é compatível apenas com strings e variáveis String . Use este campo quando o arquivo estiver localizado na pasta do projeto.
  Importante:

  Você deve usar um desses campos, já que eles são mutuamente exclusivos. Ao especificar um caminho local, sempre use caminhos de pasta relativos para garantir a compatibilidade entre diferentes estruturas de arquivos nos sistemas Windows e Linux. Por exemplo: newFolder/newFileName.txt.

Diversos

• Caminho da pasta— O caminho para a Pasta do Orchestrator que você quer usar com esta atividade. Se deixado vazio, a pasta atual do Orchestrator será usada. Este campo é compatível apenas com strings e variáveis String . Use / como um separador de subpasta para especificar a pasta desejada.
• Privado — Se selecionado, os valores de variáveis e argumentos não são mais registrados no nível da Verbose.

Armazenamento

• Caminho de destino— Apenas projetos do Windows. O caminho no bucket de armazenamento em que o arquivo é carregado, incluindo o nome do arquivo. Um valor que termina com / é usado como uma pasta, como é qualquer valor quando o Nome do arquivo carregado é definido, e o nome do arquivo vem do Nome do arquivo carregado ou do arquivo de origem. Um valor vazio carrega o arquivo para a raiz do bucket. Esse campo é compatível apenas com strings e variáveis String .
• Nome do arquivo carregado— apenas projetos do Windows. O nome do arquivo no bucket de armazenamento. Quando definido, ele é anexado ao Caminho de destino, que é usado como uma pasta. Se deixado em branco, o nome vem do Caminho de destino ou, quando este for uma pasta ou vazio, do arquivo de origem. Se o arquivo de destino já existir, ele será substituído.
• Destino— Windows - Projetos legados apenas. O caminho em que você deseja carregar o arquivo no Bucket de Armazenamento. O separador de diretórios é \. Se o arquivo de destino já existir, ele será substituído. Esse campo é compatível apenas com strings e variáveis String .
• Nome do bucket de armazenamento— O nome do bucket de armazenamento para onde você deseja carregar o arquivo. Este campo é obrigatório. Este campo é compatível apenas com strings e variáveis String .