Executar fluxos de interface do usuário assistidos e autônomosRun attended and unattended UI flows

Depois de criar e testar um fluxo de interface do usuário, execute-o de um evento, um agendamento ou um botão.After you've created and tested a UI flow, you can run it from an event, schedule, or button. Para tornar isso possível, adicione o fluxo de interface do usuário a um Fluxo automatizado, um Fluxo de botão, um Fluxo agendado ou um fluxo de processo de negócios.To make this possible, add your UI flow to an Automated flow, a Button flow, a Scheduled flow, or a business process flow.

Pré-requisitosPrerequisites

  • Você precisa do gateway de dados local para que seu dispositivo tenha o fluxo de interface do usuário disparado pelo Power Automate.You need the on-premises data gateway for your device to have the UI flow triggered by Power Automate.

    O gateway é uma conexão segura em nível empresarial entre o Power Automate e o dispositivo (em que o fluxo de interface do usuário é executado).The gateway is an enterprise-grade secure connection between Power Automate and your device (where your UI flow runs). O Power Automate usa o gateway para acessar seu dispositivo local para que ele possa disparar seus fluxos de interface do usuário de um evento, um agendamento ou um botão.Power Automate uses the gateway to access your on-premises device so that it can trigger your UI flows from an event, schedule, or button.

  • Uma conta corporativa ou de estudante.A work or school account.

    Important

    Você deve usar a mesma conta corporativa ou de estudante para configurar o gateway, entrar no Power Automate e fazer logon em seu dispositivo Windows.You must use the same work or school account to set up the gateway, to sign into Power Automate, and to log into your Windows device.

Executar o fluxo de interface do usuário de um evento, um botão, um agendamento ou um fluxo de processo de negóciosRun your UI flow from an event, button, schedule, or business process flow

Neste exemplo, usaremos um fluxo automatizado para disparar um fluxo de interface do usuário quando um novo email chegar.In this example we will use an automated flow to trigger a UI flow when a new email arrives.

  1. Navegar para Power Automate.Navigate to Power Automate.

  2. Selecione Meus fluxos na barra de navegação esquerda.Select My flows in the left navigation bar.

  3. Selecione Novo e Automatizado – do zero.Select New, and then select Automated-from blank.

    Tip

    Você pode escolher qualquer outro tipo de fluxo para atender às suas necessidades.You can choose any other type of flow to suit your needs.

  4. Dê um nome ao seu fluxo na caixa Nome do fluxo.Give your flow a name in the Flow name box.

  5. Pesquise "novo email" e selecione Quando um novo email chega (V3) na lista de gatilhos.Search for "new email", and then select When a new email arrives (V3) from the list of triggers.

    Selecionar um gatilhoSelect a trigger

  6. Selecione Criar e Nova etapa.Select Create, and then select New step.

  7. Pesquise Fluxos de interface do usuário e selecione Executar um fluxo de interface do usuário para desktop na lista de Ações.Search for UI flows, and then select Run a UI flow for desktop from the list of Actions.

    Ação de pesquisaSearch action

  8. Forneça as informações do gateway e as credenciais do dispositivo.Provide the gateway information and device credentials.

    Você precisará fazer isso uma vez por dispositivo:You'll have to do this once per device:

    • Gateway: selecione o gateway criado anteriormente ou use a opção Novo gateway para criar um gateway.Gateway: Select the gateway that you created earlier or use New gateway to create a new gateway.

    • Domínio e nome de usuário: exibe a conta corporativa ou de estudante do dispositivo.Domain and Username: Displays the work or school account from the device.

      Important

      Verifique se você pode fazer logon no dispositivo usando essas credenciais.Make sure you can login to the device using these credentials.

    • Senha: forneça sua conta corporativa ou de estudante.Password: Provide your work or school account’s password.

      Configurações de conexãoConnection settings

      Tip

      Se você não vê o gateway, talvez você esteja em um ambiente cuja região é diferente da região do gateway.If you don't see your gateway, you might be in an environment whose region is different from the gateway region. Selecione Solucionar problemas de gateway ausente na lista de nomes de gateways para saber mais.Select Troubleshoot a missing gateway in the gateway name list to learn more. Você também pode confirmar se as regiões do gateway e do Power Automate estão mapeadas corretamente.You can also confirm your gateway and Power Automate regions are mapped correctly.

      Tip

      Se você não vir seu gateway, talvez seja necessário selecionar uma conexão diferente.If you don't see your gateway, you might need to select a different connection. Para fazer isso, selecione ... no canto superior direito do cartão Executar um fluxo de interface do usuário para o desktop ou Executar um fluxo de interface do usuário para a Web e selecione a conexão em Minhas conexões.To do this, select ... from the top right side of the Run a UI flow for desktop or Run a UI flow for Web card, and then select the connection from My connections.

      Selecionar uma nova conexãoSelect a new connection

  9. Selecione o fluxo de interface do usuário que você criou anteriormente.Select the UI flow that you previously created.

    Selecionar fluxo de interface do usuárioSelect UI flow

  10. Selecione Salvar para salvar o fluxo automatizado.Select Save to save your automated flow.

    Tip

    Antes do teste, confirme se o gateway está online.Before testing, confirm that your gateway is online. Acesse Dados > Gateways no painel de navegação, selecione o nome do gateway, clique em ..., acesse Detalhes e verifique se o status do gateway está online. Se o status do gateway está offline, confirme se o dispositivo está ligado e conectado à Internet.Go to Data > Gateways on the navigation pane, select the gateway name, click on ... go to Details and verify if the gateway status is online.If the gateway status is offline, confirm that the device is turned on and connected to the Internet.

  11. Teste seu fluxo enviando um email para dispará-lo.Test your flow by sending an email to trigger it. Você verá o fluxo de interface do usuário reproduzindo as etapas que você registrou.You will see your UI flow playing back the steps you recorded.

    Execução bem-sucedida que chama um fluxo de interface do usuárioSuccessful run that calls a UI flow

    Tip

    Não interaja com seu dispositivo enquanto o fluxo é executado.Do not interact with your device while the flow runs.

Usar entradas e saídasUse inputs and outputs

Ao definir entradas e saídas em um fluxo de interface do usuário, você pode passar informações de e para essas entradas.When you define inputs and outputs within a UI flow, you can pass information from and to those inputs.

  1. Ao adicionar um fluxo de interface do usuário a um fluxo, você pode ver a lista de entradas definidas no fluxo de interface do usuário.When you add a UI flow to a flow, you can see the list of inputs that were defined in the UI flow.

    Entradas de fluxo de interface do usuárioUI flow inputs

  2. Você pode preencher cada campo de entrada no fluxo de interface do usuário com valores de etapas anteriores no fluxo.You can populate each input field in the UI flow with values from previous steps in the flow. Para fazer isso, selecione o campo de entrada e, em seguida, selecione uma entrada no seletor de token.To do this, select the input field, and then select an input from the token picker.

  3. Você também pode usar saídas de seu fluxo de interface do usuário como entradas para ações que aparecem posteriormente no fluxo.You can also use outputs from your UI flow as inputs for actions that appear later in the flow. Para fazer isso, selecione o campo de entrada e, em seguida, selecione uma entrada no seletor de token.To do this, select the input field, and then select an input from the token picker.

Usar entradas de texto confidenciaisUse sensitive text inputs

Algumas entradas, como senhas, precisam ser ofuscadas e omitidas do registro em log enquanto estão sendo usadas no aplicativo.Some inputs like passwords need to be obfuscated and omitted from logging while being used in the application. Os fluxos de interface do usuário são compatíveis com entradas chamadas Entradas de texto confidenciais para armazenar esses valores "particulares".UI flows supports inputs called Sensitive text inputs for storing these "private" values.

Para obter mais informações sobre como criar esses tipos de entradas, clique aqui.For more information on how to create these types of inputs, click here.

