Executar o Power App (versão prévia)

A ação Executar o Power App inicia um aplicativo diretamente de um fluxo da área de trabalho e estabelece um canal de comunicação entre os dois. Usando essa integração, os fluxos da área de trabalho podem chamar nativamente experiências do Power App, passar entradas e receber saídas. Essa abordagem permite uma integração nativa robusta para cenários de automação assistida, em vez de depender da automação baseada na interface do usuário.

Com essa capacidade, você pode:

• Chamar um aplicativo diretamente de um fluxo da área de trabalho
• Chamar um aplicativo diretamente de um fluxo da área de trabalho.
• Passe os dados de entrada do fluxo da área de trabalho para o aplicativo.
• Capture as saídas do aplicativo de volta ao fluxo.
• Disparar subfluxos a partir de eventos do aplicativo.

Isso habilita cenários, como:

• Formulários guiados dinâmicos e de várias etapas para automação assistida
• Experiências modernas baseadas em aplicativo substituindo formulários personalizados herdados
• Automação assistida controlada por eventos, em que as ações do usuário determinam a execução do fluxo
• Aplicações modernas em nuvem integrando a automação legada de desktop

Requisitos e disponibilidade

• Versão mínima do Power Automate para desktop: 2.68 ou posterior.
• Disponibilidade na nuvem: Disponível somente em nuvens públicas.

Pré-requisitos

Antes de começar, verifique se você tem estes itens:

• Power Automate para desktop (PAD) versão 2.68 ou posterior instalado
• Acesso a Power Apps no mesmo ambiente
• Subfluxos de desktop que você pode invocar no aplicativo
• Microsoft Edge WebView2 Runtime instalado (necessário para exibir o Power App durante o runtime)

Etapa 1: Criar subfluxos que podem ser chamados no fluxo da área de trabalho

1. Abra seu fluxo da área de trabalho no designer do PAD.
2. Crie um ou mais subfluxos locais .
3. (Opcional) Para cada subfluxo, defina:
   • Variáveis de entrada: valores que o aplicativo passa para o subfluxo
   • Variáveis de saída: valores que o subfluxo retorna ao aplicativo

Etapa 2: Estabelecer a conexão de criação com o Power Apps Studio

Para expor seus subfluxos no Power Apps Studio (para que eles apareçam como funções que você pode chamar), abra o aplicativo por meio da ponte de criação do PAD.

1. Adicione a ação Executar o Power App (versão prévia) ao fluxo da área de trabalho.
2. Nas propriedades da ação, execute um dos seguintes procedimentos:
   • Selecione um aplicativo existente ou
   • Criar um novo aplicativo

1. Selecione Abrir aplicativo.

   Seu navegador padrão abre uma página Power Automate para desktop que orienta você durante a conexão com o Power Apps Studio.

2. Na página do navegador, selecione Abrir Designer.

   Uma nova guia do navegador é aberta com Power Apps Studio, com o aplicativo selecionado já aberto.

3. Mantenha a página do navegador do Power Automate para desktop aberta até que ela indique que está conectada.

   Se você fechar a página antes de o aplicativo terminar de carregar, você impedirá o estabelecimento de uma conexão entre o fluxo da área de trabalho e o aplicativo Power.

Etapa 3: chamar subfluxos da área de trabalho do Power App

Depois de estabelecer a conexão do designer, o Power Apps Studio mostra um objeto host chamado PowerAutomateDesktop. Esse objeto disponibiliza os subfluxos da sua área de trabalho como funções que podem ser chamadas.

Padrão de invocação (geral)

Para chamar um subfluxo da área de trabalho a partir do Power Apps:

• Use o PowerAutomateDesktop objeto.
• Chame o subfluxo pelo nome.
• Passe entradas como parâmetros de função.
• Acessar valores de saída do resultado retornado.

Sintaxe geral:

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

Example

Neste exemplo:

• O subfluxo é nomeado GetCustomerData.
• Ele aceita um único parâmetro de entrada. Por exemplo, varCustomerId.
• Retorna um valor por meio de uma variável de saída chamada out_customer_data, que é armazenada na variável varResultglobal.

Para chamar o subfluxo, passe o valor de varCustomerId e armazene a saída retornada na variável global varResult:

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

Etapa 4: Retornar valores para Power Apps

