Usando parâmetros

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

Os parâmetros oferecem flexibilidade para alterar dinamicamente a saída de suas consultas, dependendo do valor, e podem ser usados para:

• Alterando os valores de argumento para transformações específicas e funções de fonte de dados.
• Entradas em funções personalizadas.

Você pode gerenciar facilmente seus parâmetros dentro da janela Gerenciar Parâmetros . Para acessar a janela Gerenciar Parâmetros , selecione a opção Gerenciar Parâmetros dentro de Gerenciar Parâmetros na guia Página Inicial .

Criando um parâmetro

O Power Query fornece duas maneiras fáceis de criar parâmetros:

• Em uma consulta existente: clique com o botão direito do mouse em uma consulta cujo valor é uma constante simples não estruturada, como uma data, texto ou número, e selecione Converter em Parâmetro.

  

  Você também pode converter um parâmetro em uma consulta clicando com o botão direito do mouse no parâmetro e selecionando Converter em Consulta.

  

• Usando a janela Gerenciar Parâmetros: selecione a opção Novo Parâmetro no menu suspenso Gerenciar Parâmetros na guia Página Inicial . Ou inicie a janela Gerenciar Parâmetros e selecione Novo na parte superior para criar um parâmetro. Preencha esse formulário e selecione OK para criar um novo parâmetro.

  

Depois de criar o parâmetro, você sempre poderá voltar à janela Gerenciar Parâmetros para modificar qualquer um dos 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. Além do nome do parâmetro e do valor que ele armazena, ele também tem outras propriedades que fornecem metadados para ele. As propriedades de um parâmetro são:

• Nome: forneça um nome para esse parâmetro que permite reconhecê-lo e diferenciá-lo facilmente de outros parâmetros que você pode criar.

• Descrição: a descrição é exibida ao lado do nome do parâmetro quando as informações do parâmetro são exibidas, ajudando os usuários que estão especificando o valor do parâmetro a entender sua finalidade e sua semântica.

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

• Tipo: especifica o tipo de dados do parâmetro. Recomendamos que você sempre configure o tipo de dados do parâmetro. Para saber mais sobre a importância dos tipos de dados, acesse os tipos de dados.

• Valores Sugeridos: fornece ao usuário sugestões para selecionar um valor para o Valor Atual nas opções disponíveis:

  • Qualquer valor: o valor atual pode ser qualquer valor inserido manualmente.

  • Lista de valores: fornece uma experiência simples de tabela para que você possa definir uma lista de valores sugeridos que você pode selecionar posteriormente para o Valor Atual. Quando essa opção é selecionada, uma nova opção chamada Valor Padrão é disponibilizada. A partir daqui, você pode selecionar o que deve ser o valor padrão para esse parâmetro, que é o valor padrão mostrado ao usuário ao referenciar o parâmetro. Esse valor não é o mesmo que o Valor Atual, que é o valor armazenado dentro do parâmetro e pode ser passado como um argumento em transformações. Usar a Lista de valores fornece um menu suspenso exibido nos campos Valor Padrão e Valor Atual , em que você pode escolher um dos valores da lista de valores sugerida.

    

    Observação

    Você ainda pode digitar manualmente qualquer valor que deseja passar para o parâmetro. A lista de valores sugeridos serve apenas como sugestões simples.

  • Consulta: usa uma consulta de lista (uma consulta cuja saída é uma lista) para fornecer a lista de valores sugeridos que você 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 várias maneiras diferentes, mas mais comumente usado em dois cenários:

• Argumento de etapa: você pode usar um parâmetro como argumento de várias transformações controladas pela UI.
• Argumento de função personalizado: você pode criar uma nova função a partir de uma consulta e parâmetros de referência como os argumentos de sua função personalizada.

As próximas seções contêm exemplos para esses dois cenários.

Argumento de etapa

Para habilitar esse recurso, primeiro acesse a guia Exibir no editor do Power Query e selecione a opção Sempre permitir no grupo Parâmetros .

Por exemplo, a tabela Pedidos a seguir contém os campos OrderID, Total de Unidades 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á para a consulta Pedidos e, no campo Margem, selecione a opção de filtro Maior que.

