Ajouter des flux Power Automate à une application de code (préversion)

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

Important

Seuls les flux qui utilisent le déclencheur Power Apps sont pris en charge. Vous ne pouvez pas ajouter de flux avec d’autres types de déclencheurs à une application de code. Ces types de déclencheurs non pris en charge incluent des flux planifiés, automatisés ou instantanés utilisant des déclencheurs autres que ceux de Power Apps.

Prerequisites

Note

Les commandes de flux sont uniquement disponibles dans l’interface CLI basée sur npm (npx power-apps). Ils ne sont pas disponibles dans les commandes CLI Power Platform (pac code).

Étape 1 : Répertorier les flux disponibles

Exécutez la commande suivante pour répertorier tous les flux prenant en compte la solution dans votre environnement actuel :

npx power-apps list-flows

La commande génère une table des 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

Note

Seuls les flux prenant en compte la solution sont répertoriés. Si vous manquez un flux, consultez : Créer un flux cloud dans une solution

Pour filtrer les résultats par nom, utilisez l’option --search suivante :

npx power-apps list-flows --search approval

Copiez la valeur d’ID de flux pour le flux que vous souhaitez ajouter.

Étape 2 : Ajouter un flux à votre application de code

Exécutez la commande suivante, en remplaçant <flow-id> par la valeur de l’étape précédente :

npx power-apps add-flow --flow-id <flow-id>

Exemple :

npx power-apps add-flow --flow-id a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1

Une fois la commande réussie, l’interface CLI confirme que le flux a été ajouté :

Flow added successfully.

Conseil / Astuce

La réexécution add-flow avec l'ID de flux identique est idempotente. Utilisez-la pour récupérer les modifications apportées à la définition du flux (nouveaux paramètres, connexions mises à jour, et ainsi de suite) sans nettoyer manuellement les anciens fichiers.

Qu’est-ce que add-flow fait

La commande télécharge la définition OpenAPI du flux, génère des fichiers TypeScript fortement typés dans votre projet, et met à jour power.config.json avec les références de connexion du flux.

Important

La personne en cours d’exécution add-flow doit avoir accès à lire le flux et aux connexions sous-jacentes du flux (par exemple, une connexion Office 365 Outlook). Si l’accès à une connexion requise est manquant, la commande échoue avec une erreur d’autorisation.

Fichiers générés

Après l’exécution add-flow, l’interface CLI crée les fichiers suivants dans votre projet (les noms de fichiers sont dérivés du nom d’affichage du flux) :

src/
  services/
    ApprovalWorkflowService.ts   ← generated service class with typed methods
  models/
    ApprovalWorkflowModel.ts     ← generated TypeScript types for inputs/outputs
schemas/
  logicflows/
    ApprovalWorkflow.Schema.json ← flow's OpenAPI schema (do not edit manually)

L’entrée suivante est également ajoutée à power.config.json:

"<uuid>": {
  "id": "/providers/microsoft.powerapps/apis/shared_logicflows",
  "displayName": "Logic flows",
  "dataSources": ["ApprovalWorkflow"],
  "workflowDetails": {
    "workflowEntityId": "<dataverse-entity-guid>",
    "workflowDisplayName": "Approval Workflow",
    "workflowName": "<flow-id>",
    "dependencies": {
      "shared_office365": "<dependency-uuid>"
    }
  }
}

Étape 3 : Appeler le flux à partir de votre application

La classe de service générée expose une Run méthode statique. La signature exacte dépend du fait que le déclencheur du flux définit les paramètres d’entrée.

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

L’objet result a la forme suivante :

Propriété Type Description
success boolean true si le flux a été déclenché avec succès.
data (varie) Charge utile de réponse typifiée provenant du flux, le cas échéant.
error Error (facultatif) Détails de l’erreur quand success est false.

Note

Les types d’entrée et de sortie exacts sont déterminés par la définition OpenAPI du flux. Ouvrez le fichier de service généré pour afficher les types spécifiques de votre flux. Les paramètres marqués x-ms-visibility: internal avec une valeur par défaut sont automatiquement incorporés par le générateur de code et ne sont pas exposés dans la signature de méthode.

Mise à jour d’un flux

Si la définition du flux change ( par exemple, son auteur ajoute un nouveau paramètre ou met à jour les références de connexion ) réexécuter add-flow avec le même ID de flux pour récupérer la dernière définition et régénérer les fichiers de service :

npx power-apps add-flow --flow-id a1b2c3d4-e5f6-7890-abcd-ef1234567890

La commande associe le flux à son workflowEntityId et réutilise l’UUID existant dans power.config.json, donc aucun nettoyage manuel n’est nécessaire.

Suppression d’un flux

Pour supprimer un flux de votre application de code, utilisez remove-flow. Vous pouvez identifier le flux par son nom de source de données (tel qu’il apparaît) power.config.jsonou par son ID de flux d’origine :

Par nom de source de données :

npx power-apps remove-flow --flow-name ApprovalWorkflow

Par ID de flux :

npx power-apps remove-flow --flow-id a1b2c3d4-e5f6-7890-abcd-ef1234567890

Commande :

  • Supprime le flux de power.config.json.
  • Régénère tous les services de modèle.

Déploiement de votre application

Après avoir ajouté des flux et vérifié l’application localement avec npm run dev, générez et déployez comme d’habitude :

npm run build
npx power-apps push

Limitations et considérations

Gardez à l’esprit les limitations et considérations suivantes lorsque vous ajoutez des flux à une application de code.

Limitation Détails
Flux manuels avec déclencheur PowerApps uniquement Seuls les flux manuels qui utilisent le déclencheur PowerApps sont pris en charge. Les flux avec d’autres types de déclencheurs (planifiés, automatisés ou instantanés avec des déclencheurs non PowerApps) ne sont pas pris en charge et ne fonctionnent pas correctement dans une application de code.
Flux sensibles à la solution uniquement La list-flows commande affiche uniquement les flux qui appartiennent à une solution. Pour ajouter un flux non solution, ajoutez-le d’abord à une solution.
Accès au Maker requis Le créateur en cours d’exécution add-flow doit avoir accès au flux et aux connexions sous-jacentes du flux. Si l’accès à une connexion requise est manquant, la commande échoue.
Autorisations dataverse requises au moment de l’exécution Les utilisateurs finaux doivent disposer d’autorisations Dataverse suffisantes pour appeler des flux. Attribuez le rôle de sécurité App Opener (ou équivalent). Consultez Configurer la sécurité utilisateur dans un environnement.
Actualisation manuelle requise pour les modifications de flux Si la définition du flux change, réexécutez-la add-flow avec le même ID de flux. L’application ne détecte pas automatiquement les modifications de flux.
npm CLI uniquement Ces commandes ne sont pas disponibles dans pac code.
  • Last updated on