Picture in picture

A funcionalidade Picture-in-Picture permite que você execute processos assistidos em colaboração com o Robô. Um processo iniciado no modo Picture-in-Picture será executado em uma sessão do Windows isolada, permitindo que você use a máquina enquanto o processo estiver em execução.

You can start a process in Picture-in-Picture mode either from the Debug tab in Studio, from StudioX, or directly from the UiPath Assistant from the Contextual Menu of a process.

Observação:

O tempo limite padrão para iniciar um processo em uma sessão PiP é de 180 segundos. Se o login na sessão Picture-in-Picture levar mais tempo que isso, um erro de tempo limite será disparado. Esse tempo limite padrão pode ser alterado usando uma variável de ambiente UIPATH_PIP_SESSION_TIMEOUT na máquina.

Ao usar o Robô no Modo de Serviço, certifique-se de definir a variável UIPATH_PIP_SESSION_TIMEOUT como uma variável de ambiente do sistema e reiniciar o Serviço do Robô.

Após um processo ser iniciado no modo Picture-in-Picture, uma janela de visualização aparece em sua área de trabalho, fornecendo feedback em tempo real da execução do processo. A janela de exibição pode ser redimensionada, movida para o lado, colocada em tela cheia ou por cima de outras janelas. Você pode sair do modo Picture-in-Picture a qualquer momento, clicando com o botão direito do mouse na entrada Picture-in-Picture da Barra de Tarefas do Windows e selecionando Fechar Janela, ou simplesmente fechando a janela. Uma caixa de diálogo de confirmação aparece e ao escolher fechar a janela do PiP, encerra o processo em execução.

Observação:

São necessários direitos de administrador para habilitar o recurso Picture-in-Picture na máquina. Isso é necessário apenas na primeira vez que o Picture-in-Picture for usado, posteriormente, o processo real poderá ser iniciado em Picture-in-Picture sem necessidade de privilégios elevados.

Controles

Os seguintes controles estão disponíveis para a janela do PiP:

• - Habilite isso para assumir o controle da sessão PiP, caso esteja desabilitado, o mouse e o teclado funcionam apenas na sessão principal.

• - Habilite isso para manter a janela PiP acima do outros aplicativos, mesmo quando estiver fora do foco.

• Minimizar - minimiza a janela PiP para a barra de tarefas da sessão principal, sem interromper o processo.

• Maximizar - maximiza a janela PiP.

• Fechar - Fecha a janela PiP, interrompe qualquer processo em execução e faz o logoff da sessão do PiP.

  

Quando você inicia uma sessão Picture-in-Picture, uma solicitação aparece para que você insira suas credenciais do Windows. Observe que, se você reiniciar a máquina, você não será solicitado a fornecer as credenciais novamente.

Marcando um processo como pronto para o PiP

Na seção Configurações do Projeto no Studio, um processo pode ser marcado como Pronto para o PiP, o que significa que ele foi testado e pode ser executado com segurança em uma Sessão de PiP. Você também pode definir que um processo seja iniciado por padrão em uma sessão Picture-in-Picture.

Usando o PiP para Atividades de Invoke

Atividades de Invoke como o Invoke Process, Invoke Workflow e Run Parallel Process, possuem a opção de escolher onde iniciar o novo processo.

Isso pode ser definido na aba Propriedades da atividade, em Misc > Sessão de Destino dentro do Studio.

Observação:

A propriedade Target Session pode ser modificada apenas no Studio. Os projetos desenvolvidos no StudioX precisam ser abertos no Studio para alterar essa propriedade.

As opções são:

• Atual - O processo filho será aberto na mesma sessão que o processo pai

• Processo Padrão - O processo filho usa as Configurações de Processo

• Principal - O processo filho é iniciado na sessão principal, independentemente de onde o processo pai for executado

• Picture-in-Picture — o processo filho começa na sessão Picture-in-Picture, independentemente de onde o processo pai está sendo executado

  

Acesso à funcionalidade Picture in Picture

Do Studio: acesse a guia Depurar e, em seguida, selecione a opção Picture in Picture .

Do UiPath Assistant: para a automação desejada, selecione a guia Configurar e, em seguida, ative a alternância Executar em PiP .

Habilitação do PiP

A funcionalidade Picture-in-Picture da máquina pode ser habilitada por meio da linha de comando ou manualmente, ao iniciar a sessão do PiP pela primeira vez na máquina.

