Configuração do Gráfico do Explorador de Dados

Para algumas zonas do explorador de dados, é mais eficaz visualizar os resultados em forma de gráfico, como um gráfico de pizza ou de linha. Os parâmetros de opção de visualização permitem que a configuração do gráfico seja integrada à zona do explorador de dados que recupera os dados.

Os parâmetros de opção de visualização são compatíveis com três opções:

  • Grade - exibe os dados em uma grade padrão do explorador de dados.
  • Gráfico - exibe os dados na forma de um gráfico.
  • Mapa - permite chamar um Mapa da Interface do Usuário para exibir os dados.

Até cinco parâmetros de opção de visualização podem ser especificados. Uma das opções deve ser a grade padrão, que permite, no máximo, quatro opções gráficas. A zona exibirá ícones correspondentes aos tipos de visualização para permitir alternar entre as várias exibições. Esses ícones são apresentados na mesma ordem que são definidos na lista de parâmetros.

Observação: se a única opção de exibição for uma grade padrão, não será necessário especificar a grade como um parâmetro de visualização.

Os parâmetros de opção de visualização são fornecidos nos tipos de zona Explorador de Dados de Informações - SQL Único (F1-DE-SINGLE) e Explorador de Dados de Informações - Vários SQLs (F1-DE).

Configuração do Parâmetro de Opção de Visualização

Mnemônicos são usados para definir os atributos de um tipo de opção dentro do valor do parâmetro.

Para uma grade, o mnemônico é 'optiontype=GRID'. Nenhum outro mnemônico é necessário.

Para um mapa, o mnemônico é 'optiontype=MAP map=MAP_​CD schemaPath=xpath', em que 'MAP_​CD' é o ID do Mapa da Interface do Usuário e 'xpath' é o caminho do esquema do Mapa da Interface do Usuário. Na maioria dos casos de uso, os elementos de esquema corresponderão ao conjunto de resultados do explorador de dados. Nesse caso, nenhum mnemônico schemaPath será necessário. Se o esquema do Mapa da Interface do Usuário tiver elementos adicionais presentes, o atributo schemaPath definirá o nó de grupo para o qual as informações do explorador de dados serão copiadas.

Para um gráfico, o mnemônico do tipo de opção é 'optiontype=CHART'. Isso é seguido pelos atributos de configuração de gráfico apropriados, que são descritos na seção abaixo.

Configuração de Gráfico

Os atributos a seguir são usados para configurar uma representação gráfica de um conjunto de dados.

O atributo 'oraChart:' define o tipo de gráfico a ser exibido e a configuração geral dele. O conjunto de parâmetros de configuração disponíveis para este atributo são:

Parâmetro

Valores

Descrição

type:

gráfico de pizza

empilhado

cluster

linha

área

combo

Define o tipo de gráfico a ser exibido.

Obrigatório

showLegend:

true

falso

Define se uma legenda deve ser exibida para o gráfico.

Opcional (o padrão é true)

legendPosition:

esquerda

right

bottom

superior

Define onde a legenda deve ser exibida.

Opcional (o padrão é right)

A definição da posição para left ou right vai renderizar o gráfico automaticamente na vertical.

A definição da posição para top ou bottom vai renderizar o gráfico automaticamente na horizontal.

legendBorder:

true

falso

Define se a legenda deve ser exibida com uma borda ao redor dela.

Opcional (o padrão é false)

profundidade:

true

falso

O valor true indica profundidade tridimensional para o gráfico.

Opcional (o padrão é false, que indica um gráfico bidimensional)

animar:

true

falso

O valor true indica que o gráfico deve ser animado quando exibido.

Opcional (o padrão é true). Considere desativar a animação ao usar conjuntos de dados grandes.

dataCursor:

ativado

desativado

O valor on ativa a exibição de dica de ferramenta em qualquer parte do gráfico.

Opcional (o padrão é off). Não se aplica a gráficos de pizza.

orientação:

horizontal

Define a orientação do gráfico. Só se aplica a gráficos de barra, linha, área e combo.

Ex.: oraChart="type:cluster; orientation:horizontal" define um gráfico de cluster horizontal.

Opcional (o padrão é vertical).

O atributo oraChartSeries define as informações de origem do gráfico. A maioria dos gráficos suporta 5 desses atributos, com os seguintes mnemônicos:

  • oraChartSeries1
  • oraChartSeries2
  • oraChartSeries3
  • oraChartSeries4
  • oraChartSeries5

Os gráficos empilhados suportam um número ilimitado de séries pela adição contínua de atributos oraChartSeries6 e acima, mas preste atenção nas implicações de desempenho e nos limites de memória ao usar um número de séries excessivamente alto. Todos os atributos são idênticos no formato e aceitam os mesmos parâmetros, conforme descrito a seguir.

Observação: Todos os gráficos requerem oraChartSeries1. Os gráficos Empilhado, de Cluster e de Linha podem incluir os atributos de série adicionais para várias barras ou linhas.

