Crear y usar funciones en Microsoft Dataverse (versión preliminar)

[Este tema es documentación preliminar y está sujeto a modificaciones.]

Crear y usar funciones reutilizables en Microsoft Dataverse. Las funciones utilizan Power Fx para ejecutar un conjunto específico de comandos dentro de Dataverse que se ejecutan en el servidor.

Requisitos previos

Debe tener el rol de seguridad Personalizador del sistema en el entorno de Power Platform.

Crear una función en una solución

1. Vaya a Power Apps y seleccione Soluciones en el panel de navegación izquierdo. Si el elemento no se encuentra en el panel lateral, seleccione …Más y, a continuación, el elemento que desee.
2. Abra la solución en la que desea crear una función.
3. En la barra de comandos, seleccione Nueva>Automatización>Función.
4. Introduzca la siguiente información en el panel lateral Nueva función que aparece.
   • Proporcione un Nombre para mostrar y una Descripción para la función.
   • Seleccione Nuevo parámetro de entrada o Nuevo parámetro de salida y, a continuación, proporcione un nombre y un tipo de datos para el parámetro. Agregue más parámetros de entrada y salida según sea necesario.
   • En la lista de Referencias de tabla, opcionalmente puede seleccionar tablas. Puede hacer referencia a las tablas de Dataverse que elija utilizando funciones de recopilación de datos, como Filter() y LookUp().
   • Introduzca la expresión de Power Fx en el cuadro Fórmula.
5. Seleccione Guardar.
6. Probar la función.

Referencie los parámetros de entrada en la fórmula por sus nombres.

Se debe hacer referencia a los parámetros de salida dentro de llaves, como { Out: "Return value" }.

Funciones de ejemplo

En esta sección se proporcionan algunas funciones de ejemplo.

Calcular la suma de dos enteros

1. Introduzca un Nombre para mostrar, como new_calculateSum, y una Descripción.

2. Agregue dos parámetros de entrada, x e y (ambos de tipo de datos entero), y un parámetro de salida, z (tipo de datos entero).

3. En la cuadro Fórmulas, introduzca la fórmula:
   { z:x+y }

   

4. Probar la función.

Agregar un título nuevo a una tabla de artículos

1. Cree dos parámetros de entrada, título y dirección URL (ambos con tipos de datos de cadena) y una variable de salida, mensaje (tipo de datos, cadena).
2. Seleccione la tabla Artículos federados de conocimiento en el menú desplegable Referencias de tabla.
3. En la cuadro Fórmulas, introduzca la fórmula:

Collect('Knowledge Federated Articles',  
   { 
    Title: title, 
    URL: url 
    } 
    ); 
{ 
    message: "New Article title added: " & title 
}

Valide si una cadena de entrada contiene las cadenas de su elección.

1. Cree un parámetro de entrada DocumentTextInput (con el tipo de datos cadena) y una variable de salida, denominada resultados (tipo de datos, cadena).
2. En la cuadro Fórmulas, introduzca la fórmula:

{
    result: If("Confidentiality" in DocumentTextInput && "Dispute Resolution" in DocumentTextInput && "Governing Law" in DocumentTextInput && "Termination" in DocumentTextInput, 

    "Document is compliant.", 
    "Document is missing one or more compliance clauses." 
    ) 
}

Calcular el precio de una estancia en un hotel

1. Cree seis parámetros de entrada: noches, habitaciones, impuestos, descuento, servicio de habitaciones, tarifapor noche (todos con tipo de datos de cadena) y una variable de salida, precio (tipo de datos float).
2. En la cuadro Fórmulas, introduzca la fórmula:

{ 
   price: ((nights*rooms*ratepernight)*(1+(tax/100))*(1-(discount/100)))+roomservice 

}

Más ejemplos de funciones

Para ver más funciones de ejemplo, vaya a Funciones de ejemplo (versión preliminar).

Editar, probar o eliminar una función

Editar una función

1. Seleccione la función en el área Funciones.
2. Seleccione Editar en la barra de comandos.
3. Modifique la fórmula y guárdela.

Probar una función

1. Seleccione la función en el área Funciones.
2. Seleccione Probar en la barra de comandos.
3. Proporcione valores para los parámetros de entrada definidos en la función y, a continuación, seleccione Reproducir.

Una prueba correcta devuelve una respuesta de OData que incluye información como el URI de la organización, el nombre de la función y los parámetros y valores de salida.

Eliminar una función

1. Seleccione Funciones en el panel de navegación izquierdo y, a continuación, seleccione su función. Si el elemento no se encuentra en el panel lateral, seleccione …Más y, a continuación, el elemento que desee.
2. Seleccione Eliminar en la barra de comandos.

Artículos relacionados

Funciones en Microsoft Dataverse (versión preliminar)