Class: HighchartsVisualizationDef

@nginstack/web-framework/lib/dsv/HighchartsVisualizationDef~ HighchartsVisualizationDef


new HighchartsVisualizationDef()

Classe abstrata que contém as configurações de visualizações de data sources com a utilização de gráficos.

Importante: o Web Framework também possui integração com a biblioteca de código aberto ECharts, uma alternativa ao Highcharts, sem custos de licenciamento.

Example
// Exemplo de definição de uma visualização em gráfico
{
  type: 'highcharts',
  dataSourceQuery: -1891504223, // Usuários habilitados.idsq
  filters: [
    {name: "begin", label: "Data inicial", required: true},
    {name: "end", label: "Data final", required: true}
  ],
  onGetOptions: function (dsv, ds) {
    var countByStatus = {};
    forEachRecord(ds, function (record) {
      var status = record.u_istatus_iname;
      var count = countByStatus[status] || 0;
      countByStatus[status] = count + 1;
    });
    var categories = [];
    var data = [];
    Object.keys(countByStatus).forEach(function (key) {
      categories.push(key);
      data.push(countByStatus[key]);
    });
    return {
      chart: {
        defaultSeriesType: 'column'
      },
      title: {
        text: dsv.title
      },
      xAxis: {
        title: 'Usuários por status',
        categories: categories
      },
      yAxis: {
        title: {
          text: 'Quantidade'
        }
      },
      series: [
        {
          name: 'Usuários',
          data: data
        }
      ]
    }
  }
}

Extends

Members


canExport :boolean

Indica se a visualização pode realizar exportação. Esta propriedade deve ser utilizada quando se deseja desabilitar a exportação, sendo setada para false; setá-la para true não dará a capacidade de exportação para uma visualização que não possa ser exportada por padrão.

Type:
  • boolean
Inherited From:
Overrides:

dataSourceQuery :!Record.<*, *>|number

A chave do DataSourceQuery ou objeto literal que contém as definições do DataSourceQuery associado à visualização.

Type:
  • !Record.<*, *>| number
Inherited From:

dataSourceQueryKey :number

A chave do DataSourceQuery associado à visualização.

Type:
  • number
Inherited From:
Deprecated:

extraExportFormats :Array.<{name: string, processKey: number, useRawData: (boolean|undefined)}>

Formatos de exportação adicionais que a visualização suporta. Seus elementos são objetos literais que contêm o nome do formato de exportação, a chave do processo correspondente e uma flag que indica se devem ser exportados os dados da visualização conforme obtidos da fonte de dados.

Caso essa propriedade seja declarada na definição de uma visualização, as opções declaradas serão exibidas junto às opções padrão quando o usuário solicitar uma exportação. Quando o usuário selecionar uma dessas opções, será redirecionado ao processo correspondente.

Cada objeto possui:

  • name - O nome do formato de exportação, que será exibido em tela quando o usuário for selecionar um formato.
  • processKey - A chave do processo que implementa a exportação para aquele formato.
  • useRawData - Indica se o formato de exportação deve utilizar os dados "crus" da visualização, isto é, aqueles utilizados para a montagem da exibição. É opcional, e seu valor padrão é false.
Type:
  • Array.<{name: string, processKey: number, useRawData: (boolean|undefined)}>
Inherited From:
Example
{
  dataSourceQueryKey: -1892603784, //./Users.idsq
  type: "report",

  filters: [
    {name: "U_iName", label: "Nome de usuário"}
  ],

  columns: [
    {name: "U_iName", label: "Nome"}
  ],

  extraExportFormats: [
    {name: 'Formato customizado', processKey: 123456, useRawData: true}
  ]
}

filters :Array.<module:@nginstack/web-framework/lib/dsv/VisualizationFilterDef~VisualizationFilterDef>

Coleção de filtros que serão utilizados para filtrar os dados a serem exibidos.

Type:
Inherited From:

Definições a serem usadas para o cabeçalho da visualização.

Type:
Inherited From:

Definições a serem usadas para o cabeçalho da visualização.

Type:
Inherited From:

help :string

Ajuda que será exibida para o usuário quando ele solicitar ajuda desta visualização.

Type:
  • string
Inherited From:

includes :Array.<(number|string)>

Scripts a serem inclusos pela visualização, quando ela for instanciada.

Type:
  • Array.<(number|string)>
Inherited From:

noResultsMessage :string

Mensagem que será exibida para o usuário quando não há dados a serem exibidos.

Type:
  • string
Inherited From:

<nullable> onCreate :function

Se a visualização for instanciada pelo criador de visualizações e este método for declarado, ele será executado após a criação da visualização. Recebe a visualização criada como único parâmetro.

Type:
  • function
Inherited From:

onGetOptions :function

Função executada quando a visualização em gráfico é criada. Recebe a visualização e o DataSet obtido pelo DataSource, e deve retornar as opções de um gráfico, conforme documentado em Chart

Type:
  • function

title :string

Título desta visualização.

Type:
  • string
Inherited From:

type :string

O tipo desta visualização. Deve ser obrigatoriamente preenchido com o valor 'highcharts'.

Type:
  • string
Overrides:
Default Value:
  • 'highcharts'