マルチ ファイル アップローダー

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

注:

Public Apps do not support the Multi File Uploader control.

IResource を使用する

ファイルを ILocalResource として取得すると、ファイルは以下を使用して自動的に IResource に変換されます。

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

重要:

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

• .toLocalResource
• .toAppsFile

全般

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

  注:

  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.

• ヘルパー テキスト - 実行時に表示されるヘルプ テキストです。

• ツールチップ - アプリ ユーザーがコントロール上でホバーしたときに表示されるテキストです。コントロール上で追加情報を提供するには、このツールチップを使用します。

• ラベル - コントロールの表示テキストです。

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

• カスタム エラー メッセージ - [必須] プロパティが true に設定され、コントロールが空のままの場合に表示するテキストです。

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

イベント

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

スタイル

• コントロールの配置 - 既定では、親の配置を継承します。親とは異なる配置を設定することもできます。既定の親の配置に戻すには、現在優先されているオプションの選択を解除します。

注:

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 (...).

VB のプロパティ

VB のプロパティ	データ型	説明
Tooltip	文字列	ユーザーが [ファイル アップローダー] にホバーしたときに表示される情報テキストです。
Label	文字列	[ファイル アップローダー] のラベルです。通常は、コントロールの前に表示されるテキストです。
Value	IResource	現在アップロードされているファイルの名前です。
Required	Boolean	ファイルのアップロードを必須にするかどうかを指定します。
RequiredErrorMessage	文字列	ファイルのアップロードが必須であるにもかかわらず指定されていない場合に表示されるメッセージです。
Hidden	Boolean	Determines the visibility of the File Uploader control. If set to true, hides the control at runtime.
Disabled	Boolean	[ファイル アップローダー] コントロールを対話可能にするかどうかを指定します。true に設定すると、実行時に [ファイル アップローダー] との対話が無効化されます。
IsValid	Boolean	Checks validity of the File Uploader value. If true, indicates it is valid.

ファイル アップローダーを使用する

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

1. 既存のアプリを開くか、新しいアプリケーションを作成します。

• 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.
     • Orchestrator のフォルダー パスとストレージ バケット名を指定します。
     • [ ファイル ] フィールドで、式 [ currentIResource] を選択します。
     • [ アップロード先 ] フィールドで式 [ currentIResource.FullName] を選択します。
3. アプリをテストまたは実行します。

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