Fluxo no código VS

Instale e configure a extensão UiPath para Visual Studio Code para criar, depurar e implantar fluxos a partir do seu espaço de trabalho local.

O que é

A extensão UiPath para Visual Studio Code permite criar, depurar e implantar fluxos do VS Code. Ele envia um editor visual para arquivos .flow , faz login no UiPath e empacota e publica seu trabalho no Orchestrator.

A tela, os nós, variáveis e a depuração funcionam da mesma maneira que funcionam no Studio Web. Esta página abrange o que é específico do VS Code: instalar a extensão, fazer login e empacotar a partir de seu espaço de trabalho local. Para saber como criar fluxos, consulte o restante deste guia, começando com Seu primeiro fluxo.

Antes de começar

Você precisa do seguinte:

• Código VS 1.110.0 ou superior.
• Uma conta da UiPath.
• Node.js e npm disponíveis em seu PATH. No primeiro login, a extensão instala o UiPath CLI (uip) com npm (npm install -g @uipath/cli@1.0.0).
• Acesso de rede ao seu ambiente da UiPath.

Observação:

Em espaços de trabalho remotos (Windows Subsystem for Linux (WSL), SSH, Codespaces ou contêineres dev), a extensão é executada no host remoto. O UiPath CLI deve ser instalado lá, não em sua máquina local.

Instalar a extensão

1. Instale o UiPath Maestro a partir do VS Code Marketplace ou Open VSX Registry.
2. Recarregue o VS Code quando solicitado.
3. Selecione o ícone da UiPath na Barra de atividades para abrir a visualização da UiPath.

A visualização da UiPath tem três seções:

• Conectar mostra seu status de login, ambiente e tenant.
• O Explorador de soluções lista as soluções, os projetos e os fluxos no espaço de trabalho.
• Recursos lista pastas e recursos do Orchestrator para o tenant selecionado depois que você faz login.

Entrar

A extensão faz você no processo, usando a biblioteca de autenticação UiPath incluída para executar um fluxo de navegador OAuth/Proof Key for Code Exchange (PKCE). A extensão nunca armazena seus tokens.

1. Na seção Conectar , selecione Entrar.
2. Se a CLI ainda não estiver instalada, aceite o prompt para instalá-la. A extensão executa npm install -g @uipath/cli@1.0.0.
3. Seu navegador é aberto para concluir o login. A biblioteca 8104 localhost
4. Depois de autorizar, retorne ao VS Code. Sua sessão é atualizada automaticamente a partir de então.

Para sair, selecione Sair na seção Conectar . Isso faz logout no processo e limpa a sessão em cache.

Observação:

O login usa a porta 8104 em localhost para o retorno de chamada do OAuth. Se o login falhar, um processo obsoleto pode estar contendo a porta. Libere-o e tente novamente. No macOS ou Linux, execute lsof -ti :8104 | xargs kill -9. No Windows, execute netstat -ano | findstr :8104 para encontrar o ID do processo, depois taskkill /F /PID <id>.

Selecione seu ambiente e tenant

Depois de fazer login, escolha onde você está trabalhando.

1. Executar o UiPath: selecione Ambiente para confirmar seu ambiente. O padrão é Cloud.
2. Executar a UiPath: selecione Tenant para escolher seu tenant ou organização.

A seção Recursos permite que você navegue por pastas e recursos para o tenant selecionado.

Resultado: a seção Recursos preenche com pastas e recursos do Orchestrator para seu tenant selecionado.

Criar ou abrir um fluxo

• Execute Fluxo: Novo Fluxo (Ctrl/Cmd+Alt+N) para criar um arquivo .flow .
• Abra um arquivo .flow existente no Explorer ou execute Fluxo: Abrir Fluxo (Ctrl/Cmd+Alt+O).
• Com uma solução aberta, selecione Adicionar fluxo na barra de título do Explorador de soluções para adicionar um fluxo ao projeto ativo.

O arquivo será aberto no editor de fluxo visual. Crie, conecte nós e configure-os exatamente como faria no Studio Web.

Criar pacote e implantar

Você publica a partir do VS Code empacotando seu espaço de trabalho como uma solução da UiPath e implantando-o no Orchestrator. Consulte Implantação de um fluxo para saber o que a implantação faz.

• UiPath: o pacote cria uma solução .uipx a partir do espaço de trabalho atual.
• UiPath: implantar carrega uma solução empacotada no Orchestrator.
• UiPath: empacotar e implantar executa as duas etapas em conjunto.
• UiPath: Switch Deploy Target altera a pasta de destino.

Por padrão, a extensão ativa a implantação após uma implantação bem-sucedida. Para implantar sem ativar, desative a configuração uipath.autoActivateDeployment .

Para executar o mesmo pacote do UiPath CLI, execute UiPath: Generate.env File. Isso grava um arquivo .env compatível com uip.

Depuração

