アクティビティ

フォームデザイナーのコントロールについて

コンポーネントをドラッグアンドドロップするか、フォームコンポーネントの [編集] アイコンをクリックすると、設定ウィザードが開きます。フォームコンポーネントの種類に応じて、ウィザードの特定のタブが利用可能になり、そのタブを使用してフォームをカスタマイズできます。UiPath フォームデザイナーで利用可能なすべてのタブとその全般的なプロパティを以下に示します。

表示

ラベル

コンポーネントのタイトルです。

ラベル位置

フィールドのラベルの位置です。

説明

入力フィールドの下に表示されるテキストです。

ツールチップ

フィールドの横にツールチップアイコンを追加します。ツールチップのテキストを入力します。

非表示

コンポーネントをフォームレンダラーで非表示にします。

ラベルを非表示

コンポーネントのラベルを非表示にします。

無効

フォームのフィールドを無効化します。

プレースホルダー

フィールドが空の場合に表示されるテキストです。

プレフィックス

フィールドの前に表示されるテキストです。

サフィックス

フィールドの後に表示されるテキストです。

表ビュー

オンの場合、送信内容の表ビュー内にこの値を表示します。

定型入力

定型入力を使用すると、あらかじめ定義された形式を提供できます。電話番号フィールドの場合、既定の定型入力の形式は (999) 999-9999 です。

定型入力の要素は次のとおりです。

9 - 数値
a - アルファベット
***** - 英数字

データ

既定値

ユーザーが操作する前のフィールドの値です。プレースホルダーテキストは既定値で上書きされます。

複数値

オンにすると、複数の値をフィールドに追加できます。フィールドに [さらに追加] ボタンが表示されます。

コンテンツ

コンポーネントのコンテンツを入力するセクションです。

形式

このフィールドの保存に使用する moment.js の形式です。例: HH:mm:ss

変更時に再描画

フォーム内の別のコンポーネントが変更された場合にこのコンポーネントを再描画します。コンポーネントを再描画するイベントをドロップダウンリストから選択します。既定で選択するイベントは、[変更時] と [送信] です。

検証

Required

オンにすると、このフィールドでは値が必須になります。

検証実行

このコンポーネントがフロントエンド検証をトリガーするタイミングを指定します。ドロップダウンリストからイベント ([変更] または [ぼかす]) を選択します。

最小文字数

このフィールドの長さの最低要件です。

最長文字数

このフィールドの長さの最長要件です。

最小の単語の長さ

このコンポーネントに追加可能な最小の語数です。

最大の単語の長さ

このフィールドに追加可能な最大の語数です。

正規表現パターン

これはフォームの送信前にコンポーネントが合格する必要がある正規表現パターンです。

エラーラベル

検証エラーメッセージが表示されるときに表示するラベルです。

カスタムエラーメッセージ

エラーが発生した場合に表示される、カスタマイズされたエラーメッセージです。

フィールドキー

プロパティ名

ワークフローフィールドコレクションにおけるこのコンポーネントの名前です。

条件

フォームデザイナーの [条件] タブでは、フォーム内のコンポーネントに条件を設定して、コンポーネントを表示または非表示にすることができます。

[条件] タブには、次の[シンプル]セクションがあります。

[条件] タブの [シンプル] セクションでは、コンポーネントを、別のコンポーネントの値に基づいて表示または非表示にすることができます。

[シンプル] セクションは、次の 3 つのフィールドで構成されます。

このコンポーネントを表示 - このドロップダウンリストから以下を選択します。
- コンポーネントを表示する条件を設定する場合は [True] を選択します。
- コンポーネントを非表示にする条件を設定する場合は [False] を選択します。
条件として使用するフォームコンポーネント - このドロップダウンリストから、条件として機能させるフォーム内のコンポーネントを選択します。
条件として使用する値 - コンポーネントを表示または非表示にする条件となる値を入力します。

フォームアクティビティに関する、簡単な条件の作成を説明するチュートリアルについてはこちらをご覧ください。

論理

