カスタムフォームおよびフィールドへの論理ルールの追加
ロジックルールを使用すると、フォームのフィールドをさらにカスタマイズできます。
例えば、ユーザーが入力する際に選択した項目に基づいて、カスタムフォームのフィールドやセクションを表示したりスキップしたりできます。
アクセス要件
| table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header | |
|---|---|
| Adobe Workfront パッケージ |
高度な表示、デフォルト値、条件付き書式設定または編集可能ロジックを適用するには：ワークフローPrime以上 その他すべてのロジックタイプを適用するには：WorkfrontまたはWorkflow パッケージ |
| Adobe Workfront プラン |
標準 プラン |
| アクセスレベル設定 | カスタムフォームへの管理アクセス権 |
詳しくは、Workfront ドキュメントのアクセス要件を参照してください。
ロジックインジケーターアイコン
カスタムフォームには、フィールドにロジックが適用されるタイミングを示すアイコンが表示されます。
フォームデザイナーのヘッダーの「ロジックを表示」をクリックして、様々なフィールドロジックタイプのアイコンを表示または非表示にします。
表示およびスキップロジックのみ場合は、フィールドを選択して、フィールド設定に既存のロジックルールを表示します。
表示ロジックとスキップロジックの使用に関する考慮事項
-
カスタムフィールド、ウィジェットまたはセクション区切りに表示ロジックを追加するには、フォーム上で、1 つ以上の複数選択フィールド（ラジオボタン、ドロップダウンまたはチェックボックス）をその前に配置する必要があります。
カスタムフォームのカスタムフィールドとウィジェットについて詳しくは、 カスタムフォームの作成を参照してください。 -
スキップロジックはウィジェットやセクション区切りに追加することはできません。 追加できるのは、複数選択フィールド（ラジオボタン、ドロップダウンまたはチェックボックス）のみです。
-
表示またはスキップロジックを適用して、マルチオプションフィールドの選択肢を表示または非表示にすることはできません。 例えば、別のフィールドの表示またはスキップロジックに基づいて、ドロップダウン、チェックボックスグループ、ラジオボタンのフィールドに表示される選択肢を制限することはできません。
-
カスタムフィールドに関して、次の内容がすべてが該当する場合、カスタムフィールドには表示ロジックとスキップロジックの両方を追加できます。
- 複数選択フィールド（ラジオボタン、ドロップダウンまたはチェックボックス）であること
- 前に複数選択フィールドがあるもの
- 後に別のカスタムフィールドがあるもの
-
表示ロジックまたはスキップロジックを含むフォームをコピーすると、ロジックは新しいカスタムフォームにコピーされます。
-
オブジェクトを一括編集する場合、スキップまたは非表示にされたフィールドを含め、すべてのカスタムフィールドが「オブジェクトを編集」ボックスに表示されます。
-
カスタムフォームで表示ロジックのルールを作成する際は、次の点に注意してください。
- 表示ロジックのステートメントに含まれていないカスタムフィールドは、デフォルトで、カスタムフォームに表示されます。
- 複数フィールドの表示ロジックステートメントを作成できます。
- セクション区切りの下のすべてのフィールドに表示ロジックが適用されていて、そのロジックの結果としてフィールドがすべて非表示になっている場合、セクション全体がカスタムフォーム上で非表示になります。
表示ロジックをカスタムフォームに追加
ユーザーが複数選択フィールドで特定の値を選択した場合、表示ロジックはフォームに表示されるカスタムフィールドを定義します。 ロジックはターゲットフィールドに追加され、値が選択されている場合にのみ表示されます。
-
Adobe Workfrontの左上隅にあるメインメニュー アイコン
-
「カスタムフォーム」をクリックします。
-
新規カスタムフォームを作成するか、既存のフォームを開きます。 詳しくは、 カスタムフォームの作成を参照してください。
-
必要に応じて、フォームにフィールドを追加します。 少なくとも1つの複数選択フィールド（ラジオボタン、ドロップダウン、チェックボックス）が、表示されるターゲットフィールドの前に配置されていなければなりません。
-
ターゲットフィールドを選択し、ロジックを追加をクリックします。
-
ロジックビルダーの「表示」タブを選択します。
-
「表示ルールを追加」をクリックします。
-
ビルダーでロジックステートメントを作成するには、次の手順に従います。
-
1 つ目のオプションは、定義するフィールドを選択することです。 これは、ターゲットを表示する選択値を含むフィールドです。 複数選択フィールドにする必要があります。
-
2 つ目のオプションは、選択値を選択することです。 そのフィールドに既に定義されている値のみを使用できます。
-
3 つ目のオプションは、選択済みまたは 未選択 です。 「選択済み」を選択すると、この値が選択された場合に、ターゲットフィールドが表示されます。 「未選択」を選択すると、定義フィールドで他の値が選択された場合に、ターゲットフィールドが表示されます。
-
AND ルールをロジックステートメントに追加するには、作成したばかりのルールのすぐ下にある「ルールを追加」をクリックします。 同じプロンプトに従って、ルールを作成します。 ターゲットフィールドを表示するには、すべての AND ルールを満たす必要があります。
-
OR ルールをロジックステートメントに追加するには、ロジックビルダーの下部付近にあ「ルールを追加」をクリックします。 次に、OR エリア内の「ルールを追加」をクリックし、同じプロンプトに従ってルールを作成します。 1 つの OR ルールが満たされると、ターゲットフィールドが表示されます。
-
-
ロジックステートメントの作成が完了したら、適用をクリックします。
ロジックが適用され、フォームデザイナーのターゲットフィールドと参照フィールドにロジックアイコンが追加されます。
カスタムフォームへの高度な表示ロジックの追加
カスタムフォームフィールドの高度な表示ロジックを使用すると、数式を使用して複雑なロジックを作成できます。 このロジックは、次のフィールドタイプに適用できます。1行テキスト、段落、書式付きテキスト、単一選択ドロップダウン、複数選択ドロップダウン、外部参照、複数選択外部参照、ネイティブフィールド参照、先行入力、計算、日付、チェックボックスグループ、ラジオボタン。
例
高度な表示ロジックを使用して、ユーザーの役割に基づくカスタムフォームセクションの表示と、別のフィールドのステータスに基づくフィールドの表示を制御できます。
フォームのデフォルトセクションにはロジックが適用されないので、常にすべてのユーザーに表示されます。
次の条件を使用すると、「リソースが必要」セクションは、リソースマネージャーの担当業務を持つユーザーがフォームを表示した場合にのみ表示されます。
IF($$USER.{roleID}="123abc", true)
123abcはリソース マネージャーの役割IDを表します。
役割
異なる役割IDを持つ同じ条件が「プロジェクト財務KPI」セクションに適用され、Financial Advisor役割のみがセクションを表示できることを定義します。
次の条件を使用すると、「販売」 KPI フィールドは、プロジェクトが完了したときにのみ表示されます。 このロジックは、フォームセクションではなく、フィールドに直接適用されます。 フィールドを表示できる役割を指定する必要はありません。その役割は、フィールドが存在するセクションで既に定義されているからです。
IF({status}="CPL", true)
高度な表示ロジックの定義
-
Adobe Workfrontの左上隅にあるメインメニュー アイコン
-
「カスタムフォーム」をクリックします。
-
新規カスタムフォームを作成するか、既存のフォームを開きます。 詳しくは、 カスタムフォームの作成を参照してください。
-
必要に応じて、フォームにフィールドを追加します。
-
ロジックを適用するフィールドを選択し、ロジックを追加をクリックします。
-
ロジックビルダーの「表示」タブを選択します。
-
詳細モードを有効にします。
表示ロジックのシンプル モードをサポートしていないフィールドタイプの場合、このオプションは自動的にオンにされる場合があります。
-
エディターで表示条件を作成します。
計算と式について詳しくは、計算フィールドをフォームに追加および計算データ式の概要を参照してください。
-
「適用」をクリックします。
ロジックが適用され、フォームデザイナーのターゲットフィールドと参照フィールドにロジックアイコンが追加されます。
note NOTE 詳細表示ロジックは、フォームデザイナーのプレビューモードではサポートされていません。
カスタムフォームにスキップロジックを追加
スキップロジックは、ユーザーが複数選択フィールドで特定の値を選択した場合に、スキップされるカスタムフォームフィールドを定義します。 スキップされたフィールドは、フォーム上で非表示になります。 このロジックは、スキップされるフィールドではなく、選択が行われる定義フィールドに適用されます。
-
Adobe Workfrontの左上隅にあるメインメニュー アイコン
-
「カスタムフォーム」をクリックします。
-
新規カスタムフォームを作成するか、既存のフォームを開きます。 詳しくは、 カスタムフォームの作成を参照してください。
-
必要に応じて、フォームにフィールドを追加します。 スキップロジックの定義フィールドは、複数選択フィールド（ラジオボタン、ドロップダウン、チェックボックス）である必要があります。
-
定義フィールドを選択し、画面左下の「ロジックを追加」をクリックします。
-
ロジックビルダーの「スキップ」タブを選択します。
-
「スキップルールを追加」をクリックします。
-
ビルダーでロジックステートメントを作成するには、次の手順に従います。
-
定義フィールドがビルダーに表示されます。 これは、スキップロジックを適用するために選択したフィールドです。
-
1 つ目のオプションは、選択値を選択することです。 フィールドに対して既に定義されている値のみをが使用できます。
-
2 つ目のオプションは、選択済みまたは 未選択 です。 「選択済み」を選択した場合、値が選択されるとターゲットフィールドが表示され、その間のフィールドがスキップされます。 「未選択」を選択した場合、定義フィールドで他の値が選択されると、ターゲットフィールドが表示され、その間のフィールドがスキップされます。
-
3 つ目のオプションは、ターゲットフィールド、またはスキップ先のフィールドです。 フィールド名または「フォームの最後」を選択します。 オプションを選択する前に、「空白」という単語をクリックする必要が生じる場合があります。
-
次の手順で OR ルールをロジックステートメントに追加する場合は、論理ビルダーの下部付近にある「ルールを追加」をクリックします。 次に、同じプロンプトに従ってオプションを選択し、ルールを作成します。 1 つの OR ルールが満たされると、ターゲットフィールドが表示されます。
-
-
ロジックステートメントの作成が完了したら、適用をクリックします。
ロジックが適用され、フォームデザイナーのターゲットフィールドと参照フィールドにロジックアイコンが追加されます。
カスタムフォームへのデフォルト値ロジックの追加
デフォルト値ロジックを使用すると、数式を使用してカスタムフォームフィールドのデフォルト値を設定できます。 定義された条件が満たされると、デフォルト値が表示されます。 デフォルト値は、静的な値でも、オブジェクト内の他のフィールドを参照する動的な値でもかまいません。 デフォルト値は他のフィールドを参照できますが、フォーム上の他のフィールドが変更しても変更されません。
高度なデフォルト値ロジックは、次のフィールドタイプに適用できます。1行テキスト、段落、単一選択ドロップダウン、複数選択ドロップダウン、外部参照、複数選択外部参照。 ネイティブフィールド参照、先行入力、チェックボックスグループ、ラジオボタン。
例
次の数式を使用すると、ロジックが適用される複数選択ドロップダウンフィールドは、プロジェクトのステータスが「計画」の場合、プロジェクトの説明からデフォルト値を取得します。
IF({status} = 'PLN', ARRAY({description}, ','))
カスタムフォームがプロジェクトに添付され、プロジェクトのステータスが「計画」の場合、「プロジェクトの説明」フィールド値が複数選択フィールドのデフォルト値として使用されます。 複数の選択フィールドであるため、値が説明と一致すると、複数の値を取り込むことができます。 説明値が複数選択値オプションのいずれかと一致しない場合、複数選択フィールドにはデフォルト値が設定されず、ユーザーはドロップダウンから値を選択できます。
デフォルト値ロジックの定義
-
「カスタムフォーム」をクリックします。
-
新規カスタムフォームを作成するか、既存のフォームを開きます。 詳しくは、 カスタムフォームの作成を参照してください。
-
必要に応じて、フォームにフィールドを追加します。
-
ロジックを適用するフィールドを選択し、ロジックを追加をクリックします。
-
ロジックビルダーの「デフォルト値」タブを選択します。
-
エディターでデフォルト値の条件を作成します。
計算と式について詳しくは、計算フィールドをフォームに追加および計算データ式の概要を参照してください。
-
「適用」をクリックします。
ロジックが適用され、フォームデザイナーのターゲットフィールドと参照フィールドにロジックアイコンが追加されます。
note NOTE デフォルト値ロジックは、フォームデザイナーのプレビューモードではサポートされていません。
カスタムフォームへの検証ロジックの追加
検証ロジックは数式を使用して構築され、必要に応じてロジックを単純または複雑にすることができます。 検証は、他のフィールドの値またはオブジェクトのステータスに基づいて行うことができ、検証が失敗した場合のエラーメッセージを提供できます。
ユーザーがカスタムフォームに入力したときに、ロジックが適用されたフィールドが定義された検証条件を満たす場合、そのフィールドが強調表示され、エラーメッセージが表示されます。
検証ロジックは、次のフィールドタイプに適用できます。1行テキスト、段落、1選択ドロップダウン、複数選択ドロップダウン、外部参照、複数選択外部参照、先行入力、日付、チェックボックスグループ、ラジオボタン。
例
次の条件を使用すると、ユーザーがメッセージをトリガーする値を入力すると、「予算」フィールドにメッセージがフィールドの下に表示されます。 例えば、入力した値が負の値の場合、最初のメッセージが表示されます。 予算値を入力する前にプロジェクトのステータスを「現在」に変更しようとすると、2番目のメッセージが表示されます。
IF({DE:Budget Field} < 0,
"Budget cannot be negative",
IF({DE:Budget Field} == 0 && {status} == "CUR", "Budget must be specified before moving to Current status")
)
もう1つの簡単な例は、電話番号フィールドに有効な一定数の数字を含める必要があることです。
他のフィールドに基づく検証の追加の例として、会議室のサイズ（小、中、大）のフィールドと、会議出席者の数の別のフィールドがあります。 各部屋サイズの人数は、検証式に記載されています。 選択した会議室に対してユーザーが入力する参加者の数が多すぎる場合は、エラーメッセージが表示されます。
検証ロジックのその他の例については、 カスタムフォームの高度なロジックの例を参照してください。
検証ロジックの定義
-
Adobe Workfrontの左上隅にあるメインメニュー アイコン
-
「カスタムフォーム」をクリックします。
-
新規カスタムフォームを作成するか、既存のフォームを開きます。 詳しくは、 カスタムフォームの作成を参照してください。
-
必要に応じて、フォームにフィールドを追加します。
-
ロジックを適用するフィールドを選択し、ロジックを追加をクリックします。
-
ロジックビルダーの「検証」タブを選択します。
-
検証が満たされていない場合に表示されるエラーメッセージを含め、検証条件をエディターで作成します。
計算と式について詳しくは、計算フィールドをフォームに追加および計算データ式の概要を参照してください。
-
「適用」をクリックします。
ロジックが適用され、フォームデザイナーのターゲットフィールドと参照フィールドにロジックアイコンが追加されます。
note NOTE フォームデザイナーのプレビューモードでは、検証ロジックはサポートされていません。
カスタムフォームへの書式設定ロジックの追加
書式設定ロジックは、定義された条件を満たすフィールド値を強調表示します。 適用された書式設定は、一度に複数のフィールドで機能します。
書式設定ロジックは、次のフィールドタイプに適用できます。1行テキスト、段落、単一選択ドロップダウン、複数選択ドロップダウン、外部参照、複数選択外部参照、先行入力、計算日、チェックボックスグループ、ラジオボタン。
カスタムフォームに適用される書式設定は、リストやレポートに適用される書式設定とは異なります。 レポートの書式設定について詳しくは、 ビューでの条件付き書式設定の使用を参照してください。
例
次の条件を使用すると、ユーザーが1000以上の値を入力すると、「予算」フィールドが赤で表示されます。 ユーザーが500以上の値を入力すると、フィールドが黄色で表示されます。
書式のホバーオーバー定義を追加するには、カスタムフォームの「手順」フィールドを使用します。 例えば、「予算」フィールドに「合理的な範囲内で予算を入力してください。 500を超える値は警告の通知であり、1000を超えると高すぎると見なされます。」
IF(
{DE:Budget Field} >=1000,
FORMAT($NEGATIVE),
IF({DE:Budget Field} >= 500, FORMAT($NOTICE))
)
書式設定ロジックの定義
-
Adobe Workfrontの左上隅にあるメインメニュー アイコン
-
「カスタムフォーム」をクリックします。
-
新規カスタムフォームを作成するか、既存のフォームを開きます。 詳しくは、 カスタムフォームの作成を参照してください。
-
必要に応じて、フォームにフィールドを追加します。
-
ロジックを適用するフィールドを選択し、ロジックを追加をクリックします。
-
ロジックビルダーの「書式設定」タブを選択します。
-
エディターで書式設定条件を作成します。
1つのフィールドに最大5つの書式設定ルールを追加できます。
カラーオプションを強調表示するフィールドは次のとおりです。
$$POSITIVE (green)$$INFORMATIVE (blue)$$NEGATIVE (red)$$NOTICE (orange)
テキストの書式設定オプションは次のとおりです。
$$BOLD$$ITALIC$$UNDERLINE
1つの機能につき1つのカラーオプションのみを使用し、最大3つの追加のテキスト書式設定オプションも使用できます。 カラーオプションを指定しない場合、システムのデフォルトのカラーが適用されます。
計算と式について詳しくは、計算フィールドをフォームに追加および計算データ式の概要を参照してください。
-
「適用」をクリックします。
ロジックが適用され、フォームデザイナーのターゲットフィールドと参照フィールドにロジックアイコンが追加されます。
note NOTE フォームデザイナーのプレビューモードでは、書式設定ロジックはサポートされていません。
カスタムフォームへの編集可能ロジックの追加
編集可能性ロジックは、カスタムフォームフィールドを編集できるかどうか、または読み取り専用かどうかを決定します。 このロジックは数式を使用して構築され、フィールドが定義された条件を満たした場合、編集可能または読み取り専用として設定できます。
編集ロジックは、次のフィールドタイプに適用できます。1行テキスト、段落、書式付きテキスト、単一選択ドロップダウン、複数選択ドロップダウン、外部参照、複数選択外部参照、先行入力、日付、チェックボックスグループ、ラジオボタン。
例
次の数式を使用すると、ロジックが適用されたフィールドは、「ラジオ」という別のフィールドで「有効」オプションが選択されている場合にのみ編集できます。
IF({DE:Radio} = "Enabled", true)
次の数式を使用すると、「説明」フィールドは空白の場合にのみ編集できます。 値を入力すると、読み取り専用になります。
IF(ISBLANK({DE:Description}), true)
次の数式を使用すると、ロジックが適用されたフィールドは、リソースマネージャーのジョブロールを持つユーザーがフォームを表示した場合にのみ編集できます。
IF($USER.{role}.{name}="Resource Manager", true)
編集可能ロジックを定義
-
Adobe Workfrontの左上隅にあるメインメニュー アイコン
-
「カスタムフォーム」をクリックします。
-
新規カスタムフォームを作成するか、既存のフォームを開きます。 詳しくは、 カスタムフォームの作成を参照してください。
-
必要に応じて、フォームにフィールドを追加します。
-
ロジックを適用するフィールドを選択し、ロジックを追加をクリックします。
-
ロジックビルダーの「編集可能性」タブを選択します。
-
エディターで編集可能条件を作成します。
計算と式について詳しくは、計算フィールドをフォームに追加および計算データ式の概要を参照してください。
-
「適用」をクリックします。
ロジックが適用され、フォームデザイナーのターゲットフィールドと参照フィールドにロジックアイコンが追加されます。
note NOTE フォームデザイナーのプレビューモードでは、編集可能性ロジックはサポートされていません。