Executar Power App (pré-visualização)

A ação Executar Power App lança uma aplicação diretamente a partir de um fluxo de ambiente de trabalho e estabelece um canal de comunicação entre os dois. Ao utilizar esta integração, os fluxos de ambiente de trabalho podem chamar nativamente experiências de Power App, passar entradas e receber saídas. Esta abordagem permite uma integração nativa rica para cenários de automação assistida, em vez de depender da automação baseada na interface.

Com esta capacidade, pode:

• Invoque uma aplicação diretamente a partir de um fluxo do ambiente de trabalho
• Chamar uma aplicação diretamente a partir de um fluxo de ambiente de trabalho.
• Passa os inputs do ambiente de trabalho para a aplicação.
• Capturar saídas da aplicação de volta para o fluxo.
• Acionar subfluxos a partir de eventos da aplicação.

Isto permite cenários como:

• Formulários guiados dinâmicos e de múltiplos passos para automação assistida
• Experiências modernas baseadas em aplicações a substituir formulários personalizados antigos
• Automação assistida orientada por eventos, onde as ações do utilizador ditam a execução do fluxo
• Aplicações de cloud modernas que fazem bridging com a automatização de ambientes de trabalho legada

Requisitos e disponibilidade

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

Pré-requisitos

Antes de começar, certifique-se de que:

• O Power Automate para computadores (PAD) versão 2.68 ou posterior instalado
• Acesso ao Power Apps no mesmo ambiente
• Subfluxos de ambiente de trabalho que pode chamar a partir da aplicação
• Microsoft Edge WebView2 Runtime instalado (necessário para mostrar a Power App durante a execução)

Passo 1: Crie subfluxos que podem ser chamados no seu fluxo da área de trabalho

1. Abra o fluxo do seu ambiente de trabalho no designer PAD.
2. Crie um ou mais subfluxos locais .
3. (Opcional) Para cada subfluxo, defina:
   • Variáveis de entrada: valores que a aplicação passa para o subflow
   • Variáveis de saída: valores que o subfluxo devolve à aplicação

Passo 2: Estabelecer a ligação de autoria ao Power Apps Studio

Para expor os seus subfluxos no Power Apps Studio (para que apareçam como funções que pode invocar), abra a aplicação através da bridge de criação do PAD.

1. Adicione a ação Executar Power App (Pré-visualização) ao seu fluxo de ambiente de trabalho.
2. Nas propriedades da ação, ou:
   • Selecione uma aplicação existente, ou
   • Criar uma nova aplicação

1. Selecione Abrir aplicação.

   O teu navegador predefinido abre uma página Power Automate para desktop que te orienta na ligação ao Power Apps Studio.

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

   É aberto um novo separador do browser com o Power Apps Studio, já com a aplicação selecionada aberta.

3. Mantenha a página do browser do Power Automate para computadores aberta até mostrar que está ligado.

   Se fechares a página antes da aplicação terminar de carregar, impedes de estabelecer uma ligação entre o fluxo de ambiente de trabalho e a aplicação Power.

Passo 3: Chamar subfluxos do ambiente de trabalho a partir do Power App

Depois de estabelecer a ligação designer, Power Apps Studio mostra um objeto host chamado PowerAutomateDesktop. Este objeto expõe os subfluxos da sua área de trabalho como funções que podem ser invocadas.

Padrão de invocação (geral)

Para chamar um subfluxo de ambiente de trabalho a partir do Power Apps:

• Usa o PowerAutomateDesktop objeto.
• Chame o subfluxo pelo nome.
• Passa entradas como parâmetros de função.
• Acede aos valores de saída do resultado devolvido.

Sintaxe geral:

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

Example

Neste exemplo:

• O subfluxo é denominado GetCustomerData.
• Aceita um único parâmetro de entrada. Por exemplo, varCustomerId.
• Devolve um valor através de uma variável de saída chamada out_customer_data, que é armazenada na variável varResultglobal .

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

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

Passo 4: Devolver valores ao Power Apps

