コラボレーション・テンプレートの標準プロパティー

表 90 に、コラボレーション・テンプレートのための標準的な構成プロパティーを示します。これらのプロパティーは CollaborationFoundation テンプレートを基にしています。

表 90. コラボレーション・テンプレートの標準プロパティー
標準構成プロパティー 説明
1_EXCLUDE_VALUES トリガー・ビジネス・オブジェクトの同期を回避するためにフィルター操作用として使用するコラボレーションの値を指定します。
1_FAIL_ON_INVALID_VALUE フィルター操作の基準に合わない、1_FILTER_ATTRIBUTE で指定された属性の値をコラボレーションがどう処理するかを示します。
1_FILTER_ATTRIBUTE 1_EXCLUDE_VALUES プロパティーと 1_INCLUDE_VALUES プロパティーで指定された値を比較する際に使用するコラボレーションのビジネス・オブジェクト属性を指定します。
1_INCLUDE_VALUES トリガー・ビジネス・オブジェクトの同期を許可するためにフィルター操作用として使用するコラボレーションの値を指定します。
ADDITIONAL_RETRIEVE データとの同期が成功した後に、コラボレーションが宛先アプリケーションからビジネス・オブジェクトを検索するかどうかを指定します。
CONVERT_CREATE ソース・アプリケーションで作成されたトリガー・ビジネス・オブジェクトが宛先アプリケーションにすでに存在する場合の Create 要求へのコラボレーションの対応方法を示します。
CONVERT_UPDATE ソース・アプリケーションで更新されたトリガー・ビジネス・オブジェクトが宛先アプリケーションに存在しない場合の Update 要求へのコラボレーションの対応方法を示します。
INFORMATIONAL_EXCEPTIONS コラボレーションが例外にどう対応するかを指定します。
SEND_EMAIL 例外を受け取った場合にコラボレーションが E メールを送信するかどうかを示します。
USE_RETRIEVE データとの同期を取る前に、コラボレーションが宛先アプリケーションからトリガー・ビジネス・オブジェクトを検索するかどうかを指定します。

1_EXCLUDE_VALUES

1_EXCLUDE_VALUES コラボレーション構成プロパティーは、トリガー・ビジネス・オブジェクトの同期を回避するためにフィルター操作用として使用するコラボレーションの値を指定します。1_FILTER_ATTRIBUTE で指定された属性の値がこのプロパティーにリストされている値のいずれかと一致する場合、コラボレーションはビジネス・オブジェクトを同期から除外します。

1_EXCLUDE_VALUES で使用される値は以下のとおりです。

デフォルト値は none です。

このプロパティーは、コラボレーション・テンプレートに使用できる構成プロパティーのリストから削除することができます。1_EXCLUDE_VALUES プロパティーは、削除されると、フィルター操作プロセスで使用されなくなります。

コラボレーションの指定値に大文字小文字の区別はありません。また、値のリスト内の余分なスペースに関する区別もありません。

排他値のリストが包含値のリストよりも 短い 場合はこのプロパティーの値を指定します。それ以外の場合は、1_INCLUDE_VALUES の値を指定します。1_INCLUDE_VALUES 内で値を指定すると、1_EXCLUDE_VALUES の値は none に設定されます。

1_FAIL_ON_INVALID_VALUE

1_FAIL_ON_INVALID_VALUE コラボレーション構成プロパティーは、フィルター操作の基準に合わない、1_FILTER_ATTRIBUTE で指定された属性の値をコラボレーションがどう処理するかを示します。1_FAIL_ON_INVALID_VALUE プロパティーは、次の値のいずれかに設定してください。

デフォルト値は true です。値に大文字小文字の区別はありません。

このプロパティーは、コラボレーション・テンプレートに使用できる構成プロパティーのリストから削除することができます。プロパティーを削除すると、それはフィルター操作プロセスで使用されなくなります。

1_FILTER_ATTRIBUTE

1_FILTER_ATTRIBUTE コラボレーション構成プロパティーは、1_EXCLUDE_VALUES プロパティーと 1_INCLUDE_VALUES プロパティーで指定された値を比較する際に使用するコラボレーションのビジネス・オブジェクト属性を指定します。コラボレーションは、特定の値を持つビジネス・オブジェクトの同期を回避または保証するために、指定された属性の値を排他または包含用に指定された値と比較します。例えば、BusObjA というトップレベルのビジネス・オブジェクトに BusObjB という子ビジネス・オブジェクトの配列が含まれていると想定します。BusObjB ビジネス・オブジェクト内の Type という属性でフィルター操作するには、1_FILTER_ATTRIBUTE の値を BusObjA.BusObjB.Type に設定します。

注:
コラボレーションがこのプロパティーを評価するのは、その 1_EXCLUDE_VALUES が、none 以外の値に評価される場合か、その 1_INCLUDE_VALUES が all 以外の値に評価される場合のみです。

