このページを共有

# タスクが完了した場合に完了したストーリーにマークを付ける

このフローは、ユーザーストーリーのタスクが完了したかどうかを確認し、完了した場合は、ユーザーストーリーに完了のマークを付ける方法を示しています。

エリア: 作業項目、タスク

このトピックの内容:

## エンティティ関連図

このフローでは、次のエンティティにアクセスし、これらのエンティティ間の関係を理解する必要があります。

エンティティ | このフローの関係 | 関係の説明 | 参照 /関係フィールド
--- | --- | --- | ---
作業項目 | エピック、フィーチャー、不具合、品質ストーリー、およびユーザーストーリー | この集約リソースコレクションは、エピック、フィーチャー、不具合、ユーザーストーリー、品質ストーリーなど、作業項目のタイプを表します。 | subtype
タスク | 作業項目はタスクに関連付けることができます。 | child_task
タスク | 作業項目 | タスクは、1つのユーザーストーリー、品質ストーリー、または不具合に関連付ける必要があります。ユーザーストーリー、品質ストーリー、および不具合は作業項目です。 タスクは、エピックやフィーチャーなどの他の作業項目に関連付けることはできません。 ユーザーストーリー、品質ストーリー、および不具合は、複数のタスクに関連付けることができます。 | stories defects
フェーズ | タスクはフェーズに関連付ける必要があります。 | phase
ユーザー | タスクには1人の所有者が必要です。 | owner
添付ファイル | タスクには添付ファイルを含めることができます。 | attachments
エピック | 作業項目 | エピックはwork_itemsのサブタイプです。 集約リソースコレクションwork_itemsに関連するフィールドはありません。 |
フィーチャー | エピックはフィーチャーに関連付けることができます。 |
フィーチャー | 作業項目 | フィーチャーはwork_itemsのサブタイプです。 集約リソースコレクションwork_itemsに関連するフィールドはありません。 |
エピック | フィーチャーはエピックに関連付けることができます。 | parent
ストーリーと不具合 | フィーチャーは、ユーザーストーリー、品質ストーリー、および不具合に関連付けることができます。 |
ユーザーストーリー | 作業項目 | ユーザーストーリーは、work_itemsのサブタイプです。 集約リソースコレクションwork_itemsに関連するフィールドはありません。 |
フィーチャー | ユーザーストーリーはフィーチャーに関連付けることができます。 | parent
不具合 | ユーザーストーリーは不具合に関連している可能性があります。 |
タスク | ユーザーストーリーはタスクに関連付けることができます。 | story
品質ストーリー | 作業項目 | 品質ストーリーは、work_itemsのサブタイプです。 集約リソースコレクションwork_itemsに関連するフィールドはありません。 |
| フィーチャー | 品質ストーリーはフィーチャーに関連付けることができます。 | parent
| 不具合 | 品質ストーリーは不具合と関連している可能性があります。 |
| タスク | 品質ストーリーはタスクに関連付けることができます。 | story
不具合 | 作業項目 | 不具合はwork_itemsのサブタイプです。 集約リソースコレクションwork_itemsに関連するフィールドはありません。 |
フィーチャー | 不具合はフィーチャーに関連付けることができます。 | parent
ユーザーストーリーと品質ストーリー | 不具合は、ユーザーストーリーと品質ストーリーに関連付けることができます。 |
タスク | 不具合はタスクに関連付けることができます。 | defect
フェーズ | フィーチャー、ユーザーストーリー、品質ストーリー、および不具合 | フィーチャー、ストーリー、および不具合は、フェーズに関連付ける必要があります。 | phase
ユーザー | すべての作業項目 | エピック、フィーチャー、使用ストーリー、品質ストーリー、および不具合は、所有者に関連付けることができます。 | owner

トップに戻る

## フロー

ステップバイステップでREST API呼び出しを作成しましょう。

1. まだ進行中のすべてのストーリーを見たいと思っています。

   これを行うには、subtypeがstoryであり、フェーズがまだ進行中の作業項目のみを一覧表示するクエリ句を入力します。フェーズは参照フィールドであり、idによってフェーズを見つけます。

   fields句を使用して、API呼び出しによって返されるフィールドを制御します。すべてのフィールドが自動的に返されるわけではないので、ここでは具体的に説明します。進行中のストーリーのいずれかがタスクに関連付けられているかどうかを確認したいので、フィールドのリストにtasks_numberを必ず追加してください。

   `GET .../api/shared_spaces/<space_id>/workspaces/<workspace_id>/work_items?fields=phase,release,name,id,tasks_number,subtype&query="(subtype EQ ^story^;phase EQ {id EQ ^phase.story.inprogress^})"`

2. ストーリーごとに、対応するタスクが実行されているかどうかを確認します。

   ここでは、ストーリー1019に対応するタスクをチェックしています。これは、前のAPI呼び出しで、このストーリーに1つのタスク1002が関連付けられていることが示されたためです。

   この例は、参照フィールドの使用法も示しています。idを使用して、story参照フィールドを使用して、ストーリーを指定します。

   `GET .../api/shared_spaces/<space_id>/workspaces/<workspace_id>/tasks?query="(story EQ {id EQ ^1019^ } )"`

   応答

       {
           "total_count": 1,
           "data": [
               {
                   "type": "task",
                   "workspace_id": 1002,
                   "phase": {
                       "type": "phase",
                       "logical_name": "phase.task.completed",
                       "name": "Completed",
                       "index": 0,
                       "id": "1034"
                   },
                   "name": "This is my task.",
                   "id": "1002"
               }
           ],
           "exceeds_total_count": false
       }

3. 応答を確認すると、タスク1002が完了したことがわかります。これで、対応するストーリーのフェーズ1019を更新して完了させることができます。

   `PUT .../api/shared_spaces/<space_id>/workspaces/<workspace_id>/work_items//1019`/

   ペイロード

       {

          "phase":{

               "type":"phase",

               "id":"phase.story.done"

              },

          "id":"1019"

       }

トップに戻る

参照情報:

- REST APIの操作方法
- 一般的なフローとERダイアグラム

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