UIP TM 对象标签

“uip tm objectlabel”的语法和选项，用于管理附加到 Test Manager 对象的标签，例如测试用例和需求。

uip tm objectlabel管理附加到 Test Manager 对象（测试用例、需求等）的标签。标签是自由格式字符串，用于对对象进行标记和分组，以便进行筛选和搜索。

重要提示：

--object-ids和--labels在该命令组中为复数形式，并以空格分隔。单数形式--object-id和--label不存在。--project-key需要list 。

大纲

uip tm objectlabel list --project-key <key> [--object-ids <uuid...>] [--label-types <types...>] [--filter <text>] [--sort-by <expr>] [--limit <n>] [--offset <n>]
uip tm objectlabel get --label-id <uuid>
uip tm objectlabel add --object-ids <uuid...> --labels <name...> [--label-type <type>] [--remove-other-labels]
uip tm objectlabel remove --object-ids <uuid...> (--labels <name...> | --remove-all-labels) [-y]

All verbs honor the global options and the standard exit codes. Every verb accepts --log-level <level> (default Information).

UIP TM 对象标签列表

列出标签分配，可选择性地将范围限定于特定对象。

参数

无。

选项

• --project-key <key> （必填） — 拥有项目。
• --object-ids <uuid...> — 要作为筛选依据的对象 UUID，以空格分隔。可选；省略以列出项目中的所有对象。
• --label-types <types...> — 要作为筛选依据的以空格分隔的标签类型。
• --filter <text> — 对标签名称进行自由文本搜索。
• --sort-by <expr> — 排序表达式（字段名称，可以添加后缀:asc或:desc ）。
• --limit <n> — 页面大小。默认为50 。
• --offset <n> — 要跳过的结果。默认为0 。

示例

uip tm objectlabel list \
  --project-key DEMO \
  --object-ids a1b2c3d4-0000-0000-0000-000000000001 b2c3d4e5-0000-0000-0000-000000000001

数据形状

{
  "Code": "ObjectLabelList",
  "Data": [
    {
      "LabelId": "c3d4e5f6-0000-0000-0000-000000000001",
      "ObjectId": "a1b2c3d4-0000-0000-0000-000000000001",
      "Label": "smoke",
      "LabelType": "Tag"
    }
  ]
}

uip tm 对象标签获取

按分配 UUID 获取单个标签分配。

参数

无。

选项

• --label-id <uuid> （必填） — 标签分配的 UUID（ LabelId由objectlabel list返回）。这是分配记录 UUID，不是标签名称。

示例

uip tm objectlabel get \
  --label-id c3d4e5f6-0000-0000-0000-000000000001

数据形状

{
  "Code": "ObjectLabelGet",
  "Data": {
    "LabelId": "c3d4e5f6-0000-0000-0000-000000000001",
    "ObjectId": "a1b2c3d4-0000-0000-0000-000000000001",
    "Label": "smoke",
    "LabelType": "Tag"
  }
}

uip tm 对象标签添加

为一个或多个对象添加一个或多个标签。

参数

无。

选项

• --object-ids <uuid...> （必填） — 要应用标签的对象 UUID，以空格分隔。
• --labels <name...> （必填） — 要添加的以空格分隔的标签名称。
• --label-type <type> — 标签类型分类。可选。
• --remove-other-labels — 请先删除指定对象上的任何现有标签，然后再添加新标签。可选。

示例

uip tm objectlabel add \
  --object-ids a1b2c3d4-0000-0000-0000-000000000001 b2c3d4e5-0000-0000-0000-000000000001 \
  --labels smoke regression \
  --label-type Tag

数据形状

{
  "Code": "ObjectLabelAdd",
  "Data": {
    "Added": 4,
    "Result": "Added"
  }
}

uip tm 对象标签删除

从一个或多个对象中删除标签。提供--labels以删除特定标签，或提供--remove-all-labels以删除指定对象中的所有标签。

参数

无。

选项

• --object-ids <uuid...> （必填项） — 以空格分隔的对象 UUID。
• --labels <name...> — 要删除的以空格分隔的标签名称。与--remove-all-labels互斥。
• --remove-all-labels — 删除指定对象的所有标签。与--labels互斥。
• -y, --yes — 跳过确认提示。

示例

# remove specific labels
uip tm objectlabel remove \
  --object-ids a1b2c3d4-0000-0000-0000-000000000001 \
  --labels smoke \
  --yes

# remove all labels
uip tm objectlabel remove \
  --object-ids a1b2c3d4-0000-0000-0000-000000000001 \
  --remove-all-labels \
  --yes

数据形状

{
  "Code": "ObjectLabelRemove",
  "Data": {
    "Removed": 1,
    "Result": "Removed"
  }
}

相关内容

• requirements — 按带有requirements list --labels <label...>标签搜索要求。
• 自定义字段— 自定义字段定义可以使用标签。

另请参阅

• Test Manager 概述