UIP AOPS 项目

“uip aops project”和“uip aops solution”的语法和选项，用于检查通过 SourceControl 连接发现的自动化项目和 Studio 解决方案。

uip aops project 检查单个自动化项目的文件、内容和提交历史。uip aops solution 对 Studio 解决方案执行相同的操作。对于基础 Git 存储库，两者都是只读的 — 首先使用connection projects / connection solutions发现标识符。有关共享概念，请参阅uip aops概述。

大纲

uip aops project list [--connections <csv>] [--target-framework <name>] [--project-type <type>] [--offset <n>] [--limit <n>] [--search <term>]
uip aops project get --project-id <id> [--reference <ref>] [--with-branches]
uip aops project files --project-id <id> [--path <path>] [--reference <ref>]
uip aops project content --project-id <id> --path <path> [--reference <ref>]
uip aops project commits --project-id <id> [--path <path>] [--branch <name>] [--offset <n>] [--limit <n>] [--search <term>]
uip aops project commit --project-id <id> --reference <sha>

uip aops solution get <solution-id>
uip aops solution commits <solution-id> [--path <path>] [--branch <name>] [--offset <n>] [--limit <n>] [--search <term>]

UIP AOPS 项目列表

列出每个可见的“来源控件”连接中的项目（交叉连接聚合器 — 大多数其他project动词按--project-id定位一个项目）。

选项

长	值	描述
--connections <csv>	逗号分隔	要扇出的目标连接标识符。默认为每个可见连接。
--target-framework <name>	字符串	项目目标框架上的服务器端筛选器。
--project-type <type>	字符串	按项目类型划分的服务器端筛选器，例如Process、Library、Agent。
--offset <n>	整数	每个连接跳过的数量。必须是 --limit 的倍数。默认 0。
--limit <n>	整数	每个连接要返回的最大值。默认 10。
--search <term>	字符串	项目名称的服务器端子字符串筛选器。

备注：

此操作并行分配到每个连接，并且会降级而不是失败：如果无法读取某些连接，则仍会返回可访问的项目，并且信封会带有Warning命名被跳过的连接 — 简短的列表永远不会出错查看完整版本。只有所有连接完全失败才属于错误。使用 --log-level warn 重新运行，以查看每个连接的基础错误。

示例

uip aops project list

uip aops project list --connections f1e2d3c4-0000-0000-0000-000000000001 --search invoice

数据形状（--输出 json）

{
  "Code": "ProjectList",
  "Data": [
    { "ProjectId": "9999dddd-0000-0000-0000-000000000001", "Name": "Invoice Processing", "Description": "Daily invoice ingest", "Type": "Process", "Repository": "automation-hub" }
  ]
}

UIP AOPS 项目获取

在给定引用中获取项目的元数据。

选项

长	值	必填	描述
--project-id <id>	字符串	是	项目的 SC 服务 UUID，来自 connection projects。
--reference <ref>	分支/标签/SHA	否	默认为默认分支的标头。
--with-branches	标记	否	同时获取完整的分支列表，并将其包含为 availableBranches。增加一次往返时间。

示例

uip aops project get --project-id 9999dddd-0000-0000-0000-000000000001

uip aops project get --project-id 9999dddd-0000-0000-0000-000000000001 --with-branches

数据形状（--输出 json）

{
  "Code": "ProjectGet",
  "Data": {
    "identifier": "9999dddd-0000-0000-0000-000000000001",
    "name": "Invoice Processing",
    "description": "Daily invoice ingest",
    "type": "Process",
    "projectVersion": "1.2.0",
    "repository": "automation-hub",
    "defaultBranch": "main"
  }
}

通过 --with-branches 将 Data 添加到 availableBranches: ["main", "release", "feature/x"]。如果无法解析项目的存储库以枚举分支，则 availableBranches 为空数组，记录了警告而非故障。

UIP AOPS 项目文件

在给定引用中列出项目的文件树。

选项

长	值	必填	描述
--project-id <id>	字符串	是	项目的 SC 服务 UUID。
--path <path>	字符串	否	要列出的子目录。默认为项目根目录。
--reference <ref>	分支/标签/SHA	否	默认为默认分支的标头。

数据形状（--输出 json）

{ "Code": "ProjectFiles", "Data": [] }

每个条目一行包含其名称、路径、类型和可构建单元类型。

uip aops 项目内容

获取项目中一个文件的原始内容。

选项

长	值	必填	描述
--project-id <id>	字符串	是	项目的 SC 服务 UUID。
--path <path>	字符串	是	相对于项目根目录的文件路径。
--reference <ref>	分支/标签/SHA	否	默认为默认分支的标头。

数据形状（--输出 json）

{ "Code": "ProjectFileContent", "Data": { "fileContent": "<xaml…>" } }

无法解析的 --path/--reference 组合将失败并显示 Project file '<path>' not found.，而不是空的成功信息。

UIP AOPS 项目提交

列出项目的提交历史记录。仅由 --project-id 作为目标 — 此端点没有基于位置（存储库/引用）的变体。

选项

长	值	必填	描述
--project-id <id>	字符串	是	项目的 SC 服务 UUID。
--path <path>	字符串	否	筛选以涉及此路径的提交。
--branch <name>	字符串	否	筛选一个分支。默认为默认分支。
--offset <n>	整数	否	要跳过的数量。必须是 --limit 的倍数。默认 0。
--limit <n>	整数	否	要返回的最大值。默认 20。
--search <term>	字符串	否	提交消息的服务器端子字符串筛选器。

数据形状（--输出 json）

{ "Code": "ProjectCommits", "Data": { "result": [] } }

UIP AOPS 项目提交

按 SHA 获取单个提交内容。

选项

长	值	必填	描述
--project-id <id>	字符串	是	项目的 SC 服务 UUID。
--reference <sha>	提交 SHA	是	同时接受解析为提交的分支/标签。

数据形状（--输出 json）

{ "Code": "ProjectCommit", "Data": { "Reference": "0123456789abcdef0123456789abcdef01234567", "Message": "Initial commit" } }

如果未解决，则失败并显示 Commit <reference> not found.。

UIP AOPS 解决方案获取

按标识符获取 Studio 解决方案的元数据，即保留的解决方案 DTO（名称、标识符、源存储库、默认分支、上次修改时间信息）。

参数

名称	必填	用途
<solution-id>	是	来自 connection solutions <connection-id> 的解决方案标识符。

数据形状（--输出 json）

{ "Code": "SolutionGet", "Data": { "identifier": "abcd5678-0000-0000-0000-000000000001", "name": "Finance Suite" } }

uip aops 解决方案提交

列出解决方案的提交历史记录。

参数

名称	必填	用途
<solution-id>	是	来自 connection solutions <connection-id> 的解决方案标识符。

选项

长	值	描述
--path <path>	字符串	筛选以涉及此路径的提交。
--branch <name>	字符串	筛选一个分支。默认为默认分支。
--offset <n>	整数	要跳过的数量。必须是 --limit 的倍数。默认 0。
--limit <n>	整数	要返回的最大值。默认 20。
--search <term>	字符串	提交消息的服务器端子字符串筛选器。

数据形状（--输出 json）

{ "Code": "SolutionCommits", "Data": { "result": [] } }

相关内容

• uip aops — 概述和概念。
• connections — 发现项目/解决方案标识符。
• pipelines — 定义和对项目运行 CI/CD 管道。

另请参阅

• 全局选项
• 退出代码