A depuração no VS Code roteia por meio do seu tenant do Cloud selecionado. Execute um fluxo do editor e assista à execução na visualização de depuração ao vivo, a qual renderiza um fluxograma de execução sereia que é atualizado à medida que a execução avança. Consulte Depuração eficaz para saber como ler uma execução e resolver falhas.

Comandos e atalhos de teclado

Execute qualquer comando da Paleta de Comandos (Ctrl/Cmd+Shift+P). Os atalhos do editor de fluxo se aplicam apenas quando um arquivo .flow é o editor ativo.

Editor de fluxo

Command	Associação de tecla padrão
Fluxo: novo fluxo	Ctrl/Cmd+Alt+N
Fluxo: abrir fluxo	Ctrl/Cmd+Alt+O
Fluxo: salvar fluxo	Ctrl/Cmd+S
Fluxo: salvar fluxo como	Ctrl/Cmd+Shift+S
Fluxo: desfazer	Ctrl/Cmd+Z
Fluxo: refazer	Ctrl+Y / Cmd+Shift+Z
Fluxo: Zoom In	Ctrl/Cmd+=
Flow: Zoom Reduzir	Ctrl/Cmd+-
Fluxo: redefinir o Zoom	Ctrl/Cmd+0
Fluxo: ajustar à tela	Ctrl/Cmd+Shift+F
Fluxo: validar fluxo	Ctrl/Cmd+Shift+V
Fluxo: exportar fluxo	Nenhum

UiPath Platform

Command	Description
UiPath: entrar	Faça login no UiPath.
UiPath: sair	Saia e limpe a sessão em cache.
UiPath: selecione ambiente	Escolha o ambiente UiPath.
UiPath: selecionar tenant	Escolha o tenant ou a organização.
UiPath: pacote	Crie uma solução .uipx a partir do espaço de trabalho.
UiPath: implantar	Carregue uma solução empacotada para o Orchestrator.
UiPath: empacotar e implantar	Empacote e implante em uma etapa.
UiPath: alternar o destino de implantação	Altere a pasta de destino.
UiPath: gerar.env Arquivo	Grave um arquivo .env compatível com CLI.
UiPath: atualizar	Atualize a árvore Connect.
UiPath: Mostrar log de saída	Abra o canal de saída da UiPath.
UiPath: introdução	Abra o guia Introdução.

Para obter o conjunto completo de atalhos de tela, consulte Atalhos de teclado.

Configurações

Configure a extensão nas configurações do VS Code.

uipath.environment

O ambiente do UiPath usado ao fazer login. O padrão é cloud. Uma sessão de CLI existente terá precedência se apontar para outro lugar.

uipath.autoActivateDeployment

Ativa uma implantação da solução após uma implantação bem-sucedida. O padrão é true.

uipath.cli.path

Um caminho absoluto para o binário da UiPath CLI (uip). Deixe vazio para encontrar uip no seu PATH. Defina isso quando a CLI estiver instalada em um local que não está em seu PATH.

uipath.telemetry.enabled

Envia a telemetria de uso anônimo. O padrão é true. A extensão também respeita telemetry.telemetryLevel global do VS Code. Desativar qualquer configuração desabilita a telemetria.

Solução de problemas

Falha no logon

O logon falha quando a porta de retorno de chamada OAuth está ocupada ou a CLI perdeu sua sessão.

• Porta em uso. A CLI usa a porta 8104 em localhost para o retorno de chamada. Se um processo obsoleto o retiver, libere a porta e faça login novamente. No macOS ou Linux, execute lsof -ti :8104 | xargs kill -9. No Windows, execute netstat -ano | findstr :8104 e, em seguida, taskkill /F /PID <id>.
• Sessão obsoleta. Execute UiPath: Sair e, em seguida, UiPath: Entrar novamente para forçar um novo login.
• Leia o log. Executar UiPath: Mostrar Log de Saída e verificar o canal de saída do UiPath para erros de login.

A CLI não foi encontrada

A extensão shells para uip. Se não for possível localizar o binário, o login e o empacotamento falharão.

1. Confirme se a CLI está instalada executando uip --version em um terminal.
2. Se uip não estiver no seu PATH, defina uipath.cli.path como o caminho absoluto do binário.
3. Se a CLI não estiver instalada, execute UiPath: faça login e aceite o prompt de instalação ou instale-a manualmente com npm install -g @uipath/cli@1.0.0. Isso requer Node.js e npm em seu PATH.

Espaços de trabalho remotos não veem a CLI

Nos espaços de trabalho do WSL, SSH, Codespaces e contêiner dev, a extensão é executada no host remoto, não na sua máquina local. O binário uip deve ser instalado nesse host. Uma CLI instalada em sua máquina local do Windows ou macOS não é visível para a extensão. Instale a CLI no espaço de trabalho remoto e, em seguida, faça login novamente.

A implantação não ativa

Por padrão, a extensão ativa uma implantação após uma implantação bem-sucedida. Se uma implantação for carregada, mas não for ativada, confirme se uipath.autoActivateDeployment está ativado.

Páginas relacionadas

• Seu primeiro fluxo
• Implantação de um fluxo
• Depuração eficaz