【Jira】課題のラベルを一括変更したい時の検索と編集手順

Jiraで課題管理をしていると、複数の課題に付与されたラベルを一度に変更したい場面があります。例えば、誤ったラベルを大量に付けてしまった、ラベル名をリニューアルした、あるいは特定のラベルを全課題から削除したいといったケースです。この記事では、Jiraの標準機能である「一括編集」を用いてラベルを効率的に変更する方法を、検索(JQL)の書き方から編集手順、注意点まで詳しく説明します。また、権限不足やスクリプト利用などの代替手段やよくある失敗パターンも取り上げ、現場で迷わないように進めます。

1. ラベル一括変更の基本的な流れ

Jiraでラベルを一括変更するには、まず変更対象の課題を正確に検索し、その後「一括編集」機能でラベルフィールドを操作します。この流れはJiraの標準機能であり、特別なプラグインやスクリプトがなくても利用できます。ただし、一括編集にはプロジェクトの「バルク編集権限」が必要です。権限がない場合は、Jira管理者に依頼するか、代替手段を検討する必要があります。

基本的な手順は次のとおりです。

1. Jiraの上部メニューから「課題」をクリックし、「詳細検索」を選びます。
2. JQLクエリを入力して、ラベルを含む課題を抽出します。例:labels = "old-label"(ラベル名は大文字小文字を区別しませんが、正確に指定します)。
3. 検索結果が表示されたら、左端のチェックボックスで全課題を選択するか、特定の課題だけ選択します。
4. 画面上部の「その他」メニューから「一括編集」をクリックします(表示されない場合は権限不足の可能性があります)。
5. 「一括編集」画面で「ラベル」フィールドを選択し、変更の種類(追加、削除、置換)を選び、値を設定します。変更をプレビューしてから「確認」で実行します。

この手順はJira CloudでもServer/Data Centerでも同様ですが、画面の文言が若干異なる場合があります。各環境の画面に従って操作してください。

2. JQL検索でラベルを正確に抽出する

一括編集の成否は、検索の正確さに大きく依存します。ラベルに関するJQLの書き方をいくつか紹介します。

2.1 単一ラベルで検索する

特定のラベルが付いている課題を検索するには labels = "ラベル名" と記述します。ラベル名にスペースが含まれる場合は二重引用符で囲みます。大文字小文字は区別されませんが、表記ゆれ(全角半角など)には注意が必要です。例えば「bug」と「Bug」は同じラベルとして扱われます。

2.2 複数ラベルで検索する

「ラベルAとラベルBの両方を持つ課題」を検索するには labels = "labelA" AND labels = "labelB" とします。「ラベルAまたはラベルBを持つ課題」は labels IN ("labelA", "labelB") で抽出できます。

2.3 ラベルが空の課題を検索する

ラベルが設定されていない課題は labels IS EMPTY で検索できます。逆にラベルが設定されている課題は labels IS NOT EMPTY です。

2.4 ラベル名を部分一致で検索する

ラベル名の一部で検索したい場合は labels ~ "キーワード" と記述します。ただし、部分一致検索はラベルの全文検索になり、予期せぬ課題が含まれる可能性があるため、確認を十分に行ってください。正確なラベル名が分かっている場合は = や IN を使うことをおすすめします。

3. 一括編集でラベルを変更する3つの方法

一括編集画面では、「ラベル」フィールドに対して次の3種類の操作が可能です。状況に応じて使い分けてください。

操作	説明	使用例
追加	既存のラベルに加えて新しいラベルを追加します。既存ラベルはそのまま残ります。	「bug」ラベルが付いている課題に「critical」ラベルを追加したい場合。
削除	指定したラベルを課題から削除します。他のラベルは影響を受けません。	「deprecated」ラベルを全課題から削除したい場合。
置換	既存のラベルを新しいラベルで置き換えます。元のラベルは削除され、新しいラベルのみになります。複数ラベルがある場合は全てのラベルが置き換わるわけではなく、選択したラベルが置き換わる動作に注意が必要です。	「urgent」ラベルを「high-priority」に置き換えたい場合。

