Ejecución de Power App (versión preliminar)

La acción Run Power App inicia una aplicación directamente desde un flujo de escritorio y establece un canal de comunicación entre ambos. Con esta integración, los flujos de escritorio pueden llamar de forma nativa a experiencias de Power App, pasar entradas y recibir salidas. Este enfoque permite una integración nativa enriquecida para escenarios de automatización asistidos en lugar de confiar en la automatización basada en la interfaz de usuario.

Con esta capacidad, puede:

• Invocación de una aplicación directamente desde un flujo de escritorio
• Llame a una aplicación directamente desde un flujo de escritorio.
• Pase las entradas del flujo de escritorio a la aplicación.
• Captura las salidas de la aplicación de nuevo en el flujo.
• Active subflujos a partir de eventos de la aplicación.

Esto habilita escenarios, como:

• Formularios guiados dinámicos en varios pasos para la automatización asistida
• Experiencias modernas basadas en aplicaciones que reemplazan los formularios personalizados heredados
• Automatización controlada por eventos, donde las acciones del usuario dictan la ejecución del flujo
• Aplicaciones en la nube modernas que puenten la automatización de escritorio heredada

Requisitos y disponibilidad

• Minimum Power Automate para la versión de escritorio: 2.68 o posterior.
• Disponibilidad en la nube: Solo está disponible en nubes públicas.

Prerequisites

Antes de empezar, asegúrese de que dispone de lo siguiente:

• Power Automate para escritorio (PAD) instalado, versión 2.68 o una versión posterior
• Acceso a Power Apps en el mismo entorno
• Subflujos de escritorio que se pueden invocar desde la aplicación
• Microsoft Edge WebView2 Runtime instalado (necesario para mostrar la aplicación Power App en tiempo de ejecución)

Paso 1: Crear subflujos invocables en el flujo de escritorio

1. Abra el flujo de escritorio en el diseñador PAD.
2. Cree uno o varios subflujos locales .
3. (Opcional) Para cada subflujo, defina:
   • Variables de entrada: valores que la aplicación pasa al subflujo
   • Variables de salida: valores que devuelve el subflujo a la aplicación

Paso 2: Establecer la conexión de creación con Power Apps Studio

Para exponer los subflujos en Power Apps Studio (para que aparezcan como funciones a las que puede llamar), abra la aplicación a través del puente de creación de PAD.

1. Agregue la acción Ejecutar Power App (versión preliminar) al flujo de escritorio.
2. En las propiedades de la acción, una de las siguientes opciones:
   • Selección de una aplicación existente o
   • Creación de una nueva aplicación

1. Seleccione Abrir aplicación.

   El explorador predeterminado abre una página Power Automate para escritorio que le guía a través de la conexión a Power Apps Studio.

2. En la página del explorador, seleccione Abrir diseñador.

   Se abre una nueva pestaña del explorador con Power Apps Studio, con la aplicación seleccionada ya abierta.

3. Mantén abierta la página del explorador de Power Automate para escritorio hasta que muestre que está conectado.

   Si cierra la página antes de que la aplicación termine de cargarse, evitará establecer una conexión entre el flujo de escritorio y la aplicación Power.

Paso 3: Llamar a subflujos de escritorio desde Power App

Después de establecer la conexión del diseñador, Power Apps Studio muestra un objeto host denominado PowerAutomateDesktop. Este objeto expone los subflujos de escritorio como funciones invocables.

Patrón de invocación (general)

Para llamar a un subflujo de escritorio desde Power Apps:

• Use el PowerAutomateDesktop objeto .
• Llame al subflujo por su nombre.
• Pase entradas como parámetros de función.
• Acceda a los valores de salida del resultado devuelto.

Sintaxis general:

PowerAutomateDesktop.SubflowName(input1, input2, ...).OutputVariableName;

Example

En este ejemplo:

• El subflujo se denomina GetCustomerData.
• Acepta un único parámetro de entrada. Por ejemplo: varCustomerId.
• Devuelve un valor a través de una variable de salida denominada out_customer_data, que se almacena en la variable varResultglobal .

Para llamar al subflujo, pase el valor de varCustomerId y almacene la salida devuelta en la variable global varResult:

Set(customer_data_result, PowerAutomateDesktop.GetCustomerData(varCustomerId));

Paso 4: Devolver valores a Power Apps

• Power Automate para escritorio devuelve todos los valores como cadenas. En Power Apps, convierta estos valores en el tipo adecuado.
• Al llamar a un subflujo de un flujo de escritorio, este devuelve todas las variables de salida como un único valor de tipo registro.
• Puede acceder a variables de salida individuales como propiedades de ese registro.

Ejemplo: Obtener y usar variables de salida en Power Apps

Set(globalVariable, PowerAutomateDesktop.GetCustomerData(inputVariable))

En este ejemplo se almacenan todas las variables de salida del subflujo en globalVariable.

Para acceder a una variable de salida específica. Por ejemplo, out_var1:

globalVariable.out_var1

Devolver valores complejos

Si necesita devolver valores complejos (objetos personalizados o listas), devuelvalos como variables de salida y anótelos en Power Apps.

1. En el subflujo de escritorio, cree un objeto personalizado.
2. Devuelve el objeto personalizado como una variable de salida.
3. En Power Apps, use ParseJSON para analizar el valor devuelto y acceder a sus propiedades.

Set(parsedValue, ParseJSON(globalVariable.out_customer_data))

Compatibilidad con IntelliSense

Al llamar a subflujos de escritorio en Power Apps, Power Apps Studio proporciona IntelliSense para ayudarle a detectar y usar las funcionalidades disponibles.

Al escribir en la barra de fórmulas:

• El PowerAutomateDesktop objeto muestra los nombres de subflujo disponibles.
• Los parámetros de entrada para el subflujo seleccionado se muestran en el orden correcto.
• Los nombres de las variables de salida se sugieren después de la llamada de función.

Este soporte le ayuda a:

• Busque rápidamente subflujos disponibles.
• Comprenda las entradas necesarias sin volver a hacer referencia al flujo de escritorio.
• Seleccione variables de salida válidas sin memorizar sus nombres.

Dónde puede llamar a un subflujo

Invocar subflujos desde propiedades que admiten acciones, como:

• Un botón es OnSelect.
• Propiedad de evento de un control (por ejemplo, OnChange) cuando sea adecuado para el diseño de la aplicación.

Comportamiento en tiempo de ejecución

Cuando el flujo de escritorio se ejecuta y la ejecución llega a Ejecutar Power App:

1. Se inicia la aplicación.
2. La aplicación establece automáticamente un canal de comunicación.

La acción Run Power App finaliza cuando el usuario cierra la ventana Power Apps o detiene el flujo manualmente.

Limitaciones y consideraciones

• Ejecución secuencial: El proceso gestiona las llamadas a subflujos una a una. No desencadene una nueva llamada antes de que finalice la llamada anterior.
• Propagación de la publicación: Después de publicar cambios en una aplicación, es posible que las actualizaciones tarden un tiempo en aparecer al iniciar la aplicación de nuevo desde Power Automate para escritorio.
• Avisos de inicio de sesión: En algunos escenarios, es posible que se pida a los usuarios que inicien sesión cuando se inicie la aplicación.

Solución de problemas

No puede ver el objeto PowerAutomateDesktop en el diseñador de Power Apps

• Asegúrese de usar Abrir aplicación en la acción PAD. A continuación, seleccione Abrir diseñador en el explorador y espere hasta que el diseñador cargue la aplicación.
• Mantenga abierta la página del explorador PAD hasta que indique que se establece la conexión.

No puedo ver mi subflujo nuevo o actualizado en Power Apps Studio

• Vuelva a abrir la aplicación a través de Run Power Apps > Open app > Open Designer para que el esquema se actualice.

Los cambios en la Power App no se reflejan cuando se ejecuta desde Power Automate de escritorio

• Asegúrese de publicar sus cambios más recientes en Power Apps.
• Después de la publicación, espere un breve período de tiempo antes de volver a ejecutar la aplicación, ya que las actualizaciones pueden tardar algún tiempo en propagarse y estar disponibles cuando se inician desde Power Automate para el escritorio. Si no desea esperar, puede volver a iniciar la aplicación mediante la acción Ejecutar power App para cargar inmediatamente la versión más reciente.

La aplicación no aparece durante el tiempo de ejecución

Power Apps se representa usando Microsoft Edge WebView2 Runtime.

• Asegúrese de que WebView2 Runtime está instalado en la máquina. Para comprobarlo, haga lo siguiente:

  • Comprobar la lista de aplicaciones instaladas en Windows Configuración (Aplicaciones > Aplicaciones instaladas) o
  • Ejecución del Power Automate para el solucionador de problemas de escritorio

• Si no está instalado, descargue e instálelo desde Microsoft Edge WebView2.

  En la página de descarga, seleccione Evergreen Bootstrapper y ejecute el instalador.