ファイルアップロードウィジェットを使用して、1 つまたは複数のファイルを ThingWorx リポジトリにアップロードできます。次のいずれかの方法で、ファイルをアップロードするようウィジェットを設定できます。

さらに、検証規則を設定してファイルタイプ、サイズ、量などの制限を適用することもできます。

ドラッグアンドドロップ

このモードでファイルをドラッグするか選択すると、DisableInstantUpload プロパティの値に基づいて、ファイルがただちにアップロードまたはリストされます。必要に応じて、AllowInstantUpload プロパティを無効にして、ボタンまたはウィジェットの Upload サービスを使用してファイルを手動でアップロードできます。「置換」ボタンも表示され、リポジトリにアップロードされているファイルを置き換えることができます。

「ブラウズ」ボタンのみ

デフォルトでは、選択したファイルは自動的にリポジトリにアップロードされます。各ファイルのアップロードの進行状況を示す進行状況バーが表示されます。

ユーザーが選択したファイルをアップロードの前に確認できるようにするには、ウィジェットのプロパティ DisbaleInstantUpload および ShowUploadButton を true に設定します。ランタイムで、ユーザーは「アップロード」ボタンをクリックすることでアップロードを開始できます。必要に応じて、マッシュアップ、関数、またはウィジェットのイベントをウィジェットの Upload サービスにバインドすることで、特定の条件に基づいてアップロードを開始します。

削除ボタンを追加できます。ユーザーはこれを使用して、アップロードを停止し、選択したファイルをリストから除去できます。アップロードされているファイルはリストから除去されるだけで、ThingWorx リポジトリからは削除されません。リポジトリからファイルを削除するには、カスタムデータサービスを使用します。

デフォルトでは、ユーザーは用意されている制御を使用して、ファイルのアップロード先となるリポジトリとフォルダを選択できます。リポジトリやフォルダパスをユーザーが選択できないようにするには、プロパティ ShowRepositoryPath および ShowRepositorySelector を false に設定します。ウィジェットのプロパティ RepositoryName および Path を使用して、デフォルトのリポジトリ名とフォルダを指定できます。プラットフォームのリポジトリの詳細については、ファイルリポジトリの管理を参照してください。

デフォルトでは、ユーザーはランタイムで任意のサイズのファイルをアップロードできます。「検証」パネルにあるウィジェットの MaxFileSize プロパティを使用して、アップロード可能な最大ファイルサイズを制限できます。ファイルが最大許容サイズよりも大きい場合の失敗メッセージをカスタマイズするには、プロパティ MaxFileSizeFailureTitle および MaxFileSizeFailureMessage を設定します。

検証プロパティ MaxUploadSize を使用して、アップロードの合計サイズを制限できます。アップロードの合計サイズが上限を超えている場合、失敗のメッセージが表示されます。エラーメッセージをカスタマイズするには、プロパティ MaxUploadSizeFailureMessage および MaxUploadSizeFailureTitle を使用します。

「検証」パネルにあるウィジェットの MaxFileSize プロパティを使用して、アップロード可能なファイルの最大数を制限できます。選択したファイルの数が最大数を超えると、失敗のメッセージが表示されます。エラーメッセージをカスタマイズするには、プロパティ MaxNumberOfFilesFailureMessage を使用します。

AllowedFileTypes プロパティを使用して、特定のファイルフォーマットを受け入れるようにウィジェットを設定できます。複数のファイルタイプをコンマで区切って追加できます。たとえば、.pdf, .png と入力すると、PDF ファイルと PNG ファイルのみが許可されます。サポートされていないファイルタイプが追加されたときに表示されるエラーメッセージをカスタマイズするには、プロパティ AllowedFileTypesMessage および AllowedFileTypesTitle を使用します。

ファイルをドロップ領域にドラッグしたり、ラベルをクリックすることでファイル選択ダイアログボックスを開いたりできます。領域の色が自動的に変わり、ファイルをドロップできることが示されます。

次のプロパティを使用して、ドロップ領域を設定できます。

次の表に、「プロパティ」パネルで使用可能なプロパティを示します。

検証をサポートしているその他のウィジェットとは異なり、ファイルアップロードでは検証および基準メッセージがサポートされていません。基準メッセージを定義し、ShowFailureMessage を有効にすることで、ValidationState が Invalid の場合に失敗メッセージを表示できます。

共通の検証プロパティの使用の詳細については、テキストフィールドウィジェット (テーマ指定可能)を参照してください。

次の表に、ThingWorx 9.3.4 以降の「検証」パネルで使用可能な検証プロパティを示します。