UiPath Documentation
maestro-automate
latest
false
Maestro Automate 用户指南

在 VS Code 中构建

如何使用 UiPath 扩展程序在 Visual Studio Code 中构建、调试和部署工作流,包括安装和登录到命令和设置。

UiPath for Visual Studio Code扩展程序将流画布添加到免费的代码编辑器 Visual Studio Code (VS Code) 中。该方法会在可视化编辑器中打开扩展名为.flow工作流文件,让您登录到 UiPath,并将您的工作部署到 UiPath Automation Cloud。

每种环境中的流画布、节点、变量和调试均相同。此页面介绍 VS Code 的专属内容:安装扩展程序、登录和从本地工作区部署。您的第一个工作流将从头到尾构建一个工作流。

开始之前​

您需要:

  • VS 代码 1.110.0或更高版本。
  • UiPath 帐户。“注册”介绍了如何创建注册。
  • 通过互联网访问 UiPath Automation Cloud。
  • 用于运行和安装命令行程序的工具Node.js和 npm,以便终端可以找到它们。首次登录时,扩展程序使用 npm 安装 UiPath 命令行工具uip ( npm install -g @uipath/cli )。

如果您在远程工作区中工作,例如适用于 Linux 的 Windows 子系统 (WSL)、SSH、Codespaces 或开发容器,则扩展程序将在远程主机上运行。在此处(而不是在本地计算机上)安装 Node.js 和 npm,以便也在远程主机上安装 UiPath CLI。

安装扩展程序​

  1. 从 VS Code Marketplace 或 打开 VSX 注册表 安装 UiPath Maestro 。
  2. 在系统提示时重新加载 VS Code。
  3. 选择活动栏中的UiPath图标,打开 UiPath Maestro 视图。

UiPath Maestro 视图包含以下部分:

  • “连接”显示登录用户、连接状态以及您所在的组织和租户。
  • 新建,其下方可显示工作区中的解决方案、项目和工作流。
  • 资源通过搜索框列出租户已有的资源,例如已部署的流程。
  • “问题”列出了工作流中存在的问题。
  • “构建和部署”显示包状态、 “部署”按钮和部署历史记录。

登录​

扩展程序将通过网页浏览器帮助您登录。它从不存储您的令牌。

  1. 在“连接”部分中,选择“ 登录 ” 。
  2. 如果尚未安装 CLI,请接受安装提示。扩展程序运行npm install -g @uipath/cli 。
  3. 您的浏览器将打开以完成登录。扩展程序通过您计算机的端口8104接收结果。
  4. 授权后,返回到 VS Code。此后,您的会话将自动刷新。

要退出登录,请在“连接”部分选择“退出登录” 。这将导致您从进程中注销并清除缓存的会话。

备注:

登录使用8104上的端口localhost进行 OAuth 回调。如果登录失败,则过时的流程可能占用端口。将其释放,然后重试。在 macOS 或 Linux 上,运行lsof -ti :8104 | xargs kill -9 。在 Windows 中,运行netstat -ano | findstr :8104以查找流程 ID,然后运行taskkill /F /PID <id> 。

选择您的环境和租户​

登录后,选择您现在的工作地点。从“命令面板”运行命令:按Ctrl/Cmd+Shift+P ,输入命令名称并选择。

  1. 运行UiPath:选择“环境”以确认您的环境。默认为 Cloud。
  2. 运行UiPath:选择“租户”以选取您的租户。“连接”部分会显示租户所属的组织。

要稍后切换租户,请在“连接”部分中选择组织和租户旁边的箭头。

然后,您可以在“资源”部分浏览所选租户的文件夹和资源。

结果: “资源”部分将列出所选租户的文件夹和资源。

创建或打开工作流​

创建项目:

  1. 在“UiPath Maestro”视图中,选择“新建” 。

  2. 在“新建项目”列表中,选择“Maestro Automate” 。该列表中还提供了Maestro Orchestrate和Data Fabric (预览版)。

项目在“流”画布上打开,底部工具栏显示Maestro Automate 。

要打开现有工作流,请在资源管理器中选择其.flow文件,或运行“流程:打开流程” ( Ctrl/Cmd+Alt+O )。

您可以在同一工作区中创建和编辑 Data Fabric 实体,这些实体对工作流读取和写入的数据进行建模,并提供预览功能。VS Code 中的实体介绍了操作方法。Studio Web 可打开包含实体项目的解决方案。

使用 Autopilot 构建​

Autopilot (预览版)在 VS Code 中作为单独的扩展程序UiPath Autopilot发布,由 UiPath 发布。要安装该扩展程序,请打开“扩展程序”视图( Ctrl+Shift+X或 macOS 上的Cmd+Shift+X ),搜索“UiPath Autopilot” ,然后选择“安装” 。然后使用“UiPath Autopilot 登录”:在“命令面板”中登录,然后使用UiPath Autopilot 打开聊天:打开 Autopilot 。描述工作流,和 Autopilot 构建该工作流。

验证工作流​

在您编辑时,UiPath Maestro 视图的“问题”部分和 VS Code 的“问题”面板中会显示验证错误和警告。

选择任何条目以直接导航到画布上的问题节点,包括子流中的节点。要按需验证(而不是等待面板更新),请运行“流程:验证流程” ( Ctrl/Cmd+Shift+V )。

部署工作流​

从 VS Code 部署会将工作区打包为 UiPath 解决方案,并将其部署到 UiPath Automation Cloud。部署工作流描述了部署的作用。

在 "UiPath Maestro" 视图的“构建和部署”部分中,选择“部署” 。它打包解决方案并一步部署。“部署”旁边的箭头单独提供了每个步骤:

  • “打包”操作仅会构建包,而不对其进行部署。
  • 部署仅部署您已构建的包。

部署后, “构建和部署”部分会显示最后一个包的状态以及部署的历史记录。

您还可以从“命令面板”运行这些操作,该面板打开时为Ctrl+Shift+P ,在 macOS 上为Cmd+Shift+P 。例如,运行“UiPath:打包和部署” 。VS Code 扩展程序会列出每个命令。

默认情况下,扩展程序会在成功部署后激活部署。要部署而不激活,请关闭uipath.autoActivateDeployment设置。

要从 UiPath CLI 运行相同的包,请运行“UiPath:生成.env 文件” 。这将写入与uip兼容的.env文件。

测试工作流​

在画布底部工具栏中选择“运行调试”。对话框询问触发器输入的值,例如productId和customerId 。输入这些信息并开始运行。工作流在您选择的租户中运行,随着运行的进行,每个节点都在画布上显示其状态。

画布下方的“执行”选项卡显示在运行之后:

  • “调试运行”列出了运行测试及其状态和持续时间。
  • 执行追踪记录按顺序列出每个运行节点及其所花费的时间。展开智能体节点,即可查看其智能体运行和模型调用。
  • 该运行的详细信息显示其变量、故障和元数据。

其他选项卡(数据集) 、评估程序和评估运行用于保存您的评估。要将测试运行转换为评估数据点,请选择底部工具栏中的 Bottle 图标“添加数据点以运行评估” 。评估描述了其工作方式。

调试基础知识介绍了如何读取运行和解决故障。

后续步骤​

此页面有帮助吗?

连接

需要帮助? 支持(opens in new window)

想要了解详细内容? UiPath Academy(opens in new window)

有问题? UiPath 论坛(opens in new window)

保持更新