Para recuperar conteúdo confidencial de outro conector, ative Entradas seguras e Saídas seguras seguindo estas etapas:To retrieve sensitive content from another connector, turn on Secure Inputs and Secure Outputs by following these steps:

  1. Escolha Select no canto superior direito da ação.on the top right corner of the action.

  2. Selecione Configurações.Select Settings.

    A opção de configurações The settings option

  3. Ative as propriedades Entradas seguras (visualização) e Saídas seguras (visualização) para impedir que essas configurações sejam exibidas nos logs.Turn on the Secure Inputs (Preview) and Secure Outputs (Preview) properties to prevent these settings from being shown in the logs.

    Entradas e saídas segurasSecure inputs and outputs

  4. Escolha Concluído.Select Done.

    Você verá que a ação agora tem um ícone de cadeado no canto superior direito, indicando tratamento especial para valores de entrada e saída.You will notice that the action now has a lock icon on the top right, indicating special handling for input and output values.

    O ícone de cadeadoThe lock icon

    Tip

    Siga as mesmas etapas para configurar as entradas fornecidas anteriormente neste artigo para passar a saída desse conector para um fluxo da interface do usuário e, em seguida, ative Texto seguro (Visualização) em Configurações.Follow the same steps to configure inputs as given earlier in this article to pass the output from this connector to a UI flow, and then turn on Secure Text (Preview) in the Settings.

    Aprovar saídas para o fluxo de interface do usuário Pass outputs to UI flow

Executar fluxos de interface do usuário no modo autônomo ou assistidoRun UI flows unattended or attended

Ao criar os fluxos de interface do usuário, execute-os no modo assistido ou autônomo.When you create UI flows, you run them either in attended or unattended mode. O modo autônomo é o melhor para aplicativos que não precisam de supervisão humana.Unattended is best for applications that do not need human supervision.

Ao serem executados no modo autônomo, os fluxos de interface do usuário entram automaticamente nos dispositivos de destino que executam o Windows 10, o Windows Server 2016 ou o Windows Server 2019.When running unattended, UI flows automatically signs into the target devices that run Windows 10, Windows Server 2016, or Windows Server 2019. Depois que a automação for concluída, os fluxos de interface do usuário se desconectarão do dispositivo e relatarão a atividade dele no Power Automate.Once the automation completes, UI flows signs out from the device and reports its activity in Power Automate.

Ao serem executados no modo assistido, os fluxos de interface do usuário usarão uma sessão do usuário existente do Windows.When running attended, UI flows will use an existing Windows user session.

Ao adicionar um fluxo de interface do usuário a um fluxo, você pode escolher se deseja que o fluxo de interface do usuário seja executado no modo assistido ou autônomo.When you add a UI flow to a flow, you can choose whether you want your UI flow to run attended or unattended. Aqui estão algumas diferenças importantes entre as execuções assistidas e autônomas:Here are some key differences between attended and unattended runs:

Modo autônomoUnattended mode

Para executar fluxos de interface do usuário no modo autônomo, o computador de destino deverá estar disponível com todos os usuários desconectados.To run unattended UI flows, the target machine needs to be available with all users signed out.

Important

As sessões de usuário do Windows bloqueadas impedirão que os fluxos de interface do usuário sejam executados.Locked Windows user sessions will prevent UI flows from running.

Os fluxos de interface do usuário fazem o seguinte:UI flows perform the following:

  1. O fluxo de interface do usuário cria, gerencia e libera a sessão de usuário do Windows nos dispositivos de destino.UI flow creates, manages, and then releases the Windows user session on the target devices.

  2. Os fluxos de interface do usuário autônomos são executados em dispositivos com a tela bloqueada para que ninguém possa ver o fluxo enquanto estiver em execução.Unattended UI flows run on devices with the screen locked so that no one can see the flow while it runs.

  3. Os dispositivos Windows 10 não podem ser executados no modo autônomo caso haja sessões de usuário do Windows ativas (até mesmo uma bloqueada).Windows 10 devices cannot run unattended if there are any active Windows user sessions present (even a locked one). Você receberá este erro: Não é possível executar o fluxo da interface do usuário. Há uma sessão de usuário do Windows bloqueada ou inativa no dispositivo de destino.You will receive this error: Cannot execute UI flow. There is a locked or an inactive Windows user session on the target device.

  4. Em Windows Server, se você tiver uma sessão de usuário bloqueada do Windows aberta com o mesmo usuário que o fluxo da interface do usuário deve ser executado, você receberá o mesmo erro: Não é possível executar o fluxo da interface do usuário. Há uma sessão de usuário do Windows bloqueada ou inativa no dispositivo de destino.On Windows Server, if you have a locked Windows user session open with the same user as the UI flow is supposed to run as, you will receive the same error: Cannot execute UI flow. There is a locked or inactive Windows user session on the target device.

Modo assistidoAttended mode

Para executar um fluxo de interface do usuário no modo assistido será necessário ter uma sessão de usuário do Windows ativa que corresponda ao nome do usuário configurado para sua conexão.To run an attended UI flow, you need to have an active Windows user session that matches the name of the user configured for your connection. A sessão não deve ser bloqueada.The session must not be locked.

