Parâmetros

Os parâmetros permitem-lhe interagir com os dados fornecidos pelos utilizadores. Por exemplo, pode criar campos calculados que incluam a opinião das pessoas que estão a usar o seu relatório ou pode transmitir valores para a consulta SQL usada pela sua origem de dados. A utilização de parâmetros torna os seus relatórios mais interativos. Também pode usar parâmetros para criar modelos de relatórios.

Como funcionam os parâmetros

Os parâmetros funcionam como variáveis numa linguagem de programação. Os parâmetros têm três utilizações principais:

• Pode usar parâmetros em campos calculados para apresentar resultados baseados na opinião dos utilizadores.
• Pode transmitir parâmetros para a consulta SQL personalizada numa origem de dados do BigQuery.
• Pode transmitir parâmetros para um conetor da comunidade.

Os parâmetros podem obter os respetivos dados das seguintes localizações:

• A partir de um valor predefinido definido para o parâmetro
• A partir do painel de propriedades do componente
• A partir de um controlo colocado no relatório
• A partir do link para o relatório

Encontra os parâmetros na parte inferior das listas de campos nos editores de relatórios e origens de dados. Os parâmetros aparecem como campos roxos.

Como os parâmetros partilham os seus dados nos relatórios

As pessoas com acesso de edição dos seus relatórios e origens de dados podem aceder a todos os dados controlados por parâmetros. Os parâmetros permitem que as pessoas com acesso de edição de relatórios peçam dados diferentes dos predefinidos.

Antes de ativar os parâmetros para a sua origem de dados, certifique-se de que compreende como as alterações aos valores dos parâmetros podem afetar os dados nos seus relatórios. Alguns parâmetros podem devolver apenas dados relativamente "seguros", como o clima numa nova localização. No entanto, outros parâmetros podem permitir que alguém peça conjuntos de dados totalmente novos.

Por exemplo, um parâmetro de número da conta ou o nome de uma tabela da base de dados pode devolver dados que não pretendia partilhar. Qualquer um destes pode devolver um esquema diferente, que pode ser incompatível com os gráficos existentes no relatório.

Crie um parâmetro

Pode criar parâmetros nas seguintes localizações:

• Uma origem de dados
• O conetor do BigQuery

Crie um parâmetro numa origem de dados

1. Edite a origem de dados.
2. Na parte superior direita, clique em ADICIONAR UM PARÂMETRO. Também pode criar um parâmetro enquanto edita um relatório selecionando um componente e, em seguida, na parte inferior direita, clicando em ADICIONAR UM PARÂMETRO. Certifique-se de que seleciona um componente com base na origem de dados pretendida.
3. Configure as opções e o valor predefinido do parâmetro.

Enquanto edita um relatório, pode usar o link +Adicionar um parâmetro no painel de dados para criar um parâmetro na origem de dados selecionada.

Crie um parâmetro no conetor do BigQuery

Pode transmitir parâmetros para uma consulta SQL personalizada no conetor do BigQuery. O conetor do BigQuery define vários parâmetros padrão que transmitem a data de início e a data de fim do relatório, bem como o endereço de email do utilizador, se disponível. Também pode transmitir parâmetros personalizados. Saiba como fazer a associação ao BigQuery.

Parâmetros e conetores da comunidade

Os conetores da comunidade podem incluir parâmetros substituíveis, que permitem que as pessoas com acesso de edição de relatórios modifiquem os respetivos valores predefinidos numa origem de dados. Se puder editar a associação de uma origem de dados criada com um conetor da comunidade, pode especificar os parâmetros que as pessoas com acesso de edição de relatórios podem alterar:

1. Edite a origem de dados.
2. Na parte superior esquerda, clique em EDITAR ASSOCIAÇÃO.
3. Se o conetor fornecer parâmetros editáveis, estes aparecem na parte inferior da página. Os conetores que lhe permitem definir parâmetros personalizados incluem instruções na página.
4. Use as caixas de verificação Permitir que o parâmetro <nome do parâmetro> seja modificado nos relatórios para permitir ou não a edição do parâmetro nos relatórios.
5. Na parte superior direita, clique em VOLTAR A ASSOCIAR.

Depois de criar uma origem de dados a partir de um conetor da comunidade, as alterações aos parâmetros nesse conetor não aparecem automaticamente na origem de dados. Tem de voltar a associar a origem de dados para ver parâmetros novos, removidos ou alterados.

Edite um parâmetro existente

Para alterar a configuração de um parâmetro existente:

1. Edite a origem de dados que contém o parâmetro.
2. Localize o parâmetro na lista de campos.
3. Clique no símbolo @ à direita do nome do parâmetro.
4. Faça as alterações e, em seguida, na parte inferior direita, clique em GUARDAR.

