メインコンテンツまでスキップ

実績工数のエクスポート

説明​

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

必要権限​

実績エクスポート

URL​

GET /workitem/workItems/timeEntries/export

クエリパラメーター​

名前型必須か説明
fileTypestring×エクスポートする出力形式
csv(既定値)：csv形式
xlsx：excel形式
fieldsstring×エクスポートするフィールド
scalestring×時間軸の集計単位
Day(既定値)：日単位
Week：週単位
Month：月単位
TimeEntry：実績単位
groupBystring×作業軸の集計単位
Project(既定値)：プロジェクトごと
WorkItem：ワークアイテムごと
startDateDateTime×集計期間の開始日
finishDateDateTime×集計期間の終了日
filterBystring×集計フィルタの種類
Project(既定値)：プロジェクト
Organization：組織
User：ユーザー
filterValuesstring○集計フィルタの値

集計フィルタで選択したデータのIDを指定します。

レスポンス​

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

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

エラーケース​

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

特記事項​

  • コスト閲覧権限がない場合、コストは 0 で取得します。
  • 集計フィルタの種類（プロジェクト、組織など）に対応する実績エクスポート権限がないデータは取得できません。

サンプル​

ユーザーを指定し、実績工数を日単位で集計し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,会議,,,
に最終更新