フィールドを検証するルールの作成
上の例のように動作するルールを作成する方法を見てみましょう。「人員数」フィールドの値が1000を超える場合に、メッセージをフォームに表示します。
検証ルールを作成するには:
- フォームを含むページを開き、「検証」タブを開きます。
ページ・デザイナでページが開いているときにタブが表示されない場合は、フォームが定義されている「レイアウト」を開き、「検証」タブを開きます。
- 新しいビジネス・ルールを作成します。
- 一部のルールがすでに定義されている場合は、
をクリックし、ラベルと説明を入力します。 - まだルールがない場合は、「+検証」をクリックし、ポップアップにラベルと説明を入力します。
「作成」をクリックします。
- 一部のルールがすでに定義されている場合は、
- 「編集」をクリックし、ルールの条件を指定します。 完了したら、「完了」をクリックします。
標準の条件ビルダーを使用して検証ルールの条件を作成するか、「拡張式の使用」をクリックして拡張式ビルダー(「より複雑な条件の作成」)を使用できます。
このルールでは、2つの条件を作成: ジョブ・ロールは「プロジェクト・マネージャ」で、「人員数」の値は1000より大きくする必要があります。 ルールは、次の両方の条件が満たされた場合に適用されます:
- メッセージの詳細を指定します。
条件が満たされると、フォームの「予算金額」フィールドに警告メッセージ「予算の更新」が表示されます。
- 「サマリー」および「詳細」フィールドにメッセージ・テキストを入力します。
これらの2つのフィールドを使用して、メッセージのテキストを入力します。
- サマリー メッセージ・ダイアログのタイトルに「サマリー」テキストが表示されます。 インライン警告を使用している場合、「サマリー」フィールドのテキストは、ページに表示されませんが、必須フィールドです。
- 詳細 詳細テキストは実際のテキスト・メッセージです。 このテキストは、インライン警告を表示している場合はフォームにインラインで表示され、インラインで表示されていない場合はメッセージ・ダイアログに表示されます。
メッセージ・テキストは、「This number is invalid」などの単純な文字列にすることも、フィールド値やコンテキスト・パラメータをメッセージに渡して、よりターゲットを絞ったメッセージに書き込むこともできます。 たとえば、「詳細」フィールドに次のようなものを追加できます:
[[ Restricted feedback applies to${$fields.PersonName.$value()}who is part of${$objectContext.Department}}. Select someone from the department without feedback restrictions.]]「サマリー」および「詳細」テキストの翻訳を生成するには、テキスト・フィールドにマウス・ポインタを重ねてから、
をクリックして「翻訳可能文字列」ポップアップを開きます:
「翻訳可能文字列」ポップアップにパラメータを追加することはできませんが、
toをクリックして式エディタを開き、パラメータを使用する場合は翻訳オブジェクトを手動で編集できます。 詳細は、「表示テキストの変換キーの生成」を参照してください。
- 「ターゲット・フィールド」ドロップダウン・メニューにインライン・メッセージを表示するフィールドを選択します。
ターゲット・フィールドを選択せず、フォームに編集可能なフィールドが1つのみ含まれている場合、そのメッセージが自動的に適用されます。
ノート:
次の場合、メッセージはインラインで表示されません:
- ターゲット・フィールドは選択せず、フォームに複数のフィールドがあります。
- 複数のターゲット・フィールドを選択しました。
メッセージをインラインではなくダイアログ・ボックスに表示する場合は、メッセージを処理するようにページ内のメッセージ・コンポーネントを手動で構成する必要があります。
- 「サマリー」および「詳細」フィールドにメッセージ・テキストを入力します。
ルールに別のメッセージを追加するには、別のフィールドに異なるテキストが表示されているメッセージを記述し、「+メッセージ」をクリックして新しいメッセージを作成し、その詳細を指定します。
ルールが機能しているかどうかを確認するには、ページをライブ・モードで表示し、ルールをトリガーする値を入力してフォームをテストします。
