Ajouter des flux Power Automate à une application de code

Cet article vous montre comment découvrir, ajouter, appeler, mettre à jour et supprimer des flux cloud Power Automate dans une application de code Power Apps à l’aide de l’interface CLI Power Apps.

Important

Les applications de code prennent uniquement en charge les flux instantanés prenant en charge les solutions qui utilisent le déclencheur Power Apps. Les flux planifiés, les flux automatisés et les flux instantanés qui utilisent d’autres déclencheurs ne sont pas pris en charge.

Prerequisites

  • Une application de code Power Apps initialisée avec pa app init
  • Flux cloud instantané prenant en compte la solution qui utilise le déclencheur Power Apps
  • @microsoft/power-apps version 1.1.1 ou ultérieure

Si le flux n’est pas dans une solution, consultez Ajouter un flux cloud existant à une solution.

Étape 1 : Répertorier les flux disponibles

Utilisez la pa app list-flows commande pour répertorier les flux prenant en compte la solution dans l’environnement actuel :

pa app list-flows

Cette commande retourne les flux 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

Pour filtrer les résultats par nom, utilisez le --search paramètre :

pa app list-flows --search approval

Copiez l’ID de flux du flux que vous souhaitez ajouter.

Note

La commande répertorie uniquement les flux prenant en compte la solution. Si un flux n’est pas répertorié, ajoutez-le d’abord à une solution.

Étape 2 : Ajouter le flux

Utilisez la pa app add flow commande pour ajouter le flux à l’application de code :

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

Par exemple:

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

L’exécution de la commande avec le même ID de flux met à jour les fichiers générés avec la dernière définition de flux.

Que fait la commande

Commande :

  • Télécharge la définition OpenAPI du flux.
  • Génère des modèles et des services TypeScript fortement typés.
  • Ajoute le flux et ses références de connexion à power.config.json.

Important

La personne qui s’exécute pa app add flow doit avoir accès au flux et à ses connexions sous-jacentes. La commande échoue si la personne n’a pas accès à une connexion requise.

Fichiers générés

L’interface CLI crée des fichiers similaires à l’exemple suivant :

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

L’interface CLI ajoute également la configuration de flux à power.config.json.

Étape 3 : Appeler le flux

La classe de service générée fournit une méthode statique Run . La signature de méthode est basée sur les paramètres d’entrée dans la définition OpenAPI du flux.

Flux avec des paramètres d’entrée

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);
}

Flux sans paramètres d’entrée

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

const result = await SendNotificationService.Run();

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

Le résultat contient les propriétés suivantes :

Propriété Type Description
success boolean Indique si le flux a été déclenché avec succès.
data Varie Contient la réponse typée du flux, le cas échéant.
error Error Contient des informations d’erreur quand success c’est false.

Ouvrez le fichier de service généré pour passer en revue les types exacts d’entrée et de sortie du flux.

La mise à jour d'un flux

Si la définition de flux change, réexécutez-la pa app add flow avec le même ID de flux :

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

La commande met à jour les fichiers générés et conserve l’entrée de flux existante dans power.config.json.

Supprimer un flux

Permet pa app remove flow de supprimer un flux par son nom de source de données :

pa app remove flow --flow-name ApprovalWorkflow

Ou supprimez-le par son ID de flux :

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

La commande supprime le flux et power.config.json régénère les modèles et services.

Exécuter et publier l’application

Exécutez l’application localement :

npm run dev

Générez et publiez l’application :

npm run build
pa app push

Limitations et considérations

Limitation Détails
Power Apps déclencheur requis Seuls les flux instantanés qui utilisent le déclencheur Power Apps sont pris en charge.
Flux prenant en compte les solutions requis Le flux doit appartenir à une solution avant de pouvoir l’ajouter.
Accès Maker requis La personne qui ajoute le flux doit avoir accès au flux et à ses connexions sous-jacentes.
Autorisations dataverse requises Les utilisateurs finaux ont besoin d’autorisations Dataverse suffisantes pour appeler le flux. Attribuez le rôle de sécurité App Opener ou un rôle équivalent.
Mise à jour manuelle requise Réexécutez pa app add flow une fois la définition de flux modifiée.
  • Last updated on