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).
• Acesso de rede ao seu ambiente da UiPath.

Observação:

Criar e editar entidades do Data Fabric no VS Code é um recurso de Visualização. Está disponível apenas no VS Code — o Studio Web pode abrir uma solução que contém um projeto de entidade, mas não pode editar a própria entidade.

O local em que a extensão é executada também afeta como ela é configurada. A observação a seguir aplica-se quando você trabalha em um ambiente remoto, em vez de em sua máquina local.

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.
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.

Você também pode modelar entidades do Data Fabric no mesmo espaço de trabalho. Consulte Entidades no código VS.

Validate a flow

Flow validation errors and warnings appear in VS Code's Problems panel alongside your project's other diagnostics as you edit.

Select any entry to navigate directly to the offending node on the canvas, including nodes inside subflows. To validate on demand instead of waiting for the panel to update, run Flow: Validate Flow (Ctrl/Cmd+Shift+V).

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: Criar novo projeto	Adicione um projeto à solução. Escolha Data Fabric para criar um projeto de entidade.
UiPath: novo arquivo	Adicione um arquivo a um projeto. Escolha Arquivo de entidade para adicionar uma entidade.
UiPath: adicionar arquivo da entidade	Adicionar outra entidade a um projeto de entidade existente. Disponível quando a solução tiver um.
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. 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
• Entidades no Código VS
• Implantação de um fluxo
• Depuração eficaz