Hyperion Essbase の接続の種類 (SSRS)

[アーティクル]
03/23/2023

Hyperion Essbase 外部データソースのデータをレポートに含めるには、種類が Hyperion Essbase のレポートデータソースに基づいたデータセットが必要です。このビルトインデータソースの種類は、Hyperion Essbase のデータ拡張機能に基づいています。これを使用すると、Hyperion Essbase 外部データソースから多次元データを取得できます。

このトピックの情報を使用して、データソースを構築してください。ステップバイステップの手順については、「データ接続を追加および確認する (レポートビルダーおよび SSRS)」を参照してください。

Connection String

次の接続文字列例では、13080 番ポートを使用してサーバー上の Hyperion Essbase データソースを指定し、SOAP を使用してインターネット経由の XML for Analysis Services (XMLA) を指定して、Sample カタログに接続しています。

Data Source=https://localhost:13080/aps/XMLA; Initial Catalog=Sample

接続文字列の例について詳しくは、「データ接続文字列を作成する - レポートビルダーおよび SSRS」を参照してください。

資格情報

クエリの実行、ローカルでのレポートのプレビュー、およびレポートサーバーからのレポートのプレビューには、資格情報が必要です。

レポートをパブリッシュした後、レポートをレポートサーバーで実行するときに、データを取得するための権限が有効な状態になるように、データソースの資格情報を変更する必要が生じる場合があります。

詳細については、「レポートデータソースに関する資格情報と接続情報を指定する」をご覧ください。

クエリ

クエリは、次の方法で指定できます。

クエリを対話形式で作成します。グラフィカルクエリデザイナーのデザインモードまたはクエリモードを使用して、外部データソースのメタデータを参照しながら、多次元式 (MDX) 構文のクエリを生成します。
- デザインビュー : ディメンション、メンバー、メンバープロパティ、メジャー、および KPI をメタデータブラウザーから データ ペインにドラッグして、MDX クエリを作成します。計算されるメンバーペインから、計算されるメンバーをデータペインにドラッグして、追加のデータセットフィールドを定義できます。
- クエリビュー ：ディメンション、メンバー、メンバープロパティ、メジャー、および KPI をメタデータブラウザーからクエリペインにドラッグして、MDX クエリを作成します。クエリペインでは、直接 MDX テキストを編集できます。計算されるメンバーを計算されるメンバーペインからクエリペインにドラッグして、追加のデータセットフィールドを定義します。
詳細については、「Hyperion Essbase クエリデザイナーのユーザーインターフェイス (レポートビルダー)」を参照してください。
レポートから既存の MDX クエリをインポートします。 [クエリのインポート] ボタンを使用して、.rdl ファイルを参照し、クエリをインポートします。クエリは、Hyperion Essbase データソースに基づく埋め込みデータセットを含むレポートからインポートできます。 MDX クエリを .mdx ファイルから直接インポートすることはできません。

デザイン時には、クエリを実行して結果セットを表示します。クエリを作成した後、メタデータから生成されたデータセットフィールドコレクションがレポートデータペインに表示されます。レポートの実行時には、外部データソースから実際のデータが返されます。

Hyperion Essbase データ処理拡張機能では、拡張データセットフィールドプロパティがサポートされています。これらの値は外部データソースから取得できますが、レポートデータペインには表示されません。詳細については、このトピックの「拡張フィールドプロパティ」を参照してください。

クエリパラメーター

クエリパラメーターを含めるには、クエリデザイナーのフィルター領域でフィルターを作成し、そのフィルターをパラメーターとして設定します。各パラメーターに対して、使用可能な値を提供するデータセットが自動的に作成されます。既定では、これらのデータセットはレポートデータペインに表示されません。詳細については、「多次元データのパラメーター値の非表示データセットの表示 (レポートビルダーおよび SSRS)」を参照してください。

各レポートパラメーターの既定のデータ型は Textです。レポートパラメーターを作成した後に、既定値の変更が必要になる場合があります。詳細については、「レポートパラメーター (レポートビルダーおよびレポートデザイナー)」をご覧ください。

拡張フィールドプロパティ

