このページを共有

# リストの操作

REST APIを使用して、カスタムリストを追加したり、既存のシステムリストの項目をカスタマイズしたりできます。

このトピックの内容:

## 概要

リストを操作するには、ALM Octaneで、スペース管理者権限またはワークスペースの管理者として認証されている必要があります。

制限事項: ALM Octaneが特定の言語にローカライズされている場合でも、UDFは英語で定義する必要があります。

リストとリスト値は、名前または論理名でフィルタリングできます。ユーザー定義リストの論理名とリスト値は自動的に生成されます。

トップに戻る

## 新しいカスタムリストの作成

1. リストのルートを作成します。

       POST .../api/shared_spaces/<shared space ID>/workspaces/<workspace ID>/list_nodes

       {"data":

         [

           {

             "name":"colors"

           }

         ]

       }

   新しく作成されたリストのlogical_nameはルートIDです。たとえば、このPOSTはIDabcd1234を返す場合があります。

2. IDがabcd1234のリストのリスト項目を作成します。

       POST .../api/shared_spaces/<shared space ID>/workspaces/<workspace ID>/list_nodes

       {"data":

         [

           {

             "list_root": {
               "type": "list_node",
               "id": "abcd1234"
             },

             "name": "blue"

           }

         ]

       }

トップに戻る

## 既存のリストに項目を追加する

1. リストのIDを見つけます。この例では、更新されるリストは、実行ステータスの可能な値を含むリストです。

       GET .../api/shared_spaces/<space_id>/workspaces/<workspace_id>/list_nodes?query="logical_name EQ ^list_node.run_status^"

       または:

       GET .../api/shared_spaces/<space_id>/workspaces/<workspace_id>/list_nodes?query="name EQ ^run_status^"

2. リストのルートノードのIDが応答で返されます。この値は、list_root idプロパティのリクエストの本文で使用します (手順3)。

3. 新しい項目をリストに追加します。

       POST .../api/shared_spaces/<space_id>/workspaces/<workspace_id>/list_nodes

       {"data":

         [

             {  "type": "list_node",

                "list_root" : {

                    "type": "list_node",

                    "id":<list root ID>},

                    "name":"new item value"

              }

         ]

       }

トップに戻る

## 既存のリストから項目を削除する

リストから項目を削除するには、次のことができます。

- リスト項目を一時的に無効にします。

- リスト項目を非推奨にします。

リスト項目のアクティビティレベルを更新することにより、リスト項目を非アクティブ化、非推奨、またはアクティブ化します。

活動レベル | 説明
--- | ---
0 | アクティブ。
1 | 非推奨。
2 | <内部使用。使用しないでください。>
3 | 非活性。

例: 項目の非アクティブ化

    PUT .../api/shared_spaces/<space_id>/workspaces/<workspace_id>/list_nodes/<list_item_logical_name>?fields=id,name,activity_level

    {

    "activity_level": 3

    }

例: 項目のアクティブ化

    PUT .../api/shared_spaces/<space_id>/workspaces/<workspace_id>/list_nodes/<list_item_logical_name>?fields=id,name,activity_level

    {

    "activity_level": 0

    }

トップに戻る

## リストの名前を変更する

カスタムリストの名前のみを変更できます。

    PUT .../api/shared_spaces/<space_id>/workspaces/<workspace_id>/list_nodes?query="logical_name EQ ^abcd1234^"

または:

    PUT .../api/shared_spaces/<space_id>/workspaces/<workspace_id>/list_nodes?query="name EQ ^colors^"

    {"data":

      [

           {

             "name":"NEW LIST_NAME"

           }

      ]

    }

トップに戻る

参照情報:

- ユーザー定義フィールド (UDF) へのアクセス

- リストのセットアップ

https://admhelp.microfocus.com ALM Octane 8942
検索結果を改善するためのヒント... ALM Octaneヘルプセンター ALM Octaneヘルプ 15.1.90 すべて ローカルヘルプセンターを表示 オンラインヘルプセンターを表示 戻る ブラウザーの履歴内を戻る 進む ブラウザーの履歴内を進む 検索のハイライトを削除する 次のトピック 次のトピックに進む 前のトピック 前のトピックに戻る 現在のトピックを印刷 バージョン: