グラフ コントロールの構成アイテム テンプレート
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
グラフ コントロールの多くは、一般的なテンプレートに基づく構成アイテムを使用します。このトピックでは、次の一般的な構成アイテム テンプレートについて説明します。
ChartFieldテンプレート
ChartFieldテンプレート
すべてのグラフ コントロールには、DataMappingグループでCategoryChartField、ValueChartFields、およびSeriesChartFieldというプロパティがあります。これらのコントロール プロパティの値としてChartField構成項目を指定し、このChartField構成項目でコントロールが使用するグラフ データ フィールド (およびその他の情報) を指定します。
ChartField構成アイテムを作成するには、ChartFieldテンプレートに基づいてアイテムを作成します。規則では、このアイテムはページまたはアプリケーションのPageSettingsフォルダーに配置します。
このアイテムには、次のフィールドがあります。
|
畑 |
形容 |
|---|---|
|
ヘッダーテキスト |
コントロールがこのフィールドのラベルとして表示する名前を指定します。 |
|
データフィールド |
データフィールドの名前を指定します。 |
|
マルチ軸チャートポジション |
このフィールドに対してコントロールが表示する軸の位置を多重軸LineChartで指定します。「左」または「右」を指定できます。 |
|
コンビネーションチャートレンダリング |
組み合わせグラフ表示モードを指定します。線、面、または 列 を指定できます。 |
|
接頭辞 |
コントロールがグラフ値を表示するときに、その値の先頭に追加する文字列を指定します。 |
|
接尾辞 |
コントロールがグラフの値を表示するときにグラフの値に追加する文字列を指定します。 |
|
数値スケール |
コントロールが数値のスケーリングに使用するNumberScale構成項目を指定します。事前定義された項目 (DataSize、Number、Time) のいずれかを指定できます。 独自の数値スケールを作成する方法の詳細については、 NumberScaleテンプレートの説明を参照してください。 |
|
スケール再帰的 |
このフィールドを選択すると、数値スケールが小さなセクションに分割されます。これにより、ユーザーはデータを理解しやすくなります。 たとえば、時間値をプロットすると、3.87日は3日、20時間、52分25秒と表示されます。 |
NumberScaleテンプレート
NumberScaleテンプレート
NumberScale構成項目を使用して、グラフ コントロールに表示される数値をスケーリングします。数値スケールは、スケールに従ってグラフ上の数値を短縮します。ChartField構成アイテムの各グラフ フィールドに対して特定の数値スケーリングを指定できます。
数値スケーリング仕様は、ScaleValueとScaleUnitの2つの一連の値で構成されます。 ScaleValueシリーズは数字の羅列であり、ScaleUnitシリーズはラベルの羅列です。2つのシリーズには、同じ数のメンバーが必要です。
例えば：
事前定義されたNumber設定項目には、ScaleValue"1000,1000,1000" とScaleUnit"K,M,B"があります。これは標準のメートル法スケーリングで、Kは千 (kilo)、Mは百万、Bは数十億です。この構成では、次のように表示するために数値がスケーリングされます。
|
数 |
スケール |
|---|---|
|
800 |
800 |
|
8000 |
8K(全8キロ) |
|
8000000 |
8M |
|
8000000000 |
8Bの |
つまり、同じグラフ内の値に異なるスケールを設定できます (たとえば、8,000と8,000,000が同じグラフの値であった場合)。
ロジックは次のとおりです。
-
値がScaleValueの最初の数値より小さい場合、何も起こりません。「800」は「800」としてスケールされます。
-
値がScaleValueの最初の数値より大きく、ScaleValueの1番目と2番目の数値の積より小さい場合、値はScaleValueの最初の数値で除算され、最初のScaleUnitが追加されます。8000は1000より大きく、1000*1000より小さいです。したがって、8000を1000で割ってKを加算すると、「8000」は「8K」としてスケールされます。
-
値がScaleValueの2番目の数値より大きく、ScaleValueの1番目、2番目、3番目の数値の積より小さい場合、値はScaleValueの1番目と2番目の数値の積で除算され、2番目のScaleUnitが追加されます。8000000は1000*1000より大きく、1000*1000*1000より小さいです。したがって、8000000を1000*1000で除算し、Mを付加すると、「8000000」は「8M」としてスケールされます。
-
等々。
SPEAKには、次の4つの事前定義済みNumberScale構成項目があります。
|
名前 |
スケール値 |
スケールユニット |
|---|---|---|
|
数 |
"1000,1000,1000" |
「K,M,B」 |
|
データサイズ |
"8,1024,1024,1024,1024" |
"バイト,KB,MB,GB,TB" |
|
百分率 | ||
|
時間 (値を秒単位でスケーリング) |
"60,60,24,7" |
「分、時間、日、週」 |
数値のスケールを独自に作成できます。
-
/sitecore/client/Business Component Library/System/Charting/NumberScalesフォルダー内のNumberScaleテンプレートに基づいて項目を作成します。
-
ScaleValueフィールドに、カンマ区切りで引用符で囲まれた数字の文字列を入力します。
-
ScaleUnitフィールドに、コンマ区切りで引用符で囲まれた文字列テキスト文字列を入力します。ScaleValueの数値とScaleUnitのテキスト文字列の数をまったく同じ数に指定することが重要です。
-
このアイテムを保存します。
これで、ChartFieldアイテムのNumberScaleフィールドで作成したNumberScaleアイテムを選択できます。