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

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

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

エンティティ関連図

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

エンティティ	このフローの関係	関係の説明	参照 /関係フィールド
作業項目	エピック、フィーチャー、不具合、品質ストーリー、およびユーザーストーリー	この集約リソースコレクションは、エピック、フィーチャー、不具合、ユーザーストーリー、品質ストーリーなど、作業項目のタイプを表します。	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呼び出しを作成しましょう。

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

これを行うには、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^})"
ストーリーごとに、対応するタスクが実行されているかどうかを確認します。

ここでは、ストーリー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
}
```
応答を確認すると、タスク1002が完了したことがわかります。これで、対応するストーリーのフェーズ1019を更新して完了させることができます。

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

ペイロード
```
{
```
```
   "phase":{ 
```
```
        "type":"phase",
```
```
        "id":"phase.story.done"
```
```
       },
```
```
   "id":"1019"
```
```
}
```

トップに戻る

参照情報:

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

エンティティ関連図

フロー

ヘルプセンターのフィードバックを送信する