円グラフ・コントロール

「円グラフ」は Coach のグラフにデータを表示します。追加のデータ・セットを表示するためのドリルダウン・ツリーを追加することもできます。

制限

円グラフには、Ajax アクセスを伴うサービス・フローを使用してデータを取り込む必要があります。

「構成」プロパティー・タブで、コントロールの構成プロパティー (外観プロパティーや動作プロパティーなど) の設定や変更を行います。

画面サイズ: プロパティー名の横に「画面サイズ」アイコンがある構成プロパティーには、画面サイズごとに異なる値を指定できます。値を設定しない場合、画面サイズはそのデフォルト値として次に大きい画面サイズの値を継承します。Process Designer デスクトップ・エディターを使用している場合は、大きい画面サイズにその値を設定していることになります。その他の画面サイズはこの値を継承します。

テーマ定義: テーマ定義は、コントロールの色およびスタイルを指定し、コントロールの外観を決定します。コントロールのルック・アンド・フィールをテーマ・エディターでプレビューできます。テーマを参照してください。

以下の表に、円グラフ・コントロールの外観構成プロパティーを示します。

表 1. 円グラフ・コントロールの外観構成プロパティー
外観構成プロパティー	説明	データ型
背景色のスタイル	背景色の色のスタイル。	`ストリング`
データ系列の色のスタイル	データ系列の色のスタイル。	`ストリング`
パンくずリストの表示	このオプションが有効になっている場合、(メニュー選択に応じて) ユーザーがドリルダウンできるツリーの現在位置がタイトルに表示されます。	`ブール`
凡例の配置	グラフの凡例の位置。	`ストリング`
境界半径	グラフの半径。	`ストリング`
Padding	グラフの上下左右の埋め込み (ピクセル単位)。	`ストリング`
高さ	グラフの高さ。	`整数`

以下の表に、円グラフ・コントロールの動作構成プロパティーを示します。

表 2. 円グラフ・コントロールの動作構成プロパティー
動作構成プロパティー	説明	データ型
グラフ・データ・モード	グラフ・データをサービスから取り込むか、構成オプションから取り込むかを選択します。ユーザーがドリルダウンできるツリーは、適切な Ajax アクセスを伴うサービス・フローを使用して取り込むことによってのみ使用できることに注意してください。	`ストリング`
データ・サービス	データ系列にデータを取り込むサービス。	`Ajax サービス`
データ系列	`seriesName` はデータ系列の名前で、`dataPoints` はデータ系列に含めるデータ・ポイントのリストです。	`seriesName` に対しては`ストリング`、`dataPoints` のリストに対しては `DataPoint[]`。
メニューを有効にする	メニューの可視性を有効にします。ユーザーがドリルダウンできるツリーがある場合、またはメニューを追加した場合は、メニューが必要です。	`ブール`
ツールチップの表示	このオプションが有効になっている場合、マウスでグラフ内のデータ・ポイント上にポインターを移動すると、ツールチップが表示されます。ツールチップにはポイントの名前とその値の両方が示されます。	`ブール`

「イベント」タブでコントロールのイベント・ハンドラーの設定や変更を行います。イベントをプログラムでトリガーするかユーザーがコントロールと対話したときにトリガーするように設定できます。イベントの定義方法およびコーディング方法については、ユーザー定義イベントを参照してください。

円グラフ・コントロールには、以下のタイプのイベント・ハンドラーがあります。

ロード時: グラフのロード時にアクティブ化されます。例:
```
me.defocusSeries("Brand1")
```
最新表示時: グラフの最新表示時にアクティブ化されます。例:
```
me.focusSeries("Brand1")
```
クリック時: グラフのクリック時にアクティブ化されます。例:
```
me.transform("donut", ["Brand1","Brand2"])
```

メニュー・アクション時: メニュー・アクションの検出時にアクティブ化されます。例:

console.log("Running menu action '" + action.name + "' on " + me.getSelectedDataPoint().label + " with value of " + me.getSelectedDataPoint().value)

円グラフ・コントロールのメソッドについて詳しくは、JavaScript の資料を参照してください。

Coach の作成方法については、Coach のビルドを参照してください。
標準プロパティー (「一般」、「構成」、「位置決め」、「可視性」、および「HTML 属性」) については、Coach ビューのプロパティーを参照してください。