UiPath Documentation
uipath-cli
latest
false
UiPath CLI 用户指南
重要 :
请注意,此内容已使用机器翻译进行了本地化。 新发布内容的本地化可能需要 1-2 周的时间才能完成。

UIP 解决方案上传

“uip solution upload”的语法和选项,用于捆绑本地解决方案并将其发送到 Studio Web 进行基于浏览器的编辑。

uip solution upload用于将本地解决方案上传到UiPath Studio Web ,以便通过浏览器进行编辑。它将解决方案捆绑到内部.uis存档中,将其发送到 Studio Web,并(在成功时)打印一个可以直接在设计器中打开的 URL。

与生成可用于 Orchestrator upload uip solution pack + uip solution publish不同, .zip针对交互式Studio Web创作界面。当您想继续在浏览器中以协作方式编辑解决方案时,请使用此选项。

如果 Studio Web 上已存在解决方案(由其SolutionId中的.uipx匹配),则上传并覆盖现有副本;否则,系统会将其作为新的解决方案导入,并将返回的 ID 写回本地.uipx ,以便后续上传的内容更新。

大纲​

uip solution upload <solutionPath> [--force] [--no-snapshot] [--login-validity <minutes>]
uip solution upload <solutionPath> [--force] [--no-snapshot] [--login-validity <minutes>]

该命令遵循全局选项,并返回标准退出代码。

参数​

  • <solutionPath> (必填项) — 以下之一:
    • 包含.uipx清单的解决方案目录(最常见)。
    • .uipx文件(该命令将解析包含该文件的目录)。
    • .uis文件(预捆绑的解决方案存档;按原样上传以实现向后兼容性)。

选项​

  • --force — 跳过存在性检查,直接覆盖由捆绑的 SolutionId 命名的 Studio Web 解决方案。通常不需要 — 上传内容会自行覆盖现有的云解决方案。如果该解决方案不存在,则失败。未捆绑 SolutionId 时无效(未捆绑 .uis 存档):上传作为新文件导入。
  • --no-snapshot — 在替换内容之前,不要录制 Cloud 解决方案的可恢复覆盖前版本。自上次上传后在 Studio Web 中所做的更改将丢失;本地文件不受影响。当上传导入新的解决方案时,无效。
  • --login-validity <minutes> — 令牌过期前触发刷新的最短分钟数。默认为10 。

示例​

最小​

uip solution upload ./my-solution
uip solution upload ./my-solution

上传特定的.uipx​

uip solution upload ./workspace/my-solution/my-solution.uipx
uip solution upload ./workspace/my-solution/my-solution.uipx

在没有可还原快照的情况下进行覆盖​

uip solution upload ./my-solution --no-snapshot
uip solution upload ./my-solution --no-snapshot

脚本编写 — 打开返回的设计器 URL​

URL=$(uip solution upload ./my-solution --output-filter "Data.DesignerUrl" --output plain)
open "$URL"   # macOS
URL=$(uip solution upload ./my-solution --output-filter "Data.DesignerUrl" --output plain)
open "$URL"   # macOS

数据形状(--输出 json)​

Studio Web 没有包含捆绑 SolutionId 的解决方案,因此将其作为新资源导入,并使用分配的 ID 更新本地 .uipx:

{
  "Code": "SolutionUpload",
  "Data": {
    "Status": "Uploaded successfully",
    "Action": "Imported",
    "SolutionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "DesignerUrl": "https://cloud.uipath.com/myorg/mytenant/studio_/designer/p1?solutionId=a1b2c3d4-0000-0000-0000-000000000001",
    "LocalSolutionIdUpdated": {
      "Path": "/workspace/my-solution/my-solution.uipx",
      "From": "00000000-0000-0000-0000-0000000000ff",
      "To": "a1b2c3d4-0000-0000-0000-000000000001"
    },
    "Response": { }
  }
}
{
  "Code": "SolutionUpload",
  "Data": {
    "Status": "Uploaded successfully",
    "Action": "Imported",
    "SolutionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "DesignerUrl": "https://cloud.uipath.com/myorg/mytenant/studio_/designer/p1?solutionId=a1b2c3d4-0000-0000-0000-000000000001",
    "LocalSolutionIdUpdated": {
      "Path": "/workspace/my-solution/my-solution.uipx",
      "From": "00000000-0000-0000-0000-0000000000ff",
      "To": "a1b2c3d4-0000-0000-0000-000000000001"
    },
    "Response": { }
  }
}

该解决方案已存在于 Studio Web 上,因此系统会就地覆盖其,同时替换的内容会首先记录为可恢复的版本:

{
  "Code": "SolutionUpload",
  "Data": {
    "Status": "Uploaded successfully",
    "Action": "Overwritten",
    "SolutionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "DesignerUrl": "https://cloud.uipath.com/myorg/mytenant/studio_/designer/p1?solutionId=a1b2c3d4-0000-0000-0000-000000000001",
    "SnapshotCreated": true,
    "Response": { }
  }
}
{
  "Code": "SolutionUpload",
  "Data": {
    "Status": "Uploaded successfully",
    "Action": "Overwritten",
    "SolutionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "DesignerUrl": "https://cloud.uipath.com/myorg/mytenant/studio_/designer/p1?solutionId=a1b2c3d4-0000-0000-0000-000000000001",
    "SnapshotCreated": true,
    "Response": { }
  }
}
  • Action — "Imported"(适用于首次上传);"Overwritten"(当 Studio Web 上已存在包含该 SolutionId 的解决方案时)。
  • SolutionId — 分配(在首次上传时)或匹配(在覆盖时)的 Studio Web 身份。同时也写回本地.uipx ,以便下一个upload更新同一解决方案。
  • DesignerUrl — 解决方案中第一个项目的可打开 URL,已预先限定为解决方案。null/Studio Web 未返回项目 ID 时出现缺失。
  • LocalSolutionIdUpdated — 仅当将新的 SolutionId 写回本地 .uipx(Path、From、To)时才存在。就地覆盖或上传源没有要重写的先前 ID 时不存在。
  • SnapshotCreated — 仅在记录可恢复的覆盖前版本的覆盖上显示和 true(即未通过 --no-snapshot)。由于没有任何内容可创建快照,因此在全新导入中缺失。
  • Response — 原始 Studio Web 响应有效负载。用于调试;不是稳定合同的一部分。

副作用​

  • 绑定同步。在上传之前, upload会重新扫描每个项目的bindings_v2.json并协调解决方案的资源声明,效果相当于运行uip solution resources refresh 。
  • 连接覆盖。上传后,在解决方案的resources/solution_folder/connection/目录中检测到的任何连接覆盖项都将针对经过身份验证的用户的“个人工作区”文件夹修补到 Studio Web。此处的失败将记录为警告,不会导致命令失败。
  • 解决方案 ID 回写。全新上传时,返回的解决方案 ID 将替换(或填充)本地.uipx中的SolutionId字段。

另请参阅​

此页面有帮助吗?

连接

需要帮助? 支持

想要了解详细内容? UiPath Academy

有问题? UiPath 论坛

保持更新