Quando um fluxo de interface do usuário assistido é iniciado no computador de destino, recomendamos evitar interagir com o dispositivo até a conclusão da execução.When an attended UI flow starts on the target machine, we recommend that you avoid interacting with your device until the run completes.

Agendar vários fluxos de interface do usuário no mesmo dispositivoSchedule multiple UI flows on the same device

É possível agendar vários fluxos de interface do usuário para serem executados em um ou mais dispositivos.You can schedule multiple UI flows to run on one or more devices. Se mais de um fluxo de interface do usuário for disparado para ser executado no mesmo dispositivo, o Power Automate seguirá as seguintes regras:If more than one UI flow is triggered to run on the same device, Power Automate will follow these rules:

  1. O primeiro fluxo de interface do usuário será executado no dispositivo de destino.The first UI flow will run on the target device.

  2. Enfileira outros fluxos de interface do usuário e os exibe como Aguardando na página de detalhes de fluxos de interface do usuário e de gateways.Queues other UI flows and displays them as Waiting in the UI flows and gateway details page.

  3. Seleciona o próximo fluxo de interface do usuário após a conclusão de cada execução.Picks the next UI flow when each run completes.

Note

Essas regras de orquestração se aplicam a execuções de fluxos de interface do usuário agendados por qualquer usuário ou por usuários diferentes no mesmo dispositivo.These orchestration rules apply to UI flow runs that are scheduled by any user scheduled by different users on the same device.

Important

Se houver muitos fluxos de interface do usuário na fila de execução, é possível que um tempo limite ocorra.If there are too many UI flows in the execution queue a timeout might occur. As execuções de fluxo de interface do usuário falharão se elas não forem executadas dentro de 30 minutos após serem disparadas.UI flow runs will fail if they don’t run within 30 minutes after being triggered.

Balancear carga de solicitações entre gateways em um clusterLoad balance requests across gateways in a cluster

Você pode optar por distribuir uniformemente execuções de fluxos de interface do usuário entre gateways em um cluster.You can choose to distribute UI flow runs evenly across gateways in a cluster. Por padrão, a seleção de um gateway durante o balanceamento de carga é aleatória.By default, the selection of a gateway during load balancing is random.

Siga estas etapas para adicionar um gateway a fim de criar um clusterFollow these steps to add a gateway to create a cluster

Note

Os membros offline do gateway em um cluster afetarão negativamente o desempenho.Offline gateway members within a cluster will negatively impact performance. Desabilite ou remova esses membros.Disable or remove these members.

Para fornecer balanceamento de carga da página de detalhes de gateways do Power Automate, navegue até Dados -> Gateways e selecione o cluster de gateway.To provide load balancing from the Power Automate gateway details page, navigate to Data -> Gateways, and then select your gateway cluster.

Na página de detalhes de gateways, alterne a Execução em todos os gateways no cluster.In the gateway details page, toggle Run on all gateways in cluster. Isso distribuirá as execuções de fluxos de interface do usuário em todos os gateways dentro desse cluster.This will distribute the UI flows runs on all the gateways within that cluster.

Distribuir a execução de fluxos de interface do usuário no cluster de gatewayDistribute UI flow run on gateway cluster

Important

Se você estiver usando contas locais do Windows, todos os computadores no cluster deverão ter a mesma conta local com a mesma senha.If you are using local Windows accounts, all machines in the cluster must have the same local account with the same password. Use essas credenciais ao criar a conexão de fluxo de interface do usuário.Use these credentials when you create the UI flow connection. Se você estiver usando computadores associados ao Active Directory ou ao Azure AD, confirme se a conta de usuário que será usada na conexão de fluxo de interface do usuário pode acessar todos os computadores no cluster.If you are using Active Directory or Azure AD joined machines, confirm that the user account you will be use in the UI flow connection can access all machines in the cluster.

Práticas recomendadas para evitar tempos limite e distribuir carga entre computadoresBest practices to avoid timeouts and distribute load across machines

