レベルの定義の詳細

ソース値が標準形式の場合のレベルの定義

ソース値が、$List 形式、%ListOpens in a new tab 形式、または文字区切りリストで使用できる場合、前述のように、以下の追加手順を使用してレベルを定義します。

1. [ソース値リスト・タイプ] で、以下のいずれかを選択します。

   • [$List 構造] — ソース値が $List 関数で返される形式であるか、データ型 %ListOpens in a new tab である場合に使用します。

   • [コンマ区切り] — ソース値がコンマ区切りリストの場合に使用します。

   • [その他の区切り] — ソース値が別の文字を区切り文字として使用するリストの場合に使用します。

2. [その他の区切り] を選択した場合は、[リスト区切り文字] でリストの区切りに使用する文字を指定します。

ソース値が他の形式の場合のレベルの定義

ソース値が、$List 形式で、または文字区切りリストとして使用できない場合は、以下の方法を使用します。

1. 要求されるいずれかの形式に変換するユーティリティ・メソッドを作成します。以下はその例です。

   ClassMethod GetAllergies(ID As %Numeric) As %List
   {
       Set allergies=##class(DeepSee.Study.Patient).%OpenId(ID,0).Allergies
       If (allergies.Count()=0) {Quit $LISTFROMSTRING("No Data Available")}
       Set list=""
       For i=1:1:allergies.Count() {
           Set $LI(list,i)=allergies.GetAt(i).Allergen.Description
           }
       Quit list
   }
   

   

   以下の点に注意します。

   • %ListOpens in a new tab クラスは、$List 形式と同等です。

   • %OpenId() に対する 2 番目の引数によって、同時処理ロックが指定されます。この引数がゼロの場合、速度の確保のため、オブジェクトの他のユーザをチェックすることなくオブジェクトを開いています。オブジェクトから値を読み取るのみの場合は、複数ユーザの環境であってもこの方法が安全です。

   • アレルギーがない場合、このメソッドは文字列 No Data Available を返します。これは、返されるその他の文字列と同様にレベルのメンバになります。

   Tip:

   このユーティリティ・メソッドは、キューブ・クラスに配置できます。また、このメソッドはターミナル内で簡単にテストできます。

2. レベルを定義するときは、アーキテクト内で以下のように操作します。

   1. [式] で、ユーティリティ・メソッドを起動し、引数として %source.%ID を渡します。以下はその例です。

      ##class(Cubes.StudyPatients).GetAllergies(%source.%ID)
      

      

   2. [リスト] を選択します。

   3. ソース値が文字区切りリストの場合は、[リスト区切り文字] でリストの区切りに使用する文字を指定します。

      これが NULL の場合、ソース値は $List 形式であるとみなされます。

例

SAMPLES ネームスペースの Patients キューブには、以下のリスト・ベースのレベルの例があります。

• Allergies レベルは、ユーティリティ・メソッドを使用してリストを返すソース式に基づいています。

• Allergy Severities レベルは、ユーティリティ・メソッドを使用してリストを返すソース式に基づいています。

• Diagnoses レベルは、$List 形式のプロパティを使用します。

概要

時間レベルは、時刻ディメンジョン内で定義されるレベルです。時間レベルのセットの例については、Patients キューブの BirthD ディメンジョンを参照してください。BirthD ディメンジョンは、ソース・クラスの BirthDate プロパティに基づきます。このプロパティには、患者の生年月日が含まれています。

このディメンジョンの各レベルは、[時間関数] と呼ばれるオプションを使用して、生年月日の特定の部分を抽出します。例えば、Year レベルは、生年月日の年の部分のみを抽出します。

結果 ：

• Decade レベルには、2010s、2000s、1990s などのメンバがあります。

• Year レベルには、2009、2008 などのメンバがあります。

• Quarter Year レベルには、Q1 2009、Q2 2009 などのメンバがあります。

• Period レベルには、2009-01、2009-02 などのメンバがあります。

• Date レベルには、Jan 1 2009、Jan 2 2009 などのメンバがあります。