フォームデザイナーの [論理] タブでは、条件や高度な論理スクリプトを作成し、それによって、選択したフォームコンポーネントのステートや動作を変更できます。

高度な論理を使用すると、フォームコンポーネントのコントロール、外観、操作感を動的に変更できます。

フォームの論理は、トリガーとアクションの 2 つの部分で構成されます。

トリガー

論理のトリガーは、アクションが発生する条件です。たとえば、チェックボックスオプションが選択されている場合にのみ、特定のフォームフィールドを表示できます。この場合、チェックボックスオプションがトリガーになり、フォームフィールドの表示がアクションになります。

論理トリガーには次の 4 種類があります。

トリガーの種類	説明	例
Simple	1 つのトリガーフォームコンポーネントと値を定義します。
JavaScript	フォームコンポーネントまたはフォームデータの JavaScript 論理を指定します。ループや動的な動作など、複雑なロジックを作成するには、JavaScript 構文を使用します。
JSON 論理	フォームコンポーネントまたはフォームデータの JSON 論理を指定します。 JavaScript を使用できない場合に推奨されます。ループや動的な動作をサポートすることはできません。
イベント	コンポーネントイベントを定義します。対応するコンポーネントによってこのイベントが生成されると、目的のアクションがトリガーされます。

操作

論理アクションは、設定した論理条件 (トリガー) に基づいて発生させるフォームコンポーネントの動作です。たとえば、特定の年齢のユーザーに対してボタンをアクティブ化できます。この場合、年齢範囲がトリガーになり、ボタンのアクティブ化がアクションになります。

論理アクションには、次の 4 種類があります。

アクションの種類	説明	例
プロパティ	トリガーは、利用可能なコンポーネントのプロパティ (ツールチップ、説明、CSS クラスなど) のいずれかを変更します。利用可能なプロパティは、トリガーコンポーネントの種類によって異なります。
値 (Value)	トリガーによって、対応するコンポーネントの値を変更します。アクションは JavaScript 構文を使用して定義する必要があります。
コンポーネントスキーマをマージ	トリガーによって、コンポーネント JSON で見つかったコンポーネントスキーマパラメーターを変更します。変更できるスキーマパラメーターを確認するには、対応するコンポーネント上でホバーして [JSON を編集] をクリックします。 1 つのアクション内で複数のパラメーターを変更できます。
カスタムアクション	JavaScript のトリガーの種類を定義する場合と同じように、JavaScript 構文を使用してカスタムアクションを定義します。	NA

テンプレート

[テンプレート] タブは、編集グリッド コンポーネント専用です。フッター テンプレートにより、JavaScript を使用してグリッドをカスタマイズできます。フッターの外観を変更できます。

フッターテンプレート

編集グリッド コンポーネントのフッターのレンダリングに使用される Lodash テンプレートです。

以下の 2 つの変数を使用できます。

value - 行データの配列です。
components - グリッド内のコンポーネントの配列です。

ファイル

[ファイル] タブは、ファイル コンポーネント専用です。[ファイル] タブでは、特定の設定とプロパティを使用してファイル コンポーネントをカスタマイズできます。

以下が [ファイル] タブで利用可能なプロパティです。

ディレクトリ - このコンポーネントにアップロードされたすべてのファイルを、指定したディレクトリに配置します。文字列は、/ で終わる必要があります。
アップロードのみ - ユーザーにファイルのアップロードのみを許可します。オンにすると、ダウンロードオプションが使用できなくなります。
ファイルの種類 - ユーザーがアップロードするファイルの種類を分類するために、ファイルの種類を指定できます。ユーザーが複数種類のファイルをアップロードする際に、ユーザーにアップロードする各ファイルの種類を指定して欲しい場合に推奨します。
ファイルパターン - アップロード可能なファイル拡張子を指定できます。指定されていない他のファイル拡張子はアップロードされません。
ファイルの最小サイズ - アップロードするファイルの最小サイズを設定します。
ファイルの最大サイズ - アップロードするファイルの最大サイズを設定します。

ファイルのパターンとサイズの指定方法についてくわしくは、GitHub のこちらのページをご覧ください。