Se você definir várias séries, deverá fornecer dados para todas as séries definidas. Os valores dos dados podem ser 0 (zero), mas precisam estar presentes para que o gráfico seja exibido corretamente.

O conjunto de parâmetros de configuração disponíveis para o atributo oraChartSeriesN é:

Parâmetro

Valores

Descrição

lista:

Valor de XPath

Define o XPath para a lista do XML que contém os dados do gráfico.

Obrigatório somente para definições HTML nos Mapas da interface do usuário. Os valores do explorador de dados são derivados das colunas da zona.

quantidade:

Cn

Pn

Valor de XPath

Define o elemento que contém o valor para o gráfico. Para os exploradores de dados, esse será um identificador de coluna SQL ou de pós-processamento. Para definições HTML, o XPath do elemento deve ser especificado.

Obrigatório

xaxis:

Cn

Pn

Valor de XPath

Define o elemento que contém os dados do eixo x. Para os exploradores de dados, esse será um identificador de coluna SQL ou de pós-processamento. Para definições HTML, o XPath do elemento é especificado.

Obrigatório para gráficos Empilhados, de Cluster, de Linha, de Área e Combo.

xaxisFormat:

data

dateTime

tempo

localDate

string

Define o formato dos dados do eixo x.

Se for date, dateTime ou time, o valor será apresentado no formato definido no perfil de exibição do usuário.

No caso de localDate ou string, os dados serão exibidos no estado em que se encontram, sem formatação especial.

Opcional (o padrão é date).

rótulo:

Text value

Define o rótulo do valor que está sendo colocado no gráfico.

Essa definição ou labelPath: precisam ser definidas.

labelPath:

Cn

Pn

Valor de XPath

Define o elemento que contém o rótulo do valor que está sendo colocado no gráfico. Para os exploradores de dados, esse será um identificador de coluna SQL ou de pós-processamento. Para definições HTML, o XPath do elemento deve ser especificado.

Essa definição ou label: precisam ser definidas.

moeda:

Um código de Moeda válido

Define o código da moeda do valor que está sendo colocado no gráfico.

Opcional.

currencyPath:

Cn

Pn

Valor de XPath

Define o elemento que contém o código da moeda do valor que está sendo colocado no gráfico. Para os exploradores de dados, esse será um identificador de coluna SQL ou de pós-processamento. Para definições HTML, o XPath do elemento deve ser especificado.

Opcional.

hoverText:

Text value

Define a dica de ferramenta do elemento do gráfico.

Opcional (sempre há uma dica padrão disponível). Ignorado se hoverTextPath: for definido.

As variáveis de substituição a seguir estão disponíveis.

  • $label será substituída pelo texto do rótulo conforme determinado pela definição label: ou labelPath:.
  • $amount será substituída pelo texto do valor conforme especificado pela definição amount:.
  • $axis será substituído pelo texto do eixo x.
  • $% será substituído pela "fatia" da porcentagem da pizza ou da barra.
  • $newline forçará uma quebra de linha.

Se a dica de ferramenta definida contiver algum dos valores acima, eles serão substituídos pelo texto equivalente antes de serem exibidos.

Exemplo:

"hoverText:$label$newline$amount"

hoverTextPath:

Cn

Pn

Valor de XPath

Define o elemento que fornece o texto suspenso do elemento do gráfico. Para os exploradores de dados, esse será um identificador de coluna SQL ou de pós-processamento. Para definições HTML, o XPath do elemento deve ser especificado.

O texto suspenso no elemento pode utilizar toda a funcionalidade de substituição descrita anteriormente em hoverText: descrição.

Opcional.

type:

bar

linha

área

Este atributo é usado somente no tipo de gráfico combo. Ele define como cada série do gráfico combo deve ser apresentada.

O exemplo a seguir define um gráfico combo em que uma série é renderizada como barras, e outra, como área.

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

navOpt:

Um código de Opção de Navegação válido.

Define uma opção de navegação a ser ativada quando o elemento do gráfico é clicado.

Opcional.

navOptPath:

Cn

Pn

Valor de XPath

Define o elemento que fornece a opção de navegação a ser ativada quando o elemento do gráfico é clicado. Para os exploradores de dados, esse será um identificador de coluna SQL ou de pós-processamento. Para definições HTML, o XPath do elemento deve ser especificado.

Opcional

Note que é possível configurar navOpt: e navOptPath:. A opção de navegação navOptPath: será processada primeiro. Se um valor for encontrado, ele será usado. Caso contrário, o valor da definição navOpt: será usado. Significa que a definição de gráfico pode incluir uma opção de navegação padrão, e uma opção presente nos dados vai substituí-la.

key:

Cn

Pn

Valor de XPath

