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

[ マルチ ファイル アップローダー ] コントロールを使用して複数のファイルを選択してアップロードできます。このコントロールは、値を IResource リストとして設定します。

注:

パブリック Apps では [ マルチ ファイル アップローダー ] コントロールはサポートされていません。

IResource を使用する

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

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

重要:

以下の関数は非推奨となったため、今後は使用しないでください。

• .toLocalResource
• .toAppsFile

全般

• 最大ファイル サイズ - アップロードできる各ファイルの最大ファイル サイズです。推奨される最大ファイル サイズは 10 MB です。

  注:

  アップロードできるファイル ID は最大 10 個です。

• 許可されるファイルの種類 - アップロードできるファイルの種類です。ファイルの拡張子を区切るには、コンマ , を使用します。たとえば、 .jpg、 .png、 .svgと記述すると、これらの種類のファイルのみをアップロードできます。ファイルの種類のリストを取得するときに、ドット . 記号は必須ではありません。

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

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

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

• 必須 - true に設定されている場合、アプリ ユーザーはコントロール内のデータを指定する必要があります。実行時にコントロールが必須であることを示すため、ラベル テキストの後にアスタリスク (*) が追加されます。

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

• 非表示 - true に設定すると、実行時にコントロールが非表示になります。

イベント

• 値の変更時 - 選択項目にファイルが追加または削除された際の挙動を設定します。

スタイル

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

注:

配置は、親に対して選択したレイアウト ( [縦方向 ]、[ 横方向] など) によって異なります。

• ラベル配置 - 既定では、ラベルはコントロールの左揃えで表示されます。ラベルは、コントロールの左横に配置することもできます。[ ラベル幅 ] プロパティはラベルの幅を設定し、[ 間隔 ] プロパティはラベルとコントロールの間の距離を設定します。
• フォント - ラベルと入力テキストの両方のフォント属性です (フォント ファミリ、サイズ、色、スタイル (太字、斜体、下線など) など)。既定では、このコントロールの直接の親コンテナーのフォント ファミリが継承されます。その場合、フォント に Inherited と表示されます。
• マージン - コントロールのマージンです。既定では 4px のマージンが設定されています。[上/下] および [左/右] のプロパティがそれぞれ組み合わされています。これらのプロパティの組み合わせは、[マージン] セクションの右側にある [リンク] ボタンをクリックして解除できます。
• サイズ - コントロールの幅と高さです。既定では、サイズは [ auto] に設定されています。最小値または最大値を設定するには、3 点リーダー メニューのアイコン (...)を選択します。

VB のプロパティ

VB のプロパティ	データ型	説明
Tooltip	文字列	ユーザーが [ファイル アップローダー] にホバーしたときに表示される情報テキストです。
Label	文字列	[ファイル アップローダー] のラベルです。通常は、コントロールの前に表示されるテキストです。
Value	IResource	現在アップロードされているファイルの名前です。
Required	Boolean	ファイルのアップロードを必須にするかどうかを指定します。
RequiredErrorMessage	文字列	ファイルのアップロードが必須であるにもかかわらず指定されていない場合に表示されるメッセージです。
Hidden	Boolean	[ ファイル アップローダー ] コントロールの表示/非表示を指定します。true に設定すると、実行時にコントロールが非表示になります。
Disabled	Boolean	[ファイル アップローダー] コントロールを対話可能にするかどうかを指定します。true に設定すると、実行時に [ファイル アップローダー] との対話が無効化されます。
IsValid	Boolean	[ファイル アップローダー] の値の有効性を確認します。true の場合、値が有効であることを示します。

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

この例では、[ マルチ ファイル アップローダー ] でストレージ バケットを使用する方法について説明します。

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

• [ マルチ ファイル アップローダー ] コントロールを追加します。
• [ イベント] を選択します。[ 値の変更時] で [ オートメーションを定義] を選択します。

2. ファイル選択を反復処理する [ 繰り返し (コレクションの各 要素)] アクティビティを追加します。
   • 式 [ Controls.MainPage.MultiFileUploader.Value] を使用できます。
   • [繰り返し (コレクションの各要素)] に [ストレージ ファイルをアップロード] アクティビティを追加します。
     • Orchestrator のフォルダー パスとストレージ バケット名を指定します。
     • [ ファイル ] フィールドで、式 [ currentIResource] を選択します。
     • [ アップロード先 ] フィールドで式 [ currentIResource.FullName] を選択します。
3. アプリをテストまたは実行します。

アプリを実行し、[ マルチ ファイル アップローダー] に複数のファイルを追加すると、ストレージ ファイルがストレージ バケットにアップロードされます。