Adición de flujos de Power Automate a una aplicación de código

En este artículo se muestra cómo detectar, agregar, llamar, actualizar y quitar Power Automate flujos de nube en una aplicación de código de Power Apps mediante la CLI de Power Apps.

Importante

Las aplicaciones de código solo admiten flujos instantáneos compatibles con la solución que usan el desencadenador Power Apps. No se admiten flujos programados, flujos automatizados ni flujos instantáneos que usan otros desencadenadores.

Requisitos previos

  • Una aplicación de código Power Apps inicializada con pa app init
  • Flujo instantáneo de nube compatible con la solución que usa el desencadenador de Power Apps
  • @microsoft/power-apps versión 1.1.1 o posterior

Si el flujo no está en una solución, consulte Incorporación de un flujo de nube existente a una solución.

Paso 1: Enumerar los flujos disponibles

Use el pa app list-flows comando para enumerar los flujos compatibles con la solución en el entorno actual:

pa app list-flows

Este comando devuelve los flujos disponibles:

Name                    Status   Modified On   Flow ID
──────────────────────────────────────────────────────────────────────────────
Approval Workflow       Started  2026-01-15    a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1
Send Notification       Started  2026-02-01    b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2

Total flows: 2

Para filtrar los resultados por nombre, use el --search parámetro :

pa app list-flows --search approval

Copie el identificador de flujo para el flujo que desea agregar.

Nota:

El comando solo muestra los flujos compatibles con la solución. Si no aparece un flujo, agréguelo primero a una solución.

Paso 2: Agregar el flujo

Use el pa app add flow comando para agregar el flujo a la aplicación de código:

pa app add flow --flow-id <flow-id>

Por ejemplo:

pa app add flow --flow-id a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1

Al ejecutar el comando de nuevo con el mismo identificador de flujo, se actualizan los archivos generados con la definición de flujo más reciente.

Qué hace el comando

El comando:

  • Descarga la definición de OpenAPI del flujo.
  • Genera modelos y servicios de TypeScript fuertemente tipados.
  • Agrega el flujo y sus referencias de conexión a power.config.json.

Importante

La persona que se ejecuta pa app add flow debe tener acceso al flujo y a sus conexiones subyacentes. Se produce un error en el comando si la persona no tiene acceso a una conexión necesaria.

Archivos generados

La CLI crea archivos similares al ejemplo siguiente:

src/
  services/
    ApprovalWorkflowService.ts
  models/
    ApprovalWorkflowModel.ts
schemas/
  logicflows/
    ApprovalWorkflow.Schema.json

La CLI también agrega la configuración de flujo a power.config.json.

Paso 3: Llamada al flujo

La clase de servicio generada proporciona un método estático Run . La firma del método se basa en los parámetros de entrada de la definición de OpenAPI del flujo.

Flujo con parámetros de entrada

import { ApprovalWorkflowService } from './services/ApprovalWorkflowService';

const result = await ApprovalWorkflowService.Run({
  requester: 'Alex',
  amount: 1500,
});

if (result.success) {
  console.log('Flow triggered. Response:', result.data);
} else {
  console.error('Flow failed:', result.error);
}

Flujo sin parámetros de entrada

import { SendNotificationService } from './services/SendNotificationService';

const result = await SendNotificationService.Run();

if (result.success) {
  console.log('Flow triggered.');
}

El resultado contiene las siguientes propiedades:

Propiedad Tipo Descripción
success boolean Indica si el flujo se desencadenó correctamente.
data Varía Contiene la respuesta con tipo del flujo, si está disponible.
error Error Contiene información de error cuando success es false.

Abra el archivo de servicio generado para revisar los tipos exactos de entrada y salida del flujo.

Actualización de un flujo

Si cambia la definición del flujo, vuelva a ejecutarse pa app add flow con el mismo identificador de flujo:

pa app add flow --flow-id a1b2c3d4-e5f6-7890-abcd-ef1234567890

El comando actualiza los archivos generados y conserva la entrada de flujo existente en power.config.json.

Eliminar un flujo

Use pa app remove flow para quitar un flujo por su nombre de origen de datos:

pa app remove flow --flow-name ApprovalWorkflow

O quítelo por su identificador de flujo:

pa app remove flow --flow-id a1b2c3d4-e5f6-7890-abcd-ef1234567890

El comando quita el flujo de power.config.json y vuelve a generar los modelos y servicios.

Ejecución y publicación de la aplicación

Ejecute la aplicación localmente:

npm run dev

Compile y publique la aplicación:

npm run build
pa app push

Limitaciones y consideraciones

Limitación Detalles
Power Apps desencadenador necesario Solo se admiten flujos instantáneos que usan el desencadenador Power Apps.
Flujos compatibles con la solución necesarios El flujo debe pertenecer a una solución para poder agregarlo.
Se requiere acceso al creador La persona que agrega el flujo debe tener acceso al flujo y a sus conexiones subyacentes.
Permisos de Dataverse necesarios Los usuarios finales necesitan permisos suficientes de Dataverse para invocar el flujo. Asigne el rol de seguridad de App Opener o un rol equivalente.
Actualización manual necesaria Vuelva a ejecutarse pa app add flow después de que cambie la definición del flujo.
  • Last updated on