資料總管圖表組態
對於某些資料總管區域,以圖形形式 (例如圓餅圖或折線圖) 顯示結果會更有效力。圖表組態可利用視覺化選項參數來與擷取資料的資料總管區域整合。
視覺化選項參數支援三個選項:
- 方格 - 以標準資料總管方格顯示資料
- 圖表 - 以圖表形式顯示資料
- 對應 - 可叫用「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) 將位置設為 left 或 right 將會以垂直方式自動呈現圖例。 將位置設為 top 或 bottom 將會自動以水平方式呈現圖例。 |
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 和數字更大的數列,但使用過多數量的數列時,請注意這對效能的影響和記憶體限制。所有屬性的格式相同,並接受相同的參數,如下所述。
如果您要定義多個數列,則必須為所有定義的數列提供資料。資料金額可以是 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 軸的資料格式。 如果是 date、dateTime 或 time,則該值會以使用者顯示設定檔中所定義的格式來顯示。 如果是 localDate 或 string,資料將會依原樣顯示,沒有任何特殊格式設定。 選擇性 (預設值為 date)。 |
label: |
文字值 |
定義圖表化金額的標籤。 您必須定義此設定,或是定義 labelPath:。 |
labelPath: |
Cn Pn XPath 值 |
定義提供圖表化金額之標籤的元素。對於資料總管,這會是 SQL 或後處理資料欄識別碼。對於 HTML 定義,則必須指定元素的 XPath。 您必須定義此設定,或是定義 label:。 |
currency: |
有效的幣別代碼 |
定義圖表化金額的幣別代碼。 選擇性。 |
currencyPath: |
Cn Pn XPath 值 |
定義提供圖表化金額之幣別代碼的元素。對於資料總管,這會是 SQL 或後處理資料欄識別碼。對於 HTML 定義,則必須指定元素的 XPath。 選擇性。 |
hoverText: |
文字值 |
定義圖表元素的動態顯示文字。 選擇性 (預設的動態顯示文字一律可用)。如果已定義 hoverTextPath:,則會忽略此參數。 下列為可用的替代變數。
如果定義的動態顯示文字包含上述任何值,系統將會在顯示該動態文字之前,將該值取代為對等的文字。 範例:
|
hoverTextPath: |
Cn Pn XPath 值 |
定義為圖表元素提供動態顯示文字的元素。對於資料總管,這會是 SQL 或後處理資料欄識別碼。對於 HTML 定義,則必須指定元素的 XPath。 元素中的動態顯示文字可以利用上方 hoverText: 描述中所述的所有替代功能。 選擇性。 |
type: |
bar line 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 顏色代碼,例如 green 或 blue。所有有效顏色名稱是在此連結 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 顏色值 (以空格區隔)。範例:
選擇性 (如果數列超出指定值,則會套用預設顏色) |
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"