Adicionar fluxos de Power Automate a um aplicativo de código

Este artigo mostra como descobrir, adicionar, chamar, atualizar e remover fluxos de nuvem Power Automate em um aplicativo de código Power Apps usando a CLI Power Apps.

Importante

Os aplicativos de código dão suporte apenas a fluxos instantâneos com reconhecimento de solução que usam o gatilho Power Apps. Fluxos agendados, fluxos automatizados e fluxos instantâneos que usam outros gatilhos não têm suporte.

Pré-requisitos

  • Um aplicativo de código Power Apps inicializado com pa app init
  • Um fluxo de nuvem instantânea com reconhecimento de solução que usa o gatilho Power Apps
  • @microsoft/power-apps versão 1.1.1 ou posterior

Se o fluxo não estiver em uma solução, consulte Adicionar um fluxo de nuvem existente a uma solução.

Etapa 1: Listar fluxos disponíveis

Use o pa app list-flows comando para listar os fluxos com reconhecimento de solução no ambiente atual:

pa app list-flows

Este comando retorna os fluxos disponíveis:

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 os resultados por nome, use o --search parâmetro:

pa app list-flows --search approval

Copie a ID de Fluxo para o fluxo que você deseja adicionar.

Note

O comando lista apenas fluxos com reconhecimento de solução. Se um fluxo não estiver listado, adicione-o a uma solução primeiro.

Etapa 2: Adicionar o fluxo

Use o pa app add flow comando para adicionar o fluxo ao aplicativo de código:

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

Por exemplo:

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

Executar o comando novamente com a mesma ID de fluxo atualiza os arquivos gerados com a definição de fluxo mais recente.

O que o comando faz

O comando:

  • Baixa a definição de OpenAPI do fluxo.
  • Gera modelos e serviços typeScript fortemente tipado.
  • Adiciona o fluxo e suas referências de conexão a power.config.json.

Importante

A pessoa que executa pa app add flow deve ter acesso ao fluxo e suas conexões subjacentes. O comando falhará se a pessoa não tiver acesso a uma conexão necessária.

Arquivos gerados

A CLI cria arquivos semelhantes ao seguinte exemplo:

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

A CLI também adiciona a configuração de fluxo a power.config.json.

Etapa 3: Chamar o fluxo

A classe de serviço gerada fornece um método estático Run . A assinatura do método baseia-se nos parâmetros de entrada na definição de OpenAPI do fluxo.

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

Fluxo sem parâmetros de entrada

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

const result = await SendNotificationService.Run();

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

O resultado contém as seguintes propriedades:

Propriedade Tipo Description
success boolean Indica se o fluxo foi disparado com êxito.
data Variações Contém a resposta digitada do fluxo, se disponível.
error Error Contém informações de erro quando success é false.

Abra o arquivo de serviço gerado para examinar os tipos exatos de entrada e saída para o fluxo.

Atualizar um fluxo

Se a definição de fluxo for alterada, execute pa app add flow novamente com a mesma ID de fluxo:

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

O comando atualiza os arquivos gerados e preserva a entrada de fluxo existente em power.config.json.

Remover um fluxo

Use pa app remove flow para remover um fluxo pelo nome da fonte de dados:

pa app remove flow --flow-name ApprovalWorkflow

Ou remova-o por sua ID de fluxo:

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

O comando remove o fluxo power.config.json e regenera os modelos e serviços.

Executar e publicar o aplicativo

Execute o aplicativo localmente:

npm run dev

Crie e publique o aplicativo:

npm run build
pa app push

Limitações e considerações

Limitation Detalhes
Power Apps gatilho necessário Há suporte apenas para fluxos instantâneos que usam o gatilho Power Apps.
Fluxos com reconhecimento de solução necessários O fluxo deve pertencer a uma solução antes que você possa adicioná-la.
Acesso do criador necessário A pessoa que adiciona o fluxo deve ter acesso ao fluxo e suas conexões subjacentes.
Permissões do Dataverse necessárias Os usuários finais precisam de permissões suficientes do Dataverse para invocar o fluxo. Atribua a função de segurança do Abridor de Aplicativos ou uma função equivalente.
Atualização manual necessária Execute pa app add flow novamente depois que a definição de fluxo for alterada.
  • Last updated on