Skip to content

指定ワークアイテム一覧の取得

説明

指定した ID のワークアイテムの一覧を取得します。
fieldsパラメータの詳細は「ワークアイテムAPIのフィールドについて」を参照してください。

必要権限

プロジェクトの閲覧

URL

GET /workitem/workItems/{workItemId}/subItems

パスパラメーター

名前 必須か 説明
workItemId string ワークアイテムID

クエリパラメーター

名前 必須か 説明
name string × 名前
keyword string × キーワード

以下のフィールドに指定したキーワードを持つアイテムを取得します。
・アイテム名
・アイテムコード
・アイテム番号
・プロジェクト名
・プロジェクトコード
assignedUserIds string × 割り当てられているユーザーID
assignedUsers string × 割り当てられているユーザー

ユーザーの「ログイン名」、「LDAPログイン名」、「メールアドレス」、「名前」のいずれかに完全一致するユーザーを割り当てに持つアイテムの検索処理を行います。
plannedStartDateFrom DateTime × 検索を開始する計画開始日

例:
10/1を指定した場合、10/1以降に開始したアイテムを取得する。
plannedStartDateTo DateTime × 検索を終了する計画開始日

例:
10/1を指定した場合、10/1までに開始したアイテムを取得する。
plannedFinishDateFrom DateTime × 検索を開始する計画終了日

例:
10/1を指定した場合、10/1以降に終了するアイテムを取得する。
plannedFinishDateTo DateTime × 検索を終了する計画終了日

例:
10/1を指定した場合、10/1までに終了するアイテムを取得する。
leaderIds string × リーダーID
leaders string × リーダー

ユーザーの「ログイン名」、「LDAPログイン名」、「メールアドレス」、「名前」のいずれかに完全一致するリーダーを持つアイテムの検索処理を行います。
hasPlannedDate boolean × 期間(計画開始日、計画終了日)が設定されているアイテムを取得するか

・true:期間が設定済みのアイテムのみ対象
・false:期間が未設定のアイテムのみ対象
・指定なし (null) :全てを対象
hasPlannedTime boolean × 計画工数が存在する(1以上)ワークアイテムを取得するかどうか

・true:計画工数が存在するアイテムのみ対象
・false:計画工数が存在しないアイテムのみ対象
・指定なし(null):
全てを対象
hasActualTime boolean × 実績工数が存在する(1以上)ワークアイテムを取得するかどうか

・true:実績工数が存在するアイテムのみ対象
・false:実績工数が存在しないアイテムのみ対象
・指定なし(null):
全てを対象
hasProgress boolean × 進捗管理対象のアイテムのみを取得するか

・true:管理対象(進捗率:0-100%)アイテムのみ対象
・false:管理対象外(進捗率:NA)アイテムのみ対象
・指定なし (null) :全てを対象
fields string × 取得対象とするフィールドをシステム名のカンマ区切りで指定します。

プロジェクトで利用可能なアイテムタイプが持つ、 フィールドタイプのシステム名をカンマ区切りで指定します。
SV を指定すると、PlannedStartDate、PlanendFinishDate、ActualProgress、HasSubItem も取得フィールドに追加します。

fieldCalcTypesを指定すると、フィールドの決定方法を取得します。
depth int × 取得するアイテムの階層
(ルートフォルダを0とします)
isCompleted boolean × 完了・未完了のアイテムのみを取得するか

・true:完了したアイテムのみ対象
・false:未完了のアイテムのみ対象
・指定なし (null) :全てを対象
statusTypeIds string × ステータスタイプID
statusTypes string × ステータスタイプ

ステータスタイプの「名前」に完全一致するステータスタイプを持つアイテムの検索処理を行います。
itemTypeIds string × アイテムタイプID
itemTypes string × アイテムタイプ

アイテムタイプの「システム名」、「名前」のいずれかに完全一致するアイテムタイプを持つアイテムの検索処理を行います。
includeDeleted boolean × 削除済みデータも取得対象とするか

true:削除されたデータを含めて取得します。
false:削除されていないデータのみを取得します。
isDeleted boolean × includeDeleted =trueのとき有効とします。

true:削除されたデータのみを取得します。
false:削除されていないデータのみを取得します。

レスポンス

名前 説明
WorkItem[] 取得したワークアイテム

エラーケース

  • 存在しない ワークアイテムID が指定された
  • 無効な検索日が指定された

