Parâmetros

Os parâmetros permitem-lhe interagir com 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 de volta 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 com base na introdução do utilizador.
  • Pode transmitir parâmetros de volta à consulta SQL personalizada numa origem de dados do BigQuery.
  • Pode transmitir parâmetros de volta a um conector da comunidade.

Os parâmetros podem obter os respetivos dados dos seguintes locais:

  • A partir de um valor predefinido definido para o parâmetro
  • No 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

Os editores dos seus relatórios e origens de dados podem aceder a quaisquer dados controlados por parâmetros. Os parâmetros permitem que os editores de relatórios solicitem 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 a meteorologia num novo local. 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 de conta ou o nome de uma tabela de base de dados devolve potencialmente 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 nos seguintes locais:

Numa origem de dados

  1. Edite a origem de dados.
  2. No canto superior direito, clique em ADICIONAR UM PARÂMETRO. Também pode criar um parâmetro enquanto edita um relatório selecionando um componente e, de 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 (veja abaixo).

Ao editar 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.

No conetor do BigQuery

Pode transmitir parâmetros a uma consulta SQL personalizada no conetor do BigQuery. O conector do BigQuery define vários parâmetros padrão que transmitem a data de início e 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 mais.

Parâmetros e conetores de comunidade

Um conetor da comunidade pode incluir parâmetros substituíveis, que permitem aos editores de relatórios modificar os respetivos valores predefinidos numa origem de dados. Se puder editar a associação de uma origem de dados criada com um conetor de comunidade, pode especificar que parâmetros os editores 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 <nome do parâmetro> seja modificado nos relatórios para permitir ou não permitir a edição do parâmetro nos relatórios.
  5. Na parte superior direita, clique em REASSOCIAR.

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. Efetue as alterações e, em seguida, clique em GUARDAR na parte inferior direita.

Configure um parâmetro

Use estas opções para configurar um parâmetro na origem de dados. Para parâmetros do conetor do BigQuery e do conetor da comunidade, consulte os artigos referidos acima.

Nome do parâmetro : verá este nome nas listas de campos nos seus relatórios e origens de dados. Este é também o nome que vai usar 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 Looker Studio para identificar o parâmetro. Os visitantes do relatório não o veem.

Tipo de dados : os parâmetros podem armazenar texto, números ou valores 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 valores de parâmetros

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

Predefina um valor para o parâmetro

Pode predefinir valores para um parâmetro quando o cria. Para ajustar o valor predefinido, siga os passos acima para editar o parâmetro.

Use um controlo para receber contributos dos utilizadores

Os controlos são componentes que permitem às pessoas interagir com um relatório. Para armazenar a entrada do utilizador num parâmetro, adicione esse parâmetro à propriedade Campo de controlo de um controlo:

  1. Edite o relatório.
  2. Na parte superior, clique em Ícone de controlo. 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 acerca dos controlos.

Substitua os valores dos parâmetros predefinidos num componente

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

  1. Edite o 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 dos parâmetros predefinidos.

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

  1. Edite o 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 de filtro. Especificamente, os parâmetros em componentes de precedência mais elevada substituem os parâmetros em componentes de precedência mais baixa. A ordem de precedência (da mais baixa para a mais alta) é:

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

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 Looker Studio e os respetivos valores são transmitidos como strings JSON codificadas por 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, não é possível editar os parâmetros nos seus relatórios através do URL do relatório.

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

  1. Edite o 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 para cada parâmetro. Este é o nome que vai usar, e não o nome do parâmetro, quando construir 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 parâmetros em campos calculados e componentes de relatórios, tal como faria com dimensões e métricas.

Use um parâmetro num campo calculado

Pode usar um parâmetro da mesma forma que usa uma dimensão ou uma métrica num campo calculado.

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

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

Primeiro, crie o parâmetro para conter o multiplicador da previsão:

  1. Inicie sessão no Looker Studio.
  2. Edite a 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 voltar à 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 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 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 entrada do utilizador:

  1. Editar ou criar um relatório.
  2. Se necessário, adicione a origem de dados ao relatório.
  3. Na parte superior, clique em Ícone de controlo. /> Adicionar um controlo .
  4. Selecione o controlo Caixa de entrada.

    O controlo da caixa de entrada permite-lhe introduzir diretamente os valores dos parâmetros. Outros tipos de controlos permitem-lhe selecionar a partir de uma lista, usar um cursor ou alternar valores booleanos com uma caixa de verificação.
  5. À direita, em Propriedades de DADOS, adicione o parâmetro Forecast multiplier que criou anteriormente.

Por fim, visualize o campo calculado parametrizado num gráfico.

  1. Na parte superior, clique em Adicione um ícone de gráfico. 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 métrica.

Agora, experimente:

  1. Na parte superior direita, clique em Ver.
  2. Introduza um número no controlo Multiplicador de previsão e, de seguida, prima Enter.
  3. O valor na tabela de dados muda à 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 faria com uma dimensão ou uma métrica. Se usar um parâmetro numérico como 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 origem de dados.
  2. Localize o parâmetro.
  3. À direita do parâmetro, clique em Mais opções. Opções.
  4. Clique em Mostrar (se o parâmetro estiver atualmente oculto) ou Ocultar (se o parâmetro estiver atualmente apresentado).

Ocultar um parâmetro remove-o da lista de campos no painel Dados e vai fazer com que os componentes que o utilizam 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 dos 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 conector, os gráficos que usam esses parâmetros podem deixar de funcionar. Por exemplo, o programador do conector 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. Por isso, pode ter de procurar em vários locais para encontrar e corrigir o erro.

Acerca dos controlos