Crear e invocar una función personalizada

Una función personalizada usa el idioma de la fórmula M, toma un conjunto de valores de entrada y, a continuación, devuelve un único valor de salida. Si tiene lógica que desea volver a usar muchas veces o aplicar el mismo conjunto de transformaciones a una consulta o valor diferente, considere la posibilidad de crear una función personalizada y, a continuación, invocar la función donde y cuando la necesite. Hay varias formas de crear una función personalizada:

Use el Editor avanzado para agregar su propia instrucción let y empezar desde cero.
Use el comando Invocar función personalizada.
Hay otras formas de crear funciones que no se debate en este tema de ayuda, como los comandos Crear función y Agregar como consulta. Para obtener una discusión detallada, vea Descripción de las funciones M de Power Query (docs.com)y Uso de funciones personalizadas (docs.com).

A continuación se muestra un ejemplo sencillo de una función personalizada que sigue una larga tradición de programación.

Para crear una consulta en blanco: Excel Seleccionar datos> Obtener datos > de otros orígenes

> consulta en blanco.

Power Query Haga clic con el botón derecho en un punto en blanco en el panel Consultas de la izquierda y, a continuación, seleccione Nueva consulta > Otros orígenes > consulta en blanco.
En el panel Consultas de la izquierda, haga doble clic en el nombre y, después, cambie el nombre de la nueva consulta en blanco a "HelloWorld".
Seleccione la nueva consulta y, a continuación, seleccione Inicio> Editor avanzado.
Reemplace el código inicial de la plantilla con el siguiente código:

let
HelloWorld = () => ("Hello World")
in
HelloWorld
Selecciona Listo.
Ha cambiado la consulta , "HelloWorld", a una función personalizada. Observe el icono de función a la izquierda de ella.
Para invocar la función, selecciónelo y, a continuación, seleccione Invocar en vista previa de datos.
Los resultados de la función se muestran en vista previa de datos y se agregan al panel Consultas como una consulta con el nombre predeterminado, Función invocada. Es posible que desee cambiarle el nombre a algo más significativo, como "HelloWorldResult".
Seleccione esa consulta y, a continuación, seleccione Inicio > Cerrar & cargar para ver los resultados en una hoja de cálculo.

Resultados

Resultados de HelloWorld en una hoja de cálculo

En el ejemplo siguiente se muestra cómo pasar un parámetro a una función personalizada para convertir un número decimal en hexadecimal.

Para crear una consulta en blanco: Excel Seleccionar datos> Obtener datos > de otros orígenes

> consulta en blanco.

Power Query Haga clic con el botón derecho en un punto en blanco en el panel Consultas de la izquierda y, a continuación, seleccione Nueva consulta > Otros orígenes > consulta en blanco.
En el panel Consultas de la izquierda, cambie el nombre de la nueva consulta en blanco a "MyHex".
Seleccione la nueva consulta y, a continuación, seleccione Inicio> Editor avanzado.
Reemplace el código inicial de la plantilla con el siguiente código:

let
MyHex = (parameter1) => Number.ToText(parameter1,"X")
in
MyHex
Selecciona Listo.
Ha cambiado la consulta , "MyHex", a una función personalizada. Observe el icono de función a la izquierda de ella.
Para invocar la función, selecciónelo y, a continuación, en Vista previa de datos, escriba un número en el cuadro parámetro1 y seleccione Invocar.
Los resultados de la función se muestran en vista previa de datos y se agregan al panel Consultas como una consulta con el nombre predeterminado Función invocada. Es posible que desee cambiarle el nombre a algo más significativo, como "MyHexResult".
Seleccione esa consulta y, a continuación, seleccione Inicio > Cerrar & cargar para ver los resultados en una hoja de cálculo.

Resultados

Resultado de la función MyHex en una hoja de cálculo

Si ha creado una función con al menos un parámetro, puede invocarla como una función personalizada para crear una nueva columna y un nuevo valor para cada fila de una tabla.

Para abrir una consulta, busque una cargada previamente desde el Editor de Power Query, seleccione una celda de los datos y, a continuación, seleccione Consulta > Editar. Para obtener más información, vea Crear, editar y cargaruna consulta en Excel (Power Query).

Nota Para este ejemplo, la consulta necesita al menos una columna de un tipo de datos Número entero.
Cree la función personalizada "MyHex", como se explica en la sección, Cree e invoque una función personalizada que tenga un parámetro con el Editor avanzado.
En la consulta, seleccione Agregar columna > Invocar función personalizada. Aparecerá el cuadro de diálogo Invocar función personalizada.
Escriba el nuevo nombre de columna, como "HexConvert", en el cuadro Nuevo nombre de columna.
Seleccione el nombre de una función personalizada predefinida en el menú desplegable Consulta de funciones. En este ejemplo, seleccione "MyHex".
Como la función personalizada hace referencia a un parámetro, ahora se muestra el parámetro.
Seleccione una columna de un tipo de datos Número entero como parámetro para la función.
Selecciona Aceptar.