uip tm オブジェクト ラベル

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]

すべての動詞は、 グローバルオプション と標準 終了コードを尊重します。すべての動詞は -t, --tenant <name> と --log-level <level> を受け入れます(デフォルト 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 objectlabel get

割り当て UUID で 1 つのラベルの割り当てを取得します。

引数

設定はありません。

オプション

• --label-id <uuid> (必須) — ラベル割り当ての UUID (objectlabel listによって返されるLabelId) です。これは、ラベル名ではなく、割り当てレコードの 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 objectlabel add

1 つ以上のオブジェクトに 1 つ以上のラベルを追加します。

引数

設定はありません。

オプション

• --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 objectlabel remove

1 つ以上のオブジェクトからラベルを削除します。特定のラベルを削除する --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 list --labels <label...>を使用してラベルで要件を検索します。
• customfield — カスタム フィールド定義ではラベルを使用できます。

参照

• Test Manager の概要
• 認証