タイムレポート

この報告書は、1 つ以上のプロジェクトで課題に取り組むのに費やされた合計時間を示します。行われた作業の種類と元の見積もりが表示されます。費やされた時間は、作業の種類、作業の作成者、親の課題、課題の種類など、さまざまな値でグループ化できます。

レポートが計算されるとき、以下のオプションが利用可能です。

プレゼンテーションを切り替えて、ユーザー (つまり、作業作成者) ごと、課題ごと、プロジェクトごと、または作業項目ごとの作業項目のリストを表示します。これらの属性のいずれかによってレポート内のアイテムをグループ化すると、対応するオプションが生成されたレポートから削除されます。データを作業の作者ごとにグループ化するようにレポートを構成すると、ユーザーごとの費やした時間のリストを表示するオプションは非表示になります。
レポートで作業タイプを表示または非表示にします。このオプションを有効にすると、レポートには作業タイプごとに個別の列が表示されます。
残りの（未使用の見積もり）および合計消費時間の追加の列を表示または非表示にします。
課題 ID をクリックして、選択した課題を単一の課題ビューで開きます。

計算されたレポートのデータが issue ごとのオプションを使用して表示されている場合は、issue ごとに選択したカスタムフィールドの現在の値を表示するようにレポートを設定できます。発行フィールド設定を追加して、含めるフィールドを選択します。

前提条件

最良の結果を得るために、以下のガイドラインに従って YouTrack を構成して使用してください。

レポートに表示する各プロジェクトでタイムトラッキングを有効にして設定します。
プロジェクトごとに一連の作業項目の種類を定義します。
課題ごとに作業項目を入力するには、タイムトラッキングを使用します。
各タスクの実際の所要時間と元の見積もりを比較する場合は、レポートで追跡する各課題の予測フィールドに値を入力します。

タイムレポートを作成する

タイムレポートを作成するには:

メインナビゲーションメニューから、レポートを選択します。
新規レポートボタンをクリックしてください。
タイムレポートのリンクをクリックしてください。
レポートの設定ページで、新しいレポートのパラメーターを設定します。
このレポートの設定の詳細については、設定を参照してください。
レポートの設定が完了したら、レポートの作成ボタンをクリックします。
- レポートは YouTrack サーバーの処理キューに送信されます。
- 処理が終了すると、新しいレポートが表示されます。

設定

レポートを設定するときには、基本的に一連のプログレッシブフィルターを設定します。これらのフィルターは、特定のプロジェクトに属し、クエリに一致し、特定の作者からの、設定された時間枠内の特定の作業タイプの作業項目を含む課題のみを含むようにレポートを制限します。最終的には、フィルターに一致する課題の作業項目に追加された費やされた時間の概要です。データをグループ化するために使用するオプションは、レポートが各行に費やした合計時間を計算する方法を決定します。

このレポートを設定するには、次の設定を使用します。

設定	説明
レポート名	レポートの名前
プロジェクト	レポートが計算されているプロジェクト。リストに表示されているプロジェクトは、読み取り（プロジェクト基本）のアクセス許可に基づいて表示されます。
課題フィルター	課題フィルターとプロジェクトの設定により、レポートの範囲を狭めてより正確な結果を得ることができます。入力フィールドは、検索ボックスで使用可能なものと同じ構文および自動補完をサポートします。クエリを入力すると、フィルターに一致する課題のサブタスクから総消費時間を収集するためのオプションが表示されます。見積もりと消費時間がサブタスクから計算される親 issue をクエリでフィルター処理する場合は、このオプションを使用します。これらのサブタスクからの合計見積もりと費やされた時間は、レポート内の各親タスクのエントリにまとめられます。
作業の作者	1 つ以上の作業作成者によってレポート計算に追加された作業項目を含む課題のみを含めるように、課題をフィルター処理します。
作業タイプ	課題をフィルタリングして、1 つ以上の作業タイプに一致する作業項目を含む課題のみをレポート計算に含めます。
ピリオド	レポートに課題が表示される期間。作業日がこの日付範囲内にある作業項目を含む課題は、レポートの計算に含まれます。
作業項目の属性	選択した属性の作業項目に割り当てられている値に基づいて課題を含めるように課題をフィルタリングします。使用すると、属性ごとに追加の設定が表示されます。これらの設定を使用して、作業項目が選択した値のみを保存する課題をさらにフィルタリングします。設定を解除すると、レポートには、空の値を含む任意の値を含む課題が含まれます。これらの属性の値はレポートには表示されません。ただし、レポート内のデータをグループ化するためにこれらの値を使用する場合、レポートを CSV または XLSX 形式でダウンロードするときにエクスポートされるデータセットにそれらの値が含まれます。
グループ化	レポート内の値をグループ化するために使用する属性またはカスタムフィールドを決定します。次のオプションが使用できます。作業の作者、作業タイプ、作業の作者と日付オプションは、作業項目に保管されている値に基づいて課題をグループ化します。カスタム作業項目属性に保存されている値に基づいて作業項目をグループ化することもできます。他のオプションでは、結果をプロジェクトまたは親の課題でグループ化できます。カスタムフィールドの場合、単一の値を格納するフィールドでのみグループ化できます。データを `string`、`integer`、`date`、`period`、`float`、`enum[1]`、`user[1]`、`ownedField[1]`、`state[1]`、`version[1]` または `build[1]` データ型として保存するフィールドの値でグループ化できます。レポート内のデータのグループ化には、次のオプションは使用できません。タイムレポートでは、複数の値を格納するフィールド (`enum[]` フィールドタイプなど) でグループ化することはできません。これらのフィールドは、グループ化リストには表示されません。これにより、レポート内で作業項目が重複することがなくなります。データを `text`、`date and time`、`group[1]` または `group[]` として保存するフィールドでグループ化することはできません。生成されたレポートには、プレゼンテーションを切り替えるコントロールがあり、ユーザー (つまり、作業作成者) ごと、課題ごと、プロジェクトごと、または作業項目ごとに作業項目のリストを表示します。この設定でこれらの属性のいずれかを選択すると、対応するオプションが生成されたレポートから削除されます。例: データを作業の作者ごとにグループ化するようにレポートを構成すると、ユーザーごとに費やした時間のリストを表示するオプションは非表示になります。
発行フィールド	レポートに表示されている課題ごとに、選択したフィールドの現在の値を表示します。この情報は、計算されたレポートで課題ごとのオプションを使用してデータが表示されている場合にのみ表示されます。この設定は、CSV および Excel 形式でダウンロード可能なデータセットに含まれるフィールドも決定します。外部アプリケーションでタイムレポートデータを分析するために追加のデータポイントが必要な場合は、この機能を使用してください。
表示と使用を許可	レポートの可視性を設定します。デフォルトでは、レポートは所有者のみに表示されます。レポートを他のユーザーと共有するには、リストからグループまたはプロジェクトチームを選択します。
編集を許可	レポート設定を表示および編集する権限を誰に与えるかを決定します。他のユーザーがレポート設定を更新できるようにするには、リストからグループまたはプロジェクトチームを選択します。