リリース用の新しいユーザーストーリーを入手する

このフローは、特定のリリースに割り当てられた新しいユーザーストーリーのリストを取得する方法を示しています。

エリア: 自分の作業、バックログ、リリース

エンティティ関連図

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

エンティティ このフローの関係 関係の説明 参照フィールド
ストーリー ワークスペースユーザー 各ストーリーは、ワークスペースユーザーに割り当てることができます。このフローでは、そのワークスペースユーザーはあなたです。 owner
フェーズ 各ストーリーにはフェーズ (ステータス) があります。この流れの中で、私たちは新しい物語に興味を持っています。 phase
リリース 各ストーリーはリリースに割り当てることができます。 release

トップに戻る

フロー

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

  1. ワークスペース内のすべてのストーリーを一覧表示するには:

    GET .../api/shared_spaces/<space_id>/workspaces/<workspace_id>/stories

  2. query_clauseを作成しましょう。私に割り当てられ、特定のリリースに関連付けられている新しいストーリーにのみ関心があります。

    このクエリには、次の2つの3つの基準セットがあります。リリース、フェーズ (ステータス)、および所有者。各セットは、AND演算子を表すセミコロン (;) で区切ります。

    リリースごとにフィルタリングする最初の基準セットから始めましょう。参照フィールドreleaseを使用し、nameフィールドと*ワイルドカードを使用してリリースをフィルタリングします。これには、941で始まるリリースが一覧表示されます。

    GET .../api/shared_spaces/<space_id>/workspaces/<workspace_id>/stories?query="release EQ {name EQ ^941*^}"

    参照フィールドの構文に注意してください。 

    標準のリクエスト構文 参照フィールドの構文
    等号 (=) EQ演算子
    引用符 (") キャロット (^)

  3. それでは、ストーリーのフェーズでフィルタリングしてみましょう。Newのストーリーのみが必要です。

    これは、リストノードの操作に似ています。ストーリーのフェーズを、値がnewのlogical_nameと比較します。

    GET .../api/shared_spaces/<space_id>/workspaces/<workspace_id>/stories?query="release EQ {name EQ ^941*^};phase EQ {logical_name EQ ^phase.story.new^}"

  4. 最後の基準は、所有者によるフィルタリングです。私の所有者IDが1001であるとすると、このクエリは、941で始まるリリースに割り当てられ、私に割り当てられた新しいストーリーを一覧表示します。

    GET .../api/shared_spaces/<space_id>/workspaces/<workspace_id>/stories?query="release EQ {name EQ ^941*^};phase EQ {logical_name EQ ^phase.story.new^};owner EQ {id EQ 1001}"

このフローの完全なREST API呼び出しは次のとおりです。 

GET .../api/shared_spaces/<space_id>/workspaces/<workspace_id>/stories?query="release EQ {name EQ ^941*^};phase EQ {logical_name EQ ^phase.story.new^};owner EQ {id EQ 1001}"

トップに戻る

参照情報: