資料總管圖表組態

對於某些資料總管區域,以圖形形式 (例如圓餅圖或折線圖) 顯示結果會更有效力。圖表組態可利用視覺化選項參數來與擷取資料的資料總管區域整合。

視覺化選項參數支援三個選項:

  • 方格 - 以標準資料總管方格顯示資料
  • 圖表 - 以圖表形式顯示資料
  • 對應 - 可叫用「UI 對應」來顯示資料

最多可以指定五個視覺化選項參數。其中一個選項必須是標準方格,最多允許四個圖形選項。此區域會顯示與視覺化類型對應的圖示,讓您在各種檢視之間切換。這些圖示會以它們在參數列表中定義的相同順序顯示。

備註:如果唯一的顯示選項是標準方格,則不需要將方格指定為視覺化參數。

視覺化選項參數會在「資訊資料總管 - 單一 SQL (F1-DE-SINGLE)」和「資訊資料總管 - 多重 SQL (F1-DE)」區域類型上提供。

視覺化選項參數組態

記憶碼用於定義參數值內選項類型的屬性。

方格的記憶碼為 'optiontype=GRID'。不需要其他記憶碼。

對應的記憶碼為 'optiontype=MAP map=MAP_​CD schemaPath=xpath',其中 'MAP_​CD' 是 UI 對應的 ID,而 'xpath' 是 UI 對應的結構路徑。大多數的使用案例中,結構元素會比對來自資料總管的結果集,在此情況下,不需要 schemaPath 記憶碼。如果 UI 對應結構有其他元素存在,schemaPath 屬性會定義將複製資料總管資訊的群組節點。

圖表的選項類型記憶碼為 'optiontype=CHART'。後面接著適當的圖表組態屬性,下面區段包含相關描述。

圖表組態

下列屬性是用來設定一組資料的圖形表示法。

'oraChart:' 屬性定義要顯示的圖表類型及其一般組態。此屬性可用的組態參數集如下:

參數

描述

type:

pie

stacked

cluster

line

area

combo

定義要顯示的圖表類型。

必要

showLegend:

true

false

定義圖表是否應顯示圖例。

選擇性 (預設值為 true)

legendPosition:

left

right

bottom

top

定義圖例的顯示位置。

選擇性 (預設值為 right)

將位置設為 leftright 將會以垂直方式自動呈現圖例。

將位置設為 topbottom 將會自動以水平方式呈現圖例。

legendBorder:

true

false

定義圖例周圍是否要顯示框線。

選擇性 (預設值為 false)

depth:

true

false

true 值表示圖表有 3D 深度。

選擇性 (預設值為 false,此為 2D 圖表)

animate:

true

false

true 值表示圖表在顯示時有動畫效果。

選擇性 (預設值為 true)。使用大型資料集時,請考慮停用動畫效果。

dataCursor:

on

off

on 值可將滑鼠游標停駐在圖表中的任何地方。

選擇性 (預設值為 off)。這不適用於圓餅圖。

orientation:

horizontal

定義圖表方向。這只適用於長條圖、折線圖、區域圖、組合圖。

例如,oraChart="type:cluster; orientation:horizontal" 定義水平叢集圖。

選擇性 (預設值為 vertical)。

oraChartSeries 屬性定義圖表的來源資訊。大多數的圖表支援其中的 5 個屬性,其記憶碼如下:

  • oraChartSeries1
  • oraChartSeries2
  • oraChartSeries3
  • oraChartSeries4
  • oraChartSeries5

堆疊圖支援無限數量的數列,方法是繼續新增屬性 oraChartSeries6 和數字更大的數列,但使用過多數量的數列時,請注意這對效能的影響和記憶體限制。所有屬性的格式相同,並接受相同的參數,如下所述。

請注意:所有圖表都需要 oraChartSeries1。堆疊圖、叢集圖和折線圖可選擇性地包含額外的數列屬性 (以顯示多個長條/折線)。

如果您要定義多個數列,則必須為所有定義的數列提供資料。資料金額可以是 0 (零),但它們必須存在,才能讓圖表正確顯示。

下列為 oraChartSeriesN 屬性可用的組態參數集:

參數

描述

list:

XPath 值

定義 XML 中包含圖表資料之列表的 XPath。

只有 UI 對應中的 HTML 定義才需指定此參數。資料總管值是從區域的資料欄所推導出。

amount:

Cn

Pn

XPath 值

定義包含要繪製圖表之金額的元素。對於資料總管,這會是 SQL 或後處理資料欄識別碼。對於 HTML 定義,則必須指定元素的 XPath。

