Applies ToExcel para Microsoft 365 Excel 2019 Excel 2016 Excel 2013 Excel 2010

Uma função personalizada utiliza a linguagem da fórmula M, utiliza um conjunto de valores de entrada e, em seguida, devolve um único valor de resultado. Se tiver lógica que pretende reutilizar várias vezes ou aplicar o mesmo conjunto de transformações a uma consulta ou valor diferente, considere criar uma função personalizada e, em seguida, invocar a função onde e quando precisar. Existem várias formas de criar uma função personalizada: 

  • Utilize o Editor Avançado para adicionar a sua própria declaração de let e começar do zero.

  • Utilize o comando Invocar Função Personalizada.

  • Existem formas adicionais de criar funções não abordadas neste tópico de ajuda, incluindo os comandos Criar Função e Adicionar como uma Consulta. Para um debate aprofundado, consulte compreender as funções do Power Query M (docs.com)e Utilizar funções personalizadas (docs.com).

Segue-se um simples exemplo de uma função personalizada que segue uma programação de programação por longa duração.

  1. Para criar uma consulta em branco: selecione Excel      Dados> Obter Dados > De Outras Origens > Consulta em Branco.Power Query      Clique com o botão direito do rato num ponto em branco no painel Consultas à esquerda e, em seguida, selecione Nova Consulta > Outras Origens > Consulta em Branco.

  2. No painel Consultas à esquerda, faça duplo clique no nome e, em seguida, renove a nova consulta em branco para "HelloWorld".

  3. Selecione a nova consulta e, em seguida, selecione Home> Advanced Editor.

  4. Substitua o código de iniciação de modelo pelo seguinte código:

    let      HelloWorld = () => ("Hello World") in      HelloWorld

  5. Selecione Concluído.

  6. Alterou a consulta, "HelloWorld", para uma função personalizada. Repare no ícone Ícone função à esquerda da mesma.

  7. Para invocar a função, selecione-a e, em seguida, selecione Invocar na Pré-visualização de Dados.Invocar a função personalizada HelloWorld

  8. Os resultados da função são apresentados na Pré-visualização de dados e adicionados ao painel Consultas como uma consulta com o nome predefinido, Função Invocada. Poderá querer dar outro nome à sua nome para algo mais significativo, como "OláMunometr".

  9. Selecione essa consulta e, em seguida, selecione> Fechar & Carregar para ver os resultados numa mesma.

Resultados 

Resultados do OláMundo numahe de trabalho

O exemplo seguinte mostra como passar um parâmetro para uma função personalizada para converter um número decimal em hexadecimal.

  1. Para criar uma consulta em branco: selecione Excel      Dados> Obter Dados > De Outras Origens > Consulta em Branco.Power Query      Clique com o botão direito do rato num ponto em branco no painel Consultas à esquerda e, em seguida, selecione Nova Consulta > Outras Origens > Consulta em Branco.

  2. No painel Consultas à esquerda, nome da nova consulta em branco para "AMinhas".

  3. Selecione a nova consulta e, em seguida, selecione Home> Advanced Editor.

  4. Substitua o código de iniciação de modelo pelo seguinte código:

    let      MyHex = (parameter1) => Number.ToText(parameter1,"X") in      MyHex

  5. Selecione Concluído.

  6. Alterou a consulta, "MyHex", para uma função personalizada. Repare no ícone Ícone função à esquerda da mesma.

  7. Para invocar a função, selecione-a e, em seguida, em Pré-visualização de Dados, introduza um número na caixa parâmetro1 e selecione Invocar.

    Invocar a função personalizada MyHex

  8. Os resultados da função são apresentados na Pré-visualização de dados e adicionados ao painel Consultas como uma consulta com o nome predefinido, Função Invocada. Poderá querer dar-lhe um nome mais significativo, como "MyHexResult".

  9. Selecione essa consulta e, em seguida, selecione> Fechar & Carregar para ver os resultados numa mesma.

Resultados 

Resultado da função AMíx numa mesma

Se criou uma função com pelo menos um parâmetro, pode invoque-a como uma função personalizada para criar uma nova coluna e um novo valor para cada linha numa tabela.

  1. Para abrir uma consulta, localize uma previamente carregada a partir do Editor do Power Query, selecione uma célula nos dados e, em seguida, selecione Consulta > Editar. Para obter mais informações, consulte Criar, editar e carregar uma consulta no Excel (Power Query).Nota    Para este exemplo, a consulta necessita de pelo menos uma coluna de um tipo de dados Número Inteiro.

  2. Crie a função personalizada "MyHex", conforme explicado na secção Criar e invocar uma função personalizada que tenha um parâmetro com o Editor Avançado.

  3. Na consulta, selecione Adicionar Coluna >Invocar Função Personalizada. É exibida a caixa de diálogo Invocar Função Personalizada.

  4. Introduza o nome da nova coluna, como "HexConvert", na caixa Nome da nova coluna.

  5. Selecione o nome de uma função personalizada predefinida a partir do dropdown da consulta de Função. Neste exemplo, selecione "AMíx".

  6. Uma vez que a função personalizada referencia um parâmetro, o parâmetro é agora apresentado.

  7. Selecione uma coluna de um tipo de dados Número Inteiro como um parâmetro para a função.A caixa de diálogo Invocar Função Personalizada

  8. Selecione OK.

Resultado

É criada uma nova coluna que mostra o valor Hexadecimal da coluna Número Inteiro que introduziu como parâmetro.

A nova coluna OsMíx dos valores numa livro

Consulte Também

Ajuda do Power Query Excel

Criar fórmulas do Power Query no Excel

Criar uma consulta parametrada

Gerir consultas

Compreender as funções do Power Query M (docs.com)

Utilizar funções personalizadas (docs.com)

Precisa de mais ajuda?

Quer mais opções?

Explore os benefícios da subscrição, navegue em cursos de formação, saiba como proteger o seu dispositivo e muito mais.

As comunidades ajudam-no a colocar e a responder perguntas, a dar feedback e a ouvir especialistas com conhecimentos abrangentes.