EMF および UML データ・セットのパラメーター

EMF および UML データ・セットのパラメーターを定義し、行マッピングと列マッピングのデータ・セット照会にパラメーターを使用して、レポート設計で値をパラメーターに設定することができます。パラメーターを使用して、汎用データ・セットに差異を作成し、互いにほぼ同一である複数データ・セットの作成を避けるようにします。また、パラメーターを使用して、オブジェクトを結合することもできます。

パラメーターを使用して、汎用データ・セットに差異を作成する方法

わずかな差異を除いて同一である複数のデータ・セットが必要な場合に、パラメーターを使用することができます。 複数データ・セットの作成を避けるには、 差異を表すパラメーターを使用する単一データ・セットを作成し、パラメーターを変更された値に設定することができます。

例えば、 A という名前のパッケージのすべてのクラスを取得する 1 つのデータ・セット、および B という名前のパッケージのすべてのクラスを取得するもう 1 つのデータ・セットを扱うのではなく、$name という名前のパッケージのすべてのクラスを取得する 1 つのデータ・セットを作成することができます。 次に、$nameAB に設定することができます。 このようにして、データ・セットをより簡潔で、またより再使用しやすいものにします。

パラメーターの使用およびパラメーターへの値の設定について詳しくは、 『BIRT へのフィールド・ガイド (Field Guide to BIRT)』を参照してください。

パラメーターを使用してオブジェクトを結合する方法

EMF および UML モデルのレポートを設計する場合、パラメーターを使用して、データ・セットのオブジェクトを結合することができます。 オブジェクト間の関係により、鍵を使用してオブジェクトを結合することができます。鍵を使用することができない場合には、パラメーターを定義して、オブジェクトを結合できます。しかし、鍵を使用できる場合に、パラメーターを使用することもできます。

パラメーターを使用せずに結合できるオブジェクト

以下の場合、オブジェクトを結合するために、パラメーターを作成する必要はありません。

結合時にパラメーターを必要とするオブジェクト

以下の場合、オブジェクトを結合するにはパラメーターが必要です。
  • 多重度 1 を持つ終端がナビゲート可能ではない、1 対 * の多重度を持つ関係
    " "
  • * 対 * の多重度を持つ関係
    “ "

この場合、EMF および UML データ・セットは、1 より大きい多重度を持つ列をサポートしないため、パラメーターが必要です。このことは、関係の終端を表すデータ・セットの列を使用して、多重度 * を持つナビゲート可能な他の終端を表すことができないということを意味します。 これらのタイプの関係は、EMF および UML モデルで非常に一般的です。

オブジェクト結合のヒント

データ・セットのパラメーターを使用して、 モデルのあらゆるタイプの関係によって関連付けられた 2 つのオブジェクトを結合することができます。パラメーターを使用して、オブジェクトを結合するには、関係のナビゲート可能な終端を表すデータ・セットを定義し、そのデータ・セット用に関係の他の終端でオブジェクトを表すパラメーターを定義します。次に、行マッピング照会で、コンテキストとしてこのパラメーターを使用し、そのパラメーターから、データ・セットの行を表すオブジェクトにナビゲートします。

例えば、クラス Y を表すデータ・セットで、クラス X のオブジェクトを表すパラメーター $X を定義してから、XPath 式 $X¥y として行マッピング照会を指定できます。 このようにして、データ・セットは、特定の方法でタイプ X のコンテキスト・オブジェクトに関連付けられたタイプ Y のオブジェクトを表します。

データ・セット・パラメーター は、Business Intelligence Reporting Tools (BIRT) がサポートするいずれかのスカラー型で入力されます。例えば、ストリング・パラメーター $name を定義し、次の 行マッピング XPath 式を書き込むことができます: Class->ownedAttribute[@name=$name]

オブジェクト・パラメーター は、オブジェクトを解決するために使用できるスカラー ID によって表すことができます。EMF および UML モデルでは、オブジェクトの固有の ID は、ストリングとしてエンコードされた URI です。 このため、URI パラメーターのタイプとして string を選択し、ランタイムに、それらのパラメーターをオブジェクト URI 列に設定します。

パラメーターの決定方法

データ・セットの作成時のパラメーターの定義について詳しくは、『EMF データ・セットの作成』および『UML データ・セットの作成』のトピックを参照してください。

また、パラメーターを、既存のデータ・セットに追加することもできます。データ・セット・エディターで、「パラメーター」ページではなく、「照会パラメーター (Query Parameters)」ページから開始して、EMF および UML データ・セット照会のパラメーターを定義します。次のような 2 つのページを使用します。
  • 照会パラメーター (Query Parameters)」ページを使用して、パラメーターの追加、除去、再配列、および名前変更を行います。このページのパラメーターは、パラメーターの内部名によって識別されます。内部名は、XPath 式で使用される名前です。このため、内部名は、変数の XPath 命名規則に準拠している必要があります。内部名は、文字またはアンダースコアー (_) で始まり、任意の連続した、文字、数字、またはアンダースコアー文字を含むことができます。 このページで行う変更は、「パラメーター」ページにも表示されます。
  • パラメーター」ページを使用して、パラメーターの定義を行います。表示名 (初期設定は内部名)、タイプ (初期設定は String)、方向 (初期設定は Input)、およびレポート・パラメーターの名前 (ある場合) を指定して、データ・セット・パラメーターを設定します。

パラメーターを定義すると、ドル記号 ($) が先頭についた内部名を使用して、行マッピングおよび列マッピング照会の両方で、パラメーターを参照できます。 「データ・バインディング」ページでデータ・セット・パラメーターに値を設定する場合は、パラメーターの表示名を使用します。

注: Eclipse 資料または開発者ガイドへのリンクなどの一部の情報は、製品ヘルプのトピックからのみ参照できます。

フィードバック