nginstack

Class: ReportVisualizationDef

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

new ReportVisualizationDef()

Classe que representa as configurações de visualizações de data sources em formato de um relatório.
Há duas formas de declarar uma visualização de uma fonte de dados. O conteúdo do arquivo pode ser um objeto literal com as propriedades documentadas nesta classe, como demonstrado no primeiro exemplo, ou um código JavaScript que deixa a definição da visualização na pilha, segundo exemplo.
O formato de objeto literal é mais compacto e é útil quando a configuração da visualização é gerada programaticamente. A segunda forma é mais interessante quando utilizada em uma IDE, pois permite que essa faça sugestões e validações das propriedades disponíveis. Ela também permite o uso de lints.
Modo 1:

{
  type: 'report',
  dataSourceQuery: dsqKey,
  filters: [{name: 'MyFilter', type: 'int64'}],
  messageWhenEmpty: 'Não há dados a serem exibidos.',
  columns: [
    {name: "U_iClass.NOME", label: ""},
    {name: "U_iFullName", label: "Nome completo do usuário"},
    {name: "U_iBegin", label: "Início"},
    {name: "U_iEnd", label: "Fim"}
  ]
}

Modo 2:

__includeOnce('ufs:/uwi/dsv/reportDef.js');

var def = new ReportVisualizationDef();
def.dataSourceQuery = dsqKey;
def.filters = [{name: 'MyFilter', type: 'int64'}];
def.columns = [
  {name: "U_iClass.NOME", label: ""},
  {name: "U_iFullName", label: "Nome completo do usuário"},
  {name: "U_iBegin", label: "Início"},
  {name: "U_iEnd", label: "Fim"}
];
var r = def;

Extends

  • DataVisualizationDef

Members

columns :Array.<ReportVisualizationColumnDef>

Coleção contendo as definições de colunas que serão montadas pela visualização.

Type:
  • Array.<ReportVisualizationColumnDef>

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

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

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

dataSourceQueryKey :number

A chave do DataSourceQuery associado à visualização.

Type:
  • number
Deprecated:
  • Use #dataSourceQuery

<nullable> footerComplement :string

Texto que servirá de complemento ao rodapé. Esta propriedade aceita texto em HTML.

Type:
  • string
See:
  • ReportVisualizationDef#showFooter

<nullable> groupExpansionLevel :number

O nível de expansão em árvore que o relatório montado pela visualização deve utilizar.

Type:
  • number
See:
  • SimpleLayout#groupExpansionLevel

<nullable> headerComplement :string

Texto que servirá de complemento ao cabeçalho. Esta propriedade aceita texto em HTML.

Type:
  • string
Deprecated:
  • Use a propriedade complement da propriedade #header.
See:
  • ReportVisualizationDef#showHeader

<nullable> orderBy :string

Os nomes das colunas pelas quais a visualização deve ser ordenada, separados por ponto-e-vírgula. Para ordenar uma coluna em ordem descendente, utilize um sinal negativo ('-') precedendo o nome da coluna.

Type:
  • string

rankingColumnLabel :string

O texto da coluna de ranking.

Type:
  • string
Default Value:
  • 'Ranking'

showDateTime :boolean

Indica se deverá ser apresentada a data e hora em que o relatório foi gerado. Esta informação se encontra na parte superior direita do relatório.

Type:
  • boolean
Default Value:
  • true

showEnterpriseName :boolean

Indica se o nome da empresa licenciada deve ser exibido no topo do relatório.

Type:
  • boolean
Default Value:
  • true

showFooter :boolean

Indica se será exibido o rodapé do relatório.

Type:
  • boolean
Deprecated:
  • Use a propriedade visible da propriedade #footer.
Default Value:
  • true
See:
  • ReportVisualizationDef#footerComplement

showHeader :boolean

Indica se será exibido o cabeçalho do relatório.

Type:
  • boolean
Deprecated:
  • Use a propriedade visible da propriedade #header.
Default Value:
  • true
See:
  • ReportVisualizationDef#headerComplement

showOnlyFilledVariables :boolean

Indica se deverão ser apresentadas somente as variáveis preenchidas com algum valor pelo usuário quando da geração do Layout. Caso esta propriedade esteja marcada como "false", serão apresentadas todas as variáveis da grade que deu origem no Layout. Note que esta propriedade será ignorada se a propriedade showVariables estiver marcada como "false".

Type:
  • boolean
Default Value:
  • true
See:
  • ReportVisualizationDef#showVariables

showPath :boolean

Indica se apresentará o caminho do relatório subjacente na hierarquia de classes do Sistema Virtual de Arquivos (Virtual File System).

Type:
  • boolean
Default Value:
  • true

showRankingColumn :boolean

Indica se o SimpleLayout deve exibir a coluna de ranking.

Type:
  • boolean
Default Value:
  • false

showUserAndDataBaseName :boolean

Indica se deverá ser exibido no relatório o código do usuário logado e o nome da base de dados. Esta informação se encontra na parte superior direita do relatório ("Usuário Logado / BASE").

Type:
  • boolean
Default Value:
  • true

showVariables :boolean

Indica se deverão ser apresentadas as variáveis utilizadas para a geração do relatório.

Type:
  • boolean
Default Value:
  • true
See:
  • ReportVisualizationDef#showOnlyFilledVariables

totalLabel :string

O texto exibido na linha com os totais.

Type:
  • string
Default Value:
  • 'Total'

type :string

O tipo desta visualização. Deve ser obrigatoriamente preenchido com o valor 'report'.
Por compatibilidade com versões anteriores, também é suportado o valor 'simpleLayout'.

Type:
  • string
Default Value:
  • 'report'