• O Power Automate para desktop devolve todos os valores como strings. No Power Apps, converta estes valores para o tipo adequado.
• Quando chama um subfluxo de um fluxo de ambiente de trabalho, este devolve todas as variáveis de saída como um único valor de registo.
• Podes aceder a variáveis de saída individuais como propriedades desse registo.

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 aceder a uma variável de saída específica. Por exemplo: out_var1

globalVariable.out_var1

Devolver valores complexos

Se precisares de devolver valores complexos (objetos ou listas personalizadas), devolve-os como variáveis de saída e analisa-os no Power Apps.

1. No subflow do ambiente de trabalho, constrói um objeto personalizado.
2. Devolve o objeto personalizado como variável de saída.
3. Em Power Apps, use ParseJSON para analisar o valor devolvido e aceder às suas propriedades.

Set(parsedValue, ParseJSON(globalVariable.out_customer_data))

Suporte ao IntelliSense

Ao chamar subfluxos de ambiente de trabalho no Power Apps, o Power Apps Studio fornece IntelliSense para ajudar a descobrir e utilizar as funcionalidades disponíveis.

Enquanto escreves na barra de fórmulas:

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

Este apoio ajuda-o a:

• Encontre rapidamente os subfluxos disponíveis.
• Compreender as entradas necessárias sem recorrer ao fluxo de ambiente de trabalho.
• Selecione variáveis de saída válidas sem memorizar os seus nomes.

Onde pode chamar um subfluxo

Invocar subfluxos a partir de propriedades com capacidade de ação, tais como:

• O OnSelect de um botão.
• A propriedade de evento de um controlo (por exemplo, OnChange), quando adequado ao design da sua aplicação.

Comportamento de tempo de execução

Quando o fluxo de ambiente de trabalho é executado e a execução chega a Executar Power App:

1. A aplicação arranca.
2. A aplicação estabelece automaticamente um canal de comunicação.

A ação Executar Power App termina quando o utilizador fecha a janela de Power Apps ou para o fluxo manualmente.

Limitações e considerações

• Execução sequencial: O processo trata as chamadas de subfluxo uma de cada vez. Não acione uma nova chamada antes da chamada anterior terminar.
• Propagação de publicação: Após publicar alterações numa aplicação, as atualizações podem demorar algum tempo a aparecer ao lançar a aplicação novamente a partir de Power Automate para desktop.
• Prompts para iniciar sessão: Em alguns cenários, os utilizadores podem ser convidados a iniciar sessão quando a aplicação é lançada.

Troubleshooting

Não consegues ver o objeto PowerAutomateDesktop no Power Apps designer

• Certifica-te de que usas Abrir aplicação na ação do PAD. Depois, selecione Abrir Designer no navegador e espere até o designer carregar a aplicação.
• Mantenha a página do browser do PAD aberta até que seja indicado que a ligação foi estabelecida.

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

• Volte a abrir a aplicação através de Executar o Power Apps > Abrir a aplicação > Abrir o Estruturador para que o esquema seja atualizado.

As alterações feitas a Power App não são refletidas quando executada a partir do Power Automate para computadores

• Certifica-te de que publica as tuas últimas alterações no Power Apps.
• Após a publicação, espere um curto período antes de voltar a executar a aplicação, pois as atualizações podem demorar algum tempo a propagar-se e a tornar-se disponíveis quando lançadas a partir do Power Automate para ambiente de trabalho. Se não quiseres esperar, podes reabrir a aplicação usando a ação Executar Power App para carregar imediatamente a versão mais recente.

A aplicação não aparece durante a execução

Power Apps renderiza usando o Microsoft Edge WebView2 Runtime.

• Certifique-se de que está WebView2 Runtime instalado na sua máquina. Pode confirmar isto através de:

  • Verificar a lista de aplicações instaladas nas Definições do Windows (Aplicações > Aplicações instaladas), ou
  • Executar a resolução de problemas do Power Automate para computadores

• Se não estiver instalado, descarregue e instale a partir de Microsoft Edge WebView2.

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