syncfusion-wpf-olap-gauge

OLAP ゲージの実装

OLAP データソースの主要業績評価指標（KPI）を表示する Syncfusion® WPF OLAP Gauge コントロールの実装ガイドです。OLAP Gauge は、経営層向けダッシュボードやレポートカードでビジネス上重要な KPI 情報を強調し、目標値に対する値を直感的に表示するのに最適です。

このスキルを使用する場面

次のような場合に、このスキルを使用してください。

• OLAP キューブの KPI データをゲージ形式で表示する
• OLAP データソース（XML/A、SQL Server Analysis Services、Mondrian、ActivePivot）に接続する
• 目標、ステータス、傾向の指標を使ってビジネスメトリクスを視覚化する
• KPI の視覚化を備えた経営層向けダッシュボードを作成する
• OLAP ゲージをオフラインキューブまたはローカル／オンラインサーバーにバインドする
• フレーム、テーマ、レイアウトを使ってゲージの外観をカスタマイズする
• 構造化されたレイアウトで複数のゲージを設定する
• ディメンションと KPI 要素を使ってOLAP レポートを実装する
• 国際対応アプリケーション向けにOLAP ゲージをローカライズする
• 値と目標の情報を表示するツールチップを追加する

コンポーネントの概要

WPF 用の OlapGauge コントロールは、高度な KPI 視覚化機能を提供します。

主な機能

• OLAP データバインディング： XML/A データソース、オフラインキューブ、SQL Server Analysis Services、Mondrian、ActivePivot サーバーを標準でサポート
• KPI の視覚化： KPI 値（ポインター）、目標（マーカー）、ステータス、傾向の指標を表示
• 視覚的なインジケーター： ステータスと傾向を示す信号機、道路標識、標準的な矢印画像
• 複数ゲージのレイアウト： 複数のゲージを表示するためのカスタマイズ可能な行と列のレイアウト
• フレームの種類： 外観を豊かにする、さまざまな組み込みフレームの種類（円形、半円形、全円形）
• テーマ： Office 2010/2013、Metro、Blend、VisualStudio の各テーマをサポート
• ツールチップ： ポインターとマーカーに対するインタラクティブなツールチップ
• カスタマイズ： ヘッダー、ラベル、係数の表示を制御し、ゲージの半径を調整
• ローカライズ： RTL（右から左）の表示に対応した多言語サポート
• XAML による設定： コードビハインドなしで、デザイン時にコントロールを完全に設定可能

アーキテクチャ

OlapGauge Control
├── OlapDataManager (manages OLAP connections)
├── OlapReport (defines cube, dimensions, KPI elements)
├── Gauge Visualization (renders KPI data)
│   ├── Pointers (KPI values)
│   ├── Markers (KPI goals)
│   ├── Status Indicators (visual feedback)
│   └── Trend Indicators (directional arrows)
└── Layout (rows/columns for multiple gauges)

ドキュメントとナビゲーションガイド

はじめに

📄 参照先： references/getting-started.md

OLAP Gauge コントロールを初めてセットアップするときは、このリファレンスを参照してください。

• Visual Studio を通じたコントロールのインストールと追加
• Expression Blend を通じたコントロールのインストールと追加
• コードビハインドを通じたプログラムでのコントロールの追加
• 必要なアセンブリ参照（Syncfusion.OlapGauge.WPF、Syncfusion.Olap.Base など）
• 接続文字列を使った OlapDataManager のセットアップ
• KpiElements と DimensionElements を含む基本的な OlapReport の作成
• キューブ名の定義とディメンションの設定
• 必要な名前空間（Syncfusion.Olap.Reports、Syncfusion.Olap.Manager、Syncfusion.Windows.Gauge.Olap）
• 初期レンダリングとサンプル出力

データバインディング

📄 参照先： references/data-binding.md

OLAP Gauge をデータソースに接続するときは、このリファレンスを参照してください。

• 物理パスを指定してオフラインキューブファイル（.cub）にバインドする
• ローカルの SQL Server Analysis Services にあるキューブにバインドする
• XML/A を介してオンラインの SQL Server にあるキューブにバインドする
• Mondrian サーバーの OLAP キューブにバインドする
• ActivePivot サーバーの OLAP キューブにバインドする
• プロバイダーごとの接続文字列の形式
• 認証と資格情報の設定
• サーバーごとの DataProvider.ProviderName の設定
• 接続の問題のトラブルシューティング

KPI の可視化

📄 参照： references/kpi-visualization.md

KPI の表示機能を使用する場合は、このリファレンスを参照してください。