Método	Command	Description
Manualmente		A primeira vez que você iniciar uma sessão do Picture-in-Picture no Studio ou UiPath Assistant, será solicitado que você habilite a funcionalidade do PiP na máquina. Isso exige direitos de administrador.
Linha de comando	UiRobot.exe PiP	Permite que você habilite ou desabilite a funcionalidade Picture-in-Picture na máquina. Essa configuração é aplicada na máquina local e afeta todos os usuários, além de ser usada para modificar instalações existentes. Ela pode conter os seguintes parâmetros: PiP --enable Habilita a funcionalidade Picture-in-Picture da máquina. PiP --disable Desabilita a funcionalidade Picture-in-Picture da máquina. Exemplo: UiRobot.exe PiP --Enable São necessários direitos de administrador para executar esses comandos.
Linha de comando	UiPathStudio.msi ENABLE_PIP	Permite que você habilite a funcionalidade Picture-in-Picture da máquina durante a instalação por linha de comando da UiPath. Para habilitá-la, use o seguinte parâmetro: ENABLE_PIP=1 Exemplo: UiPathStudio.msi ADDLOCAL=DesktopFeature,Studio,Robot,RegisterService,Packages ENABLE_PIP=1

Problemas e Limitações Conhecidas

Há algumas coisas a serem levadas em consideração ao usar o recurso Picture-in-Picture:

• Se você estiver usando um PIN para fazer login na sessão principal do Windows, você será solicitado por suas credenciais, sempre que iniciar uma sessão Picture-in-Picture.
• Quando a sessão Picture-in-Picture é aberta, os programas de inicialização também são abertos na sessão do PiP. Por isso, algumas configurações para dispositivos periféricos podem ser redefinidas para seus valores padrão (como configurações de iluminação para teclado e mouse).
• Se você habilita a Sessão de Área de Trabalho Remota quando o prompt aparece, enquanto estiver executando um processo de PiP, você precisa sair e fazer o logoff na Sessão principal do Windows para que as alterações entrem em vigor.
• A máquina não pode ser reiniciada ou desligada, enquanto a sessão PiP estiver aberta, pois a sessão PiP precisará ser fechada primeiramente.
• Devido a limitações do Sistema Operacional para executar o Picture-in-Picture, as edições Home Edition do Windows 8 e 10 não são suportadas.
• A área de transferência é compartilhada entre a sessão PiP e a sessão principal.
• Executar como administrador não pode ser usado na sessão PiP.
• Apenas uma sessão Picture-in-Picture pode ser iniciada por vez.
• Para um usuário iniciar uma sessão do PiP, ele deve receber permissões Allow Log On Locally.

Automação do Microsoft Office

Automações que usam os recursos do Microsoft Office, não executam com sucesso no Picture-in-Picture, se os recursos já estiverem abertos na sessão principal. Para garantir que as automações sejam executadas de forma suave no PiP, você poderá fazer o seguinte:

• Feche o recurso usado pelos aplicativos do Microsoft Office na sessão principal, para que eles possam ser abertos na sessão PiP.
• Use an InvokeIsolatedWorkflow activity to invoke the part of the automation using Microsoft Office and set its Target Session to Picture-in-Picture from Studio.

Usando o Navegador Web em Sessões PIP

Os dados do navegador de uma sessão Picture-in-Picture são salvos na sessão principal por padrão. Se houver uma instância aberta do Google Chrome ou do Microsoft Edge na sessão principal, ele terá que usar outro perfil de usuário no PiP. Isso é feito automaticamente pela atividade Open Browser. Não é possível ter um navegador específico (digamos, o Chrome) aberto com o mesmo perfil de usuário, tanto na sessão PiP, como na sessão Principal, ao mesmo tempo.

No entanto, o modo e o local dos dados do navegador podem ser configurados, a partir das propriedades Abrir Browser da atividade.

Configurar a propriedade UserDataFolderMode como Automatic permite que o navegador use pastas de dados do usuário separadas nas sessões principal e PiP.

Observe que, se você limpar os dados do usuário da pasta %LocalAppData%\UiPath\PIP Browser Profiles neste modo, a extensão do navegador correspondente precisará ser habilitada novamente.

Caso você precise usar dados da sessão principal (como cookies ou senhas salvas), considere definir a propriedade UserDataFolderMode como DefaultFolder. Isso significa que as sessões principais e do PiP usam a mesma pasta para os dados do usuário do navegador.

Observação:

Ao definir o UserDataFolderMode como DefaultFolder, o navegador irá funcionar em apenas uma sessão por vez. Se o navegador estiver aberto na sessão principal, ele não funciona na sessão PiP. Isso ocorre porque o mesmo perfil do navegador não pode ser usado em duas sessões simultaneamente.

Observação:

Target Session e UserDataFolderMode são propriedades que podem ser modificadas apenas no Studio. Os projetos desenvolvidos no StudioX precisam ser abertos no Studio para alterar essas propriedades.

Configurar a propriedade UserDataFolderMode para CustomFolder, permite que você especifique diferentes pastas de dados do usuário para as sessões principal e de PiP.

Observação:

The browser extension needs to be installed per machine in order to work by default in PiP browsers. Otherwise, you must install it in the PiP session.

O PiP Requer login todas as vezes