• Power Automate para área de trabalho retorna todos os valores como cadeias de caracteres. Em Power Apps, converta esses valores no tipo apropriado.
• Quando você chama um subfluxo de fluxo da área de trabalho, ele retorna todas as variáveis de saída como um único valor de registro.
• Você pode acessar variáveis de saída individuais como propriedades desse registro.

Exemplo: obter e usar variáveis de saída no Power Apps

Set(globalVariable, PowerAutomateDesktop.GetCustomerData(inputVariable))

Este exemplo armazena todas as variáveis de saída do subfluxo em globalVariable.

Para acessar uma variável de saída específica. Por exemplo, out_var1:

globalVariable.out_var1

Retornar valores complexos

Se você precisar retornar valores complexos (objetos ou listas personalizados), retorne-os como variáveis de saída e analise-os em Power Apps.

1. No subfluxo da área de trabalho, crie um objeto personalizado.
2. Retorne o objeto personalizado como uma variável de saída.
3. Em Power Apps, use ParseJSON para analisar o valor retornado e acessar suas propriedades.

Set(parsedValue, ParseJSON(globalVariable.out_customer_data))

Suporte do IntelliSense

Quando você chama subfluxos da área de trabalho no Power Apps, o Power Apps Studio fornece IntelliSense para ajudar você a descobrir e usar os recursos disponíveis.

Ao digitar na barra de fórmulas:

• O PowerAutomateDesktop objeto mostra os nomes de subfluxo disponíveis.
• Os parâmetros de entrada para o subfluxo selecionado são exibidos na ordem correta.
• Nomes de variável de saída são sugeridos após a chamada de função.

Esse suporte ajuda você a:

• Localize rapidamente os subfluxos disponíveis.
• Entenda as informações necessárias sem precisar consultar o fluxo no desktop.
• Selecione variáveis de saída válidas sem memorizar seus nomes.

Onde você pode chamar um subfluxo

Invoque subfluxos a partir de propriedades com suporte a ações, como:

• Uma opção OnSelect do botão.
• Propriedade de evento de um controle (por exemplo, OnChange) quando apropriado para o design do aplicativo.

Comportamento de tempo de execução

Quando o fluxo da área de trabalho é executado e a execução atinge Executar o Power App:

1. O aplicativo inicia.
2. O aplicativo estabelece automaticamente um canal de comunicação.

A ação Run Power App termina quando o usuário fecha a janela Power Apps ou interrompe o fluxo manualmente.

Limitações e considerações

• Execução sequencial: O processo lida com chamadas de subfluxo uma de cada vez. Não dispare uma nova chamada antes que a chamada anterior seja concluída.
• Propagação da publicação: Depois de publicar alterações em um aplicativo, pode levar algum tempo para que as atualizações apareçam ao iniciar o aplicativo novamente no Power Automate para desktop.
• Prompts de entrada: Em alguns cenários, os usuários podem ser solicitados a entrar quando o aplicativo é iniciado.

Solução de problemas

Não é possível ver o objeto PowerAutomateDesktop no designer de Power Apps

• Certifique-se de usar Open app na ação PAD. Em seguida, selecione Abrir Designer no navegador e aguarde até que o designer carregue o aplicativo.
• Mantenha a página do PAD no navegador aberta até que indique que a conexão foi estabelecida.

Não consigo ver meu subfluxo novo ou atualizado no Power Apps Studio

• Reabra o aplicativo por Run Power Apps > Abrir aplicativo > Open Designer para que o esquema seja atualizado.

As alterações no Power App não são aplicadas ao executar pelo Power Automate para desktop

• Verifique se você publicou suas alterações mais recentes no Power Apps.
• Após a publicação, aguarde um curto período de tempo antes de executar o aplicativo novamente, pois as atualizações podem levar algum tempo para se propagarem e ficarem disponíveis quando iniciadas de Power Automate para área de trabalho. Se você não quiser esperar, poderá relançar o aplicativo usando a ação Executar Power App para carregar imediatamente a versão mais recente.

O aplicativo não aparece durante o runtime

Power Apps renderiza usando o Microsoft Edge WebView2 Runtime.

• Verifique se WebView2 Runtime está instalado na sua máquina. Você pode verificar isso:

  • Verificar a lista de aplicativos instalados em Configurações do Windows (Aplicativos > Aplicativos instalados) ou
  • Executando o Power Automate para solução de problemas da área de trabalho

• Se ele não estiver instalado, baixe-o e instale-o de Microsoft Edge WebView2.

  Na página de download, selecione Evergreen Bootstrapper e execute o instalador.