• 階層 H1 内のレベルの順序によって、Decade レベルが Year レベルの親となるように設定されます。例えば、メンバ 1990s は、メンバ 1990、1991、1992 などの親になります。

  同様に、Year レベルは Quarter Year レベルの親です。例えば、メンバ 2009 は、メンバ Q1 2009、Q2 2009 などの親になります。

時間のレベルでは、NOW と呼ばれる特殊なメンバを使用できます。このメンバは現在の日付 (実行時) を使用して、そのレベルの適切なメンバにアクセスします。

時間レベルの定義

時間レベルを定義する手順は以下のとおりです。

1. 前述のようにディメンジョンを定義します。ただし、2 つ変更点があります。

   • [ディメンジョン・タイプ] で、[時間] を選択します。

   • [暦] で、[グレゴリオ] (既定値)、[ヒジュラ (表形式)]、または [ヒジュラ (観測)] を選択します。

     このオプションでは、このディメンジョンのレベルのメンバにソース・レコードを割り当てる際に使用する暦を指定します。

   • [プロパティ] または [式] を指定します。

     [プロパティ] を指定する場合、そのプロパティは %DateOpens in a new tab、%MV.DateOpens in a new tab、%TimeOpens in a new tab、%TimeStampOpens in a new tab、%FilemanDateOpens in a new tab、または %FilemanTimeStampOpens in a new tab のいずれかのタイプであるか、2 番目のサブセクションに示した要件を満たすカスタムのデータ型である必要があります。

     [式] を指定した場合、ソース式が $Horolog 形式のデータを返す必要があります。値を NULL にすることはできますが、0 にすることはできません (値を 0 にすると、キューブの構築時に評価エラーが発生します)。

   ディメンジョンを定義すると、ディメンジョンと階層が作成されます。

2. この階層内でレベルを定義します。

   この場合、データ・ディメンジョンとは異なるオプションが表示されます。

3. [関数で値を抽出] で、日付/時間値の必要な部分を抽出する関数を選択します。以下のテーブルのいずれかの値を使用します。ヒジュラ暦の場合は、すべての関数がサポートされるわけではないことに注意してください。

   時間関数	格納される値	表示される値	ヒジュラ時間ディメンジョンでの使用可否
   MinuteNumber	60958,5083	01:24	はい
   HourNumber	60958,5083	1am	はい
   DayMonthYear	60958	Nov 24 2007	はい
   DayNumber	24	24	はい
   WeekYear	2007W47	2007W47	いいえ
   WeekNumber	47	47	いいえ
   MonthNumber	11	November	はい
   MonthYear	200711	November 2007	はい
   QuarterNumber	4	Q4	はい
   QuarterYear	20074	Q4 2007	はい
   Year	2007	2007	はい
   Decade	1950	1950s	はい
   DayOfWeek	1	Sunday (日曜日)	不可

4. [時刻形式] には、オプションで、日付の表示方法を説明する形式文字列を指定します。詳細は、最初のサブセクションを参照してください。

5. [ヒジュラ (観測)] 暦を使用している場合は、%Calendar.HijriOpens in a new tab クラスを使用して太陰観測値を追加します。

   詳細は、%Calendar.HijriOpens in a new tab のクラスリファレンスを参照してください。

WeekYear 関数と WeekNumber 関数は、ISO 8601Opens in a new tab 標準 (1 ～ 53 の週番号を 1 年のすべての日付に割り当てる) に準拠しています。365 または 366 は 7 で割り切れないので、週数が 53 になる年があります。年の第 1 週は、その年の最初の木曜日が含まれる週として定義されています。これは、1 月 1 日が前年最終週に含まれる年があることを意味します。同様に、12 月 31 日が翌年第 1 週に含まれる場合もあります。

時間レベルおよび階層

既に述べているように、階層内のレベルの順序はレベルのメンバの作成方法に影響します。同一階層内の隣接する 2 つのレベルでは、最初のレベル (レベル A) が 2 番目のレベル (レベル B) の親になります。階層は親子階層であるため、以下のようになります。

• レベル A のメンバはすべて、レベル B の 1 つ以上のメンバの親です。

• レベル B のメンバはすべて、レベル A の 1 つのメンバの子です。

• レベル B の特定のメンバに属するレコードはすべて、必ずレベル A の同一メンバに属します。

