チャートコントロールのための構成項目テンプレート
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
多くのチャートコントロールは共通テンプレートに基づく設定項目を使用しています。本トピックでは、これらの一般的な構成項目テンプレートについて説明します:
ChartFieldテンプレート
すべてのチャートコントロールには、DataMappingグループ内にCategoryChartField、ValueChartFields、SeriesChartFieldというプロパティがあります。これらのコントロールプロパティの値としてChartFieldの設定項目を指定し、このChartField設定項目でコントロールが使用するチャートデータフィールド(およびその他の情報)を指定します。
ChartFieldの設定項目は、ChartFieldテンプレートに基づいてアイテムを作成することで作成します。慣例としては、この項目をページやアプリケーションのPageSettingsフォルダに入れます。
この項目には以下のフィールドがあります:
フィールド
概要
ヘッダーテキスト
このフィールドのラベルとしてコントロールに表示される名前を指定します。
DataField
データフィールドの名前を指定してください。
多軸チャート位置
多軸 線図のこのフィールドに対して、コントロールが示す軸の位置を指定します。左または右を指定できます。
CombinationChartRenderAs
チャートレンダリングモードの組み合わせを指定する。線、面積、列のいずれかを指定できる。
接頭辞
チャートの値を表示する際にコントロールが先行する文字列を指定します。
接尾辞
チャートの数値表示時にコントロールが付加する文字列を指定します。
ナンバースケール
コントロールが数値のスケーリングに使用する NumberScale の設定項目を指定します。これらのあらかじめ定義された項目のいずれかを指定できます
、Number、またはTime。自分で数目盛りを作る方法の詳細や情報については、 NumberScaleテンプレートの説明をご覧ください。
再帰的にスケール
このフィールドを選択すると、数値スケールはより小さなセクションに分かれています。これにより、ユーザーがデータを理解しやすくなります。
例えば、時間の値をプロットすると、3.87日は3日20時間52分25秒として表示されます。
ナンバースケールのテンプレート
NumberScaleの設定項目を使って、チャートコントロールに表示される数値をスケールします。数字スケーリングは、スケールに応じてチャート上の数字を短縮します。ChartFieldの設定項目で、各チャートフィールドごとに特定の数値スケーリングを指定することができます。
数値スケーリング仕様は、ScaleValueとScaleUnitという2つの値の系列から成ります。ScaleValueシリーズは数字の連続であり、ScaleUnitシリーズはラベルの連続です。両シリーズは同じメンバー数でなければなりません。
例えば:
あらかじめ定義された 番号 設定項目にはScaleValue"1000,1000,1000" とScaleUnit"K,M,B"があります。これは標準的なメトリックスケーリングです
(キロ)、Mは百万、Bは数十億です。この構成では、数値をこのように表示します:番号
スケール as
800
800
8000
8K
8000000
8歳男
8000000000
8B
つまり、同じチャート内の値が異なるスケールを持つことがあります(例えば、同じチャート内の値が8,000と8,000,000の場合)。
その論理は以下の通りです。
- ScaleValueの最初の数値より小さい場合は何も起こりません。「800」は「800」とスケールします。
- もしその値がScaleValueの最初の数字より大きく、ScaleValueの最初の数字と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より小さいです。したがって、80000000は1000×1000で割り、Mを付け加えます。「80000000」スケールは「8M」と表記されます。
- などなど。
SPEAKには4つのあらかじめ定義 されたNumberScale構成項目があります:
名称
スケールバリュー
スケールユニット
番号
"1000,1000,1000"
「K、M、B」
データサイズ
"8,1024,1024,1024,1024"
「バイト、KB、MB、GB、TB」
割合
時間(秒単位で値をスケール)
"60,60,24,7"
「min, hr, day, wk」
自分で数字のスケールを作ることができます:
- /sitecore/client/Business Component Library/System/Charting/NumberScalesフォルダ内のNumberScaleテンプレートに基づいてアイテムを作成します。
- ScaleValueフィールドにカンマ区切りで引用された数字の列を入力してください。
- ScaleUnitフィールドにカンマ区切りで引用符付きの文字列を入力してください。ScaleValueで数字の数とテキスト文字列をScaleUnitで正確に指定することが重要です。
- このアイテムを保存してください。
ChartField項目のNumberScaleフィールドで作成したNumberScale項目を選択できます。