Utilização de parâmetros

Um parâmetro serve como uma forma de armazenar e gerir facilmente um valor que pode ser reutilizado.

Os parâmetros dão-lhe a flexibilidade de alterar dinamicamente a saída das suas consultas consoante o seu valor, e podem ser usados para:

• Alterar os valores dos argumentos para transformações particulares e funções de fonte de dados.
• Entradas em funções personalizadas.

Pode gerir facilmente os seus parâmetros dentro da janela de Gerir Parâmetros . Para aceder à janela Gerenciar Parâmetros , selecione a opção Gerir Parâmetros dentro de Gerir Parâmetros no separador Home .

Criação de um parâmetro

O Power Query oferece duas formas simples de criar parâmetros:

• A partir de uma consulta existente: Clique com o botão direito numa consulta cujo valor seja uma constante simples e não estruturada, como uma data, texto ou número, e depois selecione Converter para Parâmetro.

  

  Também pode converter um parâmetro numa consulta clicando com o botão direito no parâmetro e depois selecionando Converter em Consulta.

  

• Usando a janela Gerir Parâmetros: Selecione a opção Novo Parâmetro no menu suspenso Gerir Parâmetros no separador Inicial. Ou então abra a janela Gerir Parâmetros e, em seguida, selecione Novo no topo para criar um parâmetro. Preencha este formulário e depois selecione OK para criar um novo parâmetro.

  

Depois de criares o parâmetro, podes sempre voltar à janela de Gerir Parâmetros para modificar qualquer um dos teus parâmetros a qualquer momento.

Propriedades do parâmetro

Um parâmetro armazena um valor que pode ser usado para transformações no Power Query. Para além do nome do parâmetro e do valor que armazena, também possui outras propriedades que lhe fornecem metadados. As propriedades de um parâmetro são:

• Nome: Dê um nome a este parâmetro que lhe permita reconhecê-lo e diferenciá-lo facilmente de outros parâmetros que possa criar.

• Descrição: A descrição é exibida ao lado do nome do parâmetro quando a informação do parâmetro é apresentada, ajudando os utilizadores que estão a especificar o valor do parâmetro a compreender o seu propósito e a sua semântica.

• Obrigatório: A caixa de seleção indica se os utilizadores subsequentes podem especificar se deve ser fornecido um valor para o parâmetro.

• Tipo: Especifica o tipo de dado do parâmetro. Recomendamos que configure sempre o tipo de dados do seu parâmetro. Para saber mais sobre a importância dos tipos de dados, consulte Tipos de dados.

• Valores Sugeridos: Fornece ao utilizador sugestões para selecionar um valor para o Valor Atual entre as opções disponíveis:

  • Qualquer valor: O valor atual pode ser qualquer valor introduzido manualmente.

  • Lista de valores: Proporciona-lhe uma experiência simples semelhante a uma tabela para que possa definir uma lista de valores sugeridos que depois poderá selecionar para o Valor Atual. Quando esta opção é selecionada, uma nova opção chamada Valor Padrão é disponibilizada. A partir daqui, pode selecionar qual deve ser o valor padrão para este parâmetro, que é o valor padrão mostrado ao utilizador ao referenciar o parâmetro. Este valor não é o mesmo que o Valor Atual, que é o valor armazenado dentro do parâmetro e pode ser passado como argumento em transformações. Usar a Lista de valores fornece um menu suspenso exibido nos campos de Valor Padrão e Valor Atual, onde pode escolher um dos valores da lista sugerida de valores.

    

    Observação

    Ainda podes escrever manualmente qualquer valor que queiras passar ao parâmetro. A lista de valores sugeridos serve apenas como sugestões simples.

  • Consulta: Utiliza uma consulta de lista (uma consulta cujo resultado é uma lista) para fornecer a lista de valores sugeridos que pode selecionar posteriormente para o Valor Atual.

    

• Valor Atual: O valor armazenado neste parâmetro.

Onde usar parâmetros

Um parâmetro pode ser usado de muitas formas diferentes, mas é mais comum em dois cenários:

• Argumento da etapa: Pode usar um parâmetro como argumento de múltiplas transformações controladas pela interface do utilizador (UI).
• Argumento de função personalizada: Pode criar uma nova função a partir de uma consulta e parâmetros de referência como argumentos da sua função personalizada.

As secções seguintes contêm exemplos para estes dois cenários.

Argumento de passo

Para ativar esta funcionalidade, vá primeiro ao separador Visualizar no editor Power Query e selecione a opção Sempre permitir no grupo de Parâmetros .

Por exemplo, a tabela de Ordens seguinte contém os campos OrderID,Unidades Totais e Margem .

Neste exemplo, crie um novo parâmetro com o nome Margem Mínima , com um tipo de Número Decimal e um Valor Atual de 0,2.