Configure um parâmetro

Use estas opções para configurar um parâmetro na origem de dados. Consulte as páginas respetivas se estiver a usar o conetor do BigQuery ou um conetor da comunidade.

Nome do parâmetro : vê este nome nas listas de campos nos seus relatórios e origens de dados. Este é também o nome que usa para se referir ao parâmetro num campo calculado.

ID do parâmetro : definido por predefinição. O ID do parâmetro é usado internamente pelo Data Studio para identificar o parâmetro. Os visualizadores de relatórios não o veem.

Importante: a alteração do ID do parâmetro vai fazer com que os componentes e os campos calculados que incluem o parâmetro deixem de funcionar.

Tipo de dados : os parâmetros podem armazenar valores de texto, números ou booleanos (verdadeiro/falso).

Valores permitidos : especifica os valores que o utilizador pode introduzir.

Para especificar uma lista de valores, escolha essa opção e, em seguida, introduza o valor aceitável, juntamente com um nome a apresentar opcional. Clique em Adicionar opção para adicionar mais itens à lista.

Para especificar um intervalo de valores permitidos, introduza os valores mínimo e máximo do intervalo.

Valor predefinido : especifique um valor inicial para o parâmetro.

Defina os valores dos parâmetros

Pode definir o valor de um parâmetro das seguintes formas:

• Defina um valor predefinido para o parâmetro
• Use um controlo para receber a opinião dos utilizadores
• Substitua os valores predefinidos dos parâmetros num componente
• Modifique os parâmetros através do link do relatório

Defina um valor predefinido para o parâmetro

Pode definir valores predefinidos para um parâmetro quando cria um parâmetro ou edita um parâmetro.

Use um controlo para receber a opinião dos utilizadores

Os controlos são componentes que permitem que as pessoas interajam com um relatório. Para armazenar a opinião dos utilizadores num parâmetro, adicione esse parâmetro à propriedade Campo de controlo de um controlo:

1. Edite o seu relatório.
2. Na parte superior, clique em Adicionar um controlo.
3. Escolha o tipo de controlo a adicionar.
4. No painel Propriedades, selecione o separador CONFIGURAÇÃO.
5. Adicione o parâmetro ao Campo de controlo.

Saiba mais sobre os controlos.

Substitua os valores predefinidos dos parâmetros num componente

Pode substituir os valores predefinidos dos parâmetros editando componentes individuais no relatório:

1. Edite o seu relatório.
2. Selecione um componente com base numa origem de dados que inclua parâmetros.
3. Na parte inferior do separador DADOS do componente, edite os valores predefinidos dos parâmetros.

Também pode editar parâmetros ao nível do relatório e da página:

1. Edite o seu relatório.
2. Selecione Ficheiro > Definições do relatório ou Página > Definições da página atual.
3. Edite os valores dos parâmetros.

Herança de parâmetros

Os parâmetros seguem as mesmas regras de herança que as propriedades dos filtros. Especificamente, os parâmetros em componentes de maior precedência substituem os parâmetros em componentes de menor precedência. A ordem de precedência (da mais baixa para a mais alta) é a seguinte:

1. Origem de dados (predefinição)
2. Relatório
3. Página
4. Grupo
5. Gráfico ou controlo individual

Modifique os parâmetros através do link do relatório

A definição de parâmetros através do URL do relatório permite que os programadores e os utilizadores avançados criem relatórios que podem ser configurados programaticamente.

Os parâmetros do relatório do Data Studio e os respetivos valores são transmitidos como strings JSON com codificação de URL anexadas ao URL do relatório através do parâmetro de consulta "params".

Saiba mais no Guia do programador.

Faça a gestão dos parâmetros do relatório

Por predefinição, os parâmetros nos seus relatórios não são editáveis através do URL do relatório.

Para selecionar os parâmetros que os utilizadores do relatório podem modificar:

1. Edite o seu relatório.
2. Selecione Recurso > Gerir variáveis (parâmetros).
3. Na coluna Permitir modificação no URL do relatório , selecione os parâmetros que quer permitir.

Esta página também apresenta o parâmetro de URL de cada parâmetro. Este é o nome que usa, e não o nome do parâmetro, quando cria o objeto de parâmetro codificado. Pode editar este nome clicando no lápis de edição. Todos os parâmetros de URL num relatório têm de ser únicos.

A edição do nome do parâmetro de URL não tem qualquer efeito na forma como o parâmetro é usado no relatório.

Use parâmetros

Depois de criados, pode usar os parâmetros em campos calculados e componentes de relatórios, tal como usaria dimensões e métricas.

Use um parâmetro num campo calculado