Com base no seu ambiente, determinadas políticas do Windows podem fazer com que a sessão PiP solicite um login sempre que ele for inicializado.

Por exemplo, a seguinte configuração definida como Disabled faz com que a janela PiP solicite credenciais toda vez que for iniciada:

• Local Group Policy\Computer Configuration\Administrative Templates\System\Credential Delegation\Allow delegating default credentials

  Isso também acontece quando o PIN de Hello do Windows Business é usado. A autenticação PIN só funciona na primeira vez que uma sessão PiP é lançada. Depois disso, a sessão PiP só pode ser autenticada usando nome de usuário e senha.

Autenticação do SmartCard

Se seu ambiente exigir logon com um smartcard, a seguinte política deve notser definida como Enabled:

• Computer Configuration\Administrative Templates\Windows Components\Remote Desktop Services\Remote Desktop Session Host\Device and Resource Redirection\Do not allow smart card device redirection

O fluxo de trabalho leva muito tempo para iniciar no PiP

Ao iniciar um processo no PiP pela primeira vez, ele leva mais tempo do que o habitual até a execução real começar. Isso acontece porque a sessão do PiP precisa iniciar todos os seus processos do Windows e programas de inicialização.

Recomendação: inicie uma sessão PiP quanto ligar a máquina e a mantenha aberta ao longo do dia. Isso utiliza menos recursos do que iniciar uma nova sessão PiP para cada processo.

A sessão do PiP não inicia

Algumas políticas do Windows podem restringir o início da sessão do PiP. Para evitar isso, o usuário que estiver iniciando uma sessão do PiP deve fazer parte das seguintes políticas:

• Computer Configuration\Windows Settings\Security Settings\Local Policies\User Rights Assignment\Allow Log On Locally

• Computer Configuration\Windows Settings\Security Settings\Local Policies\User Rights Assignment\Access this computer from the network

  Observação:

  Atualmente estamos investigando para encontrar outras políticas que possam afetar a funcionalidade PiP.

Cliente VPN não trabalhando no PiP

Quando clientes VPN são usados em conjunto com o PiP, há algumas situações nas quais podem ocorrer conflitos. Por exemplo, se os clientes VPN estiverem configurados para iniciar quando o usuário fizer login, quando o PiP iniciar, outra instância do cliente VPN será iniciada. Isso causa um conflito entre as duas sessões, pois o cliente VPN está definido para executar uma única instância por usuário.

Para resolver esses cenários, compilamos uma lista dos provedores VPN mais comuns com suas particularidades, além de resoluções para os problemas conhecidos que possam ocorrer.

Cisco Anyconnect

Comportamento Observado

Quando o cliente do Cisco Anyconnect estiver sendo executado na máquina do usuário e uma sessão PiP for iniciada, outro cliente do Cisco Anyconnect será iniciado na sessão PiP.

Cause The Cisco VPN server is set to accept one session per user at a time. When the PiP session starts, Cisco Anyconnect disconnects the VPN in the main session and throws an error in the PiP session.

Isso desabilita a conexão VPN do usuário, impedindo o usuário de acessar serviços que exijam uma conexão VPN.

Resolution Do not set the VPN client to start automatically at Windows start-up. This stops the VPN client from starting a new connection when the PiP session starts and tunnels the PiP traffic through the main Windows session.

Zscaler

Comportamento Observado

Quando a sessão PiP é iniciada, outro cliente do Zscaler é iniciado na sessão PiP. Isso faz com que o cliente do Zscaler desapareça da sessão principal do Windows. Tudo funciona como esperado até o usuário fechar a sessão PiP. Quando a sessão PiP é fechada, o cliente Zscaler permanece em estado de limbo e o usuário tem que sair e entrar novamente ou reiniciar a máquina para abrir o Zscaler.

Cause We are currently investigating this behavior with Zscaler to find the cause. Resolution We are currently investigating this behavior with Zscaler to find a resolution.

Pulse secure

Comportamento Observado

Quando uma sessão PiP é iniciada, o usuário é desconectado da VPN.

Cause The Pulse secure client cannot handle two Windows sessions for the same user. Resolution We recommend opening a ticket with Pulse Secure team.

Palo Alto Global Protect

Quando o PiP é iniciado, a GUI mostra o usuário desconectado da VPN em ambas as sessões. Mas a sessão PiP ainda está conectada à VPN.

Resolution We recommend opening a ticket with Palo Alto team.

PIP e Servidores Windows

Em um cenário em que vários usuários estão conectados a um Windows Server ao mesmo tempo, apenas uma sessão PIP pode ser iniciada na máquina. Isso significa que apenas uma sessão PiP pode ser aberta em uma única máquina, independentemente de qual usuário ou tipo de sessão foi usado para abrir a sessão PiP.

PIP e outros ambientes virtualizados

Em outros ambientes virtualizados, como AppV ou Citrix XenApps, a funcionalidade de PIP não está disponível.