実績工数のエクスポート

---

説明

実績工数をエクスポートします。
取得したパラメータの詳細は、次のリンクを参照ください。： 「エクスポート時の出力項目について」

必要権限

実績エクスポート

URL

GET /workitem/workItems/timeEntries/export

クエリパラメーター

名前	型	必須か	説明
fileType	string	×	エクスポートする出力形式 csv(既定値)：csv形式 xlsx：excel形式
fields	string	×	エクスポートするフィールド
scale	string	×	時間軸の集計単位 Day(既定値)：日単位 Week：週単位 Month：月単位 TimeEntry：実績単位
groupBy	string	×	作業軸の集計単位 Project(既定値)：プロジェクトごと WorkItem：ワークアイテムごと
startDate	DateTime	×	集計期間の開始日
finishDate	DateTime	×	集計期間の終了日
filterBy	string	×	集計フィルタの種類 Project(既定値)：プロジェクト Organization：組織 User：ユーザー
filterValues	string	○	集計フィルタの値 集計フィルタで選択したデータのIDを指定します。

レスポンス

名前	型	説明
ー		条件に従ったファイルを出力します。

備考

本APIでは csv形式でデータを出力します。
テキストに出力し、csv形式で保存してご利用ください。

エラーケース

• 集計フィルタの値が null または空文字を指定した

特記事項

• コスト閲覧権限がない場合、コストは 0 で取得します。
• 集計フィルタの種類（プロジェクト、組織など）に対応する実績エクスポート権限がないデータは取得できません。
• ユーザーの組織はAPI実行時の組織情報を取得します。
  組織名・組織コードが実績登録時から変更されている場合、最新の組織名・組織コードを取得します。

サンプル

ユーザーを指定し、実績工数を日単位で集計しCSV形式で出力する

集計フィルタ(filterBy)にUserを指定し、filterValuesに対象とするユーザーIDを設定します。

GET /workItem/workItems/timeEntries/export?filterBy=User&filterValues=14,15,21&startDate=2018-12-01&finishDate=2018-12-31&scale=day&groupBy=project&fileType=csv

階層情報（階層1～16）を出力したい場合

サンプル： 「ユーザーと出力するフィールドを指定し、実績工数を実績単位で集計しCSV形式で出力する」のように、fieldsを指定してください。

Response

200 OK

