Macro de gráfico
A macro de gráfico permite que você exiba um gráfico com base em dados tabulares. Ao adicionar a macro a uma página, você:
- fornece os dados a serem representados no gráfico pela macro como tabela no lugar reservado da macro.
- edita os parâmetros da macro no Navegador de macro para configurar o formato do gráfico.
Captura de tela 1: Uma tabela de dados no lugar reservado da macro de gráfico
Captura de tela 2: O gráfico resultante
Nesta página:
Usar a macro de gráfico
Para adicionar a macro de gráfico a uma página:
- Edite a página e use o preenchimento automático para adicionar a macro de gráfico. (Digite "{chart}".)
- Insira os dados do seu gráfico como uma ou mais tabelas no corpo do lugar reservado da macro. (Consulte a captura de tela acima.)
- Clique no lugar reservado da macro e escolha Editar.
- Selecione um tipo de gráfico usando o parâmetro Tipo (ver abaixo).
- Escolha outras configurações de parâmetro no navegador de macro, conforme descrito abaixo.
- Clique em Atualizar na área de "Visualização" para verificar se o gráfico aparece da maneira esperada.
- Clique em Salvar para adicionar o gráfico à sua página.
- Clique em Salvar novamente quando estiver pronto para salvar a página.
Parâmetros
Parâmetros de tipo de gráfico
Esses parâmetros determinam o tipo de gráfico a ser exibido e a aparência do gráfico.
Parâmetro | Padrão | Descrição |
---|---|---|
Tipo | pie | O tipo de gráfico a ser exibido. Gráficos XY têm eixos x e y numéricos. Como opção, os valores de x podem ser baseados em tempo (veja o parâmetro Série temporal). Padrão — pie, bar, line, area Representações XY — xyArea, xyBar, xyLine, xyStep, xyStepArea, scatter, timeSeries Outros — gantt |
Orientação da exibição | vertical | Aplica-se a gráficos de área, barra e linha.
|
Mostrar em 3D | false | Aplica-se a gráficos de área, barra e linha. |
Valores empilhados | false | Aplica-se a gráficos de área e barra. |
Mostrar formas | true | Aplica-se a gráficos de linha. As formas são mostradas em cada ponto de dados. |
Opacidade |
| Um valor percentual entre 0 (transparente) e 100 (opaco) que determina a opacidade das áreas do primeiro plano e das barras. |
Exibir parâmetros de controle
Parâmetro | Padrão | Descrição |
---|---|---|
Largura | 300 | A largura do gráfico em pixels. |
Altura | 300 | A altura do gráfico em pixels. |
Exibir dados renderizados | false | Define se o corpo renderizado da macro (geralmente, as tabelas de dados) deve ser exibido. Por padrão, a tabela de dados do gráfico não é renderizada.
|
Formato da imagem | png | O formato de imagem a ser usado para o gráfico.
|
Parâmetros de título e rótulo
Parâmetro | Padrão | Descrição |
---|---|---|
Título do gráfico | none | O título do gráfico. |
Subtítulo do gráfico | none | Um subtítulo para o gráfico, usando uma fonte menor que a do Título. |
Rótulo do eixo horizontal | none | O rótulo do eixo x (domínio). |
Rótulo do eixo vertical | none | O rótulo do eixo y (imagem). |
Mostrar legenda | true | Mostrar uma legenda ou chave. |
Parâmetros de especificação de dados
Os dados do gráfico são retirados de tabelas encontradas quando o corpo da macro é renderizado. Essas opções controlam como esses dados são interpretados. Por padrão, valores numéricos e de datas são interpretados de acordo com os formatos globais de idioma (local) padrão do Confluence. Se a conversão falhar, outros idiomas definidos no Confluence serão utilizados. Opções de conversão adicionais podem ser especificadas usando os parâmeros abaixo.
Parâmetro | Padrão | Descrição |
---|---|---|
Tabelas | todas as tabelas de primeiro nível | Lista de ids de tabela e/ou números de tabela (começando pelo 1) separados por vírgula contidos dentro do corpo da macro que serão usados como dados para o gráfico. Se as tabelas de dados forem integradas a outras tabelas, será necessária a seleção da tabela. Isso ocorre quando é realizada uma formatação mais complexa (por exemplo, usando macros de seção e coluna). |
Colunas | todas as colunas | Lista de rótulos de coluna e/ou números de coluna separados por vírgula para tabelas usados para dados do gráfico. Isso se aplica a todas as tabelas processadas. As colunas são enumeradas de 1. O rótulo da coluna é o texto para a coluna na linha do cabeçalho. O título da coluna é o atributo de título (html) da coluna na linha do cabeçalho. |
Orientação do conteúdo | horizontal |
|
Série temporal | false |
|
Formato de data | Formatos de data definidos pelo idioma do Confluence | Para dados de série temporal, o formato de data permite uma personalização adicional da conversão de dados para valores em data. Se um formato de data for especificado, ele será o primeiro formato usado para interpretar valores de data. Especifique um formato que corresponda aos dados da série temporal. Consulte formato de data simples. |
Período de tempo | Dia | O período de tempo para os dados da série temporal. Define a granularidade de como os dados são interpretados. Os valores válidos são: Milissegundo, Segundo, Minuto, Hora, Dia, Semana, Mês, Trimestre, Ano. |
Idioma | none | Use em conjunto com o parâmetro País para formar um local. Esses formatos adicionais de número e data serão usados para conversão de dados antes dos idiomas padrão. Os valores válidos são códigos ISO 639-1 alpha-2 de 2 caracteres. |
País | none | Use em conjunto com o parâmetro Idioma para formar um local. Os valores válidos são códigos ISO 3166 de 2 caracteres. |
Tolerância | true |
|
Parâmetros de cor
Cores são especificadas com o uso de notação hexadecimal ou nomes de cor HTML.
Parâmetro | Padrão | Descrição |
---|---|---|
Cor do segundo plano | Branco | Segundo plano do gráfico. |
Cor da borda | no border | Borda em torno do gráfico. |
Cores | Lista de cores, separadas por vírgula, usadas para personalizar cores de categoria, seções e séries. |
Parâmetros de eixo
Dependendo do tipo de gráfico, os eixos de imagem e domínio podem ser personalizados. Esses valores são gerados automaticamente com base nos dados, mas podem ser substituídos especificando um ou mais desses parâmetros.
Parâmetro | Padrão | Descrição |
---|---|---|
Valor mínimo da imagem | none | Eixo de imagem voltado para baixo. |
Valor máximo da imagem | none | Eixo de imagem voltado para cima. |
Unidade de marcação do eixo de imagem | none | Unidades do eixo de imagem entre marcações de indicação do eixo. |
Ângulo do rótulo do eixo de imagem | none | Ângulo para o rótulo do eixo de imagem em graus. |
Eixo de domínio voltado para baixo | none | Aplica-se apenas a representações XY. Eixo de domínio voltado para baixo. Para um eixo de data, esse valor precisa ser expresso no formato de data especificado pelo parâmetro Formato de data. |
Eixo de domínio voltado para cima | none | Aplica-se apenas a representações XY. Eixo de domínio voltado para cima. Para um eixo de data, esse valor precisa ser expresso no formato de data especificado pelo parâmetro Formato de data. |
Unidade de marcação do eixo de domínio | none | Aplica-se apenas a representações XY. Unidades do eixo de domínio entre marcações de indicação do eixo. Para um eixo de datas, esse valor representa uma contagem das unidades especificadas no parâmetro Período de tempo. A unidade do Período de tempo pode ser substituída especificando um caractere final: y (anos), M (meses), d (dias), h (horas), m (minutos), s (segundos), u (milissegundos). |
Ângulo do rótulo do eixo de domínio | none | Aplica-se apenas a representações XY. O ângulo do rótulo do eixo de domínio, em graus. |
Posição do rótulo de categoria | none | Colocação do texto do rótulo do eixo para categorias.
|
Posição da marcação de indicação de data | start | Colocação da marcação de indicação de data.
|
Parâmetros de gráfico do tipo pizza
Parâmetro | Padrão | Descrição |
---|---|---|
Rótulo da seção da pizza | Mostrar apenas o valor da chave da seção da pizza | Formatar como os rótulos de seções da pizza são exibidos. O formato usa uma string com variáveis de substituição especial:
Exemplo 1: "%0% = %1%" exibiria algo do tipo "Independente = 20" |
Explosão da seção da pizza | Nenhuma seção explodida | Lista de chaves da pizza, separadas por vírgula, que devem ser mostradas explodidas. Nota: necessário jFreeChart versão 1.0.3 ou mais recente. |
Parâmetros de anexo
Essas são opções avançadas que podem ser usadas para criação de versões do gráfico, para permitir automação e para melhorar o desempenho. Use essas opções com cuidado! Normalmente, a imagem do gráfico é gerada novamente toda vez que a página é exibida. Essas opções permitem que a imagem gerada seja salva como anexo e faz com que o acesso subsequente reutilize o anexo. Isso pode ser útil, especialmente ao ser combinado com o Cache Pluginpara melhorar o desempenho. Dependendo das opções escolhidas, é possível criar versões de imagens de gráfico para fins de histórico.
Parâmetro | Padrão | Descrição |
---|---|---|
Anexo | none | O nome e o local com os quais a imagem do gráfico será salva como anexo. O usuário precisa estar autorizado a adicionar anexos à página especificada.
|
Versão do anexo | new | Define o mecanismo de criação de versões para gráficos salvos.
|
Comentário de anexo | none | Comentário usado para um anexo de gráfico salvo. |
Miniatura | false |
|
Exemplos
Gráfico pizza
Parâmetros no navegador de macro | Tabela de dados no lugar reservado da macro | Gráfico renderizado | |||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Tipo | pie |
| |||||||||
Título do gráfico | Peixes vendidos 2011 | ||||||||||
Mostrar legenda | true | ||||||||||
Orientação do conteúdo | vertical | ||||||||||
|
Gráfico de barras
Parâmetros no navegador de macro | Tabela de dados no lugar reservado da macro | Gráfico renderizado | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Tipo | bar |
| |||||||||||||
Título do gráfico | Peixes vendidos | ||||||||||||||
Mostrar legenda | true | ||||||||||||||
| |||||||||||||||
Gráfico de barras 3D
Parâmetros no navegador de macro | Tabela de dados no lugar reservado da macro | Gráfico renderizado | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Tipo | bar |
| |||||||||||||
Mostrar em 3D | true | ||||||||||||||
Opacidade | 50 | ||||||||||||||
Mostrar legenda | true | ||||||||||||||
Gráfico de série temporal
Parâmetros no navegador de macro | Tabelas de dados no lugar reservado da macro | Gráfico renderizado | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Tipo | Série temporal |
|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||
Formato de data | MM/aaaa | |||||||||||||||||||||||||||||||||||||||||||||||||||||||
Período de tempo | Mês | |||||||||||||||||||||||||||||||||||||||||||||||||||||||
Orientação do conteúdo | vertical | |||||||||||||||||||||||||||||||||||||||||||||||||||||||
Eixo de imagem voltado para baixo | 0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||
Mostrar legenda | true | |||||||||||||||||||||||||||||||||||||||||||||||||||||||
Gráfico de linha XY
Parâmetros no navegador de macro | Tabela de dados no lugar reservado da macro | Gráfico renderizado | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Tipo | xyLine |
| |||||||||||||
Mostrar legenda | true | ||||||||||||||
|
Gráfico de área XY
Parâmetros no navegador de macro | Tabela de dados no lugar reservado da macro | Gráfico renderizado | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Tipo | xyArea |
| |||||||||||||
Mostrar legenda | true | ||||||||||||||
Gráficos de área
Exemplo 1
Parâmetros no navegador de macro | Tabela de dados no lugar reservado da macro | Gráfico renderizado | |||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Tipo | area |
| |||||||||||||||||||||
Mostrar legenda | true | ||||||||||||||||||||||
Largura | 300 | ||||||||||||||||||||||
Altura | 300 | ||||||||||||||||||||||
Opacidade | 50 | ||||||||||||||||||||||
|
Exemplo 2
Parâmetros no navegador de macro | Tabela de dados no lugar reservado da macro | Gráfico renderizado | |||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Tipo | area |
|
| ||||||||||||||||||||
Mostrar legenda | true | ||||||||||||||||||||||
Largura | 300 | ||||||||||||||||||||||
Altura | 300 | ||||||||||||||||||||||
Valores empilhados | true | ||||||||||||||||||||||
|
Gráfico de Gantt
Parâmetros no navegador de macro | Tabela de dados no lugar reservado da macro | Gráfico renderizado | |||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Tipo | gantt |
| |||||||||||||||||||||||||||||||||
Largura | 300 | ||||||||||||||||||||||||||||||||||
Altura | 200 | ||||||||||||||||||||||||||||||||||
Colunas | ,,1,2,3,4 | ||||||||||||||||||||||||||||||||||
Formato de data | MM/dd/aaaa | ||||||||||||||||||||||||||||||||||
|
É necessário incluir duas vírgulas iniciais no parâmetro da coluna (por exemplo, ,,1,2,3,4
) para que o gráfico seja criado corretamente.
Exemplos de código
Esse exemplo é útil quando você quer adicionar uma macro fora do editor, por exemplo, como um conteúdo personalizado na barra lateral, no cabeçalho ou no rodapé de um espaço.
Nome da macro: chart
Corpo da macro: Aceita rich text, consistindo em tabelas que contêm os dados do gráfico.
Essa macro reconhece um grande número de parâmetros, listados aqui por tipo.
Exemplo de marcação do wiki
Abaixo há um exemplo simples de um gráfico do tipo pizza. Consulte mais exemplos em Exemplos de marcação do Wiki para macro de gráfico.
{chart:type=pie|title=Fish Sold}
|| Fish Type || 2004 || 2005 ||
|| Herring | 9,500 | 8,300 |
|| Salmon | 2,900 | 4,200 |
|| Tuna | 1,500 | 1,500 |
{chart}