書式文字列の操作
フォーマット文字列を使用すると、Essbaseデータベース・メンバーの値(セル・コンテンツ)を、問合せ目的でテキスト、日付またはその他のタイプの事前定義済の値として表示されるように、数値タイプのメジャーでフォーマットできます。 結果として表示される値はセルのフォーマットされた値(MDXではFORMATTED_VALUEプロパティ)です。
基礎となる実数は数値であり、この値は関連する書式設定された値の影響を受けません。 書式文字列を使用すると、生の数値のかわりに、より意味のある値を表示できます。 たとえば、テキスト・ベースのフォーマットされた値を使用して、データ・セルを「高」、「中」および「低」として表示できます。
テキストおよび日付タイプの値は、組込みのテキストおよび日付メジャー・タイプを使用して追加でサポートされます。 書式文字列を使用すると、実装の柔軟性が向上します。つまり、書式文字列は複数のディメンションのメンバーに適用できますが、テキスト・メジャーと日付メジャーでは、単一のメジャー・ディメンションにのみ適用できます。 フォーマット文字列は数値ディメンションに適用できます。ディメンションをテキストまたは日付として入力する必要はありません。
フォーマット文字列は、集約ストレージ・データベースまたはブロック・ストレージ・データベースに適用できます。
フォーマット文字列は、次のメンバーで定義できます:
-
Measuresディメンションのすべてのメンバー
-
他のディメンションの明示的な式文字列に関連付けられているメンバー
トピックス:
書式文字列の実装
フォーマット文字列は、集約およびブロック・ストレージ・データベースでサポートされています。 書式文字列はデータベース・レベルで実装します。
書式文字列を有効にして使用するには、次のワークフローを使用します:
-
アウトライン・プロパティで、型付きメジャーを有効にします。
-
勘定科目ディメンションで、メンバーをフォーマットするメジャーを作成し、そのメンバー・プロパティで「フォーマット文字列の関連付け」フィールドを編集してMDXフォーマット・ディレクティブを作成します。 MDX形式ディレクティブを作成する構文は、「MDX形式ディレクティブ」を参照してください。
MDX形式ディレクティブ
書式文字列は、次の構文で定義されます:
format_string_expression = MdxFormat (string_value_expression)string_value_expressionは、MDX仕様(「MDX文法ルール」を参照)で説明されている有効なMDX文字列値式です。
ほとんどのMDX式は、書式設定文字列の指定に使用できますが、書式設定文字列には、書式設定されている現在のセル値以外のデータ・セルの値への参照を含めることはできません。 MDX CellValue関数を使用して、現在のセル値を参照できます。
Essbaseは、フォーマット文字列が無効なメンバーをフォーマット文字列が定義されていないかのように処理します。 アウトラインは、無効な書式文字列を使用して保存できます。 問合せが無効なフォーマット文字列を持つメンバーで構成されている場合、Essbaseは警告を生成します。
メンバーがフォーマット文字列に関連付けられていない場合は、デフォルトのフォーマット・ルールが適用されます。 デフォルトの書式ルールでは、メジャーが数値、テキストまたは日付タイプのいずれであるかに基づいてセルが書式設定されます。 数値メジャーの場合、デフォルトの書式設定された値はその数値のテキスト・バージョンです。 テキスト・メジャーの場合、デフォルトの書式設定された値は、関連付けられたテキスト・リスト・オブジェクトに基づくテキスト値です。 日付値の場合、デフォルトの書式は、アウトライン・プロパティで定義された日付書式文字列に従って書式設定された日付文字列です。
書式文字列をサポートする関数
次のMDX関数は、書式文字列をメジャーに適用する際に役立ちます。 フォーマット文字列は、集約ストレージ・データベースとブロック・ストレージ・データベースの両方でMDX式として適用されます。
-
EnumTextは、内部数値に関連付けられたテキスト・リスト・ラベルを返します。
-
EnumValueは、テキスト・リスト・ラベルの内部数値を返します。
-
CellValueは、現在のセルの内部数値を戻します。
-
NumToStrは、値を小数文字列に変換します。
@ENUMVALUE計算関数は、テキスト・メジャーまたはフォーマット文字列を含むブロック・ストレージ・データベースの計算スクリプトを記述する場合に便利です。 この関数は、内部数値に関連付けられているテキスト・リスト・ラベルを戻します。
MaxL alter session set dml_output文には、set formatted_value on | off句があります。 デフォルトでは、書式設定された値は問合せに表示されますが、この文を使用して書式設定された値の表示をオフにできます。