Se você planeja executar vários fluxos de interface do usuário, há um conjunto de estratégias que você pode adotar para distribuir carga e verificar se todos os fluxos de interface do usuário são executados com êxito sem sobrecarregar os computadores de destino nem alcançar os tempos limite devido à execução de vários fluxos de interface do usuário simultaneamente.If you plan to run multiple UI flows, there are a set of strategies you can adopt to distribute load and ensure that all your UI flows run successfully without overloading the target machine(s) or running into timeouts because multiple UI flows are running at the same time. Você pode:You can either:

  1. Planejar que os fluxos de interface do usuário sejam executados em diferentes momentos do dia, distribuindo a carga ao longo do tempo.Plan your UI flows to run at different times of the day, spreading your load over time. Isso funciona melhor se você tem um conjunto único ou limitado de computadores que podem executar cargas de trabalho e também pode controlar os gatilhos (por exemplo, fluxos agendados) que iniciam os fluxos de interface do usuário.This works best if you have a single or a limited set of machines that can run workloads, and you can control the triggers (for example, scheduled flows) that start your UI flows.
  2. Crie clusters de computadores que podem executar fluxos de interface do usuário com configurações idênticas em paralelo.Create clusters of machines that can run UI flows with identical configurations in parallel.
  3. Crie vários fluxos que usam uma conexão separada aos diferentes computadores de destino.Create multiple flows that each use a separate connection to target different machines.

Seguindo essas estratégias, você pode evitar que os fluxos de interface do usuário compitam para ser executados no mesmo dispositivo e, em alguns casos, falhem devido a tempos limite.By following these strategies, you can avoid having UI flows competing to run on the same device and in some cases failing due to timeouts.

Note

Se você estiver executando fluxos de interface do usuário no modo autônomo, será necessário não só antecipar o número de fluxos de interface do usuário que sua organização planeja executar em paralelo, mas também comprar uma quantidade adequada de complementos autônomos.If you are running UI flows in unattended mode, you will need to anticipate the number of UI flows your organization plans to run in parallel, and then purchase an adequate amount of Unattended Add-ons.

Executar novamente os fluxos de interface do usuário com falhaRerun failed UI flows

Caso uma execução de fluxo de interface do usuário falhe, corrija o problema e tente as seguintes etapas para executá-la novamente:If a UI flow run fails, correct the issue, and then try the following steps to rerun it:

  1. Acesse a página de detalhes e identifique a execução com falha.Go to the details page and identify the failed run.

  2. Selecione o botão Reenviar no menu ação.Select the Resubmit button from the action menu.

Solucionar problemas de falhasTroubleshoot failures

  1. Se o fluxo de interface do usuário autônomo falhar com a mensagem Não é possível criar uma sessão, siga as seguintes etapas para resolver o problema:If your unattended UI flow fails with the cannot create new session message, follow these steps to resolve the issue:

    • No Windows 10, confirme se você não tem uma sessão de usuário ativa que está bloqueada ou desbloqueada em seu dispositivo de destino.On Windows 10, confirm that you don’t have an active user session locked or unlocked on your target device.
    • No Windows Server 2016 ou no Windows Server 2019, confirme se você não atingiu o número máximo de sessões de usuário ativas que está configurado para o dispositivo.On Windows Server 2016 or Windows Server 2019, confirm you haven’t reached the maximum number of active user sessions that's configured for your device. Os fluxos de interface do usuário não poderão ser executados se não for possível criar sessões.UI flows won’t be able to run if it cannot create new sessions.
  2. Se você estiver executando fluxos de interface do usuário em um sistema operacional de um idioma diferente do inglês e receber uma mensagem 502 – Solicitação incorreta, confirme se seguiu as etapas para atualizar os fluxos de interface do usuário de versões anteriores.If you are running UI flows on a non-English language operating system and you receive a 502 - Bad request message, confirm you have followed the steps to upgrade your UI flows from preview.

  3. Se o status do gateway estiver offline, confirme se o dispositivo está ligado e conectado à Internet.If the gateway status is offline, confirm that the device is turned on and connected to the Internet. Você também pode solucionar problemas do gateway.You may also troubleshoot the gateway.

  4. Se o status do gateway estiver online, tente as seguintes ações:If the gateway status is online, try the following actions:

    • Confirme se o aplicativo de fluxos de interface do usuário e os serviços estão em execução no dispositivo.Confirm the UI flows app and services are running on your device.

    • Reinicie o serviço de fluxo de interface do usuário em seu dispositivo.Restart the UI flow service on your device.

Saiba MaisLearn more