なお、「置換」は一括編集画面上で「既存の値を新しい値に変更」と表示されることがあります。この操作を行うと、課題に付いているすべてのラベルが削除され、指定した1つのラベルだけが設定される、という誤解がありますが、実際には「ラベルフィールド全体を置換する」わけではありません。Jiraの一括編集における置換は、現時点では「既存のラベルを一旦クリアして新しいラベルを設定する」動作になる場合と、「該当ラベルだけを置換する」動作になる場合があり、バージョンや設定によって挙動が異なる可能性があります。そのため、置換を利用する際は、必ずプレビューで影響範囲を確認してください。安全を期すなら、最初に「削除」で不要ラベルを消し、その後「追加」で新しいラベルを付ける手順をおすすめします。

4. 失敗パターンと対処法

ラベルの一括変更でよくある失敗とその対処法をまとめます。

• パターン1:一括編集ボタンが表示されない – 権限不足が原因です。プロジェクトのバルク編集権限がないか、管理者が権限を制限しています。Jira管理者に連絡し、権限を付与してもらうか、管理者に代行してもらいます。
• パターン2:ラベル名の表記ゆれで検索ヒットしない – ラベル名に余分なスペースや全角文字が混入している可能性があります。Jiraの管理画面(またはプロジェクト設定)でラベル一覧を確認し、正しい表記を把握しましょう。また、JQLの「~」を使った部分一致で広めに検索し、結果を目視確認する方法もあります。
• パターン3:一度に大量の課題を変更しようとしてタイムアウト – 一括編集はサーバーに負荷をかけます。1000課題を超えるような場合は、検索条件を分割(例えばプロジェクトごと、日付範囲ごと)して複数回に分けて実行します。Jira管理者に相談し、メンテナンス時間帯に実行することも検討してください。
• パターン4:置換操作で想定と違う結果になる – 上記の通り、置換の挙動は環境依存です。必ず検索結果から一部の課題だけを選択してテスト実行し、結果を確認してから全体に適用します。
• パターン5:ラベルが編集できない(グレーアウト) – 課題の状態(例えばクローズ済み)や画面スキームでラベルフィールドが非表示になっている可能性があります。管理者に確認してください。

5. 管理者に確認すべき情報

ラベルの一括変更をスムーズに進めるため、事前にJira管理者に次の点を確認しておくとよいでしょう。

• 自分がバルク編集権限を持っているかどうか。
• プロジェクトでラベルが有効になっているか、カスタムフィールドとしてラベルを使用しているか。
• ラベル名の一覧(管理画面の「ラベル」一覧)を出力してもらい、正式なラベル名を確認する。
• 大量の課題を一括編集する場合の推奨手順(分割単位、推奨時間帯など)。
• もし標準の一括編集で不十分な場合、Automation for Jira(自動化ルール)やScriptRunnerなどのアドオンで実現可能かどうか。

6. よくある質問(FAQ)

Q1. ラベルを完全に削除して空にしたい場合はどうすればいいですか?

一括編集で「ラベル」フィールドを「削除」にしても空にはなりません。「削除」は特定のラベルを削除する操作です。ラベルを空にする(ラベルなしの状態にする)には、現在付いているラベルをすべて削除する必要があります。labels IS NOT EMPTY で検索し、一括編集で「置換」を選択し、置換先の値を空欄にして実行します。ただし、この操作はラベルフィールド全体をクリアします。必ずプレビューで確認してください。

Q2. ラベル名を一括でリネーム(変更)できますか?

標準機能ではラベル名そのものをリネームする機能はありません。代わりに、古いラベルを削除し、新しいラベルを追加する形で実現します。labels = "old" で検索し、一括編集で「削除」(oldを削除)と「追加」(newを追加)の2段階で行うか、置換機能を利用します(動作確認推奨)。

Q3. 特定のプロジェクトだけラベルを変更したいのですが、JQLはどう書けばいいですか?

project = "プロジェクト名" AND labels = "ラベル名" のようにプロジェクト条件を追加します。複数プロジェクトの場合は project IN ("A", "B") とします。

Q4. 一括編集で変更した内容を元に戻したい場合は?

一括編集は元に戻せない操作です。変更前にバックアップとして、課題の一覧をExcelなどにエクスポートしておくことをおすすめします。また、変更後に問題が発生した場合、個別に手動で戻すか、管理者がデータベースリストアなどの対応を行う必要があります。

7. まとめ

Jiraで課題のラベルを一括変更するには、JQLで対象を正確に検索し、一括編集機能で追加・削除・置換を実行します。権限やラベル名の表記ゆれに注意し、大量の課題は分割実行することでトラブルを防げます。置換操作は環境によって挙動が異なるため、必ずプレビューで確認してから適用してください。管理者と連携しながら、安全かつ効率的にラベルを管理しましょう。