Hyperion Essbase データ処理拡張機能では、拡張フィールドプロパティがサポートされています。拡張フィールドプロパティは、 Value と IsMissing に追加する形で、データ処理拡張機能によってデータセットのフィールドに定義されるプロパティです。拡張プロパティには、定義済みプロパティとカスタムプロパティがあります。定義済みのプロパティは、複数のデータソースに共通のプロパティです。カスタムプロパティは、各データソースの固有のプロパティです。

拡張フィールドプロパティは、レポートレイアウトにドラッグすることのできるアイテムとして [レポートデータ] ウィンドウには表示されません。その代わりに、このプロパティの親フィールドをレポートにドラッグすることによって、既定のプロパティである Value を必要なプロパティに変更することが可能です。

クエリデザイナーのメタデータペインでフィールドにカーソルを合わせると、拡張フィールドプロパティの名前がツールヒントに表示されます。基になっているデータの調査に使用できるクエリデザイナーの詳細については、「 Hyperion Essbase クエリデザイナーのユーザーインターフェイス」を参照してください。

注意

拡張フィールドプロパティに対応する値が存在するのは、そのプロパティが MDX 式に含まれており、レポートを実行して対応するデータセットのデータを取得する際に、データソースによって値が提供された場合のみです。その場合、次のセクションに示す構文を使用して、すべての式からこれらの Field プロパティ値を参照できます。ただし、これらのフィールドはこのデータプロバイダーに固有であり、レポート定義言語には含まれないため、これらの値に加えた変更はレポート定義には保存されません。

定義済みフィールドプロパティ

複数のデータプロバイダーで一般的にサポートされ、レポートデータセットの基となる MDX クエリに表示される定義済みフィールドプロパティ。たとえば、MDX ディメンションプロパティ MEMBER_UNIQUE_NAME は、定義済みレポートデータセットフィールドプロパティ UniqueNameにマッピングされます。一意な名前の値をテキストボックスに入力するには、=Fields!<FieldName>.UniqueName という式を使用します。

次の表に、Hyperion Essbase データソースで使用できる定義済みフィールドプロパティの一覧を示します。

Property	Type	説明/有効値
Value	Object	フィールドのデータ値を指定します。ディメンションプロパティの場合は、MEMBER_CAPTION にマッピングされます。メジャーの場合は、データ値にマッピングされます。
IsMissing	Boolean	フィールドが結果データセットに存在するかどうかを示します。
FormattedValue	String	主要データの書式設定した値を返します。 MDX 式の FORMATTED_VALUE からマッピングされます。
BackgroundColor	String	データベースで定義されたフィールドの背景色を返します。 MDX 式の BACK_COLOR からマッピングされます。
Color	String	データベースで定義されたアイテムの前景色を返します。 MDX 式の FORE_COLOR からマッピングされます。
UniqueName	String	レベルの完全修飾名を返します。 MDX 式の MEMBER_UNIQUE_NAME からマッピングされます。

フィールドおよびフィールドプロパティを式で使用する方法の詳細については、「式で使用される組み込みコレクション (レポートビルダーおよび SSRS)」を参照してください。

カスタムプロパティ

データプロバイダーでサポートされ、レポートデータセットの基となる MDX クエリで使用される一方で、レポートのデータセットペインにはそのデータセットのフィールドとして表示されないカスタムフィールドプロパティ。たとえば、 [長い名前] はディメンションレベルで定義されたメンバープロパティです。値をテキストボックスに入力するには、=Fields!<FieldName>("Long Names") という式を使用します。この式ではフィールド名の大文字と小文字が区別されます。

カスタム拡張プロパティを式の中で参照するには、次の構文を使用します。

Fields!FieldName("PropertyName")

次の表に、Hyperion Essbase データソースで使用できるカスタムフィールドプロパティを示します。

Property	Type	説明/有効値
FORMAT_STRING	String	メジャーで定義されます。String 型として使用できる FormattedValue です。

解説

このデータプロバイダーでは使用できないレポート配信モードもあります。このデータ処理拡張機能では、データドリブンサブスクリプションを使ったレポートの配信はサポートされません。詳細については、「サブスクライバーデータに対して外部データソースを使用する (データドリブンサブスクリプション)」を参照してください。

詳細については、「 SQL Server 2005 Reporting Services を Hyperion Essbase と組み合わせて使用する方法」を参照してください。