特記事項

  • 指定したアイテム以下をツリー構造で取得します。指定したアイテムから検索条件に一致したアイテムまでの中間アイテムを含めて取得します。
  • コスト権限がない場合は以下の情報は0で取得します。
    • 実績コスト(ActualCost)
    • 計画コスト(PlannedCost)
    • 遅れコスト(CV)
    • 最終予測遅れコスト(CVAC)
    • 最終予測コスト(EstimatedFinalCost)
    • 子アイテムの実績コスト(ActualCostOfChildren)
    • 子アイテムの計画コスト(PlannedCostOfChildren)

サンプル

ワークアイテムのIDを指定して、そのワークアイテムと子アイテムを取得する

リクエスト
GET /workitem/workItems/126/subItems?fields=Id,Name,StatusTypeId,ActualProgress,PlannedStartDate,PlannedFinishDate,PlannedTime,ActualTime
レスポンス
200 OK

[
    {
        "fields":{
            "Id":"126",
            "StatusTypeId":"2",
            "Name":"仕様",
            "ActualProgress":25.0,
            "PlannedStartDate":"2018-11-05T00:00:00",
            "PlannedFinishDate":"2018-11-16T00:00:00",
            "PlannedTime":2400,
            "ActualTime":2130,
            "StatusTypeName":"作業中",
            "IsAclInherited":false,
            "CanEdit":true,
            "SubItems":[
                {
                    "fields":{
                        "Id":"127",
                        "StatusTypeId":"3",
                        "Name":"要求ヒアリング",
                        "ActualProgress":100.0,
                        "PlannedStartDate":"2018-11-05T00:00:00",
                        "PlannedFinishDate":"2018-11-08T00:00:00",
                        "PlannedTime":240,
                        "ActualTime":210,
                        "StatusTypeName":"完了",
                        "IsAclInherited":false,
                        "CanEdit":true
                    },
                    "aclId":"0",
                    "permission":526464
                },
                {
                    "fields":{
                        "Id":"128",
                        "StatusTypeId":"1",
                        "Name":"仕様作成",
                        "ActualProgress":0.0,
                        "PlannedStartDate":"2018-11-09T00:00:00",
                        "PlannedFinishDate":"2018-11-13T00:00:00",
                        "PlannedTime":1800,
                        "ActualTime":1290,
                        "StatusTypeName":"未着手",
                        "IsAclInherited":false,
                        "CanEdit":true
                    },
                    "aclId":"0",
                    "permission":526464
                },
                {
                    "fields":{
                        "Id":"129",
                        "StatusTypeId":"3",
                        "Name":"仕様レビュー",
                        "ActualProgress":100.0,
                        "PlannedStartDate":"2018-11-14T00:00:00",
                        "PlannedFinishDate":"2018-11-15T00:00:00",
                        "PlannedTime":360,
                        "ActualTime":540,
                        "StatusTypeName":"完了",
                        "IsAclInherited":false,
                        "CanEdit":true
                    },
                    "aclId":"0",
                    "permission":526464
                },
                {
                    "fields":{
                        "Id":"130",
                        "StatusTypeId":"3",
                        "Name":"指摘修正",
                        "ActualProgress":100.0,
                        "PlannedStartDate":"2018-11-14T00:00:00",
                        "PlannedFinishDate":"2018-11-16T00:00:00",
                        "PlannedTime":0,
                        "ActualTime":90,
                        "StatusTypeName":"完了",
                        "IsAclInherited":false,
                        "CanEdit":true
                    },
                    "aclId":"0",
                    "permission":526464
                }
            ]
        },
        "aclId":"0",
        "permission":526464
    }
]

型定義

WorkItem

名前 必須か 説明
fields Fields フィールド一覧
fieldCalcTypes FieldCalcType × フィールド計算方法一覧

Fields

名前 必須か 説明
key string
key/valueで値を保持します。
Ex:"XXXXX":"YYYYY"
XXXXXはkeyの名称
YYYYYは値

FieldCalcType(列挙型)

名前 説明
None 無効値
UserInput ユーザー入力
Sum 合計
Average 平均
Max 最大
Min 最小
And 論理積
Or 論理和
Count 個数
ProgressNA 進捗管理なし
ProgressOutputScale 規模進捗
ProgressWeightedAverage 加重平均
ProgressRemainingTime 進捗率(残作業時間)
Auto 自動計算
Expression 計算式