Na janela Filtrar Linhas , há um botão com um tipo de dados para o campo selecionado. Selecione a opção Parâmetro no menu suspenso associado a este botão. Na seleção de campo ao lado do botão de tipo de dados, selecione o parâmetro que você deseja passar para esse argumento. Nesse caso, é o parâmetro Margem Mínima .

Depois de selecionar OK, sua tabela será filtrada usando o Valor Atual para seu parâmetro.

Se você modificar o Valor Atual do parâmetro margem mínima para 0,3, a consulta de pedidos será atualizada imediatamente e mostrará apenas as linhas em que a Margem está acima de 30%.

Dica

Muitas transformações no Power Query permitem que você selecione seu parâmetro em uma lista suspensa. Recomendamos que você sempre procure e aproveite o que os parâmetros podem oferecer a você.

Argumento de função personalizada

Com o Power Query, você pode criar uma função personalizada a partir de uma consulta existente com uma seleção simples. Seguindo o exemplo anterior, clique com o botão direito do mouse na consulta Pedidos e selecione Criar Função. Essa ação inicia uma nova janela Criar Função . Nesta janela, nomeie sua nova função e ela informa os parâmetros que estão sendo referenciados em sua consulta. Esses parâmetros são usados como parâmetros para a função personalizada.

Você pode nomear essa nova função como desejar. Para fins de demonstração, o nome dessa nova função é MyFunction. Depois de selecionar OK, um novo grupo será criado no painel Consultas usando o nome da nova função. Nesse grupo, você encontra os parâmetros que estão sendo usados para a função, a consulta que foi usada para criar a função e a função em si.

Para testar essa nova função, insira um valor, como 0,4, no campo abaixo do rótulo margem mínima . Em seguida, selecione o botão Invocar . Essa ação cria uma nova consulta com o nome Função Invocada, passando efetivamente o valor 0.4 para ser usado como argumento para a função e dando a você apenas as linhas em que a margem está acima de 40%.

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

Parâmetros de múltiplos valores ou de lista

Um novo tipo de parâmetro disponível somente no Power Query Online é de vários valores ou parâmetros de lista. Esta seção descreve como criar um novo parâmetro de lista e como usá-lo em suas consultas.

Seguindo o exemplo anterior, altere o valor atual da Margem Mínima de 0,3 para 0,1. A nova meta é criar um parâmetro de lista que possa conter os números de ordem dos pedidos que você está interessado em analisar. Para criar o novo parâmetro, vá para a caixa de diálogo Gerenciar Parâmetros e selecione Novo para criar um novo parâmetro. Preencha este novo parâmetro com as seguintes informações:

• Nome: Pedidos interessantes
• Descrição: Um conjunto de números de pedidos interessantes para uma análise específica
• Necessário: Verdadeiro
• Tipo: Lista

Depois de definir esses campos, uma nova grade é exibida onde você pode inserir os valores que deseja armazenar para o parâmetro. Nesse caso, esses valores são 125, 777 e 999.

Observação

Embora este exemplo use números, você também pode armazenar outros tipos de dados em sua lista, como texto, datas, datetime e muito mais. Mais informações: Tipos de dados no Power Query

Dica

Se você quiser ter mais controle sobre quais valores são usados no parâmetro de lista, sempre poderá criar uma lista com valores constantes. Em seguida, converta a consulta de lista em um parâmetro, conforme mostrado anteriormente neste artigo.

Com os novos parâmetros da lista Pedidos Interessantes em vigor, volte para a Consulta Pedidos. Selecione o menu de filtro automático do campo OrderID. Selecione Filtros de Número.>No

Dica

Para alguns dos outros tipos de dados, o filtro In pode não aparecer no menu de filtro principal. Selecione qualquer outra opção de filtro e edite o filtro nas configurações de consulta. Em seguida, na lista suspensa de filtro no editor, selecione In.

Depois de selecionar essa opção, uma nova caixa de diálogo Filtrar linhas será exibida. A partir daqui, você pode selecionar o parâmetro de lista em um menu suspenso.

Observação

Os parâmetros de lista podem funcionar com as opções Em ou Não em. In permite filtrar apenas pelos valores de sua lista. Não faz exatamente o oposto e tenta filtrar sua coluna para obter todos os valores que não são iguais aos valores armazenados em seu parâmetro.

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