ユーザー名,ユーザーコード,現在の組織,現在の組織コード,該当日の組織,該当日の組織コード,プロジェクト名,プロジェクトコード,顧客,業務分野,業務種別,案件重要度,日付,実績工数,実績工数（分）,実績コスト
岡本 直哉,008,開発2課,,開発2課,,AG製品の開発,,,,,,2018/12/10,3,180,24000
岡本 直哉,008,開発2課,,開発2課,,AG製品の開発,,,,,,2018/12/11,4,240,32000
岡本 直哉,008,開発2課,,開発2課,,AG製品の開発,,,,,,2018/12/12,6,360,48000
岡本 直哉,008,開発2課,,開発2課,,AG製品の開発,,,,,,2018/12/18,5,300,40000
岡本 直哉,008,開発2課,,開発2課,,AG製品の開発,,,,,,2018/12/19,4.5,270,36000
岡本 直哉,008,開発2課,,開発2課,,AG製品の開発,,,,,,2018/12/26,4,240,32000
岡本 直哉,008,開発2課,,開発2課,,AG製品の開発,,,,,,2018/12/27,3.5,210,28000
岡本 直哉,008,開発2課,,開発2課,,AG製品の開発,,,,,,2018/12/31,1,60,8000
岡本 直哉,008,開発2課,,開発2課,,A機能の開発,PRJ-099,,,,,2018/12/24,3.5,210,28000
岡本 直哉,008,開発2課,,開発2課,,A機能の開発,PRJ-099,,,,,2018/12/25,1,60,8000
　・
　・
　・
山本 博,002,開発1課,,開発1課,,L商品の開発,PRJ-201,,,,,2018/12/03,1,60,4000
山本 博,002,開発1課,,開発1課,,L商品の開発,PRJ-201,,,,,2018/12/05,1,60,4000
山本 博,002,開発1課,,開発1課,,P機器の開発,PRJ-007,,,,,2018/12/05,6.5,390,26000
山本 博,002,開発1課,,開発1課,,R商品開発,PRJ-001,,,,,2018/12/03,3,180,12000
山本 博,002,開発1課,,開発1課,,R商品開発,PRJ-001,,,,,2018/12/05,0.5,30,2000
山本 博,002,開発1課,,開発1課,,R商品開発,PRJ-001,,,,,2018/12/06,8,480,32000
　・
　・
　・
山本 博,002,開発1課,,開発1課,,S機器の開発,PRJ-002,A社,開発,研究,低,2018/12/03,0.5,30,2000
山本 博,002,開発1課,,開発1課,,S機器の開発,PRJ-002,A社,開発,研究,低,2018/12/07,1.5,90,6000
山本 博,002,開発1課,,開発1課,,S機器の開発,PRJ-002,A社,開発,研究,低,2018/12/10,0.5,30,2000
山本 博,002,開発1課,,開発1課,,S機器の開発,PRJ-002,A社,開発,研究,低,2018/12/13,1,60,4000
山本 博,002,開発1課,,開発1課,,S機器の開発,PRJ-002,A社,開発,研究,低,2018/12/17,0.5,30,2000
山本 博,002,開発1課,,開発1課,,S機器の開発,PRJ-002,A社,開発,研究,低,2018/12/21,1,60,4000
山本 博,002,開発1課,,開発1課,,S機器の開発,PRJ-002,A社,開発,研究,低,2018/12/24,5,300,20000
山本 博,002,開発1課,,開発1課,,S機器の開発,PRJ-002,A社,開発,研究,低,2018/12/26,1.5,90,6000
山本 博,002,開発1課,,開発1課,,S機器の開発,PRJ-002,A社,開発,研究,低,2018/12/27,3.5,210,14000
山本 博,002,開発1課,,開発1課,,S機器の開発,PRJ-002,A社,開発,研究,低,2018/12/28,1,60,4000
山本 博,002,開発1課,,開発1課,,S機器の開発,PRJ-002,A社,開発,研究,低,2018/12/31,6.5,390,26000
山本 博,002,開発1課,,開発1課,,会社横断業務,部門業務-会社,,,,,2018/12/03,2.5,150,10000
山本 博,002,開発1課,,開発1課,,会社横断業務,部門業務-会社,,,,,2018/12/04,5,300,20000
山本 博,002,開発1課,,開発1課,,会社横断業務,部門業務-会社,,,,,2018/12/10,2.5,150,10000

ユーザーと出力するフィールドを指定し、実績工数を実績単位で集計しCSV形式で出力する

以下を設定します。

• 集計フィルタ(filterBy)：User
• filterValues：実績を取得するユーザーID

GET /workItem/workItems/timeEntries/export?filterBy=User&filterValues=14,15,21&startDate=2022-02-01&finishDate=2022-02-28&scale=day&groupBy=workitem&fileType=csv&fields=UserName,UserCode,OrganizationName,OrganizationNameOfWorkDate,ProjectName,ProjectCode,ProjectCategory1,ProjectCategory2,ProjectCategory3,ProjectCategory4,WorkDate,ActualTimeHour,ActualTimeMinute,ActualCost,Level1,Level2,Level3,WorkItemName

上記リクエストでは以下を取得しています。

• ユーザー情報
  • ユーザー名、ユーザーコード、現在の組織、該当日の組織
• プロジェクト情報
  • プロジェクト名、プロジェクトコード、プロジェクトカテゴリ1～4
• 実績情報
  • 日付
  • 実績工数、実績工数（分）、実績コスト
• アイテム情報
  • アイテム名、階層1～3

Response

200 OK