必要

xaxis:

Cn

Pn

XPath 值

定義包含 X 軸資料的元素。對於資料總管,這會是 SQL 或後處理資料欄識別碼。對於 HTML 定義,會指定元素的 XPath。

堆疊圖、叢集圖、折線圖、區域圖和組合圖的必要參數。

xaxisFormat:

date

dateTime

time

localDate

string

定義 X 軸的資料格式。

如果是 datedateTimetime,則該值會以使用者顯示設定檔中所定義的格式來顯示。

如果是 localDatestring,資料將會依原樣顯示,沒有任何特殊格式設定。

選擇性 (預設值為 date)。

label:

文字值

定義圖表化金額的標籤。

您必須定義此設定,或是定義 labelPath:

labelPath:

Cn

Pn

XPath 值

定義提供圖表化金額之標籤的元素。對於資料總管,這會是 SQL 或後處理資料欄識別碼。對於 HTML 定義,則必須指定元素的 XPath。

您必須定義此設定,或是定義 label:

currency:

有效的幣別代碼

定義圖表化金額的幣別代碼。

選擇性。

currencyPath:

Cn

Pn

XPath 值

定義提供圖表化金額之幣別代碼的元素。對於資料總管,這會是 SQL 或後處理資料欄識別碼。對於 HTML 定義,則必須指定元素的 XPath。

選擇性。

hoverText:

文字值

定義圖表元素的動態顯示文字。

選擇性 (預設的動態顯示文字一律可用)。如果已定義 hoverTextPath:,則會忽略此參數。

下列為可用的替代變數。

  • $label:這會取代為由 label:labelPath: 設定所決定的標籤文字。
  • $amount:這會取代為由 amount: 設定所指定的金額文字。
  • $axis:這會取代為 X 軸文字。
  • $%:這會取代為圓餅圖或長條圖的「切片」百分比。
  • $newline:這會強制換行。

如果定義的動態顯示文字包含上述任何值,系統將會在顯示該動態文字之前,將該值取代為對等的文字。

範例:

"hoverText:$label$newline$amount"

hoverTextPath:

Cn

Pn

XPath 值

定義為圖表元素提供動態顯示文字的元素。對於資料總管,這會是 SQL 或後處理資料欄識別碼。對於 HTML 定義,則必須指定元素的 XPath。

元素中的動態顯示文字可以利用上方 hoverText: 描述中所述的所有替代功能。

選擇性。

type:

bar

line

area

此屬性僅用於組合圖表類型。它定義組合圖表中每個數列的顯示方式。

在下列範例所定義的組合圖表中,其中一個數列是以長條圖來呈現,另一個數列則是以區域圖來呈現。

oraChart="type:combo;" 
oraChartSeries1="xaxis:C3; 
label:C2; amount:C1;type:bar" 
oraChartSeries2="xaxis:C3; 
label:C2; amount:C1;type:area"

navOpt:

有效的導覽選項代碼。

定義按一下圖表元素時,要啟用的導覽選項。

選擇性。

navOptPath:

Cn

Pn

XPath 值

定義按一下圖表元素時,提供要啟用之導覽選項的元素。對於資料總管,這會是 SQL 或後處理資料欄識別碼。對於 HTML 定義,則必須指定元素的 XPath。

選擇性

請注意,您可以同時設定 navOpt:navOptPath:。系統會先處理 navOptPath: 導覽選項。如果系統找到值,就會使用該值,否則就會使用 navOpt: 設定中的值。這表示圖表定義可以包含預設導覽選項,但資料中的導覽選項會置換它。

key:

Cn

Pn

XPath 值

定義包含要用於導覽選項之索引鍵欄位資料的元素。對於資料總管,這會是 SQL 或後處理資料欄識別碼。對於 HTML 定義,則必須指定元素的 XPath。

如果已定義 navOpt:navOptPath:,便需有此參數。

備註:一個導覽選項只能設定一個索引鍵欄位。

script:

業務處理助理指令檔名稱

定義按一下圖表元素時,要啟用的業務處理助理指令檔。

選擇性

執行指令檔時,圖表資料中的所有元素都可供指令檔作為暫存變數。

scriptPath:

Cn

Pn

XPath 值

定義按一下圖表元素時,提供要啟用之業務處理助理指令檔的元素。對於資料總管,這會是 SQL 或後處理資料欄識別碼。對於 HTML 定義,則必須指定元素的 XPath。

選擇性

