課題をアーカイブする
課題をアーカイブすると、それを Jira で非表示にし、後で必要になったときのためにデータを保持できます。Jira インスタンスでの情報の散在を防ぐために、完了済みまたは解決済みの課題、または解決期限を過ぎた課題をアーカイブすることをおすすめします。たとえば、多くのお客様は過去 2 年間更新されていない課題をアーカイブしています。
1 つまたは複数の課題をアーカイブすることができます。大量の課題をアーカイブする場合、時間がかかる可能性があります。課題のアーカイブまたは復元時には、インデックスの再作成は不要です。
この機能は Data Center でのみ利用できます。
はじめる前に
- 既定では、課題をアーカイブまたは復元するには、Jira 管理者または Jira システム管理者である必要があります。ただし管理者はユーザーに、課題のアーカイブのグローバルまたはプロジェクト権限、および課題の復元のグローバルまたはプロジェクト権限を付与できます。プロジェクトごとのアーカイブおよび復元権限を持っていると、特定のプロジェクトの課題をアーカイブおよび復元できます。既定では、これらの権限は有効化されていません。
- アーカイブ済みの課題をエクスポートするには、Jira システム管理者である必要があります。
- アーカイブと復元に加えて、アーカイブの参照権限とプロジェクト アーカイブの参照のグローバル権限があります。これらの権限を持っていると、[アーカイブ済み課題] ページにアクセスでき、フィルターを使用して必要な課題 (すべての課題または特定のプロジェクトに属している課題) を検索できます。
課題をアーカイブする
アーカイブ用に課題を準備する必要はありません。必要に応じてあらゆる課題をアーカイブし、後から復元させることができます。課題をアーカイブする手順は、次のとおりです。
- Go to Issues.
アーカイブする課題を見つけて開き、 [その他] > [アーカイブ] を選択します。
課題はすぐにビューで非表示になり、アーカイブに移動します。各課題はそれらのすべてのサブタスクとともにアーカイブされます。
一括変更の一環として複数の課題をアーカイブ
一度に数千件の課題をアーカイブする場合、課題を手動で選択するのではなく、一括変更を実行できます。既定ではこのオプションを使用すると、現在のページのすべての課題、または最大 1000 件の課題をアーカイブできます。ただし、システム管理者は、必要に応じてこれを増加させることができます。
一括変更を行うには、Jira 管理者か委任された管理者である必要があります。
[課題] を開きます。
- 表示する課題を選択します。
現在のページまたは最大 1000 件の課題に変更を実行できます。課題が数件しかない場合、これらのオプションが表示されない場合があります。その場合、表示されている課題に対する操作のみを実行できます。
- ボードまたはバックログの 1 つまたは複数の課題を右クリックして、[一括変更] を選択することもできます。
- [課題のアーカイブ] を選択します。
- 変更に関する通知を課題に関連するユーザーに送信するかどうかを選択します。
課題はそれらのすべてのサブタスクとともにアーカイブされます。課題には複数のサブタスクが含まれている場合があるため、サブタスクの数が多いとアーカイブに時間がかかる場合があることに注意してください。
アーカイブした課題はダッシュボードや検索には表示されなくなります。Jira Software または Jira Service Management を使用している場合、他の場所でも非表示になる場合があります。詳細については、「課題への影響」を参照してください。
API によるアーカイブ
API を使用して課題をアーカイブすることもできます。API ドキュメントを参照してください。
REST API を使用してアーカイブすると、一度に 1000 件を超える課題をアーカイブできます。詳細については、「大量の課題を簡単にアーカイブする方法」を参照してください。
アーカイブした課題はどうなりますか?
次の点を念頭に置いておく必要があります。
課題
- Issues will be read-only and accessible only with a direct link, mentions in other issues or applications, or on the Archived issues page (Issues > Archived issues). You won't be able to modify them but for audit purposes, you can view or, if you're a Jira system admin, export them to a CSV file. To export archived issues with all their data, go to Issues > Archived issues, open the Export drop-down and click to export all issues or only the selected ones.
- 課題はプロジェクトの課題一覧、検索結果、JQL のオートコンプリート、ダッシュボード、またはレポートに表示されなくなります。
- Jira Software では、アーカイブ済みの課題はスクラムおよびカンバン ボードやバックログにも表示されなくなります。
- Jira Service Management の場合、アーカイブ済みの課題はカスタマー ポータルやキューなど、これまで表示されていたすべての場所で表示されなくなります。
- Archived issues are deleted from Jira index and because of that Custom Filed Optimizer does not have the full set of information about the issues which use a particular custom field. This can result in some unwanted behavior such as custom fields not displaying for archived issues and for the issues that have been restored. For more information, see Jira Knowledge Base.
インデックス
課題データはインデックスで無視され、インデックスから削除されます。Jira が保存するデータが減るため、これによって Jira のパフォーマンスが向上します。
添付ファイル
When an issue is archived, all attachments in it, including the ones in comments, are preserved. You can view and download attachments in archived issues, but you can't edit or delete these attachments.
課題の復元
すべての課題データはデータベース内に残るため、必要になったときにはいつでも復元できます。現在、一度に 1 件の課題を復元できます。
複数の課題を復元するには、REST API を使用してこれを行います。
To restore an archived issue, open it with the direct link and select Restore.
You can also see the list of all archived issues from which you can restore them. To do this:
- 画面右上で [管理] > [課題] の順に選択します。
- In the left panel, under Browse and export, select Archived issues.
- On the Archived issues page, use filters to find specific archived issues. If you want to see all archived issues, select Search.
- Go to an archived issue you want to restore.
- Select Restore and confirm your action.
The issue will be restored to its original state and brought back to Jira. While issues are being restored Jira is also reindexed so that no additional action is needed for the issues to be visible and searchable again. The issue will be restored with all its subtasks.
アーカイブ済みのプロジェクトから課題を復元する
課題を、課題が属するプロジェクトとともにアーカイブした場合、課題を復元するにはプロジェクトを復元する必要があります。プロジェクトを復元するには、「プロジェクトのアーカイブ」を参照してください。アーカイブ済みの課題の参照
すべてのアーカイブ済みの課題を参照するには、Jira システム管理者であるか、アーカイブの参照権限を持っている必要があります。特定のプロジェクトの課題を参照するには、プロジェクト アーカイブの参照権限を持っている必要があります。
To browse archived issues:
- 画面右上で [管理] > [課題] の順に選択します。
- In the left panel, under Browse and export, select Archived issues.
- On the Archived issues page, use filters to browse issues.
If your search matches more than 1000 issues, we will only be able to see the latest 1000 archived issues. In this case, you can either narrow down your search or ask your system administrator to export a complete list of archived issues.
アーカイブされた課題のエクスポート
アーカイブ済みの課題の一覧をエクスポートするには、Jira システム管理者である必要があります。
監査のため、アーカイブ済みの課題を CSV ファイルにエクスポートできます。フィルタリングされた結果をエクスポートするか、すべてのアーカイブ済みの課題をエクスポートするかを選択できます。ファイルには、個別にアーカイブされた課題と、課題が属するプロジェクトとともにアーカイブされた課題の両方が、アーカイブされた日付順で含まれます。エクスポートされた各課題には、次のフィールドが含まれます: システム フィールド、アーカイブしたユーザー、アーカイブ日、URL (課題への直接リンク)。
フィルタを使用すると、エクスポートされる課題の数を制限し、エクスポート ファイルを読みやすくできます。
[課題] > [アーカイブ済みの課題] に移動して [エクスポート] をクリックし、エクスポート オプションを選択することで、アーカイブ済みの課題を CSV にエクスポートできます。
すべての課題をエクスポートする場合、エクスポートされる課題の数が確認ポップアップに表示されます。
課題のエクスポートは、誤ってアーカイブされた可能性のある課題を迅速に追跡するのにも役立ちます。
また、REST API も使用できます。REST API を使用して課題をエクスポートするには、以下のコマンドを実行します。
|
課題のアーカイブとレポート
アーカイブされた課題はインデックスから削除されるため、レポートで使用される JQL クエリで選択されません。そのため、アーカイブされた課題はレポートに表示されません。たとえば、5 月に 30 件の課題を作成して、後ほどアーカイブし、その月に作成および解決した課題を示すレポートを実行した場合、レポートには結果が表示されません。一方で、アーカイブ機能を使用すると、アーカイブによってインデックスのサイズが小さくなるため、レポートの速度が改善する場合があります。
このため、レポートで使用されることのない古い課題はアーカイブすることをおすすめします。たとえば、1 年以上の期間のレポートを生成しない場合、それよりも古い課題を安全にアーカイブできます。これにより、課題をアーカイブしてもそれがレポートのメトリックに影響することを防ぐことができます。
Deleting archived issues
You can bulk delete archived issues through the database. Before deleting archived issues, make sure you won't need them in the future. Deleted issues can't be restored.
To delete archived issues, follow the instruction in this knowledge base article.
アーカイブについての FAQ
Q: サブタスクを復元したいのですが、課題は復元したくありません。これは可能ですか。
A: いいえ。サブタスクを復元するには、それらのサブタスクが属する課題も復元する必要があります。
Q: いくつかのアーカイブ済みの課題を含むプロジェクトを削除したいと考えています。これらの課題はどうなりますか?
A: 課題は削除され、アーカイブ済みの課題として保存されなくなります。
Q: アーカイブ済みの課題に関する情報は、バッチ通知に含まれますか?
A: はい。アーカイブ済みおよび復元済みのすべての課題について通知が送信されます。
Q: 課題をアーカイブし、この課題が属するプロジェクトをアーカイブした場合、課題を表示するにはこの課題を復元すればよいですか?
A: いいえ。課題を表示するには、まずプロジェクトを復元し、その後課題を復元する必要があります。