柏拉圖圖表小器具 (主題化)
簡介
用於顯示柏拉圖圖表。
柏拉圖圖表是一種圖表類型，它是柱狀圖與折線圖的組合。個別值由柱狀圖以遞減的順序表示，累積值由折線圖表示。柏拉圖圖表中的累積線會根據長條中的資料自動計算。
請觀看下列視訊，瞭解如何在 Mashup Builder 中建立柏拉圖圖表。如需以較大的視窗觀看視訊，請按一下視訊標題。
 | • 在 ThingWorx 9.1 及更新版本中，會提供「柏拉圖圖表」小器具。 • 如果您從 SDK 匯入，此小器具會作為「標準」包含在平台中，並作為 web 元件使用。 |
資料格式
您必須使用表示圖表資料結構的欄位定義建立資料負載。資料負載必須包含 X 與 Y 軸值的欄位定義。您可以針對資料系列值新增具有欄位定義的其他欄，來新增多個資料系列。每個資料負載列都表示 X 軸上的類別及其對應的 Y 軸值。下表列出資料負載的資料格式：
X 軸 | Y 軸值 | Y 軸值 N | |
|---|---|---|---|
欄位定義 | x:{name:'x',baseType:'STRING'} | value1:{name:'value1',baseType:'NUMBER'} | value1:{name:'value2',baseType:'NUMBER'} |
使用 | 定義圖表條或欄的 X 軸值。資料必須擁有 STRING 基礎類型。每一列都會顯示為 X 軸上的一個類別。此欄的定義名稱是您應針對 XAaxisField 小器具內容選取的選項。 | 為類別定義 Y 軸值與圖例標籤。 | 為其他每個資料系列定義 Y 軸值與圖例標籤。 |
基礎類型 | STRING | NUMBER | NUMBER |
列範例 | x:'Apple' - 其中 Apple 是要顯示在 X 軸上的類別名稱 | value1:10 - 類別的 Y 軸值 | value2:30 - 第二個資料系列的 Y 軸值 |
下圖顯示具有 y 軸四個欄位定義之資料負載中已傳回資料的範例：
內容表
下表列出的內容適用於 ThingWorx 9.4 或更新版本：
屬性名稱 | 描述 | 基礎類型 | 預設值 | 可繫結 | 可當地語系化 |
|---|---|---|---|---|---|
SampleSize | 指定要顯示在圖表中的資料點數目。 | NUMBER | n/a | N | N |
ShowZoomButtons | 啟用水平或垂直縮放時，在圖表工具列上顯示放大與縮小按鈕。 | BOOLEAN | False | N | N |
EmptyChartIcon | 指定要在圖表為空時顯示的圖示。 | 媒體實體 | not visible | N | N |
EmptyChartLabel | 指定要在圖表為空時顯示的文字。 | STRING | [[ChartStateLabelEmpty]] | N | Y |
ErrorStateIcon | 指定要在圖表為空時顯示的圖示。 | 媒體實體 | error | N | N |
ErrorStateLabel | 指定要在圖表為空時顯示的文字。 | STRING | N | Y | |
LoadingIcon | 指定要在圖表資料載入時顯示的圖示。 | 媒體實體 | chart loading icon | N | N |
NoDataSourceIcon | 指定要在圖表未繫結至資料來源時顯示的圖示。 | 媒體實體 | bind | N | N |
NoDataSourceLabel | 指定要在圖表未繫結至資料來源時顯示的文字。 | STRING | [[ChartStateLabelNoData]] | N | Y |
柏拉圖圖表小器具的內容如下：
屬性名稱 | 描述 | 基礎類型 | 預設值 | 可繫結? (Y/N) | 可當地語系化? (Y/N) | ||
|---|---|---|---|---|---|---|---|
CumulativeLineLabel | 可指定針對圖例區域中的累積線標籤顯示的文字。 | STRING | 百分比 | Y | Y | ||
CumulativeLineMarkerShape | 可設定累積線中資料點的標記形式。 可用選項有「圓形」、「正方形」、「菱形」或「無」。 | STRING | 圓形 | Y | N | ||
CumulativeLineMarkerSize | 可設定累積線中資料點的標記大小。 | NUMBER | 8 | Y | N | ||
CustomClass | 這是套用至小器具頂部分區之使用者定義的 CSS 類別。可輸入多個類別，之間以空格分隔。 | STRING | n/a | Y | N | ||
Data | 圖表的資料負載資料來源。 | INFOTABLE | n/a | Y | N | ||
DataLabel1 - DataLabel24 | 只有在您將 NumberOfSereis 設定為特定數值時，才會列出這些內容。您可以使用內容來為圖例中的每個資料系列指定自訂標籤。如需詳細資訊，請參閱自訂圖表圖例。 | STRING | n/a | N | Y | ||
DataSeriesStyle | 可配置圖表中所有資料序列的狀態格式。 您可根據資料值來設定序列樣式，以便更輕鬆地繪製趨勢或模式圖。 欲配置每個資料序列的格式規則，請輸入 NumberOfSeries 內容的特定值。 | STATEDEFINITION | n/a | N | N | ||
EmphasizeThresholdFactors | 可讓您強調低於指定臨界值的資料。 | BOOLEAN | False | Y | N | ||
ExternalPadding | 設定距離軸的填補。填補是柱狀寬度的百分比。 | NUMBER | 25 | Y | N | ||
HideCumulativeLine | 可隱藏顯示累積百分比的線。 | BOOLEAN | False | Y | N | ||
HideLegend | 隱藏圖例區域。 | BOOLEAN | False | Y | N | ||
HideNotes | 隱藏註記區域。 | BOOLEAN | False | Y | N | ||
HideSecondYAxis | 可隱藏次要 Y 軸。 | BOOLEAN | False | Y | N | ||
HideXAxis | 可隱藏 X 軸。 | BOOLEAN | False | Y | N | ||
HideYAxis | 可隱藏 Y 軸。 | BOOLEAN | False | Y | N | ||
HorizontalAxisMaxHeight | 設定水平軸的最大高度。 | NUMBER | 85 | Y | N | ||
HorizontalAxisLabelsRotation | 設定水平軸上標籤的旋轉角度。您可以輸入介於 -180 至 180 之間的值。 | NUMBER | 自動調整 | N | N | ||
HorizontalZoom | 可讓您在水平軸進行放大。 當您選取此內容時，其他 HorizontalRangeZoom、HorizontalSliderZoom、DirectSelectionZoom 與 DragSelectionZoom 內容會顯示在內容清單中。 | BOOLEAN | False | Y | N | ||
DirectSelectionZoom | 可讓您直接在圖表中選取兩個資料項目來放大。 可用選項有「水平軸」與「無」。 | STRING | 無 | Y | N | ||
DragSelectionZoom | 可讓您在要檢視的資料範圍周圍繪製選取方塊，來放大圖表的特定部份。 可用選項有「水平軸」與「無」。 | STRING | 無 | Y | N | ||
HorizontalRangeZoom | 新增可讓您指定在水平軸放大之值範圍的控制項。 當您選取此內容時，HorizontalStartZoomLabel 與 HorizontalEndZoomLabel 內容會顯示在內容清單中。 | BOOLEAN | False | Y | N | ||
HorizontalStartZoomLabel | 指定範圍選取開始位置的文字標籤。 | STRING | n/a | Y | Y | ||
HorizontalEndZoomLabel | 指定範圍選取結束位置的文字標籤。 | STRING | n/a | Y | Y | ||
HorizontalSliderZoom | 可新增可讓您顯示水平軸上最小值與最大值之間資料的滑桿控制項。 當您選取此內容時，HorizontalSliderZoomMinLabel 與 HorizontalSliderZoomMaxLabel 內容會顯示在內容清單中。 | BOOLEAN | False | Y | N | ||
HorizontalSliderZoomMinLabel | 指定滑桿縮放控制項最小值的文字標籤。 | STRING | n/a | Y | Y | ||
HorizontalSliderZoomMaxLabel | 指定滑桿縮放控制項最大值的文字標籤。 | STRING | n/a | Y | Y | ||
InternalPadding | 設定序列之間的填補。填補是柱狀寬度的百分比。 | NUMBER | 25 | Y | N | ||
Label | 可指定針對柏拉圖圖表顯示的文字標籤。 | STRING | 柏拉圖圖表 | Y | Y | ||
LabelAlignment | 可將小器具標籤文字的對齊設定為「靠左對齊」、「置中」或「靠右對齊」。 | STRING | 左 | N | N | ||
LabelPosition | 可將文字標籤的方位設定在「上」或「下」。 | STRING | 桌面 | N | N | ||
LabelReset | 可指定用於重設圖表縮放之按鈕的標籤。 | STRING | 重設 | Y | Y | ||
LabelType | 可將柏拉圖圖表的標籤類型設定為「標題」、「子標題」、「標籤」或「本文」。 | STRING | 子標題 | Y | N | ||
LegendAlignment | 將圖例文字向「上」、「中」或「下」對齊。 此內容的可用選項取決於 LegendPosition 內容的設定。 | STRING | 桌面 | N | N | ||
LegendFilter | 可新增可讓您在執行時間篩選圖表的圖例篩選器。 | BOOLEAN | False | N | N | ||
LegendMarkerShapes | 將資料系列圖例的標記形狀設定為「正方形」、「圓形」或「無」。 | STRING | 正方形 | N | N | ||
LegendMaxWidth | 設定圖例區域的最大寬度。 | NUMBER | 736 | Y | N | ||
LegendPosition | 可將圖表圖例的方位設定在「上」、「右」、「下」或「左」。 | STRING | 右 | N | N | ||
LineValuesPosition | 可設定值標籤相對於線上資料點的方位。 可用選項有「高於」、「重疊」或「低於」。 | STRING | 上方 | N | N | ||
MultipleDataSources | 可讓您視覺化來自圖表中多個資料來源的資料。 當您選取此內容時，其他 DataSource 與 XAxisField 內容會顯示在內容清單中。 | BOOLEAN | False | N | N | ||
Notes | 可指定要在圖表註記區域顯示的文字。您可以輸入字串或選取當地語系化權杖。 | STRING | n/a | Y | Y | ||
NotesAlignment | 可將註釋區域的對齊設定為「靠左對齊」、「置中」或「靠右對齊」。 | STRING | 左 | N | N | ||
NotesPosition | 將註記區域的方位設定在「上」或「下」。 | STRING | 下 | N | N | ||
NumberOfSeries | 可設定顯示在圖表中的資料序列數目。依預設，「自動」設定會顯示資料負載資料中的所有資料序列。 根據您的設定，其他資料負載 DataField 內容會顯示在您可用來顯示對應數值資料序列的內容清單中。此外，其他 DataSeriesStyle 狀態格式內容也會顯示在內容清單中。 | NUMBER | 自動 | N | N | ||
NumberOfYLabels | 設定要在 Y 軸上顯示的標籤數。
| NUMBER | 自動 | N | N | ||
ResetToDefaultValue | 將此小器具的輸入重設為其預設值。 | n/a | n/a | Y | N | ||
RulersInFront | 在資料值前方顯示量尺。依預設，量尺顯示在資料之後。 | BOOLEAN | False | Y | N | ||
SecondYAxisLabel | 可指定次要 Y 軸的文字標籤。 | STRING | 百分比 | Y | Y | ||
SecondYAxisLabelAlignment | 可將次要 Y 軸標籤的對齊設定為「靠上對齊」、「向中對齊」或「靠下對齊」。 | STRING | 中 | N | N | ||
SecondYAxisMaximumValues | 可設定次要 Y 軸值的最大範圍。根據預設，最大值為 100%。 | NUMBER | 自動 | Y | N | ||
SecondYAxisMinimumValues | 可設定次要 Y 軸值的最小範圍。依預設，最小值為 0%。 | NUMBER | 自動 | Y | N | ||
SeriesClicked | 按一下圖表中的資料點時會觸發事件。 | n/a | n/a | Y | N | ||
ShowLineValues | 可顯示在圖表中的線上所顯示的值標籤。 | BOOLEAN | False | Y | N | ||
ShowHideLegend | 新增了顯示/隱藏按鈕，可讓您在執行時間顯示或隱藏圖表圖例。
| BOOLEAN | False | N | N | ||
ShowValues | 可顯示圖表中的值標籤。 | BOOLEAN | False | Y | N | ||
ShowXAxisRuler | 可顯示 X 軸量尺。 | BOOLEAN | False | Y | N | ||
ShowYAxisRuler | 可顯示 Y 軸量尺。 | BOOLEAN | False | Y | N | ||
SparkView | 顯示圖表視覺化的簡化視圖。 選取此內容可隱藏標籤、圖例與量尺。 | BOOLEAN | False | Y | N | ||
ShowZoomButtons | 啟用水平或垂直縮放時，在圖表工具列上顯示放大與縮小按鈕。
| BOOLEAN | False | N | N | ||
TabSequence | 按下 TAB 時，小器具的序號。 | NUMBER | 0 | N | N | ||
ThresholdLine | 可讓您顯示水平或垂直線，來標記累積百分比的臨界值。 此內容可用的選項有「水平」、「垂直」、「兩者」或「無」。 | STRING | Horizontal | Y | N | ||
ThresholdValue | 可設定臨界線的百分比值。 | NUMBER | 80 | Y | N | ||
VerticalAxisMaxWidth | 設定垂直軸的最大寬度。 | NUMBER | 85 | Y | N | ||
XAxisField | 可指定資料負載欄，其中包含顯示在圖表中之類別的資料。 | INFOTABLE | n/a | N | N | ||
XAxisLabel | 可指定 X 軸的文字標籤。 | STRING | X 軸 | Y | Y | ||
XAxisLabelAlignment | 可將 X 軸標籤的對齊設定為「靠左對齊」、「置中」或「靠右對齊」。 | STRING | 置中 | N | N | ||
YAxisFormat | 可設定 Y 軸值的格式。 | STRING | 0000.0 | Y | N | ||
YAxisLabel | 可指定 Y 軸的文字標籤。 | STRING | Y 軸 | Y | Y | ||
YAxisLabelAlignment | 可將 Y 軸文字標籤的對齊設定為「靠上對齊」、「向中對齊」或「靠下對齊」。 | STRING | 中 | N | N | ||
YAxisMaximumValues | 可設定 Y 軸值的最大範圍。依預設，範圍將根據小器具資料自動計算。若圖表資料包含更大值，將會略過此內容的值。 | NUMBER | 自動 | Y | N | ||
YAxisMinimumValues | 可設定 Y 軸值的最小範圍。依預設，範圍將根據小器具資料自動計算。若圖表資料包含更小值，將會略過此內容的值。 | NUMBER | 自動 | Y | N |