階層的な子の折り畳み
親ビジネスオブジェクト(例: 階層的な自己関係 selfRelationshipRef を持つ組織 (「OrganizationalUnit」など) がある場合、このシステム関数は、自己関係を介して、現在のノードからそのリーフ ノードまで階層を再帰的にトラバースします。
リーフ ノードでは、子関係 childRelationshipRef を介して指定された子ビジネス オブジェクトを反復処理し、各子ビジネス オブジェクトのコンテキストで childExpression を評価します。 式の評価の結果は、aggregatorFunc パラメータを使用して集計されます。
子ノードからの結果は親ノードに渡され、aggregatorFunc パラメータを使用して集計されます。 このプロセスは、元のノードで集約が完了するまで、階層を上って続行されます。
本質的には、HierarchicalChildFold 関数は、特定の階層内に表示される子ビジネス オブジェクトのロールアップ集計をサポートします。
このリリースでは、 サービス マネージャ はプラス (+ ) 集計演算子のみをサポートします。
構文
HierarchicalChildFold (parentObjectRef, parentRecId, selfRelationshipRef, displayFieldName, childRelationshipRef, childExpression, aggregatorFunc, childPredicateExpression)有効
ビジネス オブジェクト カテゴリの説明については、「有効な対象」に関する注意事項 ( 「有効」に関する注意事項
ビジネスオブジェクトカテゴリ | はい/いいえ |
|---|---|
ビジネスルール: 保存前ルール | はい |
ビジネス ルール: 計算ルール (保存後、ロード時に再計算の有無) | はい |
ビジネス ルール: 計算ルール (保存前または常に、読み込み時に再計算なし) | はい |
ビジネス ルール: 計算ルール (保存前または常に、読み込み時に再計算) | はい |
ビジネスルール: ルールの編集 | はい¹ |
ビジネスルール: 初期化ルール | はい |
ビジネスルール: 読み取り専用ルール | いいえ |
ビジネスルール: 必須ルール | はい¹ |
ビジネスルール: 検証ルール | はい |
クライアントの表現 | いいえ |
オブジェクトの権限 | いいえ |
サービス | はい |
LDAP の | はい |
携帯 | はい |
クイックアクション(UI クイックアクションを除く) | はい |
UI クイックアクション | いいえ |
レポート | はい |
フィールド参照のない検索/ダッシュボード | はい |
フィールド参照付き検索/ダッシュボード | いいえ |
1. ただし、このフィールドがフォーム上に表示される場合、またはこのようなフィールドによってトリガーされる場合を除きます。 | |
パラメータ
パラメータ | 説明 |
|---|---|
親オブジェクト参照 | 親ビジネス オブジェクトの名前。 このビジネスオブジェクトは、それ自身との自己関係を持つ必要があります(例: 「組織単位」)。 |
親レコードID | 親ビジネス オブジェクトのインスタンスの RecID。 これは、子ビジネス オブジェクトに到達する前に階層をトラバースするソースです。 |
自己関係参照 | 親とそれ自身を関連付ける関係の名前。 式エディターは、指定された関係が実際に自己関係であるかどうかを設計時に確認し、無効な関係が指定されている場合はエラーを表示して、式の保存を防止します。 |
表示フィールド名 | 指定されたレコードの表示名を提供する親ビジネス オブジェクト内のフィールド。 このプロパティの主な目的は、階層を走査しながら式を評価する際に、循環依存関係が検出されたノードの名前とともにエラー メッセージを表示することです。 |
子関係参照 | 親に関連する関係の名前(例: 「OrganizationalUnit」をその関連オブジェクト(子ビジネスオブジェクト、例: “CI”). |
子表現 | 各子ビジネス オブジェクトに対して評価する式。 これは通常、フィールド参照ですが、サブ式になることもあります。 |
アグリゲーター関数 | 文字列として指定された集計関数。 このリリースでは、 サービス マネージャ はプラス (+) アグリゲータのみをサポートします。 |
子述語式 | (オプション) 各子に対して評価されるブール式。 この評価の結果が正しい場合にのみ、子が含まれます。 |
戻り値
Unicode テキスト値。
例
HierarchicalChildFold システム関数は現在、Ivanti Asset Manager のすぐに使用できる実装、具体的には OrganizationalUnit ビジネス オブジェクトで定義されている「集計値の計算」QuickAction で使用されています。
「資産マネージャ」オブジェクト モデルでは、OrganizationalUnit と「OrganizationalUnit#.parent_ou_rel」と呼ばれるその親との間で定義される関係があり、これは selfRelationshipRef パラメータに対応しています。
OrganizationalUnit と「CI#.CIAssociatedEmbeddedOrganizationalUnit」と呼ばれるその子 CI との間で定義される関係もあり、これは childRelationshipRef パラメータに対応しています。
CIビジネスオブジェクトには、ivntPurchasePriceというフィールドがあり、これは特定のCIの購入価格を定義します(つまり、 資産)。
特定の OrganizationalUnit のすべての CI にわたる 合計購入価格 を計算するには、既存の ChildFold 式を使用できます。
$(ChildFold("OrganizationalUnit#", RecId, "CI#.CIAssociatedEmbeddedOrganizationalUnit", "ivnt_PurchasePrice", "+"))特定の組織単位のすべての CI と階層内のすべての子組織単位の合計購入価格を計算するには、新しい HierarchicalChildFold 式を使用できます。
$(HierarchicalChildFold("OrganizationalUnit#", RecId, "OrganizationalUnit#.parent_ou_rel", "Name", "CI#.CIAssociatedEmbeddedOrganizationalUnit", "ivnt_PurchasePrice", "+"))以前の ChildFold 式と比較すると、HierarchicalChildFold 式には selfRelationshipRef および displayFieldName プロパティが追加されていますが、それ以外は式の本体は両方の式で同一です。
高度な例
上記の例では、CI の「ivntPurchasePrice」フィールドを子式として使用しています。
CI ビジネス オブジェクトは、特定の CI の 財務トランザクション を表す FrsITFMTransaction と関係があります。 総費用を計算するには、次の ChildFold 式を使用できます。
$(ChildFold("CI#", RecId, "Frs_ITFM_Transaction#.CostItem", $(Cost), "+"))すべての CI 全体の総費用を計算するには、次の ChildFold 式を使用できます。上記の ChildFold 式がメインの ChildFold 式に埋め込まれていることに注意してください。
$(ChildFold("OrganizationalUnit#", RecId, "CI#.CIAssociatedEmbeddedOrganizationalUnit", $(ChildFold("CI#", RecId, "Frs_ITFM_Transaction#.CostItem", $(Cost), "+")), "+"))上記の式は、指定された組織単位の 総所有コスト を表します。
特定の組織単位のすべての CI と階層内のすべての子組織単位にわたる総所有コストを計算するには、新しい HierarchicalChildFold 式を使用できます。
$(HierarchicalChildFold("OrganizationalUnit#", RecId, "OrganizationalUnit#.parent_ou_rel", "Name", "CI#.CIAssociatedEmbeddedOrganizationalUnit", $(ChildFold("CI#", RecId, "Frs_ITFM_Transaction#.CostItem", $(Cost), "+")), "+"))前の例と同様に、以前の ChildFold 式と比較すると、HierarchicalChildFold 式には selfRelationshipRef および displayFieldName プロパティが追加されていますが、それ以外は式の本体は両方の式で同一です。