Define o elemento que contém os dados do campo-chave a serem usados em uma opção de navegação. Para os exploradores de dados, esse será um identificador de coluna SQL ou de pós-processamento. Para definições HTML, o XPath do elemento deve ser especificado.

Obrigatório se navOpt: ou navOptPath: forem definidos.

Observação: Somente um campo chave pode ser configurado para uma opção de navegação.

script:

O nome de um script de BPA

Define um script de BPA a ser ativado quando o elemento do gráfico é clicado.

Opcional

Quando um script é executado, todos os elementos dos dados do gráfico são disponibilizados para o script como variáveis temporárias.

scriptPath:

Cn

Pn

Valor de XPath

Define o elemento que fornece o script assistente do processo de negócios a ser ativado quando o elemento do gráfico é clicado. Para os exploradores de dados, esse será um identificador de coluna SQL ou de pós-processamento. Para definições HTML, o XPath do elemento deve ser especificado.

Opcional

Note que é possível configurar script: e scriptPath:. A opção de script scriptPath: será processada primeiro. Se um valor for encontrado, ele será usado. Caso contrário, o valor da definição script: será usado. Significa que a definição de gráfico pode incluir um script padrão e um script presente nos dados o substituirá.

cor:

Código HTML da Cor/valor RGB

Opcional (cores padrão aplicadas)

Define a cor da série. O formato é um código HTML de cor válido, por ex.: verde ou azul. Todos os nomes de cor válidos estão definidos neste link: http://www.w3schools.com/htmL/html_​colornames.asp.

Como alternativa, o formato RGB pode ser usado. (00FF00 é verde 0000FF é azul).

Observação: Consulte Contraste de Cores para mais informações sobre o uso da cor HTML "vermelho" e o impacto dela na acessibilidade.

colorPath:

Cn

Pn

Valor de XPath

Define o elemento que contém uma cor para a série. Para os exploradores de dados, esse será um identificador de coluna SQL ou de pós-processamento. Para definições HTML, o XPath do elemento deve ser especificado.

Os formatos válidos descritos na definição cor: se aplicam.

Opcional (cores padrão aplicadas)

pieColors:

Código HTML da cor/valores RGB

Define as cores da série de pizza. Qualquer número de códigos HTML de cor ou valores de cor RGB pode ser especificado, separado por espaços. Exemplos: 

pieColors: green blue
pieColors: 00FF00 0000FF

Opcional (as cores padrão são aplicadas se a série exceder os valores especificados)

O atributo oraChartBroadcast: permite transmitir um valor de um gráfico para o contexto do portal. Um número ilimitado de campos pode ser transmitido, configurado como pares de nome/valor, como por exemplo: oraChartBroadcast="FIELD_​NAME1:C1;FIELD_​NAME2:C2;" em que FIELD_​NAMEn é o nome do campo de contexto do portal a ser transmitido e Cn (ou Pn) é o elemento que contém o valor de dados a ser transmitido. A transmissão é acionada clicando em uma seção correspondente do gráfico.

Para definições HTML nos Mapas da Interface do Usuário, a sintaxe é oraChartBroadcast="FIELD_​NAME1:xpath1;FIELD_​NAME2:xpath2;" em que 'xpathn' é o elemento no esquema de lista que contém o valor de dados a ser transmitido.

Exemplos de Configuração de Zona

Zona com um gráfico de pizza simples

Neste exemplo, a zona SQL resume as entradas de Atividade por Função. As definições de coluna são:

  • C1 - descrição da atribuição

  • C2 - contagem de entradas de Atividade por função

  • C3 - ID da atribuição

Opção de Visualização 1

Esta opção mostra as entradas de Atividade por Função como um gráfico de pizza. O ID da função será transmitido ao portal quando a seção correspondente do gráfico de pizza for clicada.

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

Zona com dois tipos de gráfico

Neste exemplo, o SQL da zona resume as entradas de Atividade por Prioridade e também calcula contagens separadas por status de Atividade dentro da prioridade. As definições de coluna são:

  • C1 - descrição da prioridade

  • C2 - contagem de entradas de Atividade por prioridade

  • C3 - valor do indicador de prioridade

  • C4 - contagem de Atividades Abertas por prioridade

  • C5 - contagem de Atividades em Processamento por prioridade

  • C6 - Rótulo da barra Atividades Abertas no gráfico de cluster

  • C7 - Rótulo da barra Atividades em Processamento no gráfico de cluster

Opção de Visualização 1

Esta opção mostra as entradas de Atividade por Prioridade como um gráfico de pizza. O valor de prioridade será transmitido ao portal quando a seção correspondente do gráfico de pizza for clicada.

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

Opção de Visualização 2

Esta opção mostra as entradas de Atividade por Prioridade como um gráfico de cluster com duas séries de dados, uma para Atividades Abertas e outra para Atividades em Processamento. O valor de prioridade correspondente será transmitido para o portal ao clicar na barra Abrir ou Em Processamento do gráfico de cluster.

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"