この章では、IBM WebSphere Business Integration Server Express 定義のクラス Relationship のオブジェクトに対して操作を行うメソッドについて説明します。Relationship クラスは関係インスタンス と呼ばれる関係のランタイム・インスタンスを操作するためのメソッドを提供します。
通常は、一致関係または静的参照としてマップされるビジネス・オブジェクト属性の変換ステップでこのメソッドを使用します。このクラスのメソッドを使用して関係属性をプログラミングする方法の詳細については、"サブマップを使用した変換"を参照してください。
このクラスのメソッドのほとんどは、指定したパラメーターのバリエーションをサポートしています。バリエーションは通常、次のガイドラインに従います。
ほとんどの場合、(例えば retrieve() 呼び出しの結果として) Participant インスタンスがあれば、各属性を個別に指定しなくても、パラメーターとして Relationship クラス・メソッドにインスタンスを簡単に渡すことができます。
このクラスのメソッドはすべて、静的として宣言されます。既存の関係インスタンスから、または Relationship クラスを参照することでメソッドを呼び出すことができます。
表 140 に、Relationship
クラスのメソッドについて要約します。
メソッド | 説明 | ページ |
---|---|---|
静的メソッド | ||
addParticipant() | 新しい参加者を関係インスタンスに追加します。 | addParticipant() |
create() | 新しい関係インスタンスを作成します。 | create() |
deactivateParticipant() | 1 つ以上の関係インスタンスから参加者を非アクティブにします。 | deactivateParticipant() |
deactivateParticipantByInstance() | 特定の関係インスタンスから参加者を非アクティブにします。 | deactivateParticipantByInstance() |
deleteParticipant() | 1 つ以上の関係インスタンスから参加者インスタンスを除去します。 | deleteParticipant() |
deleteParticipantByInstance() | 特定の関係インスタンスから参加者を除去します。 | deleteParticipantByInstance() |
getNewID() | 関係定義名に基づいて、次に使用可能な関係の関係インスタンス ID を戻します。 | getNewID() |
retrieveInstances() | 特定の参加者インスタンスを含むゼロまたは複数の関係インスタンスの関係インスタンス ID のみを検索します。 | retrieveInstances() |
retrieveParticipants() | 関係インスタンスからゼロまたは複数の参加者を検索します。 | retrieveParticipants() |
updateParticipant() | 1 つ以上の関係インスタンスの参加者を更新します。 | updateParticipant() |
updateParticipantByInstance() | 特定の関係インスタンスの参加者を更新します。 | updateParticipantByInstance() |