LREL メソッド

LREL メソッドは、オブジェクト関係に関する情報を提供します。関係を持つオブジェクトでは、左端（lhs）と右端（rhs）の定義によって多対多の関係を表します。多対多の関係のいくつかの例を、以下に示します。

案件と構成アイテム
連絡先と構成アイテム
タスクタイプとステータスコード

LREL メソッドを使用する場合は、BREL 属性または LREL 属性によって多対多の関係を表します。 BREL 属性は、LREL 属性に代わって、多対多の関係を定義します。ただし、LREL 属性は残り、以前のリリースとの後方互換性を維持します。各関係は、.maj ファイルで宣言します。コードでは、CreateLrelRelationship() などの LREL メソッドが、既存の Web サービスクライアントコードと一緒に使用されます。

注：グループオブジェクト管理を使用する場合は、特別な Web メソッドを使用して、グループに属するメンバーを定義することができます。

majic ファイルで、関係を定義する BREL 属性を使用して関係を宣言します。たとえば、以下のステートメントは、change.maj で変更要求（chg）オブジェクトの多対多の関係を宣言します。

asset BREL lrel_asset_chgnr chg {LREL nr;};

変更要求「asset」の BREL 属性は、関連付けられているすべての構成アイテムのリストです。オプションの LREL フラグは、一連の所有リソースを表す属性です。構成アイテム（nr）の対応する majic 定義には、以下が含まれます。

chgnr BREL lrel_asset_chgnr nr {LREL chg;};

chgnr 属性は、構成アイテムに対するすべての変更要求のリストです。

コードでは、変更要求に関連付けられている構成アイテムの数を検出することができます。以下のパラメータを指定して、getLrelLength() を呼び出します。

getLrelLength(sid, ChangeHandle, "asset")

ログインメソッドからサービス ID の sid パラメータを使用します。 ChangeHandle パラメータは、特定の変更要求への文字列ハンドルです。同様に、以下のステートメントは、変更要求に関連するすべての構成アイテムの名前を取得する方法を表します。

String attrs[] = {"name"};
getLrelValues(sid, ChangeHandle, "asset", 0, -1, attrs);

getLrelValues() メソッドは、attrs 配列内の関係を提供します。

注： LREL テーブルおよびオブジェクトの詳細については、「データエレメント辞書」および「オブジェクトと属性」を参照してください。