キューブ継承を使用する方法
場合によっては、類似した複数のキューブの定義が必要になります。Business Intelligence には単純な継承メカニズムが用意されていて、これらのキューブをさらに容易に定義できます。ここでは、このメカニズムの使用方法を説明します。説明している手順の一部ではアーキテクトを使用できません。代わりに ObjectScript をサポートする統合開発環境 (IDE) である Visual Studio Code またはスタジオを使用する必要があります。
キューブ継承の概要
キューブ継承メカニズムを使用するには、以下を実行します。
-
"InterSystems IRIS Business Intelligence のモデルの定義" ガイドの "キューブの定義" で説明されている手順に従って、1 つのキューブ・クラスを定義します。このキューブには、類似するすべてのキューブで想定される主要な項目が含まれ、親キューブとして機能します。
-
必要に応じて、このキューブを抽象としてマークし、直接使用できないようにすることができます。
-
BI インスタンスでスタジオ・セッションを開き、アナリティクス・ネームスペースにいることを確認します。
-
XData 定義で <cube> 要素を見つけて、属性のリストで abstract="true" を設定します。これにより、コンパイラによるキューブの検証、アナライザによるキューブの表示、およびユーザによるキューブに対するクエリの実行が行われなくなります。
-
変更内容を保存します。
-
子キューブをそれぞれのキューブ・クラスで定義します。この手順は、親キューブの定義に使用する手順からは外れています。
-
BI インスタンスで、管理ポータルに管理者権限を持つユーザとしてログインします。
-
[ホーム]→[アナリティクス]→[アーキテクト] に移動します。
-
[新規作成] ボタンをクリックします。
-
[定義タイプ] で [キューブ] を選択します。
-
[キューブ名] を入力し、オプションで、選択した [表示名] を入力します。
-
[キューブのソース] で [キューブ] を選択します。
-
[ベースキューブ] フィールドに、先ほど作成した親キューブの論理名を入力します。
-
[キューブのクラス名] を入力し、オプションで [クラスの説明] を入力します。
-
[OK] をクリックして、子キューブを作成します。既定では、この方法で作成されたキューブは親キューブからすべての定義を継承します。各キューブは 1 つのベース・キューブのみを持つことができますが、ベース・キューブ自体は他のキューブから継承できます。
-
親キューブが子キューブの前にコンパイルされていることを確認してください。モデル・ビューワの右側にある [詳細] ペインで、[依存] フィールドに親キューブの論理名を入力します。
-
必要に応じて、親キューブで指定されたディメンジョン、メジャー、またはその他の最上位レベル要素を再定義します。そのためには、子キューブで定義を指定し、親キューブと同じ論理名を使用します。新しい定義で、親キューブからの対応する定義が完全に置換されます。"項目の非表示または削除" も参照してください。
-
必要に応じて、子キューブで追加の定義 (ディメンジョン、メジャー、リストなど) を指定します。
キューブ継承メカニズムにクラス継承とのリレーションシップはありません。各サブキューブは独自のファクト・テーブルとインデックスを保持し、(実行時に) これらは親キューブに依存しません。キューブ継承メカニズムは、構築時にのみ使用され、そのキューブの定義にのみ影響します。
キューブ継承とアーキテクト
アーキテクトでサブキューブを表示する際は、継承要素を表示またはオーバーライドしたり、新しい要素を定義したりできます。左側の領域にはキューブのソース・クラスが表示されるため、このクラスから項目をドラッグ・アンド・ドロップして、サブキューブ内の要素として使用できます。アーキテクトの中央の領域には、継承項目 (斜体) とローカル定義項目 (通常書体) の両方が表示されます。
アーキテクトの中央の領域で継承項目を選択すると、[詳細] ペインの上部に以下のように表示されます。
[詳細] ペインの残り部分は表示専用です。
以下のサブセクションでは、継承項目を再定義する方法、オーバーライド項目を削除する方法、およびローカル要素を追加する方法を説明します。キューブのコンパイルと構築については、"InterSystems Business Intelligence のモデルの定義" を参照してください。サブキューブは、その他の種類のキューブと同じように扱われます。
継承要素の再定義
継承要素を再定義するには、その要素を中央の領域でクリックしてから、右側の [詳細] ペインで [カスタマイズ] ボタンをクリックします。カスタマイズする要素が最上位レベル要素でない場合は、その要素が含まれた最上位レベル要素をクリックしてから、右側の [詳細] ペインで [カスタマイズ] ボタンをクリックします。
[カスタマイズ] をクリックすると、親キューブからサブキューブに定義がコピーされて、継承された定義をオーバーライドするローカル定義が作成されます。この時点で、このローカル定義を編集できます。
オーバーライド項目の削除
継承された定義をオーバーライドするローカル定義を削除する手順は以下のとおりです。
-
アーキテクトの中央領域で、その項目の行の [X] をクリックします。
-
[OK] をクリックしてこの操作を確定します。
%cube ショートカット
親キューブに %cube 変数を使用するソース式が含まれている場合は、そのキューブをシステムで構築できるようにするために、以下のいずれかの操作を実行する必要があります。
項目の非表示または削除
メジャー、ディメンジョン、計算メンバ、または計算メジャーを非表示にするには、その項目のオーバーライドを追加して、そのオーバーライドで [隠し] オプションを選択します。この場合でもその項目は作成されますが、アナライザには表示されません。
レベルまたは階層を非表示にするには、それらが含まれているディメンジョンを再定義します。そのためには、そのディメンジョンのオーバーライドを追加します。そのオーバーライドで、このディメンジョンに含まれる必要のある階層とレベルをすべて定義します。継承されたディメンジョンは、この新しいディメンジョンに完全に置き換えられます。例えば、新しいディメンジョンでは、親キューブ内の対応するディメンジョンよりも少ない、または多い数のレベルを定義できます。
継承とリレーションシップ
親キューブにリレーションシップがあると、これらのリレーションシップは継承されますが、必ずしも便利な方法で継承されるとは限りません。リレーションシップは必ず元のキューブを指すためです。
例えば、2 つのキューブ (Patient と Encounter) が相互に関連付けられていて、それぞれにサブキューブ (CustomPatient と CustomEncounter) を作成するとします。既定では、CustomPatient には元の Encounter キューブを指すリレーションシップがあります。同様に、CustomEncounter キューブには Patient キューブを指すリレーションシップがあります。CustomPatient と CustomEncounter との間にリレーションシップが必要な場合、そのリレーションシップを明示的にサブキューブで定義する必要があります。