Pode usar um parâmetro tal como usaria uma dimensão ou uma métrica num campo calculado.

Campo calculado com um parâmetro. Clique para a expandir.

Por exemplo, suponhamos que quer visualizar as vendas previstas permitindo que alguém introduza um multiplicador para as suas vendas do trimestre anterior.

Primeiro, crie o parâmetro para reter o multiplicador de previsão:

1. Inicie sessão no Data Studio.
2. Edite a sua origem de dados.
3. Na parte superior direita, clique em ADICIONAR UM PARÂMETRO.
4. Atribua um nome ao parâmetro (por exemplo, "Multiplicador de previsão").
5. Defina o Tipo de dados como Número.
6. Para simplificar, deixe a opção Valores permitidos definida como Qualquer valor.
   Pode usar as outras opções para permitir que o utilizador escolha a partir de uma lista de valores ou pode restringir a respetiva entrada a um intervalo de valores.
7. Defina o Valor predefinido como 1.
8. Clique em Guardar.
9. Para regressar à lista de campos da origem de dados, clique em TODOS OS CAMPOS à esquerda.

Em seguida, crie o campo calculado:

1. Na parte superior direita, clique em ADICIONAR UM CAMPO .
2. Atribua um nome ao campo (por exemplo, "Previsão de vendas com parâmetro").
3. Na fórmula, multiplique o campo "Vendas" da sua origem de dados pelo parâmetro Forecast multiplier. Por exemplo, se a sua origem de dados tiver um campo denominado Receita, introduza o seguinte:
   Revenue * Forecast multiplier
4. Clique em Guardar.

Em seguida, adicione um controlo para recolher a opinião do utilizador:

1. Edite ou crie um relatório.
2. Se necessário, adicione a sua origem de dados ao relatório.
3. Na parte superior, clique em /> Adicionar um controlo .
4. Selecione o controlo Caixa de introdução.
   O controlo Caixa de introdução permite-lhe escrever valores de parâmetros diretamente. Outros tipos de controlos permitem-lhe selecionar a partir de uma lista, usar um controlo de deslize ou ativar/desativar valores booleanos com uma caixa de verificação.
5. À direita, em Propriedades de DADOS, adicione o Forecast multiplier parâmetro que criou anteriormente.

Por fim, visualize o campo calculado com parâmetros num gráfico.

1. Na parte superior, clique em Adicionar um gráfico.
2. Para simplificar, selecione uma Tabela de dados.
3. À direita, em Propriedades de DADOS, adicione o campo calculado Sales forecast with parameter como a métrica.

Agora, experimente:

1. Na parte superior direita, clique em Ver.
2. Introduza um número no controlo Multiplicador de previsão e, em seguida, prima Enter.
3. O valor na tabela de dados é alterado à medida que é multiplicado pelo valor que introduz.

Use um parâmetro numa visualização

Pode adicionar um parâmetro a um gráfico, tal como adicionaria uma dimensão ou uma métrica. Se usar um parâmetro numérico como uma métrica, o respetivo valor é agregado.

Mostre ou oculte parâmetros nos relatórios

Pode mostrar ou ocultar parâmetros que criou numa origem de dados:

1. Edite a sua origem de dados.
2. Localize o parâmetro.
3. À direita do parâmetro, clique em Opções.
4. Clique em Mostrar (se o parâmetro estiver atualmente oculto) ou Ocultar (se o parâmetro estiver atualmente visível).

A ocultação de um parâmetro remove-o da lista de campos no painel Dados e faz com que os componentes que o usam deixem de funcionar. Se o parâmetro for usado num campo calculado, a fórmula usa o valor predefinido do parâmetro.

Copie um componente com parâmetros

A cópia de um componente copia os respetivos valores de parâmetros conforme definidos no painel de propriedades. Pode substituir os parâmetros da cópia editando o componente.

Corrija parâmetros inválidos

Se a configuração dos parâmetros for alterada no conetor, os gráficos que usam esses parâmetros podem deixar de funcionar. Por exemplo, o programador do conetor pode remover a capacidade de substituir um valor de parâmetro e o valor que forneceu no relatório deixa de devolver dados válidos. Neste caso, é apresentada uma mensagem de erro em todos os gráficos afetados por essa alteração.

Para corrigir este problema, localize o componente que contém o parâmetro agora inválido. Em seguida, na secção Parâmetros das propriedades de DADOS desse componente, clique em Corrigir valores inválidos.

Lembre-se de que os parâmetros podem ser definidos ao nível do relatório, da página e do grupo, bem como em gráficos individuais, pelo que pode ter de procurar em várias localizações para encontrar e corrigir o erro.

Recurso relacionado

Acerca dos controlos