Carregador de vários arquivos

You can select and upload multiple files using the Multi File Uploader control, which sets the value as an IResource list.

Observação:

Public Apps do not support the Multi File Uploader control.

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 an ILocalResource

Importante:

The following functions have been deprecated and you should no longer use them:

• .toLocalResource
• .toAppsFile

Geral

• Max file size - The maximum file size of each file you can upload. The recommended maximum file size is 10 MB.

  Observação:

  You can upload a maximum of 10 files.

• Allowed file types - The file types you can upload. Use a comma , to separate file extensions. For example, if you write .jpg, .png, .svg, you can only upload these file types. The dot . symbol is not mandatory when listing the file types.

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

• Required - If set to true, app users must provide data in the control. To mark the control as mandatory at runtime, an asterisk (*) is added after the label text.

• Mensagem de erro personalizada - o texto a ser exibido se a propriedade Obrigatório estiver definida como verdadeira e o controle for deixado vazio.

• Hidden - If set to true, hides the control at runtime.

Events

• Value Changed - Configure what happens when a file is added or removed from the selection.

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:

The alignment is dependent on the layout selected for the parent, such as Vertical or Horizontal.

• Label Placement - By default, the label is displayed on top of the control, aligned to the left. You can place it to the left of the control on the same line. The Label Width property configures how wide the label should be, and the Space between property sets the distance between the label and the control.
• Font - The font attributes for both the label and the input text, such as font family, size, color, or style, such as bold, italic, and underline. By default, the control inherits the font family of the immediate parent container, indicated by the keyword Inherited.
• Margin - The margin of the control. By default, a margin of 4px is set. Top/Bottom and Left/Right margin properties are combined. These properties can be detached using the Link button on the right side of the Margin section.
• Size - The width and height of the control. By default, the size is set to auto. To set minimum or maximum values, select the three-dot icon (...).

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	Determines the visibility of the File Uploader control. If set to true, hides the control at runtime.
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	Checks validity of the File Uploader value. If true, indicates it is valid.

Uso do Carregador de arquivos

This example shows how you can use the Multi File Uploader with a storage bucket:

1. Abra um aplicativo existente ou crie um.

• Add a Multi File Uploader control.
• Select Events. In Value Changed, select Define automation.

2. Add a For Each activity that iterates over the file selection.
   • You can use the expression Controls.MainPage.MultiFileUploader.Value.
   • Add an Upload Storage File activity in For Each.
     • Especifique o caminho da pasta do Orchestrator e o nome do compartimento de armazenamento.
     • No campo Arquivo , selecione a expressão currentIResource.
     • No campo Onde carregar , selecione a expressão currentIResource.FullName.
3. Teste ou execute seu aplicativo.

When you run the app and add multiple files in the Multi File Uploader, the app uploads the storage file to the storage bucket.