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

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

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

エンティティ関連図

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

エンティティ このフローの関係 関係の説明 参照 /関係フィールド
作業項目 エピック、フィーチャー、不具合、品質ストーリー、およびユーザーストーリー この集約リソースコレクションは、エピック、フィーチャー、不具合、ユーザーストーリー、品質ストーリーなど、作業項目のタイプを表します。 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. まだ進行中のすべてのストーリーを見たいと思っています。

    これを行うには、subtypestoryであり、フェーズがまだ進行中の作業項目のみを一覧表示するクエリ句を入力します。フェーズは参照フィールドであり、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^ } )"

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

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

    ペイロード 

    {
       "phase":{ 
            "type":"phase",
            "id":"phase.story.done"
           },
       "id":"1019"
    }

トップに戻る

参照情報: