Konfiguracja wykresu przeglądu danych

W niektórych strefach przeglądu danych wyświetlanie wyników w formie graficznej, takiej jak wykres kołowy lub liniowy, jest bardziej efektywne. Integracja konfiguracji wykresu ze strefą przeglądu danych, który odpowiada za pobieranie danych, jest możliwa dzięki zastosowaniu parametrów opcji wizualizacji.

W parametrach opcji wizualizacji obsługiwane są trzy opcje:

  • Siatka - dane wyświetlane są w standardowej siatce przeglądu danych
  • Wykres - dane wyświetlane są w formie wykresu
  • Odwzorowanie - umożliwia wywołanie odwzorowania interfejsu użytkownika w celu wyświetlenia danych

Można określić maksymalnie pięć parametrów opcji wizualizacji. Jedną z tych opcji musi być standardowa siatka, co pozwala na zdefiniowanie maksymalnie czterech opcji graficznych. W strefie zostaną wyświetlone ikony odpowiadające typom wizualizacji, aby umożliwić przełączanie się między różnymi widokami. Ikony przedstawione są w tej samej kolejności, w jakiej zostały zdefiniowane na liście parametrów.

Uwaga: Jeśli jedyną opcją wyświetlania jest standardowa siatka, nie jest konieczne określanie jej jako parametru wizualizacji.

Parametry opcji wizualizacji są dostępne w typach stref: Przegląd danych dot. informacji - jedna instrukcja SQL (F1–DE-SINGLE) oraz Przegląd danych dot. informacji - wiele instrukcji SQL (F1–DE).

Konfiguracja parametrów opcji wizualizacji

Atrybuty typu opcji w ramach wartości parametru są definiowane za pomocą mnemoników.

W przypadku siatki używany jest mnemonik "optiontype=GRID". Inne mnemoniki nie są wymagane.

W przypadku odwzorowania używane są następujące mnemoniki: "optiontype=MAP map=MAP_​CD schemaPath=xpath", gdzie "MAP_​CD" to ID odwzorowania interfejsu użytkownika, a "xpath" to ścieżka schematu odwzorowania interfejsu użytkownika. W większości przypadków użycia elementy schematu będą zgodne z zestawem wyników z przeglądu danych. W takim przypadku mnemonik "schemaPath" nie jest wymagany. Jeśli schemat odwzorowania interfejsu użytkownika zawiera dodatkowe elementy, atrybut "schemaPath" służy do zdefiniowania węzła grupy, do którego zostaną skopiowane informacje przeglądu danych.

W przypadku wykresu używany jest mnemonik typu opcji "optiontype=CHART". Następują po nim odpowiednie atrybuty konfiguracji wykresu, które opisano w poniższej sekcji.

Konfiguracja wykresu

Do konfigurowania graficznej reprezentacji zbioru danych służą opisane poniżej atrybuty.

Atrybut "oraChart:" służy do definiowania typu i ogólnej konfiguracji wykresu, który ma być wyświetlany. Dla tego atrybutu dostępny jest następujący zestaw parametrów konfiguracji:

Parametr

Wartości

Opis

type:

pie

stacked

cluster

line

area

combo

Służy do określania typu wykresu do wyświetlenia.

Wymagane

showLegend:

true

false

Służy do określania, czy w wykresie powinna być wyświetlana legenda.

Opcjonalne (wartość domyślna to true)

legendPosition:

left

right

bottom

top

Służy do określania, gdzie powinna być wyświetlana legenda.

Opcjonalne (wartość domyślna to right)

Ustawienie położenia na wartość left lub right automatycznie spowoduje renderowanie w pionie.

Ustawienie położenia na wartość top lub bottom automatycznie spowoduje renderowanie w poziomie.

legendBorder:

true

false

Służy do określania, czy legenda powinna być wyświetlana z ramką.

Opcjonalne (wartość domyślna to false)

depth:

true

false

Wartość true oznacza, że wykres będzie wyświetlany jako trójwymiarowy.

Opcjonalne (wartość domyślna to false, co oznacza wykres dwuwymiarowy)

animate:

true

false

Wartość true oznacza, że po wyświetleniu wykres powinien być animowany.

Opcjonalne (wartość domyślna to true). Korzystając z dużych zestawów danych, warto rozważyć wyłączenie animacji.

dataCursor:

on

off

Wartość on powoduje włączenie umieszczania kursora myszy w dowolnym miejscu wykresu.

Opcjonalne (wartość domyślna to off). Ustawienie to nie dotyczy wykresów kołowych.

orientation:

horizontal

Służy do określania orientacji wykresu. Dotyczy tylko wykresów słupkowych, liniowych, warstwowych i mieszanych.

Przykład: oraChart="type:cluster; orientation:horizontal" oznacza poziomy wykres klastrowy.

Opcjonalne (wartość domyślna to "vertical").

Atrybut oraChartSeries służy do określania informacji źródłowych dotyczących wykresu. W większości wykresów obsługiwanych jest 5 z tych atrybutów, z następującymi mnemonikami:

  • oraChartSeries1
  • oraChartSeries2
  • oraChartSeries3
  • oraChartSeries4
  • oraChartSeries5

Wykresy skumulowane obsługują nieograniczoną liczbę serii poprzez dalsze dodawanie oraChartSeries6 i więcej serii atrybutów, ale podczas korzystania z wyjątkowo dużej liczby serii należy pamiętać o konsekwencjach dla wydajności i ograniczeniach pamięci. Wszystkie atrybuty mają identyczny format i akceptują te same parametry, jak opisano poniżej.

Uwaga: W przypadku wszystkich wykresów należy podać oraChartSeries1. Wykresy skumulowane, klastrowe i liniowe mogą opcjonalnie zawierać dodatkowe atrybuty (dotyczące wielu słupków/linii).

W przypadku zdefiniowania wielu serii trzeba podać dane dla wszystkich zdefiniowanych serii. Ilości danych mogą wynosić 0 (zero), ale muszą one być obecne, aby wykres był wyświetlany prawidłowo.

Zestaw parametrów konfiguracji dostępny dla atrybutu oraChartSeriesN to:

Parametr

Wartości

Opis

list:

XPath value

Służy do określania ścieżki XPath do listy w elemencie XML zawierającej dane do umieszczenia w wykresie.

Wymagane tylko w przypadku definicji HTML w odwzorowaniach interfejsu użytkownika. Wartości przeglądu danych są wyznaczane na podstawie kolumn strefy.

amount:

Cn

Pn

XPath value

Służy do określania elementu zawierającego kwotę do umieszczenia na wykresie. W przypadku przeglądów danych będzie to instrukcja SQL lub identyfikator kolumny przetwarzania końcowego. W definicjach HTML należy określić wartość XPath elementu.

Wymagane

xaxis:

Cn

Pn

XPath value

Służy do określania elementu zawierającego dane osi X. W przypadku przeglądów danych będzie to instrukcja SQL lub identyfikator kolumny przetwarzania końcowego. W definicjach HTML określana jest wartość XPath elementu.

Wymagane w przypadku wykresów skumulowanych, klastrowych, liniowych, warstwowych i mieszanych.

xaxisFormat:

date

dateTime

time

localDate

string

Służy do określania formatu danych osi X.

Wartości date, dateTime i time są prezentowane w formacie określonym w profilu wyświetlania użytkownika.

Wartości localDate i string wyświetlane są w podanej postaci, bez formatowania specjalnego.

Opcjonalne (wartość domyślna to date).

label:

Wartość tekstowa

Służy do określania etykiety dla ilości umieszczanej w wykresie.

Należy określić to ustawienie albo wartość labelPath:.

labelPath:

Cn

Pn

XPath value

Służy do określania elementu, który udostępnia etykietę dla kwoty umieszczanej na wykresie. W przypadku przeglądów danych będzie to instrukcja SQL lub identyfikator kolumny przetwarzania końcowego. W definicjach HTML należy określić wartość XPath elementu.

Należy określić to ustawienie albo wartość label:.

currency:

Prawidłowy kod waluty

Służy do określania kodu waluty dla ilości umieszczanej w wykresie.

Opcjonalne.

currencyPath:

Cn

Pn

XPath value

Służy do określania elementu, który udostępnia kod waluty dla kwoty umieszczanej na wykresie. W przypadku przeglądów danych będzie to instrukcja SQL lub identyfikator kolumny przetwarzania końcowego. W definicjach HTML należy określić wartość XPath elementu.

Opcjonalne.

hoverText:

Wartość tekstowa

Służy do określania tekstu wyświetlanego po wskazaniu kursorem dla elementu wykresu.

Opcjonalne (zawsze dostępny jest domyślny tekst wyświetlany po wskazaniu kursorem). Ignorowane po zdefiniowaniu wartości hoverTextPath:.

Dostępne są następujące zmienne zastąpienia.

  • $label Element ten zostanie zastąpiony tekstem etykiety, jak określono w ustawieniu label: lub labelPath:.
  • $amount Element ten zostanie zastąpiony tekstem ilości, jak określono w ustawieniu amount:.
  • $axis Element ten zostanie zastąpiony tekstem osi X.
  • $% Element ten zostanie zastąpiony procentowym "wycinkiem" koła lub słupka.
  • $newline Element ten spowoduje wymuszenie podziału wiersza.

Jeśli zdefiniowany tekst wyświetlany po wskazaniu kursorem zawiera którąś z powyższych wartości, zostaną one przed wyświetleniem zastąpione tekstem równoważnym.

Przykład:

"hoverText:$label$newline$amount"

hoverTextPath:

Cn

Pn

XPath value

Służy do określania elementu, który udostępnia tekst wyświetlany po wskazaniu kursorem dla elementu wykresu. W przypadku przeglądów danych będzie to instrukcja SQL lub identyfikator kolumny przetwarzania końcowego. W definicjach HTML należy określić wartość XPath elementu.

W tekście wyświetlanym po wskazaniu kursorem w elemencie można wykorzystać całą opisaną powyżej funkcjonalność zastąpienia w opisie hoverText:.

Opcjonalne.

type:

bar

line

area

Ten atrybut jest używany tylko na potrzeby wykresu mieszanego. Służy on do określania sposobu prezentowania poszczególnych serii w wykresie mieszanym.

W poniższym przykładzie zdefiniowano wykres mieszany, w którym jedna seria jest renderowana jak słupki, a druga jako warstwa.

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

navOpt:

Prawidłowy kod opcji przechodzenia.

Służy do określania opcji przechodzenia do aktywowania po kliknięciu elementu wykresu.

Opcjonalne.

navOptPath:

Cn

Pn

XPath value

Służy do określania elementu, który udostępnia opcję nawigacji do aktywowania po kliknięciu elementu wykresu. W przypadku przeglądów danych będzie to instrukcja SQL lub identyfikator kolumny przetwarzania końcowego. W definicjach HTML należy określić wartość XPath elementu.

Opcjonalne

Należy pamiętać, że można skonfigurować zarówno element navOpt:, jak i navOptPath:. Opcja nawigacji navOptPath: jest przetwarzana jako pierwsza. W przypadku znalezienia wartości zostanie ona użyta, w przeciwnym razie zastosowana będzie wartość w ustawieniu navOpt:. Oznacza to, że w definicji wykresu można uwzględnić domyślną opcję nawigacji - zostanie ona nadpisana przez opcję nawigacji obecną w danych.

key:

Cn

Pn

XPath value

Służy do określania elementu zawierającego dane pola klucza do zastosowania w opcji nawigacji. W przypadku przeglądów danych będzie to instrukcja SQL lub identyfikator kolumny przetwarzania końcowego. W definicjach HTML należy określić wartość XPath elementu.

Jest to wymagane w przypadku zdefiniowania elementu navOpt: lub navOptPath:.

Uwaga: Na potrzeby opcji przechodzenia można skonfigurować tylko jedno pole klucza.

script:

Nazwa skryptu APB

Służy do określania skryptu APB do aktywowania po kliknięciu elementu wykresu.

Opcjonalne

Po wykonaniu skryptu wszystkie elementy z danych wykresu zostaną udostępnione skryptowi jako zmienne tymczasowe.

scriptPath:

Cn

Pn

XPath value

Służy do określania elementu, który udostępnia skrypt APB do aktywowania po kliknięciu elementu wykresu. W przypadku przeglądów danych będzie to instrukcja SQL lub identyfikator kolumny przetwarzania końcowego. W definicjach HTML należy określić wartość XPath elementu.

Opcjonalne

Należy pamiętać, że można skonfigurować zarówno element script:, jak i scriptPath:. Opcja skryptu scriptPath: jest przetwarzana jako pierwsza. W przypadku znalezienia wartości zostanie ona użyta, w przeciwnym razie zastosowana będzie wartość w ustawieniu script:. Oznacza to, że w definicji wykresu można uwzględnić domyślny skrypt - zostanie on nadpisany przez skrypt obecny w danych.

color:

Kod koloru HTML/wartość RGB

Opcjonalne (zastosowane kolory domyślne)