このコラボレーション構成プロパティーの有効な値は、以下のとおりです。

コラボレーション・テンプレートは、任意の数のビジネス・オブジェクト属性でフィルター操作を行うように設計されています。フィルターを追加するには、構成プロパティーのセット (X_FILTER_ATTRIBUTE、X_FAIL_ON_INVALID_VALUE、X_EXCLUDE_VALUES または X_INCLUDE_VALUES) をコラボレーションに追加します。X は、2 から N の整数です。その他のプロパティーは、2 から N の順に追加し、前記の正確な名前を指定する必要があります。

1_INCLUDE_VALUES

1_INCLUDE_VALUES コラボレーション構成プロパティーは、トリガー・ビジネス・オブジェクトの同期を許可するためにフィルターとして使用するコラボレーションの値を指定します。1_FILTER_ATTRIBUTE で指定された属性の値がこのプロパティーにリストされている値のいずれかと一致する場合、コラボレーションは、指定された値を持つビジネス・オブジェクトのみを同期します。

1_INCLUDE_VALUES プロパティーの有効な値は、以下のとおりです。

デフォルト値は all です。値に大文字小文字の区別はありません。また、コラボレーションは、値のリスト内にある余分なスペースを無視します。

このプロパティーをフィルター操作プロセスで使用しない場合は、コラボレーションに使用できる構成プロパティーのリストから削除することができます。

包含値のリストが排他値のリストよりも 短い 場合はこのプロパティーの値を指定します。それ以外の場合は、1_EXCLUDE_VALUES の値を指定します。1_EXCLUDE_VALUES 内で値を指定すると、1_INCLUDE_VALUES の値は all に設定されます。

ADDITIONAL_RETRIEVE

ADDITIONAL_RETRIEVE コラボレーション構成プロパティーは、データとの同期が成功した後に、コラボレーションが宛先アプリケーションからビジネス・オブジェクトを検索するかどうかを指定します。ADDITIONAL_RETRIEVE プロパティーは、以下のように設定します。

デフォルト値は false です。

CONVERT_CREATE

CONVERT_CREATE コラボレーション構成プロパティーは、ソース・アプリケーションで作成されたトリガー・ビジネス・オブジェクトが宛先アプリケーションにすでに存在する場合にコラボレーションが Create 要求にどう対応するかを示します。CONVERT_CREATE プロパティーは、以下のように設定します。

デフォルト値は false です。

CONVERT_CREATE に対するコラボレーションのアクションは、USE_RETRIEVE コラボレーション構成プロパティーの値によって決まります。

USE_RETRIEVE 構成プロパティーと CONVERT_CREATE 構成プロパティーの関係については、Use_Retrieve プロセスの表を参照してください。

CONVERT_UPDATE

CONVERT_UPDATE コラボレーション構成プロパティーは、ソース・アプリケーションで更新されたトリガー・ビジネス・オブジェクトが宛先アプリケーションに存在しない場合にコラボレーションが Update 要求にどう対応するかを示します。CONVERT_UPDATE プロパティーは、以下のように設定します。

デフォルト値は false です。

CONVERT_UPDATE に対するコラボレーションのアクションは、USE_RETRIEVE コラボレーション構成プロパティーの値によって決まります。

INFORMATIONAL_EXCEPTIONS

INFORMATIONAL_EXCEPTIONS コラボレーション構成プロパティーは、コラボレーションが例外にどう対応するかを指定します。プロパティーには、以下の値を入れることができます。

デフォルト値は 1000、2000、2005、2010、2015、2020、3000、3010、3020 です。

SEND_EMAIL

SEND_EMAIL コラボレーション構成プロパティーは、例外を受け取った場合にコラボレーションが E メールを送信するかどうかを示します。SEND_EMAIL プロパティーは、以下のように設定します。

デフォルト値は none です。

注:
System Manager の「Collaboration Object Properties」ダイアログ・ボックスの「E メール通知アドレス」フィールドでアドレスを指定します。コラボレーションに対して E メール・アドレスが指定されている場合、コラボレーションは例外が発生したときに Email コラボレーションを呼び出します。Email コラボレーションは、WebSphere Business Integration Express の一部としてインストールし、構成することができます。

USE_RETRIEVE

USE_RETRIEVE コラボレーション構成プロパティーは、データとの同期の前に、コラボレーションが宛先アプリケーションからトリガー・ビジネス・オブジェクトを検索するかどうかを指定します。USE_RETRIEVE プロパティーは、以下のように設定します。

デフォルト値は false です。

注:
このプロパティーの使用の詳細については、CONVERT_CREATEおよび CONVERT_UPDATEを参照してください。

Copyright IBM Corp. 2004