各子
子ビジネス オブジェクト インスタンスを反復処理し、それぞれのテキスト値を計算します。 これらの値はオプションでソートされ、連結されて、指定された区切り文字で区切られます。
関連する (子) ビジネス オブジェクトごとにテキスト値の式を評価し、結果を 1 つのテキスト値に連結します。 関連オブジェクトは、 childRelationshipRef パラメータを介して単一の親ビジネス オブジェクトに関連付けられます。 子オブジェクトの 1 つ以上の並べ替えフィールドを並べ替えキーとして指定することで、子を並べ替えることができます。
構文
ForEachChild(親オブジェクト参照、recId、子関係参照、子式、フィールドと順序)有効
ビジネス オブジェクト カテゴリの説明については、「有効な対象」に関する注意事項 ( 「有効」に関する注意事項
ビジネスオブジェクトカテゴリ | はい/いいえ |
|---|---|
ビジネスルール: 保存前ルール | はい |
ビジネス ルール: 計算ルール (保存後、ロード時に再計算の有無) | はい |
ビジネス ルール: 計算ルール (保存前または常に、読み込み時に再計算なし) | はい |
ビジネス ルール: 計算ルール (保存前または常に、読み込み時に再計算) | はい |
ビジネスルール: ルールの編集 | はい¹ |
ビジネスルール: 初期化ルール | はい |
ビジネスルール: 読み取り専用ルール | いいえ |
ビジネスルール: 必須ルール | はい¹ |
ビジネスルール: 検証ルール | はい |
クライアントの表現 | いいえ |
オブジェクトの権限 | いいえ |
サービス | はい |
LDAP の | はい |
携帯 | はい |
クイックアクション(UI クイックアクションを除く) | はい |
UI クイックアクション | いいえ |
レポート | はい |
フィールド参照のない検索/ダッシュボード | はい |
フィールド参照付き検索/ダッシュボード | いいえ |
1. ただし、このフィールドがフォーム上に表示される場合、またはこのようなフィールドによってトリガーされる場合を除きます。 | |
パラメータ
パラメータ | 説明 |
|---|---|
親オブジェクト参照 | オブジェクト参照としての親ビジネス オブジェクト。 |
受信ID | 親ビジネス オブジェクト インスタンスの RecID。 |
子関係参照 | 親と子を関連付ける関係。 |
子表現 | 各子について評価する式。 注: 連結の最後の要素が各インスタンスで同じであり、リテラル値である場合、アプリケーションはそのリテラル値を区切り文字として解釈します。 アプリケーションは、最後のエントリを除くすべてのエントリの末尾に区切り文字を追加します。 |
フィールドと順序 | (オプション) 結果を並べ替える順序。 各引数は、オプションでスペースと ASC (昇順) または DESC (降順) が続くフィールド名のリストです。 昇順がデフォルトです。 この関数は、パラメータを無制限に受け取ることができます(パラメータをまったく受け取らない場合も含む)。 このパラメータの追加インスタンスを使用して、結果をさらに並べ替えます。 |
戻り値
テキスト値。
例
たとえば、特定の RecID を持つ修正済みの問題について、 ResNoteHistory 子ビジネス オブジェクトのすべてのインスタンスを反復処理するには、親ビジネス オブジェクトのビジネス ルール内で以下を使用します。
ForEachChild("IssueFix", RecId, "ResNoteHistory
最終変更日時
'\r\n' 解像度メモ
'\r\n\r\n'", "CreatedDateTime ASC")アプリケーションは、各インスタンスについて、インスタンスを最後に変更したユーザーの名前 (LastModBy)、タブ、最終変更日時 (LastModDateTime)、新しい行、解決メモのテキスト (ResolutionNote)、下線付きの新しい行、さらに別の新しい行の順に連結します。 これらの連結は、インスタンスが作成された日時 (CreatedDateTime) によって昇順 (ASC) で並べ替えられます。
次に、インシデント関連のすべての構成項目を 1 つのテキスト フィールドにまとめる別の例を示します。
$(ForEachChild("Incident#",
受信ID、
"CI#.",
"CIType + '\t' + Name + '\r\n' + IPAddress + '\t' + Model +'\r\n______________\r\n'", "Name ASC"))