Carregador de Arquivo

O UiPath Apps agora oferece suporte ao formato IResource para manipulação de arquivos.

Trabalhando com o IResource

Se você obter um arquivo como um ILocalResource, ele será convertido automaticamente em um IResource usando:

JobAttachment.fromResource(file) // file is a ILocalResource

Importante:

As seguintes funções foram descontinuadas e não devem mais ser usadas:

• .toLocalResource
• .toAppsFile

Navegação de Página

Você pode navegar programaticamente até uma página específica dentro do Visualizador de documentos usando:

appsFile.NavigateToPage(pageNumber)

Geral

• Tamanho máximo do arquivo — o tamanho máximo do arquivo que os usuários podem carregar. O tamanho de arquivo máximo recomendado é de 10 MB.
• Tipos de arquivos permitidos — os tipos de arquivos que os usuários podem carregar. Use "," para separar extensões de arquivos. Por exemplo, se você escrever .jpg, .png, .svg, somente esses tipos de arquivos serão para carregamento. O símbolo . não é obrigatório ao se listar os tipos de arquivos.
• Texto de ajuda — o texto de ajuda a ser exibido no tempo de execução.
• Dica de ferramenta — o texto a ser exibido quando um usuário de aplicativo passa o mouse sobre o controle. Use a dica para fornecer informações adicionais sobre o controle.
• Rótulo — o texto de exibição do controle.
• Obrigatório — se verdadeiro, os usuários de aplicativos devem fornecer dados no controle. Para marcar o controle como obrigatório no tempo de execução, um asterisco * é adicionado após o texto do rótulo.
• Mensagem de erro personalizada - o texto a ser exibido se a propriedade Obrigatório estiver definida como verdadeira e o controle for deixado vazio.
• Oculto— se verdadeiro, oculta o controle no tempo de execução.
• Desabilitado — se verdadeiro, desabilita o controle no tempo de execução.
  Observação:

  • O controle do Seletor de arquivos pode carregar apenas um arquivo por vez.
  • O Apps em um navegador móvel não oferece suporte a uploads de fotos baseadas na câmera nativa. Em vez disso, salve a foto no seu dispositivo e, em seguida, carregue o arquivo salvo usando o controle Carregador de arquivos.

Events

• Arquivo adicionado — Configure o que acontece quando um arquivo é adicionado.
• Arquivo removido — Configure o que acontece quando um arquivo é removido.

Estilo

• Alinhamento de controle — Por padrão, herda o alinhamento parent. É possível definir outro alinhamento que não o pai. Para voltar ao alinhamento padrão pai, desmarque as opções substituídas.

  Observação:

  O alinhamento depende do layout selecionado para o pai (Vertical vs Horizontal).

• Posicionamento do rótulo — por padrão, o rótulo é definido para ser exibido na parte superior do controle, no lado esquerdo. Você pode colocá-lo à esquerda do controle, na mesma linha. A propriedade Largura do rótulo configura a largura do rótulo e a propriedade Espaço entre define a distância entre o rótulo e o controle.

• Fonte — os atributos de fonte para o texto do rótulo e da entrada, como família de fontes, tamanho, cor ou estilo (Necessário, Itálico e Sublinhado). Por padrão, o controle herda a família de fontes do contêiner pai imediato, que é indicado pela palavra-chave “herdado”.

• Margem — a margem do controle. Por padrão, uma margem de 4px é definida. As propriedades Top/Bottom e Left/Right são combinadas. Essas propriedades podem ser desanexadas usando o botão Link no lado direito da seção Margem .

• Tamanho — a largura e a altura do controle. Por padrão, o tamanho é definido como auto. Para definir valores mínimos ou máximos, clique no ícone de três pontos (*).

Uso do Carregador de arquivos

Este exemplo mostra como você pode usar o Carregador de arquivos com um bucket de armazenamento e com um campo de arquivos de uma entidade.

1. Em seu aplicativo, adicione um Bucket de armazenamento e uma entidade Data Service que tem campos de arquivos.
2. Adicione um Carregador de arquivos e um controle de Botão.
3. Crie uma variável do tipo IResource e nomeie-a "SB_file_var". Use essa variável para armazenar o arquivo baixado do bucket de armazenamento.
4. Adicione a regra Carregar arquivo no bucket de armazenamento ao evento Clicado em do controle de botão.
   1. No campo Arquivo a carregar, faça referência ao arquivo carregado por meio do controle Carregador de arquivos, da seguinte forma:

      MainPage.FileUploader.Value
      

   2. No campo Bucket de armazenamento, faça referência ao bucket de armazenamento do Orchestrator que você adicionou anteriormente a seu aplicativo.
   3. Opcionalmente, no campo Quando concluído, você pode adicionar uma regra Mostrar mensagem para informar que o carregamento foi concluído com sucesso.
5. Adicione a regra Baixar arquivo do bucket de armazenamento ao evento Clicado em do controle de botão.
   1. No campo Bucket de armazenamento, faça referência ao bucket de armazenamento do Orchestrator que você adicionou anteriormente a seu aplicativo.
   2. No campo Nome do arquivo (com extensão), escreva o nome do arquivo que seus usuários devem baixar.
   3. Na variável Atribuir arquivo a aplicativo, faça referência à variável criada anteriormente "SB_file_var".
   4. Opcionalmente, no campo Quando concluído, você pode adicionar uma regra Mostrar mensagem para informar que o download foi concluído com sucesso.
6. Adicione um controle de Rótulo a seu aplicativo.
   1. No campo Texto do controle, faça referência ao nome do arquivo baixado, da seguinte forma, onde "SB_file_var" é a variável usada para armazenar dados sobre o arquivo baixado:

      SB_file_var.Name
      

7. Execute seu aplicativo e carregue um arquivo usando o controle Carregador de arquivos. Clique no botão.

Uma mensagem de sucesso deve aparecer na parte superior de sua tela, informando que o carregamento/download foi concluído com sucesso. Agora verifique o bucket de armazenamento no Orchestrator e você deve ver o arquivo que você carregou usando o controle Carregador de arquivos.

Simultaneamente, clicar no botão baixou o arquivo indicado na regra Baixar arquivo do bucket de armazenamento em seu dispositivo local e armazenou seus dados em uma variável. O controle de Rótulo exibe o nome do arquivo baixado.

Propriedades VB

Propriedade do VB	Tipo de dados	Description
Tooltip	String	Texto informativo que aparece quando o usuário passa o mouse sobre o Carregador de arquivos.
Label	String	O rótulo do Carregador de arquivo, normalmente o texto exibido precedendo o controle.
Value	IResource	Nome do arquivo carregado atualmente.
Required	Booleano	Especifica se o upload do arquivo é obrigatório.
RequiredErrorMessage	String	Mensagem exibida quando o upload do arquivo é necessário, mas não foi fornecido.
Hidden	Booleano	Determina a visibilidade do controle Carregador de arquivos . Se definido como verdadeiro, oculta o controle no tempo de execução.
Disabled	Booleano	Determina se é possível interagir com o controle Carregador de arquivos . Se definido como verdadeiro, desabilita a interação com o Carregador de arquivos no runtime.
IsValid	Booleano	Verifica a validade do valor do Carregador de arquivo. Se for verdadeiro, indica que é válido.