• KPI 要素と構造の理解
• ポインターを使用した KPI 値の表現
• マーカーを使用した KPI 目標の表現
• KPI ステータスインジケーター（信号機、道路標識）
• KPI トレンドインジケーター（方向矢印）
• KpiElement のプロパティの設定（ShowKPIGoal、ShowKPIStatus、ShowKPIValue、ShowKPITrend）
• 各 KPI コンポーネントの表示オプション
• メンバーと KPI の組み合わせ表示パターン
• パフォーマンス指標の視覚的なフィードバック

カスタマイズ

📄 参照： references/customization.md

ゲージのレイアウトや動作をカスタマイズする場合は、このリファレンスを参照してください。

• ColumnsCount プロパティと RowsCount プロパティによるレイアウトのカスタマイズ
• 複数のゲージの配置の制御
• ゲージヘッダーの表示設定（ShowGaugeHeaders）
• ゲージラベルの表示設定（ShowGaugeLabels）
• ゲージファクターの表示設定（ShowGaugeFactors）
• コードビハインドを使用しない XAML の完全な構成
• DataSource.ConnectionString プロパティと DataSource.ConnectionName プロパティ
• XAML での ReportName と CurrentCubeName の構成
• CategoricalAxis、SeriesAxis、SlicerAxis の定義
• XAML マークアップでのディメンション要素と KPI 要素
• 計算メンバーの構成

外観

📄 参照： references/appearance.md

ゲージの外観をスタイル設定する場合は、このリファレンスを参照してください。

• サイズを調整するゲージ半径の変更
• 組み込みのフレームタイプ（CircularCenterGradient、CircularWithDarkOuterFrames、FullCircle、HalfCircle）
• SkinStorage.VisualStyle によるテーマの適用
• 使用可能なテーマ：Metro、Blend、Office2010Black、Office2010Blue、Office2010Silver
• Office 2013 のテーマ：LightGray、DarkGray、White
• VisualStudio2013 テーマ
• XAML とコードビハインドでのテーマの設定
• SfSkinManager.SetVisualStyle の使用方法

ツールチップとローカライズ

📄 参照： references/tooltips-localization.md

ツールチップや多言語サポートを実装する場合は、このリファレンスを参照してください。

• ポインターツールチップの有効化（ShowPointersTooltip）
• マーカーツールチップの有効化（ShowMarkersTooltip）
• ツールチップの内容と書式設定
• ローカライズの概要と翻訳プロセス
• 適切な命名規則に従ったリソースファイル（.resx）の作成
• ファイル名の形式：Syncfusion.OlapGauge.wpf..resx
• 文化圏の指定に使用する CurrentUICulture の設定
• FlowDirection プロパティによる RTL（右から左）サポート
• アラビア語やヘブライ語などでのローカライズと RTL の組み合わせ

クイックスタートの例

KPI を使用した基本的な OLAP ゲージ

<Window x:Class="OlapGaugeApp.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:syncfusion="http://schemas.syncfusion.com/wpf">
    <Grid>
        <syncfusion:OlapGauge x:Name="OlapGauge1"/>
    </Grid>
</Window>

using Syncfusion.Olap.Manager;
using Syncfusion.Olap.Reports;
using System.Windows;

namespace OlapGaugeApp
{
    public partial class MainWindow : Window
    {
        public MainWindow()
        {
            InitializeComponent();
            
            // Create data manager with connection string
            var olapDataManager = new OlapDataManager(
                "Data Source=http://bi.syncfusion.com/olap/msmdpump.dll; " +
                "Initial Catalog=Adventure Works DW 2008 SE;");
            
            // Set OLAP report
            olapDataManager.SetCurrentReport(CreateOlapReport());
            
            // Bind to gauge
            this.OlapGauge1.OlapDataManager = olapDataManager;
        }

        private OlapReport CreateOlapReport()
        {
            OlapReport report = new OlapReport();
            report.CurrentCubeName = "Adventure Works";

            // Configure KPI element
            KpiElements kpiElement = new KpiElements();
            kpiElement.Elements.Add(new KpiElement 
            { 
                Name = "Revenue", 
                ShowKPIGoal = true, 
                ShowKPIStatus = true, 
                ShowKPIValue = true, 
                ShowKPITrend = true 
            });

            // Configure dimensions
            DimensionElement dimensionElement = new DimensionElement();
            dimensionElement.Name = "Date";
            dimensionElement.AddLevel("Fiscal Year", "Fiscal Year");

            // Add elements to report
            report.CategoricalElements.Add(new Item { ElementValue = kpiElement });
            report.CategoricalElements.Add(new Item { ElementValue = dimensionElement });
            
            return report;
        }
    }
}