このため、例えば [年] に基づくレベルが [四半期] に基づくレベルの親になることはできません。2 人の患者について考えてみましょう。1 人は 2007 年第 3 四半期に生まれ、もう 1 人は 1982 年第 3 四半期に生まれています。この 2 人の患者はいずれも Quarter レベルの同じメンバ (Q3) に属していますが、Year レベルでは異なるメンバ (それぞれ 2007 と 1882) に属しています。

また、例えば [月] に基づくレベルが [WeekNumber] に基づくレベルの親になることはできません。週は 2 つの月に渡ることがあるため、週メンバに属するレコードが必ずしも同じ月メンバに属しているとは限りません。

以下のテーブルは時間レベルとその一般的な子レベルを示しています。参考のため、各レベルのメンバ例も示しています。

日付オフセットがあるカレンダーの処理

場合によっては、日付オフセットを含む財務カレンダーに時間レベルを一致させることが必要になります。例えば、会計年度は多くの企業で 10 月 1 日に開始します。以下のピボット・テーブルで考えてみましょう。

最も内側のグループ化では、このピボット・テーブルは実際の期間 (年と月の結合) によってレコードをグループ化します。例えば、実際の期間 2001 年 10 月に 14 レコードが関連付けられています。この期間は会計四半期にグループ化され、会計四半期は会計年度にグループ化されます。四半期 FY 2002–Q1 には、2001 年 10 月、11 月、12 月が含まれることに注意してください。

このような時間レベルの場合、スタジオでキューブ・クラスを編集し、<level> 要素の timeOffset プロパティと timeFormat プロパティを指定します。ここで示した例の場合は以下のようになります。

• 最初の 2 つのレベル (FY 2002、FY 2002–Q1 などのメンバのあるレベル) では、timeOffset が "-3m" になります (これらのレベルで使用される日付値から 3 か月減算します)。

• 3 番目のレベル (Oct-2001 などのメンバのあるレベル) では、timeOffset が指定されず、このレベルでは実際の日付値が使用されます。

詳細は、付録 “キューブ・クラスのリファレンス情報” の “日付オフセットの指定” を参照してください。

例

SAMPLES ネームスペースには、以下の時間レベルの例があります。

• Patients キューブで、BirthD、BirthQD、および BirthTD の各ディメンジョンを参照してください。

• HoleFoods Sales キューブで、DateOfSale レベルを参照してください。

例

SAMPLES ネームスペースの Patients キューブでは、BirthWeekdayD ディメンジョンを参照してください。このディメンジョンの場合、式は以下のようになります。

$system.SQL.DAYNAME(%source.BirthDate)

このメソッドは、%SYSTEM.SQLOpens in a new tab クラスの DAYNAME() メソッドを実行します。このクラスには、データ値を処理するメソッドが大量に用意されています。

このディメンジョンを使用すると、以下のようにピボット・テーブルを作成できます。

このサンプル・ディメンジョンは、1 つのレベルのみ定義しています。適切なロジックを使用すると、例えば 4-4-5 カレンダーOpens in a new tabの週、月、および四半期を使用する階層を定義できます。

数値ビンの定義

数値ビンを定義する場合、範囲式エディタは以下のように表示されます。

このテーブルの各行が、以下のように数値ビンを定義します。

• 行の左端のボタンは、下限の値を含む か、含まない かを示します。

  下限が存在しない場合は、このオプションは何の効果も持ちません。

  下限の値を含むとは、[下限] に示された値が範囲に含まれることを意味します。下限の値を含まないとは、[下限] の値が範囲に含まれないことを意味します。

• [下限] は、指定されている場合は、ビンの下限を示します。

• [上限] は、指定されている場合は、ビンの上限を示します。

• 行の右端のボタンは、上限の値を含む か、含まない かを示します。

  上限が存在しない場合は、このオプションは何の効果も持ちません。

• [置換値] は、このレベルのメンバ名として使用する文字列を指定します。ソース値が定義されている範囲内にあるレコードはすべて、このメンバに割り当てられます。

  この値は、メンバのキーにもなります。

