1. コンポーネントライブラリ

ジャーニーチャート

Version:
日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

JourneyChartコントロールには、拡張ColumnChartチャートが表示されます。JourneyChartコントロールは、ColumnChartコントロールに次の機能を追加します。

  • ユーザーは、コントロールがグラフに表示するデータの時間範囲 ("期間") を選択できます。

  • ユーザーはページングを切り替えることができます。コントロールは、現在表示されている日付範囲の前または後の日付範囲に使用できるデータがあるかどうかを確認します。その場合、コントロールには必要に応じて戻るボタンと進むボタンが表示されます。

  • ユーザーが時間範囲を通じて「ドリルアップ」および「ドリルダウン」できるように指定できます。

  • ユーザーがグラフのセグメントのDetails Panelを開くことができるように指定できます。

期間と単位

DurationとUnitの概念は、JourneyChartコントロールのしくみを理解するために重要です。Durationは、コントロールが表示するデータの時間範囲です。Unitは、グラフの1つのセグメントの時間範囲です。

期間を作成するには、Duration構成アイテムを作成します。作成した項目をPageSettings項目の下のフォルダに配置し、このフォルダをJourneyChartコントロールのDurationItemsプロパティで指定します。

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

畑

形容

期間

コントロールが表示するデータの時間範囲を指定します。指定できる値は、Day、Week、Month、Quarter、Yearです。

単位

グラフの1つのセグメントの時間範囲を指定します。指定できる値は、Hour、Day、Week、Month、Quarter、Yearです。

ユニットステップ

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

缶ドリルアップ

trueの場合、コントロールにDrill-Upボタンが表示され、ユーザーはドリルアップできます。

缶ドリルダウン

trueの場合、コントロールにはDrill-Downボタンが表示され、ユーザーはドリルダウンできます。

SPEAKには、すでに構成されているDuration項目がいくつかあります。

  • 時間、日、週、月、四半期、年Duration項目があります。

  • YearアイテムのCanDrillUpフィールドが「False」に設定されています。

  • HourアイテムのCanDrillDownフィールドが「False」に設定されています。

  • CanDrillUpフィールドとCanDrillDownフィールドの他のすべての設定は "True" です。

DurationフィールドとUnitフィールドは次のように指定します。

期間アイテム

期間

単位

時

何一つ

時

日

日

時

週

週

日

月

月

日

四半期

四半期

週

年

年

月

ドリルアップとドリルダウン

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

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

  • 現在のDuration項目のCanDrillDownフィールドがtrueである

  • ユーザーがセグメントを選択しました

ドリルアップとは、コントロールが期間を1桁大きい期間に変更することを意味します。たとえば、現在の期間がWeekの場合、コントロールは期間をMonthに設定し、表示するデータを更新することでドリルアップします。

コントロールには常にドリルアップ ボタンが表示されますが、それを有効にするのは、より大きなマグニチュードの期間がある場合のみです。

メモ

期間の順序は、ユーザーがドリルアップするときとドリルダウンするときで異なる場合があります。これは、たとえば、事前設定されたDurationアイテムを使用する場合に発生します。期間がMonthしているときにユーザーがドリルダウンすると、期間はDayに変わります。期間がDayしているときにユーザーがドリルアップすると、期間はWeekに変わります。

詳細パネル

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

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);
}

プロパティ

名前

形容

デフォルト

Appearance

軸を表示

trueの場合、コントロールは軸を表示します。

真

凡例を表示

trueの場合、コントロールにはグラフの凡例が表示されます。

真

値の表示

trueの場合、コントロールはグラフ自体の内部にあるデータ ポイントの値を表示します。

偽

シングルチャートの高さ

グラフの高さをピクセル単位で指定します。

グラフが一連のグラフの一部である場合、コントロールは個々のグラフにこの高さを与えます。

400

シングルチャート幅

100%を指定すると、グラフは使用可能な幅を使用します。数値を指定すると、コントロールはグラフにこの幅をピクセル単位で指定します。

グラフがグラフのシーケンスの一部である場合、100% は、各グラフが使用可能な幅全体を持ち、グラフの順序が垂直方向のシーケンスになることを意味します。

グラフがグラフのシーケンスの一部であり、整数を指定すると、コントロールによって各グラフにこの幅がピクセル単位で与えられ、グラフのシーケンスは水平方向に折り返されます。

100%

スタックシリーズ

trueの場合、コントロールは複数系列グラフの個々の系列を積み上げます。

偽

ツールチップ

ユーザーがグラフの上にマウスを置いたときに表示するテキストを指定します。

何一つ

VisibleCategoriesRange (表示カテゴリ範囲)

複数系列グラフで、この数値が > 0の場合、コントロールはこの数のカテゴリを横軸に沿って表示します。データにさらに多くのカテゴリが含まれている場合、ユーザーは水平方向にスクロールする必要があります。

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

0

Behaviors

DurationItems (デュレーションアイテム)

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

IsDurationButtonsPanelVisibleです

trueの場合、コントロールには、各Durationのボタンを含むパネルが表示されます。コントロールは、Duration項目のDisplay Nameを、そのDuration項目のボタンのラベルとして使用します。

セグメント選択アクション

ユーザーがグラフ内のセグメントをクリックしたときの動作を指定します。

  • NoAction: 何も起こりません

  • DrillDown: コントロールは次の期間レベルにドリルダウンします。 ドリルアップとドリルダウンを参照してください。

  • ShowDetails: コントロールには、セグメントのDetailsパネルが表示されます。

SelectedDurationItemId (選択期間項目ID)

コントロールが表示されているページを開いたときにコントロールによって選択されるDuration項目を指定します。

Data

データ

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

データマッピング

カテゴリーChartField

ChartFieldアイテムをポイントします。コントロールは、このフィールドをグラフのX軸 (水平軸) として使用します。

カテゴリーフィルター

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

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

ChartFieldアイテムをポイントします。コントロールは、表示する系列の定義としてこのフィールドを使用します。

シリーズフィルター

次のように1つ以上の値を指定します: {value1,value2}。コントロールは、これらの各値を、SeriesChartFieldプロパティが指すデータ列のファセットとして使用します。

何も入力しない場合、コントロールはデータ列の個別の値ごとにファセットを作成します。

バリューチャートフィールド

ChartFieldアイテムをポイントします。コントロールは、このフィールドをグラフのY (垂直) 軸として使用します。

構成

JourneyChartコントロールの構成項目を作成するには、JourneyFCChart Parametersテンプレートに基づいて項目を作成します。

構成アイテムには、次の特定のフィールドがあります。

  • セグメント選択アクション

  • DurationItems (デュレーションアイテム)

  • SelectedDurationItemId (選択期間項目ID)

  • IsDurationButtonsPanelVisibleです

次のフィールドを継承します。

  • 軸を表示

  • バリューチャートフィールド

  • シングルチャート幅

  • カテゴリーChartField

  • 凡例を表示

  • データ

  • 値の表示

  • カテゴリーフィルター

  • シングルチャートの高さ

  • 目に見える

  • アクセスキー

  • ツールチップ

  • 動作

  • 身分証明書

  • VisibleCategoriesRange (表示カテゴリ範囲)

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

  • シリーズフィルター

  • スタックシリーズ

この記事を改善するための提案がある場合は、 お知らせください!