一般的なユースケース

複数の KPI を含むエグゼクティブダッシュボード

構造化されたレイアウトで複数の KPI ゲージを表示します。

// Configure 2x2 layout for 4 KPIs
this.OlapGauge1.RowsCount = 2;
this.OlapGauge1.ColumnsCount = 2;

オフラインキューブのバインド

ローカルキューブファイルに接続します。

string connectionString = @"DataSource = C:\Cubes\Adventure_Works_Ext.cub; Provider = MSOLAP;";
OlapDataManager dataManager = new OlapDataManager(connectionString);

XAML の完全な構成

コードビハインドを使用せず、OLAP ゲージ全体を XAML で定義します。

<syncfusion:OlapGauge x:Name="olapGauge" 
                      CurrentCubeName="Adventure Works" 
                      ReportName="SalesReport"
                      olapshared:DataSource.ConnectionString="datasource=localhost; initial catalog=adventure works dw">
    <syncfusion:OlapGauge.CategoricalAxis>
        <syncfusion:Dimension Name="Date" HierarchyName="Fiscal" LevelName="Fiscal Year"/>
        <syncfusion:Kpi Name="Revenue" ShowGoal="True" ShowStatus="True" ShowValue="True"/>
    </syncfusion:OlapGauge.CategoricalAxis>
</syncfusion:OlapGauge>

ツールチップ付きのテーマ設定済みゲージ

テーマを適用し、操作可能なツールチップを有効にします。

<syncfusion:OlapGauge x:Name="OlapGauge1" 
                      ShowPointersTooltip="True" 
                      ShowMarkersTooltip="True"
                      sfshared:SkinStorage.VisualStyle="Metro"/>

主なプロパティ

コアプロパティ

プロパティ	型	説明
OlapDataManager	OlapDataManager	OLAP 接続とデータバインディングを管理します
RowsCount	int	複数のゲージをレイアウトする際の行数です
ColumnsCount	int	複数のゲージをレイアウトする際の列数です
CurrentCubeName	string	使用する OLAP キューブの名前です
ReportName	string	OLAP レポートの名前です

表示プロパティ

プロパティ	型	デフォルト	説明
ShowGaugeHeaders	bool	true	ゲージヘッダーの表示／非表示を切り替えます
ShowGaugeLabels	bool	true	ゲージラベルの表示／非表示を切り替えます
ShowGaugeFactors	bool	true	ゲージファクターの表示／非表示を切り替えます
ShowPointersTooltip	bool	false	ポインター（値）のツールチップを有効にします
ShowMarkersTooltip	bool	false	マーカー（目標）のツールチップを有効にします

外観プロパティ

プロパティ	型	説明
Radius	double	ゲージの半径サイズ
FrameType	GaugeFrameType	フレームのスタイル（Circular、HalfCircle など）
FlowDirection	FlowDirection	レイアウトの方向（LeftToRight／RightToLeft）

XAML 構成プロパティ

プロパティ	説明
DataSource.ConnectionString	OLAP 接続文字列
DataSource.ConnectionName	App.Config の接続名
SharedDataManagerName	共有データマネージャーの参照
CategoricalAxis	カテゴリ軸のディメンションと KPI
SeriesAxis	系列軸のディメンション
SlicerAxis	スライサー軸のディメンション

関連コンポーネント

データ視覚化カテゴリ内

• Circular Gauges - ポインターと範囲を備えた、OLAP を使用しない放射状ゲージの視覚化に使用します
• Charts - 複数のチャートタイプを使用した詳細な OLAP データの視覚化に使用します

その他の Syncfusion WPF コンポーネント

その他の WPF コンポーネントについては、メインライブラリを参照してください。

• Main WPF Library - Syncfusion WPF コンポーネントのドキュメント一式

アセンブリ参照

OLAP ゲージに必要なアセンブリ：

• Syncfusion.OlapGauge.WPF
• Syncfusion.Gauge.WPF
• Syncfusion.Olap.Base
• Syncfusion.OlapShared.WPF
• Syncfusion.Core
• Syncfusion.Shared.WPF

場所：{Drive}:\Program Files (x86)\Syncfusion\Essential Studio\{version}\precompiledassemblies\{version}\{framework}\

ライセンス

v16.2.0.x 以降では、Syncfusion ライセンスキーの登録が必要です。アプリケーションにライセンスキーを含めてください。詳細については、Syncfusion licensing documentation を参照してください。