Apps (アプリ)

ファイルアップローダー

全般

最大ファイルサイズ - ユーザーがアップロードできるファイルの最大サイズです。推奨される最大ファイルサイズは 10 MB です。
許可されるファイルの種類 - ユーザーがアップロードできるファイルの種類です。ファイルの拡張子を区切るには「,」を使用します。たとえば、「.jpg, .png, .svg」と記述すると、これらの種類のファイルだけがアップロード可能となります。ファイルの種類のリストを取得する場合、. 記号は必須ではありません。
ヘルパーテキスト - 実行時に表示されるヘルプテキストです。
ツールチップ - アプリユーザーがコントロール上でホバーしたときに表示されるテキストです。コントロール上で追加情報を提供するには、このツールチップを使用します。
ラベル - コントロールの表示テキストです。
必須 - true の場合、アプリユーザーはコントロール内のデータを指定する必要があります。実行時にコントロールが必須であることを示すため、ラベルテキストの後にアスタリスク * が追加されます。
カスタムエラーメッセージ - [必須] プロパティが true に設定され、コントロールが空のままの場合に表示するテキストです。
非表示 - true の場合、実行時にコントロールが非表示になります。
無効化 - true の場合、実行時にコントロールを無効化します。

注: [ファイルアップローダー] コントロールで一度にアップロードできるファイルは 1 つだけです。

イベント

ファイルの追加時 - ファイルが追加された際の挙動を設定します。
ファイルの削除時 - ファイルが削除された際の挙動を設定します。

スタイル

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

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

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

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

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

アプリでストレージバケットと、ファイルフィールドを持つ Data Service エンティティを追加します。
[ファイルアップローダー] と [ボタン] コントロールを追加します。
AppsFile 型の変数を作成し、「SB_file_var」という名前を付けます。この変数を使用して、ストレージバケットからダウンロードしたファイルを格納します。
[ストレージバケットへファイルをアップロード] ルールを、[ボタン] コントロールの [クリック時] イベントに追加します。
1. [アップロードするファイル] フィールドで、[ファイルアップローダー] コントロールでアップロードされるファイルを次のように参照します。
```
MainPage.FileUploader.ValueMainPage.FileUploader.Value
```
2. [ストレージバケット] フィールドで、アプリに追加されている Orchestrator のストレージバケットを参照します。
3. 必要に応じて、[完了時] フィールドに [メッセージを表示] ルールを追加して、アップロードが正常に完了したことが通知されるようにできます。
[ストレージバケットからファイルをダウンロード] ルールを、[ボタン] コントロールの [クリック時] イベントに追加します。
1. [ストレージバケット] フィールドで、アプリに追加されている Orchestrator のストレージバケットを参照します。
2. [ファイルの名前 (拡張子を含む)] フィールドに、ユーザーがダウンロードするファイルの名前を入力します。
3. [アプリの変数にファイルを割り当てる] で、作成済みの変数「SB_file_var」を参照します。
4. 必要に応じて、[完了時] フィールドに [メッセージを表示] ルールを追加して、ダウンロードが正常に完了したことが通知されるようにできます。
[ラベル] コントロールをアプリに追加します。
1. コントロールの [テキスト] フィールドで、ダウンロードされるファイルの名前を次のように参照します。
```
SB_file_var.NameSB_file_var.Name
```
  - "SB_file_var" は、ダウンロードしたファイルに関するデータの格納に使用する変数です。
アプリを実行し、[ファイルアップローダー] コントロールを使用してファイルをアップロードします。ボタンをクリックします。