Vá à consulta de Ordens e, no campo Margem, selecione a opção de filtro Maior Que.

Na janela de Linhas de Filtro , há um botão com um tipo de dado para o campo selecionado. Selecione a opção Parâmetro no menu pendente do botão. No campo de seleção mesmo ao lado do botão do tipo de dados, selecione o parâmetro que quer passar para este argumento. Neste caso, é o parâmetro de Margem Mínima .

Depois de selecionares OK, a tua tabela é filtrada usando o Valor Atual do teu parâmetro.

Se modificar o Valor Atual do seu parâmetro de Margem Mínima para 0,3, a sua consulta de ordens é atualizada imediatamente e mostra-lhe apenas as linhas onde a Margem é superior a 30%.

Sugestão

Muitas transformações no Power Query permitem selecionar o seu parâmetro a partir de uma lista pendente. Recomendamos que procure sempre e aproveite o que os parâmetros lhe podem oferecer.

Argumento da função personalizada

Com o Power Query, pode criar uma função personalizada a partir de uma consulta existente com uma simples seleção. Seguindo o exemplo anterior, clique com o botão direito na consulta de Ordens e selecione Criar Função. Esta ação abre uma nova janela de Criar Função . Nesta janela, nomeie a sua nova função e ela indica-lhe os parâmetros referenciados na sua consulta. Estes parâmetros são usados como parâmetros para a função personalizada.

Podes dar o nome a esta nova função como quiseres. Para efeitos de demonstração, o nome desta nova função é MyFunction. Depois de selecionares OK, um novo grupo é criado no painel de Consultas usando o nome da tua nova função. Neste grupo, encontra-se os parâmetros usados para a função, a consulta que foi usada para criar a função e a própria função.

Para testar esta nova função, introduza um valor, como 0,4, no campo abaixo do rótulo de Margem Mínima . Depois seleciona o botão Invocar . Esta ação cria uma nova consulta com o nome Função Invocada, passando efetivamente o valor 0,4 para ser usado como argumento da função e dando-lhe apenas as linhas onde a margem é superior a 40%.

Para saber mais sobre como criar funções personalizadas, consulte Criar uma função personalizada.

Parâmetros de múltiplos valores ou de lista

Um novo tipo de parâmetro disponível apenas no Power Query Online são os parâmetros de múltiplos valores ou de lista. Esta secção descreve como criar um novo parâmetro de lista e como usá-lo nas suas consultas.

Seguindo o exemplo anterior, altere o valor atual da Margem Mínima de 0,3 para 0,1. O novo objetivo é criar um parâmetro de lista que possa conter os números de encomenda das encomendas que deseja analisar. Para criar o novo parâmetro, vá ao diálogo Gerir Parâmetros e selecione Novo para criar um novo parâmetro. Preencha este novo parâmetro com a seguinte informação:

• Nome: Ordens Interessantes
• Descrição: Um conjunto de números de ordem interessantes para uma análise específica
• Necessário: Verdade
• Tipo: Lista

Depois de definires estes campos, aparece uma nova grelha onde podes introduzir os valores que queres armazenar para o teu parâmetro. Neste caso, esses valores são 125, 777 e 999.

Observação

Embora este exemplo use números, também pode armazenar outros tipos de dados na sua lista, como texto, datas, data e hora, e mais. Para obter mais informações: Tipos de dados no Power Query

Sugestão

Se quiser ter mais controlo sobre os valores usados no seu parâmetro de lista, pode sempre criar uma lista com valores constantes. Depois, converta a sua consulta de lista num parâmetro, como mostrado anteriormente neste artigo.

Com os novos parâmetros da lista de Ordens Interessantes em vigor, volte na consulta de Ordens. Selecione o menu de autofiltro do campo OrderID . Selecionar Filtros de número>Em.

Sugestão

Para alguns dos outros tipos de dados, o filtro In pode não aparecer no menu principal do filtro. Selecione qualquer outra opção de filtro e depois edite o filtro em Definições de Consulta. Depois, no menu suspenso do filtro no editor, selecione In.

Depois de selecionar esta opção, aparece uma nova caixa de diálogo Filtrar linhas . A partir daqui, pode selecionar o parâmetro da lista num menu suspenso.

Observação

Os parâmetros da lista podem funcionar com as opções In ou Not in . Permite filtrar apenas pelos valores da sua lista. Not in faz exatamente o oposto e tenta filtrar a tua coluna para obter todos os valores que não são iguais aos valores armazenados no teu parâmetro.

Depois de selecionares OK, és levado de volta à tua consulta. Lá, a sua consulta é filtrada usando o parâmetro de lista que criou, com o resultado de que apenas as linhas onde o OrderID era igual a 125, 777 ou 999 foram mantidas.