チャイルドフォールド
Childfold 関数は、親のビジネス オブジェクトの子オブジェクトを反復処理し、各子オブジェクトのコンテキストで式を評価します。 式の評価の結果は、 aggregatorFunc パラメータを使用して集計されます。
childPredicateExpression パラメータが指定されている場合は、含める関連オブジェクトを選択します。 指定がない場合は、すべて含まれます。
構文
ChildFold (親オブジェクト参照、親レコード ID、子関係参照、子式、アグリゲーター関数、子述語式)有効
ビジネス オブジェクト カテゴリの説明については、「有効な対象」に関する注意事項 ( 「有効」に関する注意事項
ビジネスオブジェクトカテゴリ | はい/いいえ |
|---|---|
ビジネスルール: 保存前ルール | はい |
ビジネス ルール: 計算ルール (保存後、ロード時に再計算の有無) | はい |
ビジネス ルール: 計算ルール (保存前または常に、読み込み時に再計算なし) | はい |
ビジネス ルール: 計算ルール (保存前または常に、読み込み時に再計算) | はい |
ビジネスルール: ルールの編集 | はい¹ |
ビジネスルール: 初期化ルール | はい |
ビジネスルール: 読み取り専用ルール | いいえ |
ビジネスルール: 必須ルール | はい¹ |
ビジネスルール: 検証ルール | はい |
クライアントの表現 | いいえ |
オブジェクトの権限 | いいえ |
サービス | はい |
LDAP の | はい |
携帯 | はい |
クイックアクション(UI クイックアクションを除く) | はい |
UI クイックアクション | いいえ |
レポート | はい |
フィールド参照のない検索/ダッシュボード | はい |
フィールド参照付き検索/ダッシュボード | いいえ |
¹. ただし、このフィールドがフォーム上に表示される場合、またはこのようなフィールドによってトリガーされる場合を除きます。 | |
パラメータ
パラメータ | 説明 |
|---|---|
親オブジェクト参照 | 親ビジネス オブジェクトの名前。 |
親レコードID | 親ビジネス オブジェクトのインスタンスの RecID。 |
関係キー | 親と関連オブジェクト (子ビジネス オブジェクト) を関連付ける関係のリレーションシップ キー。 |
子表現 | 各子ビジネス オブジェクトに対して評価する式。 |
アグリゲーター関数 | 文字列として指定された集計関数。 このリリースでは、 サービス マネージャ はプラス ( )、SUM、AVG、AVERAGE、MIN、MAX、COUNT 集計機能をサポートしています。 |
子述語式 | (オプション) 各子に対して評価されるブール式。 この評価の結果が正しい場合にのみ、子が含まれます。 |
戻り値
Unicode テキスト値。
例
例1:
親インシデント ビジネス オブジェクトに関連付けられている子ビジネス オブジェクトのインスタンスの数を確認するには、次のように入力します。
$(ChildFold("Incident#", "213KJASD92132SD", "Task#Assignment.Rev3", Cost + 100, "+"))これは、 RecIDが 213KJASD92132SD であるインシデントビジネスオブジェクトを検索し、 Task#Assignment.Rev3 を通じてこの変更ビジネスオブジェクトに関連するすべてのタスクビジネスオブジェクトを検索します。 これらの各子ビジネス オブジェクトのコンテキストで、関数は式 Cost 100 を評価し、加算を使用してこれらの計算された値をすべて結合します。
例2:
タスクをすべて数える
$(ChildFold("Incident#", RecId, "Task#Assignment.Rev3", 1, "SUM", $(Status != 'Canceled')))例3:
変更ビジネス オブジェクトのフィールドを更新してインシデントの数を取得するには:
$(ChildFold("Change#", RecId, "Incident#.", 1, "+", $(Status != 'Active')))インシデント 子インシデント ビジネス オブジェクトへのリレーションシップ参照です。このリレーションシップの内部参照名は空です。 関係の内部参照名が空でない場合は、代わりに次を使用します: インシデント
関係が FRS_Knowledge.IssueResolution などのグループ メンバー ビジネス オブジェクトに対するものである場合は、FRS_Knowledge#IssueResolution.Internal Reference Name を使用します。 メンバービジネスオブジェクトが # と . の間にあることに注意してください。すべての例において。
高度な例
ChildFold() 関数の結果を使用するクライアント側の計算値フィールド (クライアントの可視性、または必須ルール) を作成するには (たとえば、可視性ルールがオープン タスクの数に依存する場合)、次の手順に従います。
ChildFold() 関数はクライアントではサポートされていないため、 TaskCountなどのヘルパー フィールドを作成し、サーバー コンテキストで評価される計算ルールを追加できます。
- ユーザーが所属するチームに基づいてユーザー インターフェイス内のボタンを非表示にするには、表示ルールを作成します。
- クライアント側 (表示または読み取り専用) ルールで計算フィールド値を参照すると、次のことが起こります。
- フィールドが既存の保存フィールドである場合は、通常の BeforeSave 条件を使用します。 [ロード時に再計算も行う] を選択する必要はありません。。
- フィールドがユーザー インターフェイスの表示のみを目的としている場合は、次の操作を実行して、計算ルールが AfterSaveに設定されて保存されない新しいフィールドを作成します。
- TaskCountなどのフィールドを開き、 Stored が選択されていないことを確認します。
- そのフィールドの計算ルールを編集し、条件を AfterSaveに設定します。 「 ロード時に再計算も行う」を選択します。
- インシデントのヘッダー フォームに、 TaskCount フィールドを非表示フィールドとして追加します。
- フォーム アクションにユーザー インターフェイスの表示ルールを追加します。
- これで、ボタンは可視性ルールが false を返す場合にのみ表示され、可視性ルールが true を返す場合は非表示になります。
