/
Criar gráfico (Servidor) / Create chart (Server)

Criar gráfico (Servidor) / Create chart (Server)

Crie um gráfico definindo a série de dados, legenda, nome da série, entre outras configurações, e o renderiza por meio do componente visual Gráfico.

Figura 1 - Bloco Criar gráfico

Compatibilidade

  • Bloco servidor: cronapi.chart.Operations.createChart()

Retorno

O bloco não possui retorno.

Características do bloco

O bloco Criar gráfico permite a adição de novos parâmetros "Série(s) do gráfico". Para isso, clique no ícone de configuração do bloco e arraste os blocos "item" para a área correspondente. Verifique o local que será encaixado, pois a ordem pode ser alterada.

Figura 2 - Adicionando novos parâmetros ao bloco

Parâmetros

Id

Identificador (id) do componente Gráfico a ser utilizado. Para selecioná-lo, é necessário vincular o bloco de programação a um formulário de referência, confira no tópico Propriedades do Blockly da documentação Bloco de Programação.

  • Posição: 1

  • Inglês: Id

  • Tipo: Objeto / Object

  • Exemplo: "chart2156"

Tipo de gráfico

Seleção do tipo de gráfico a ser exibido. 

  • Posição: 2

  • Inglês: Chart type

  • Tipo: Objeto / Object

  • Exemplo: "line"

  • Opções:

Linha / Line

Barra / Bar

Rosca / Doughnut

Pizza / Pie

Área polar / PolarArea

Legenda

Define o rótulo da série do gráfico. Caso seja mais de um rótulo, utilize uma lista.

  • Posição: 3

  • Inglês: Legends 

  • Tipo: Lista / List

  • Exemplo: retorno do bloco criar lista informando os rótulos

Opções

Define uma estrutura JSON para personalizar o gráfico, adicionando propriedades como animação, legenda, título, entre outras configurações. Para mais detalhes de personalização, consulte os links de Animação, Layout, Legenda, Título, Tooltip e Elementos.

  • Posição: 4

  • Inglês: Options

  • Tipo: JSON / JSON

  • Exemplo:

    { "title": { "display": true, "text": "Título personalizado do gráfico" }, "legend" : { "display": true } }

Série(s) do gráfico

Define uma ou mais séries do gráfico utilizando o bloco de programação Criar série. É possível adicionar novas séries ao bloco através do botão de engrenagem do bloco. Para mais detalhes, consulte o tópico Características do bloco.

  • Posição: 5

  • Inglês: Chart serie(s)

  • Tipo: Lista / List

  • Exemplo: retorno do bloco Criar série

Exemplo

A função da imagem abaixo cria um gráfico no componente Gráfico correspondente ao "Id" informado. Esse gráfico exibe dados que representam a quantidade de uma venda hipotética de chocolate e jujuba nos meses de julho, agosto e setembro. 

Figura 3 - Exemplo de uso do bloco Criar gráfico

 

Na imagem a seguir, podemos visualizar o resultado de execução da função da Figura 3.

Figura 3.1 - Resultado de execução da função da Figura 3

Nesta página