ユーザー名,ユーザーコード,現在の組織,該当日の組織,プロジェクト名,プロジェクトコード,顧客,業務分野,業務種別,案件重要度,日付,実績工数,実績工数（分）,実績コスト,アイテム名,階層1,階層2,階層3
岡本 直哉 直哉,008,開発2課,開発2課,AG製品の開発,PRJ-095,A社,開発,請負,高,2022/02/02,1,60,8000,メイン画面設計,フェーズ1,設計,
岡本 直哉 直哉,008,開発2課,開発2課,AG製品の開発,PRJ-095,A社,開発,請負,高,2022/02/02,2,120,16000,プロジェクト作成機能設計,フェーズ1,設計,
岡本 直哉 直哉,008,開発2課,開発2課,AG製品の開発,PRJ-095,A社,開発,請負,高,2022/02/03,1,60,8000,プロジェクト作成機能設計,フェーズ1,設計,
岡本 直哉 直哉,008,開発2課,開発2課,AG製品の開発,PRJ-095,A社,開発,請負,高,2022/02/03,2,120,16000,工数入力機能設計,フェーズ1,設計,
岡本 直哉 直哉,008,開発2課,開発2課,AG製品の開発,PRJ-095,A社,開発,請負,高,2022/02/04,1,60,8000,工数入力機能設計,フェーズ1,設計,
岡本 直哉 直哉,008,開発2課,開発2課,AG製品の開発,PRJ-095,A社,開発,請負,高,2022/02/04,2,120,16000,メイン画面設計,フェーズ1,設計,
岡本 直哉 直哉,008,開発2課,開発2課,AG製品の開発,PRJ-095,A社,開発,請負,高,2022/02/07,1,60,8000,工数入力機能設計,フェーズ1,設計,
岡本 直哉 直哉,008,開発2課,開発2課,AG製品の開発,PRJ-095,A社,開発,請負,高,2022/02/07,1,60,8000,工数入力機能設計,フェーズ1,設計,
岡本 直哉 直哉,008,開発2課,開発2課,A機能の開発,PRJ-099,A社,開発,請負,高,2022/02/01,0.5,30,4000,進捗ミーティング,案件C,管理,進捗
岡本 直哉 直哉,008,開発2課,開発2課,A機能の開発,PRJ-099,A社,開発,請負,高,2022/02/01,0.75,45,6000,レビュー指摘修正,案件C,製作,
　・
　・
　・
山本 博,002,開発1課,開発1課,R2商品開発,PRJ-002,C社,開発,請負,高,2022/02/01,5,300,20000,仕様作成,仕様,,
山本 博,002,開発1課,開発1課,R2商品開発,PRJ-002,C社,開発,請負,高,2022/02/02,1,60,4000,機能テスト,テスト実施,,
山本 博,002,開発1課,開発1課,R2商品開発,PRJ-002,C社,開発,請負,高,2022/02/02,7,420,28000,非機能テスト,テスト実施,,
山本 博,002,開発1課,開発1課,R2商品開発,PRJ-002,C社,開発,請負,高,2022/02/03,1,60,4000,機能テスト,テスト実施,,
山本 博,002,開発1課,開発1課,R2商品開発,PRJ-002,C社,開発,請負,高,2022/02/03,5,300,20000,非機能テスト,テスト実施,,
山本 博,002,開発1課,開発1課,R2商品開発,PRJ-002,C社,開発,請負,高,2022/02/04,5,300,20000,機能テスト,テスト実施,,
　・
　・
　・
藤井 智一,003,開発1課,開発1課,開発部 一般業務,部門業務-開発,,開発,自社,,2022/02/02,2,120,14000,一般,,,
藤井 智一,003,開発1課,開発1課,開発部 一般業務,部門業務-開発,,開発,自社,,2022/02/02,2,120,14000,人事業務,,,
藤井 智一,003,開発1課,開発1課,開発部 一般業務,部門業務-開発,,開発,自社,,2022/02/03,8,480,56000,出張,,,
藤井 智一,003,開発1課,開発1課,開発部 一般業務,部門業務-開発,,開発,自社,,2022/02/07,1,60,7000,人事業務,,,
藤井 智一,003,開発1課,開発1課,開発部 一般業務,部門業務-開発,,開発,自社,,2022/02/07,4.5,270,31500,顧客・業者対応,,,
藤井 智一,003,開発1課,開発1課,開発部 一般業務,部門業務-開発,,開発,自社,,2022/02/08,1,60,7000,会議,,,