Adicionando linhas usando uma propriedade

Você pode utilizar uma propriedade como entrada para uma linha ou uma curva. Um valor de propriedade pode ser uma expressão de string em si ou pode ser usado como uma variável em uma expressão personalizada.

Antes de Iniciar

A funcionalidade descrita aqui deve ser criada usando o cliente instalado.

Usar um valor de propriedade para definir uma linha em uma visualização

O primeiro exemplo descreve como a posição de uma linha horizontal em um gráfico de dispersão pode ser alterada por qualquer pessoa utilizando um controle de propriedade em uma área de texto.

Por Que e Quando Desempenhar Esta Tarefa

Siga as etapas para criar esse tipo de análise.

Procedimento

Crie ou edite uma área de texto.
No modo de edição, adicione o controle de propriedade à área de texto. Neste exemplo, adicionamos um campo de entrada.
Na caixa de diálogo Controle de propriedade, crie a propriedade em Novo. Dê um nome para a propriedade, especifique seu tipo de dados e defina um valor inicial. Neste exemplo, chamamos a propriedade “LineAt”.
Quando a propriedade existir e for selecionada, você poderá ajustar a formatação dos valores na parte inferior da caixa de diálogo Controle de propriedade. Clique em OK quando terminar e Salve a área de texto.
A próxima etapa é conectar a propriedade criada à configuração que deve ser afetada pelo valor da propriedade. Na visualização em que você deseja adicionar a linha, clique com o botão direito do mouse e selecione Propriedades.
Clique em Linhas e Curvas.
Clique em Adicionar > Linha horizontal > Linha reta.
Na caixa de diálogo Linha horizontal, selecione a opção Expressão personalizada, clique em Editar e, na caixa de diálogo Expressão personalizada, insira ${LineAt}.
Essa é a sintaxe usada ao adicionar o valor da propriedade como texto em uma expressão (e também o padrão se você clicar duas vezes na propriedade na lista Propriedades disponíveis para a coluna). Veja em Propriedades em expressões mais informações sobre as diferentes sintaxes.
Clique em OK.
A curva é mostrada na visualização, e você pode usar o controle de propriedade na área de texto para alterar o valor e, portanto, a posição da linha.

Usar uma expressão de propriedade para definir uma curva

Neste exemplo, é usado um gráfico de dispersão para mostrar os salários dos funcionários, em grade por nível educacional. A área de texto contém um controle de propriedade na forma de uma lista suspensa, em que um usuário do painel pode optar por adicionar linhas horizontais que mostram a média, a mediana ou o salário mais comum em cada nível de formação.

Por Que e Quando Desempenhar Esta Tarefa

Siga as etapas para criar esse tipo de análise.

Procedimento

Crie ou edite uma área de texto.
No modo de edição, adicione o controle de propriedade à área de texto. Neste exemplo, adicionamos uma lista suspensa.
Na caixa de diálogo Controle de propriedade, crie a propriedade em Novo. Dê um nome para a propriedade, especifique seu tipo de dados e defina um valor inicial. Neste exemplo, chamamos a propriedade “SalaryExpression”.
Na visualização onde você deseja adicionar a curva, clique com o botão direito do mouse e selecione Propriedades.
Clique em Linhas e Curvas.
Clique em Adicionar e selecione Desenho da Curva.
As propriedades também podem ser usadas ao definir linhas retas ou em expressões para curvas a partir da tabela de dados.
Na caixa de diálogo Desenho de Curva, chame a propriedade que contém a expressão no campo Expressão da curva usando a sintaxe Texto: Por exemplo, ${CurveExpression}.
A propriedade do documento curve.expression poderia, neste exemplo, reter um valor como "2+3*x". A expressão poderia também conter outras propriedades. Por exemplo, "2+DocumentProperty("ExpressionConstant")*x". Observe que a sintaxe para chamar uma propriedade difere ao chamá-la para recuperar o valor da propriedade. Veja em Propriedades em expressões mais informações sobre as diferentes sintaxes.
Clique em OK.
A curva é mostrada na visualização.

Adicionar um campo de entrada que atualiza a propriedade do documento

Esta é uma descrição genérica de como adicionar um campo de entrada (vinculado a uma propriedade do documento) a uma área de texto.

Procedimento

Crie uma área de texto, onde você quer que o campo de entrada fique.
Na barra de título da área de texto, clique em Editar Área de Texto.

Dica: Você também pode clicar com o botão direito do mouse e selecionar Editar Área de Texto do menu pop-up.
Na caixa de diálogo Editar área de texto, digite um texto descritivo sobre o que o controle fará.
Isto pode ser importante para ajudar outros usuários do arquivo de análise compreender o que acontecerá quando alterarem o texto no campo de entrada.
Clique em Inserir Controle de Propriedade e selecione a opção Campo de entrada.
Na caixa de diálogo Controle de Propriedade, clique para selecionar a propriedade de interesse na lista Selecionar propriedade.
Use o campo de pesquisa se você não encontrou sua propriedade. Você também pode especificar uma nova propriedade, clicando em Novo.
Clique em OK.
Clique em Salvar quando terminar.
Clique em Fechar no canto superior direito para sair da caixa de diálogo Editar Área de Texto.

Resultados

O campo de entrada é adicionado à área de texto.

Esse tipo de campo de entrada funciona bem junto com um botão ou um link que executa alguns tipos de ação. Por exemplo, um botão que atualiza um título de visualização, conforme descrito em Usando scripts na área de texto. Veja também Usando uma propriedade para fins de coloração.