このレベルでは、ソース値が指定されているどのビンにも該当しないレコードは無視されます。

文字列置換の定義

文字列置換を定義する場合、範囲式エディタは以下のように表示されます。

このテーブルの各行が、以下のように文字列置換を定義します。

• [元の値] は、このレベルのソース・プロパティまたはソース式の可能な値を指定します。

• [置換値] は、このレベルのメンバ名として使用する文字列を指定します。ソース値が [元の値] に指定されている値と一致するレコードはすべて、このメンバに割り当てられます。

  この値は、メンバのキーにもなります。

このレベルでは、ソース値が指定されているどの元の値にも一致しないレコードは無視されます。

例

SAMPLES ネームスペースには、以下の範囲式の例があります。

• Patients キューブで、Age Group レベルを参照してください。

• HoleFoods Sales キューブで、Discount Type レベルを参照してください。

例

SAMPLES ネームスペースには、以下のような [DISPLAYLIST の値を使用] オプションを使用するレベルの例があります。

• Patients キューブの Gender レベル。

• HoleFoods Sales キューブの Channel Name レベル。

例

SAMPLES ネームスペースには、以下のような、[メンバ名として使用] または [実行時に値を取得]、あるいはその両方で構成されたプロパティを持つレベルの例があります。

• Patients キューブの DxDoc レベル。このレベルには、Name プロパティがあります。このプロパティは、[メンバ名として使用] で構成されています。DxDoc レベルは、医師の一意の ID に基づいています。生成した患者の数によっては、同名の複数の医師が表示される場合があります。このレベルの定義方法により、これらの医師どうしは結合されません。

• Patients キューブの City レベル。このレベルには、Name プロパティがあります。このプロパティは、[メンバ名として使用] と [実行時に値を取得] で構成されています。

• HoleFoods Sales キューブの City レベルと Channel Name レベル。これらのレベルには、[メンバ名として使用] で構成されるプロパティがあります。

• HoleFoods Sales キューブの Product Name レベル。このレベルには、[メンバ名として使用] と [実行時に値を取得] で構成されるプロパティがあります。

データ・レベルの場合

データ・レベルの場合、既定では、メンバは以下のように並べられます。

• レベルで範囲式を使用しない場合、メンバは名前の昇順に並べ替えられます (名前の形式にかかわらず、アルファベット順の並べ替えを使用)。

• そのレベルで範囲式を使用する場合、メンバは範囲式で決定される順序で並べ替えられます。すなわち、最初のメンバは範囲式の最初の置換によって決定され、2 番目のメンバは 2 番目の置換によって決定され、以下同様に決定されます。

データ・レベルのメンバの並べ替え順序を変更するには、後続のサブセクションで説明する方法のいずれかを使用します。

時間レベルの場合

既定では、時間レベルのメンバは、時間によって昇順に並べ替えられています。

メンバに対して別の並べ替え順序を指定するには、[ソート] オプションを指定します。[昇順] (時間の昇順) または [降順] (時間の降順) のいずれかを選択します。

例

この機能の動作を確認するために、以下のデモを試してみます。

1. アーキテクトで Patients キューブを開きます。

2. PatGrpD ディメンジョンの Patient Group レベルを編集します。[依存] を以下のように指定します。

   [HomeD].[H1].[ZIP]
   

   

3. キューブを保存して、コンパイルします。

4. SAMPLES ネームスペースで、ターミナルから DeepSee.PopulateOpens in a new tab の ReassignPatients() メソッドを実行します。

   d ##class(DeepSee.Populate).ReassignPatients()
   

   

   このメソッドは、Patient Group レベルと ZIP code レベルの間に仮想依存関係が存在するように、このサンプルのデータを変更します。特定の郵便番号の患者は、患者グループ A に属するか、どのグループにも属さないかのどちらかであり、別の郵便番号の患者は、患者グループ B に属するか、どのグループにも属さないかのどちらかです。

   このメソッドはキューブを同期するので、その実行後にこのキューブを再構築する必要はありません。

Basic Dashboard Demo を開き、Home ZIP Code フィルタと Patient Group フィルタを試します。郵便番号を選択すると、Patient Group フィルタのリストに影響します。