ジャーニーチャート

演奏時間と単位

DurationとUnitの概念は、JourneyChartコントロールの仕組みを理解する上で重要です。Durationはコントロールが表示するデータの時間範囲です。Unitはチャートの単一のセグメントの時間範囲です。

Duration設定 項目を作成することでDurationを作成します。作成したアイテムをPageSettings項目の下にフォルダに入れ、JourneyChartコントロールのDurationItemsプロパティでこのフォルダを指定します。

JourneyDurationテンプレートに基づいてアイテムを作成することで、Durationアイテムを作成します。アイテムには以下のフィールドがあります:

フィールド

概要

期間

コントロールが表示するデータの時間範囲を指定します。可能な値は日、週、月、四半期、年です。

部隊

チャートの単一のセグメントの時間範囲を指定します。可能な値は、時間、日、週、月、四分期、年のことです。

UnitStep

コントロールが一度に表示する単位数(「ページ」)を指定します。

CanDrillUp

もし正しい場合、コントロールには ドリルアップ ボタンが表示され、ユーザーはドリルアップできます。

CanDrillDown

もしそうであれば、コントロールには 「ドリルダウン 」ボタンが表示され、ユーザーはドリルダウンできます。

SPEAKにはすでに設定されているDuration項目がいくつかあります:

• 時間、日、週、月、四半期、年の 持続時間 項目があります。
• Year項目のCanDrillUpフィールドは「False」に設定されています。
• Hour項目のCanDrillDownフィールドは「False」に設定されています。
• CanDrillUpおよびCanDrillDownフィールドのその他の設定はすべて「True」です。

DurationとUnitフィールドはこのように指定しています:

持続時間項目

期間

部隊

時間

全くありません

時間

日

日

時間

週

週

日

月間

月間

日

四分の一

四分の一

週

年

年

月間

上下にドリルを叩く

ドリルダウンとは、コントロールが現在の単位に持続時間を変更することを意味します。例えば、現在の持続時間が週で現在の単位が日の場合、コントロールは持続時間を日に設定し、表示するデータを更新してドリルダウンします。

コントロールは常にドリルダウンボタンを表示しますが、このボタンは以下の条件下でのみ有効になります。

• 現在の Duration 項目のCanDrillDownフィールドは真です
• ユーザーはセグメントを選択しました

ドリルアップとは、コントロールが持続時間を1桁高い期間に変更することを意味します。例えば、現在の期間が週の場合、コントロールは持続時間を月に設定し、表示するデータを更新することでドリルアップします。

コントロールは常にドリルアップボタンを表示しますが、より長い持続時間がある場合にのみ有効になります。

!注ユーザーがドリルアップすると、ドリルダウン時の持続時間の順序が異なることがあります。例えば、事前に設定されたDuration項目を使う場合に起こります。ユーザーがDurationがMonthの状態でドリルダウンすると、Dayに変わります。Dayの期間でドリルアップすると、Weekに変わります。

詳細パネル

ユーザーがJourneyChartコントロール内のセグメントをクリックした際にSPEAKに詳細パネルを表示するように設定できます。

JourneyChartコントロールのSegmentSelectedActionプロパティを次のように設定しますShowDetails.

例えば、DetailsPanelのプレースホルダーにListControlなどのコントロールを追加してください

DetailsPanelのプレースホルダーに入力したコントロールは自分で入力する必要があります。これはページコードで行えます。以下の文は、ユーザーがセグメントを選択し、SegmentSelectedActionがShowDetailsされているかを確認します:

if (selectedSegment && selectedSegment.action === "ShowDetails") { // Log to the console the data object for selected segment console.log(selectedSegment.dataObject); }

性質

名称

概要

デフォルト

外見

ショーアクシス

もし正しい場合、コントロールは軸を表示します。

確かに

ショーレジェンド

もし正しければ、コントロールはチャートの凡例を表示します。

確かに

ショーバリューズ

もし正しければ、制御はグラフ内のデータ点の値を表示します。

間違いです

シングルチャートハイト

チャートの高さをピクセル単位で指定します。

チャートが一連のチャートの一部であれば、コントロールはそれぞれのチャートにこの高さを示します。

400

シングルチャート幅

100%を指定すると、チャートは利用可能な幅を占めます。数字を指定すると、コントロールはこの幅をピクセル単位でチャートに示します。

チャートがチャートの連続の一部である場合、 100% は各チャートが利用可能な幅全体を持ち、チャートのシーケンスは垂直シーケンスになります。

チャートがチャートの列の一部で整数を指定すると、コントロールは各チャートにピクセル単位の幅を与え、チャートの列は水平に巻き付けられます。

100%

スタックシリーズ

もし正しければ、コントロールは個々のシリーズをマルチシリーズチャートに重ねます。

間違いです

ツールチップ

ユーザーがチャートにマウスを合わせたときに表示したいテキストを指定してください。

全くありません

VisibleCategoriesRange

多系列チャートでこの数値が> 0の場合、コントロールは横軸にこのカテゴリ数を表示します。データにカテゴリが多い場合は、横スクロールが必要です。

この数値が 0の場合、コントロールはすべてのカテゴリを表示します。

0

行動

持続時間項目

Duration項目でフォルダを指定する コントロールにはフォルダ内の各Duration項目にDurationがあります。

IsDurationButtonsPanelVisible

もし正しければ、コントロールは各持続時間ごとにボタンがあるパネルを表示します。コントロールは持続 時間項目の 表示名をその 持続時間項目 のボタンのラベルとして使用します。

SegmentSelectedAction

ユーザーがチャート内のセグメントをクリックしたときに何が起こるかを指定してください:

• NoAction
• DrillDown
  。「 ドリルの上下」を参照してください。
• ShowDetails: コントロールはセグメント の詳細パネルを表示します 。

SelectedDurationItemId

そのページが開くときにコントロールで選択される Duration 項目を指定します。

データ

データ

例えば、コントロールを使用するデータにバインドします。 Binding.ChartDataProvider.Data}

データマッピング

カテゴリチャートフィールド

ChartFieldの項目を指します。コントロールはこのフィールドをチャートのX軸(水平軸)として使います。

カテゴリフィルター

以下のように1つ以上の値を指定します: {value1,value2}。コントロールはこれらの値それぞれを使って、CategoryChartFieldプロパティが指すデータ列をフィルタリングします。

シリーズチャートフィールド

ChartFieldの項目を指します。コントロールはこのフィールドを表示する系列の定義として使用します。

シリーズフィルター

以下のように1つ以上の値を指定します: {value1,value2}。コントロールはこれらの値をそれぞれ、SeriesChartFieldプロパティが指すデータ列の面として使います。

何も入力しない場合、コントロールはデータ列内の各異なる値に対してファセットを作成します。

ValueChartFields

ChartField項目を指します。コントロールはこのフィールドをチャートのY軸(縦軸)として使います。

構成

JourneyFCChartパラメータテンプレートに基づいてアイテムを作成することで、JourneyChartコントロールの設定項目を作成できます。

設定項目には以下の特定のフィールドがあります:

• SegmentSelectedAction
• 持続時間項目
• SelectedDurationItemId
• IsDurationButtonsPanelVisible

以下の場を継承します:

• ショーアクシス
• ValueChartFields
• シングルチャート幅
• カテゴリチャートフィールド
• ショーレジェンド
• データ
• ショーバリューズ
• カテゴリフィルター
• シングルチャートハイト
• IsVisible(見えるもの)
• アクセスキー
• ツールチップ
• 行動
• ID
• VisibleCategoriesRange
• シリーズチャートフィールド
• シリーズフィルター
• スタックシリーズ