Controle de entrada de variável

Você pode usar o controle de entrada variável para definir o valor de uma variável. Ela está incluída no Dashboard bundle.

Quando usar

Se você tiver visualizações com expressões que contenham uma variável, poderá usar o controle de entrada de variável para permitir que o usuário controle o valor da variável.

Criando um controle de entrada de variável

Você pode criar um controle de entrada de variável na pasta que está editando.

Faça o seguinte:

1. No painel de ativos do modo de edição avançada, abra Objetos personalizados > Dashboard bundle e arraste um objeto do Variable input até a pasta.
2. Selecione a variável a ser usada em Name em Aparência > Variable no painel de propriedades.

3. Selecione como você deseja inserir dados em Show as:

   • Buttons permite adicionar vários botões, com um botão para cada valor de variável definido.

     Você pode selecionar como exibir os botões em Display, selecionar Row para mostrá-los em uma linha horizontal ou Column para mostrá-los em uma coluna vertical.

     Os botões podem ser definidos de duas maneiras diferentes: fixos (Fixed) ou dinâmicos (Dynamic) com a configuração Fixed or dynamic values em Values.

     Se você optar por usar valores fixos, precisará adicionar cada botão com Add Alternative e definir um valor (Value) e um rótulo (Label) para cada botão.

     Se você usar valores dinâmicos, defina os botões com uma string em Dynamic values. Use | para separar botões e ~ para separar o valor do rótulo. Por exemplo, 'Germany~GER|France~FRA' criará dois botões chamados GER e FRA. O primeiro mudará o valor da variável para Germany, e o segundo mudará o valor para France. Você não precisará especificar rótulos se quiser usar valores como rótulos.

   • Drop down adiciona um menu suspenso com um item para cada valor de variável definido.

     Os itens podem ser definidos de duas maneiras diferentes: fixos (Fixed) ou dinâmicos (Dynamic) com a configuração Fixed or dynamic values em Values.

     Se você optar por usar valores fixos, precisará adicionar cada item com Add Alternative e definir um valor (Value) e um rótulo (Label) para cada item.

     Se você usar valores dinâmicos, defina os itens com uma string em Dynamic values. Use | para separar itens e ~ para separar o valor do rótulo. Por exemplo, 'Germany~GER|France~FRA' criará dois itens chamados GER e FRA. O primeiro mudará o valor da variável para Germany, e o segundo mudará o valor para France. Você não precisará especificar rótulos se quiser usar valores como rótulos.

   • Input box fornece uma caixa de entrada simples que atualizará o valor da variável.

   • Slider cria um controle deslizante que atualiza o valor da variável. Você define a configuração mínima com Min e a configuração máxima com Max em Values. Você também pode definir a etapa a ser usada com Step. Se você selecionar Slider label, o valor selecionado será exibido quando você arrastar o controle deslizante.

     O valor da variável será atualizado quando você parar de arrastar o controle deslizante, mas é possível selecionar Update on drag para que esse valor seja atualizado enquanto você arrasta. Isso pode ser útil quando você deseja que as visualizações baseadas na variável sejam atualizadas dinamicamente ao arrastar o controle deslizante. Use essa opção com cautela, pois o constante redesenho de gráficos pode ser inconveniente.

Personalizando o estilo

Com as Opções avançadas ativadas, você tem várias opções de estilo disponíveis em Aparência no painel de propriedades.

Clique em Estilo em Aparência > Apresentação para personalizar ainda mais o estilo do gráfico. Você pode redefinir seus estilos clicando em ao lado de cada seção. Clique em Redefinir tudo para redefinir os estilos de todas as guias disponíveis no painel de guias.

Para obter informações gerais sobre o estilo de uma visualização individual, consulte Aplicando estilo personalizado a uma visualização.

Personalizando o texto

Você pode definir o texto do título, subtítulo e nota de rodapé em Aparência > Geral. Para ocultar esses elementos, desative Mostrar títulos.

A visibilidade dos diferentes rótulos no gráfico depende das configurações específicas do gráfico e das opções de exibição do rótulo. Esses podem ser configurados no painel de propriedades.

Você pode estilizar o texto que aparece no gráfico.

Faça o seguinte:

1. Clique em Opções avançadas.

2. No painel propriedades, expanda a seção Aparência.

3. Em Aparência > Apresentação, clique em Estilo.

4. Na guia Geral, defina a fonte, o estilo de ênfase, o tamanho da fonte e a cor dos seguintes elementos de texto:

   • Título

   • Subtítulo

   • Nota de rodapé

Personalizando o plano de fundo

Você pode personalizar o plano de fundo do gráfico. O plano de fundo pode ser definido por cor e imagem.

Faça o seguinte:

1. Clique em Opções avançadas.

2. No painel propriedades, expanda a seção Aparência.

3. Em Aparência > Apresentação, clique em Estilo.

4. Na guia Geral do painel de estilo, você pode selecionar uma cor de fundo (cor única ou expressão). Você também pode definir o plano de fundo como uma imagem da sua biblioteca de mídia ou de uma URL.

   Nota informativa

   Para adicionar uma imagem de fundo de uma URL, a origem da URL precisa ser adicionada à lista de permissões na Content Security Policy de seu locatário. A origem deve ser adicionada com a seguinte diretriz: img-src. Isso é feito por um administrador de locatários.

   Para obter mais informações, consulte Criando uma entrada de CSP.

   Ao usar uma cor de fundo, use o controle deslizante para ajustar a opacidade do fundo.

   Ao usar uma imagem de fundo, você pode ajustar o tamanho e a posição da imagem.

Personalizando a borda e a sombra

Você pode personalizar a borda e a sombra do gráfico.

Faça o seguinte:

1. Clique em Opções avançadas.

2. No painel propriedades, expanda a seção Aparência.

3. Em Aparência > Apresentação, clique em Estilo.

4. Na guia Geral do painel de estilo, em Borda, ajuste o tamanho do Contorno para aumentar ou diminuir as linhas da borda ao redor do gráfico.

5. Selecione uma cor para a borda.

6. Ajuste o Raio do canto para controlar o arredondamento da borda.

7. Em Sobra na guia Geral, selecione um tamanho e uma cor para a sombra. Selecione Nenhum para remover a sombra.

Limitações

Para obter informações sobre limitações gerais, consulte Limitações.

• O rótulo do controle deslizante só pode exibir valores numéricos. Isso significa que, se o valor for uma data, o valor numérico da data será exibido. Se o valor for um valor percentual, o caractere de porcentagem não será exibido.