1. Instalar uma função
- No Power Query, Nova Fonte › Consulta Nula.
- Abra o Editor Avançado, apague tudo e cole o Código completo da função.
- Renomeie a consulta com o nome da função (ex.:
fnValidaCPF). - Use numa coluna: Adicionar Coluna › Coluna Personalizada com
fnValidaCPF([CPF]), ou Invocar Função Personalizada.
Funções com Dependências precisam das consultas listadas no mesmo
arquivo (ex.: fnHolidaysInPeriodPT chama fnFeriados).
2. Padrão de documentação
Toda função termina em Value.ReplaceType, que grava a documentação no
tipo da função. Ela aparece quando você seleciona a consulta da função no
Power Query.
| Campo | Onde aparece | Status |
|---|---|---|
Documentation.Name | Topo da caixa de invocação da função | Documentado pela Microsoft |
Documentation.LongDescription | Informações da função | Documentado pela Microsoft |
Documentation.Examples | Informações da função (lista de registros Description, Code, Result) | Documentado pela Microsoft |
Documentation.Description, .Category, .Author, .Version, .Source | Ficam nos metadados, legíveis com Value.Metadata(Value.Type(fn)) | Convenção deste Code Library, não documentada para funções personalizadas |
Atenção Dentro de Documentation.Examples, Code e Result são texto M:
aspas duplas se escrevem dobradas ("fnValidaCPF(""123.456.789-09"")").
Aspas simples não delimitam texto em M.
3. Nomes de função
- Convenção:
fn+ PascalCase, sem acento (fnClassificacaoIMC,fnTelefoneAnonimo). - Acento no nome funciona sem
#"...": a especificação do M aceita letras Unicode em identificadores. O motivo para evitar é outro: digitar, buscar e automatizar (scripts, XMLA, CI) fica mais sujeito a erro de codificação. #"..."só é obrigatório com espaço, símbolo, nome que começa com número ou palavra-chave.