Służy do określania koloru serii. Formatem jest prawidłowy kod koloru HTML, na przykład green lub blue. Wszystkie prawidłowe nazwy kolorów są zdefiniowane pod następującym łączem: http://www.w3schools.com/htmL/html_​colornames.asp.

Alternatywnie można zastosować format RGB. (00FF00 to kolor zielony, a 0000FF to kolor niebieski)

Uwaga: Informacje na temat wykorzystania koloru czerwonego z języka HTML i jego wpływu na dostępność zawiera sekcja Kontrast koloru.

colorPath:

Cn

Pn

XPath value

Służy do określania elementu zawierającego kolor serii. W przypadku przeglądów danych będzie to instrukcja SQL lub identyfikator kolumny przetwarzania końcowego. W definicjach HTML należy określić wartość XPath elementu.

Stosowane są prawidłowe formaty zgodnie z opisem w ustawieniu color:.

Opcjonalne (zastosowane kolory domyślne)

pieColors:

Kod koloru HTML/wartości RGB

Służy do określania koloru serii kołowej. Można określić dowolną liczbę kodów kolorów HTML lub wartości kolorów RGB, oddzielonych spacjami. Przykłady: 

pieColors: green blue
pieColors: 00FF00 0000FF

Opcjonalne (jeśli seria przekracza zdefiniowane wartości, stosowane są kolory domyślne)

Atrybut oraChartBroadcast: umożliwia rozesłanie wartości z wykresu do kontekstu portalu. Możliwe jest rozesłanie nieograniczonej liczby pól skonfigurowanych jako pary nazwa/wartość, na przykład: oraChartBroadcast="FIELD_​NAME1:C1;FIELD_​NAME2:C2;" gdzie wartość FIELD_​NAMEn to nazwa pola kontekstu portalu do rozesłania, a wartość Cn (lub Pn) to element zawierający wartość danych do rozesłania. Rozsyłanie jest wyzwalane poprzez kliknięcie odpowiedniej sekcji wykresu.

W definicjach HTML zawartych w odwzorowaniach interfejsu użytkownika używana jest następująca składnia: oraChartBroadcast="FIELD_​NAME1:xpath1;FIELD_​NAME2:xpath2;", gdzie wartość "xpathn" to element w schemacie listy, który zawiera wartość danych do rozesłania.

Przykłady konfiguracji strefy

Strefa z prostym wykresem kołowym

W tym przykładzie instrukcja SQL strefy służy do podsumowania pozycji Do wykonania według roli. Definicje kolumn to:

  • C1 - opis roli

  • C2 - liczba pozycji Do wykonania według roli

  • C3 - ID roli

Opcja wizualizacji 1

W tej opcji pozycje Do wykonania według roli są przedstawione w formie wykresu kołowego. ID roli zostanie rozesłany do portalu po kliknięciu odpowiedniej sekcji wykresu kołowego.

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

Strefa zawierająca dwa typy wykresu

W tym przykładzie instrukcja SQL strefy służy do podsumowania pozycji Do wykonania według priorytetu. Oprócz tego obliczane są również oddzielne liczby według statusu pozycji Do wykonania w ramach priorytetu. Definicje kolumn to:

  • C1 - opis priorytetu

  • C2 - liczba pozycji Do wykonania według priorytetu

  • C3 - wartość znacznika priorytetu

  • C4 - liczba otwartych pozycji Do wykonania według priorytetu

  • C5 - liczba obsługiwanych pozycji Do wykonania według priorytetu

  • C6 - etykieta słupka Otwarte pozycje Do wykonania na wykresie klastrowym

  • C7 - etykieta słupka Obsługiwane pozycje Do wykonania na wykresie klastrowym

Opcja wizualizacji 1

W tej opcji pozycje Do wykonania według priorytetu są przedstawione w formie wykresu kołowego. Wartość priorytetu zostanie rozesłana do portalu po kliknięciu odpowiedniej sekcji tego wykresu.

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

Opcja wizualizacji 2

W tej opcji pozycje Do wykonania według priorytetu są przedstawione w formie wykresu klastrowego zawierającego dwie serie danych. Pierwsza z nich przedstawia otwarte pozycje Do wykonania, a druga obsługiwane pozycje Do wykonania. Odpowiednia wartość priorytetu zostanie rozesłana do portalu po kliknięciu słupka otwartych lub obsługiwanych pozycji na wykresie klastrowym.

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"