請注意,您可以同時設定 script:scriptPath:。系統會先處理 scriptPath: 指令檔選項。如果系統找到值,就會使用該值,否則就會使用 script: 設定中的值。這表示圖表定義可以包含預設指令檔,但資料中的指令檔會置換它。

color:

HTML 顏色代碼/RGB 值

選擇性 (會套用預設顏色)

定義數列的顏色。格式為有效的 HTML 顏色代碼,例如 greenblue。所有有效顏色名稱是在此連結 http://www.w3schools.com/htmL/html_​colornames.asp 中定義。

您也可以使用 RGB 格式。(00FF00 為綠色,0000FF 為藍色)

備註:如需使用 HTML 顏色 'red' 以及它對存取性之影響的相關資訊,請參考顏色對比

colorPath:

Cn

Pn

XPath 值

定義包含數列顏色的元素。對於資料總管,這會是 SQL 或後處理資料欄識別碼。對於 HTML 定義,則必須指定元素的 XPath。

color: 設定中所述的有效格式也適用於此參數。

選擇性 (會套用預設顏色)

pieColors:

HTML 顏色代碼/RGB 值

定義圓餅圖數列的顏色。可以指定任何數量的 HTML 顏色代碼或 RGB 顏色值 (以空格區隔)。範例:

pieColors: green blue
pieColors: 00FF00 0000FF

選擇性 (如果數列超出指定值,則會套用預設顏色)

oraChartBroadcast: 屬性可讓您將值從圖表廣播至入口內容。可以廣播不限數目的欄位,設定方式為名稱/值配對;例如:oraChartBroadcast="FIELD_​NAME1:C1;FIELD_​NAME2:C2;",其中 FIELD_​NAMEn 是要廣播的入口內容欄位名稱,而 Cn (或 Pn) 是包含要廣播之資料值的元素。按一下圖表的對應部分即可觸發廣播。

如果是 UI 對應中的 HTML 定義,語法為 oraChartBroadcast="FIELD_​NAME1:xpath1;FIELD_​NAME2:xpath2;",其中 'xpathn' 是列表結構中包含要廣播之資料值的元素。

區域組態範例

含簡易圓餅圖的區域

在此範例中,區域 SQL 會彙總「依角色區分的待辦事項數」。資料欄定義為:

  • C1 - 角色描述

  • C2 - 依角色區分的待辦事項數

  • C3 - 角色 ID

視覺化選項 1

此選項會將「依角色區分的待辦事項數」顯示為圓餅圖。按一下圓餅圖的對應部分時,角色 ID 將會廣播至入口。

optiontype=CHART
oraChart="type:pie;"
oraChartSeries1="labelPath:C1; amount:C2;hoverText:$label$newline$amount;"
oraChartBroadcast="ROLE_ID:C3"

含兩種圖表類型的區域

在此範例中,區域 SQL 會彙總「依優先順序區分的待辦事項數」,同時依優先順序內的待辦事項狀態計算個別計數。資料欄定義為:

  • C1 - 優先順序描述

  • C2 - 依優先順序區分的待辦事項數

  • C3 - 優先順序標誌值

  • C4 - 依優先順序的未處理待辦事項計數

  • C5 - 依優先順序的已指派待辦事項計數

  • C6 - 叢集圖中「未處理待辦事項」列的標籤

  • C7 - 叢集圖中「已指派待辦事項」列的標籤

視覺化選項 1

此選項會將「依優先順序區分的待辦事項數」顯示為圓餅圖。按一下圓餅圖的對應部分時,優先順序值將會廣播至入口。

optiontype=CHART
oraChart="type:pie; legendBorder:true;"
oraChartSeries1="labelPath:C1; amount:C2;hoverText:$label$newline$amount;"
oraChartBroadcast="TD_PRIORITY_FLG:C3"

視覺化選項 2

此選項會將「依優先順序區分的待辦事項數」顯示為有兩個資料數列的叢集圖,一個代表「未處理待辦事項」,另一個代表「已指派待辦事項」。按一下叢集圖的「未處理」或「已指派」列時,對應的優先順序值將會廣播至入口。

optiontype=CHART oraChart="type:cluster;  showLegend:true;" 
oraChartSeries1="xaxis:C1; xaxisFormat:string; labelPath:C6; amount:C4;hoverText:$label$newline$amount;"
oraChartSeries2="xaxis:C1; xaxisFormat:string; labelPath:C7; amount:C5;hoverText:$label$newline$amount;"
oraChartBroadcast="TD_PRIORITY_FLG:C3"