

Amazon CodeCatalyst は新規のお客様には提供されなくなりました。既存のお客様は、通常どおりサービスを引き続き使用できます。詳細については、「[CodeCatalyst から移行する方法](migration.md)」を参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# CodeCatalyst で問題を使用して作業の追跡と整理を行う
<a name="issues"></a>

CodeCatalyst では、機能、バグ、およびプロジェクトに関連するその他の作業をモニタリングできます。各作業は、*問題*と呼ばれる個別のレコードに保持されます。問題にタスクのチェックリストを追加することで、さらに小さな目標に分割できます。各問題には、説明、担当者、ステータスなどのプロパティを含めることができます。このプロパティは、検索、グループ化、フィルタリングに使用できます。デフォルトのビューを使用して問題を表示することも、カスタムフィルタリング、ソート、またはグループ化を使用して独自のビューを作成することもできます。問題に関連する概念の詳細については、「[問題の概念](issues-concepts.md)」を参照してください。最初の問題を作成する方法については、「[CodeCatalyst で問題を作成する](issues-create-issue.md)」を参照してください。

以下は、問題を使用するチームで考えられるワークフローの 1 つです。

Jorge Souza は、プロジェクトに取り組んでいるデベロッパーです。Jorge と他のプロジェクトメンバーである Li Juan、Mateo Jackson、Wang Xiulan は協力して、どのような作業を行う必要があるかを洗い出しています。毎日、Jorge と他のデベロッパーは Wang Xiulan が取り仕切る進捗会議を行っています。Jorge らは、ボードのチームビューの 1 つに移動してボードを表示します。ビューを作成することで、ユーザーとチームはフィルター、グループ理分け、問題のソートを保存して、各自の指定した条件に一致する問題を簡単に表示できます。こうしたビューには、**[担当者]** 別にグループ化され、**[優先度]** 別にソートされた問題が含まれています。これにより、各デベロッパーにとって問題の最も重要な問題とステータスがわかるようになっています。タスクが割り当てられると、Jorge はタスクごとに問題を作成して作業計画を立てます。問題を作成する場合、Jorge は適切な **[ステータス]**、**[優先度]** を選択し、作業の工数の **[見積もり]** を設定することができます。より大きな問題について、Jorge はタスクを問題に追加して、作業を小さな目標に分割します。Jorge は、**バックログ**などの下書きステータスを設定した問題を作成します。これは、すぐに着手する予定がないためです。下書きステータスの問題は、**[ドラフト]** ビューに表示されます。このビューで、計画および優先順位付けを行います。Jorge が作業を開始する準備ができたら、そのステータスを別のカテゴリ (**[未開始]**、**[開始済み]**、または **[完了済み]**) のステータスに更新して、対応する問題をボードに移動します。各タスクでの作業中、チームはタイトル、ステータス、担当者、ラベル、優先度、見積もりでフィルタリングして、指定されたパラメータに一致する特定の問題または同様の問題を検索できます。ボードを使用すると、Jorge とチームは、各問題に対して完了したタスクの数を確認し、タスクが完了するまで各問題を 1 つのステータスから次のステータスにドラッグして、毎日の進捗状況を追跡できます。プロジェクトの進捗に伴って、完了した問題は **[完了済み]** ステータスに蓄積されます。Wang Xiulan は、デベロッパーが現在および今後の作業に関連する問題に集中できるように、クイックアーカイブボタンを使用して完了済みの問題をアーカイブすることで、ビューから削除することにしました。

作業計画を立てる際、プロジェクトに取り組むデベロッパーは、バックログからボードに移動する問題を検索するために、**[ソート基準]** と **[グループ化の基準]** を選択します。最も優先度の高い顧客リクエストに基づいて問題をボードに追加する選択をする場合、ボードを **[顧客リクエスト]** ラベルでグループ化し、**[優先度]** でソートします。また、見積もりでソートして、達成可能な作業量を引き受けるようにすることもできます。プロジェクトマネージャーの Saanvi Sarkar は、プロジェクトの成功に各問題の重要性が優先順位に正確に反映されるように、バックログを定期的にレビューして整理します。



**Topics**
+ [問題の概念](issues-concepts.md)
+ [問題を使用して作業を追跡する](issues-tracking-work.md)
+ [バックログ、ラベル、ボードを使用して作業を整理する](issues-organizing-work.md)
+ [CodeCatalyst の問題のクォータ](issues-quotas.md)

# 問題の概念
<a name="issues-concepts"></a>

問題を作成することで、プロジェクト内で行われている作業を迅速かつ効率的に追跡できます。問題を使用して、毎日の進捗会議での作業についての議論、作業の優先順位付けなどを行うことができます。

このページには、CodeCatalyst で問題を効果的に使用するためのヒントとなる概念の一覧を掲載しています。

## アクティブな問題
<a name="issues-concepts-active-issue-definition"></a>

*アクティブな問題*とは、**[下書き]** ステータスにある、またはアーカイブされていない問題のことです。つまり、アクティブな問題は、**[未開始]**、**[開始済み]**、**[完了済み]** のいずれかのステータスカテゴリのステータスを持つ問題です。ステータスとステータスカテゴリの詳細については、「[ステータスとステータスカテゴリ](#issues-concepts-status-definition)」を参照してください。

プロジェクト内のすべてのアクティブな問題は、デフォルトの **[アクティブな問題]** ビューから表示できます。

## アーカイブされた問題
<a name="w2aac41c15b4b9"></a>

*アーカイブされた問題*とは、プロジェクトに関係なくなった問題のことです。例えば、問題が完了し、**[完了]** 列に表示する必要がなくなった場合や、誤って作成された場合は、[問題をアーカイブ](issues-archive-issues.md)できます。アーカイブされた問題は、必要に応じてアーカイブ解除できます。

## 担当者
<a name="w2aac41c15b4c11"></a>

*担当者*とは、問題が割り当てられたユーザーです。検索時にそのユーザーがリストに表示されない場合は、プロジェクトに追加されていません。ユーザーを追加するには、「[プロジェクトへのユーザーの招待](projects-members.md#projects-members-add)」を参照してください。問題に対して複数の担当者を有効にするには、「[複数の担当者を有効または無効にする](issues-settings-multiple-assignees.md)」を参照してください。複数の担当者が割り当てられた問題は、それぞれの担当者を表す異なる色のアイコンがボードに表示されます。

## カスタム フィールド
<a name="w2aac41c15b4c13"></a>

*カスタムフィールド*を使用すると、プロジェクト内の問題を追跡および維持するために、必要に応じて問題のさまざまな属性をカスタマイズできます。例えば、ロードマッピング用のフィールド、具体的な期日、リクエスタフィールドなどを追加できます。

## Estimate
<a name="w2aac41c15b4c15"></a>

アジャイル開発では、*見積り*はストーリーポイントと呼ばれます。問題の見積もりを使用して、問題のあいまいさと複雑さのほかにも、必要な工数を表すことができます。リスク、難易度、不明点が多い問題については、見積りを高く設定することを検討してください。

見積もりのタイプとその設定方法の詳細については、「[問題にかかる工数の見積もりを設定する](issues-settings-estimation.md)」を参照してください。

## 問題
<a name="issues-concepts-issue-definition"></a>

*問題*は、プロジェクトに関連する作業を追跡するレコードです。プロジェクトに関連する機能、タスク、バグなど、あらゆる作業に対して問題を作成できます。アジャイル開発を使用している場合、問題でエピックやユーザーストーリーを記述することもできます。

## ラベル
<a name="w2aac41c15b4c19"></a>

*ラベル*は、問題をグループ化、ソート、フィルタリングするために使用します。新しいラベル名を入力するか、入力されたリストからラベルを選択できます。このリストは、プロジェクトで最近使用されたラベルで構成されます。問題には複数のラベルを設定でき、問題からラベルを削除することもできます。ラベルをカスタマイズするには、「[ラベルを使用して作業を分類する](issues-labels.md)」を参照してください。

## 優先度
<a name="w2aac41c15b4c21"></a>

*優先度*とは、問題の重要性のレベルを指します。**低**、**中**、**高**、**優先度なし**の 4 つのオプションがあります。

## ステータスとステータスカテゴリ
<a name="issues-concepts-status-definition"></a>

*ステータス*は問題の現在の状態であり、開始から完了までのライフサイクルを通じて問題の進行状況をすばやく確認するために使用します。すべての問題にステータスが必要です。各ステータスは*ステータスカテゴリ*に属します。ステータスカテゴリは、ステータスを整理し、デフォルトの問題ビューに表示させるために使用されます。

CodeCatalyst には、5 つのデフォルトステータスと 4 つのステータスカテゴリがあります。他のステータスは作成できますが、他のステータスカテゴリは作成できません。次のリストには、デフォルトのステータスとそのステータスカテゴリが括弧内に含まれています。**バックログ (下書き)**、**To do (未開始)**、**進行中 (開始済み)**、**レビュー中 (開始済み)**、**完了 (完了済み)**。

ステータスの使用の詳細については、「[カスタムステータスを使用して作業を追跡する](issues-customize-statuses.md)」を参照してください。

## タスク
<a name="w2aac41c15b4c25"></a>

*タスク*を問題に追加して、その問題の作業をさらに分類して整理できます。タスクは、作成時に問題に追加することも、既存の問題に追加することもできます。問題を表示する際、タスクの順序を変更、削除、または完了としてマークできます。

## ビュー
<a name="issues-concepts-views-definition"></a>

CodeCatalyst プロジェクトの問題は*ビュー*に表示されます。ビューは、リスト形式で問題を表示するグリッドビューか、問題ステータス別に整理された列にタイルとして問題を表示するボードビューのいずれかです。デフォルトのビューは 4 つあり、[カスタムのグループ化、フィルタリング、ソートを使用して独自のビューを作成できます](issues-creating-view.md)。次のリストには、4 つのデフォルトビューの詳細が含まれています。
+ **[下書き]** ビューは、現在処理されていない問題を示すグリッドビューです。**[下書き]** ステータスカテゴリのステータスで作成された問題は、このビューに表示されます。このビューは、チームが、どの問題がまだ定義されているか、または割り当て待ちおよび処理待ちかを確認するために使用できます。
+ **[アクティブな問題]** ビューは、現在取り組んでいるすべての問題のボードビューです。**[未開始]**、**[開始済み]**、または **[完了済み]** ステータスカテゴリのステータスを持つ問題は、このビューに表示されます。
+ **[すべての問題]** ビューは、*[下書き]* と *[アクティブな問題]* の両方、プロジェクト内のすべての問題を表示するグリッドビューです。
+ **[アーカイブ済み]** ビューには、アーカイブされたすべての問題が表示されます。

# 問題を使用して作業を追跡する
<a name="issues-tracking-work"></a>

問題を使用して、プロジェクトでの作業を計画および追跡できます。各問題は、作業の一部であり、個別のレコードに保持されています。問題はタスクに分割され、その問題の作業をさらに整理して追跡できます。また、問題間のリンクを作成して、関連する作業の追跡、作業の整理と分類に役立つラベルの追加、問題のグループ化、作業の優先順位の割り当て、作業がブロックされているかどうかの表示に役立てることもできます。

問題や一連の問題に取り組む準備ができたら、作業を見積もってユーザーに割り当て、作業とその進行状況を他のユーザーが理解できるようなコメントを追加することができます。問題はエクスポートして、含まれる情報を他の形式に取り込むこともできます。

# CodeCatalyst で問題を作成する
<a name="issues-create-issue"></a>

開発チームは、作業を追跡および管理するために問題を作成します。プロジェクト内で、必要に応じて問題を作成できます。例えば、コード内の変数の更新を追跡する問題を作成できます。プロジェクト内の他のユーザーに問題を割り当てる、作業の追跡に役立つラベルを使用するなどが可能です。

CodeCatalyst で問題を作成する手順は次のとおりです。

**問題を作成するには**

1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。

1. 問題を作成するプロジェクトに移動します。

1. プロジェクトのホームページで、**[問題の作成]** を選択します。または、ナビゲーションペインで **[問題]** を選択します。

1. **[問題の作成]** を選択します。
**注記**  
グリッドビューを使用している場合は、問題をインラインで追加することもできます。

1. 問題のタイトルを入力します。

1. (オプション) **[説明]** を入力します。Markdown を使用して書式を追加できます。

1. (オプション) 問題の **[ステータス]**、**[優先度]**、**[見積もり]** を選択します。
**注記**  
プロジェクトの見積り設定が **[見積りを非表示]** に設定されている場合、**[見積り]** フィールドは表示されません。

1. (オプション) 問題にタスクを追加します。タスクは、問題の作業を小さな目標に分解するために使用できます。タスクを追加するには、**[\$1 タスクの追加]** を選択します。次に、テキストフィールドにタスク名を入力し、Enter キーを押します。タスクを追加したら、チェックボックスをオンにして完了としてマークするか、チェックボックスの左側でタスクをクリックしてドラッグすることで順序を変更できます。

1. (オプション) 既存のラベルを追加するか、新しいラベルを作成し、**[\$1 ラベルを追加]** を選択して追加します。

   1. 既存のラベルを追加するには、リストからラベルを選択します。フィールドに検索語を入力して、プロジェクト内のその語句を含むすべてのラベルを検索できます。

   1. 新しいラベルを作成して追加するには、作成するラベルの名前を検索フィールドに入力し、Enter キーを押します。

1. (オプション) **[\$1 担当者を追加]** を選択して、担当者を追加します。**[\$1 自分を追加]** を選択すると、自分を担当者としてすばやく追加できます。
**ヒント**  
**Amazon Q** に問題を割り当てることで、Amazon Q で問題の解決を試みることができます。詳細については、「[チュートリアル: CodeCatalyst の生成 AI 機能を使用して開発作業を高速化する](getting-started-project-assistance.md)」を参照してください。この機能は、米国西部 (オレゴン) リージョンでのみ利用可能です。  
この機能を使用するには、スペースに対して生成 AI 機能を有効にする必要があります。詳細については、「[Managing generative AI features](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html)」を参照してください。

1. (オプション) 既存の **[カスタムフィールド]** を追加するか、新しいカスタムフィールドを作成します。問題には、複数のカスタムフィールドを含めることができます。

   1. 既存のカスタムフィールドを追加するには、リストからカスタムフィールドを選択します。フィールドに検索語を入力して、プロジェクト内のその語句を含むすべてのカスタムフィールドを検索できます。

   1. 新しいカスタムフィールドを作成して追加するには、作成するカスタムフィールドの名前を検索フィールドに入力し、Enter キーを押します。次に、作成するカスタムフィールドのタイプを選択し、値を設定します。

1. **[問題の作成]** を選択します。右下隅に通知が表示されます。問題が正常に作成された場合、問題が正常に作成されたことを示す確認メッセージが表示されます。問題が正常に作成されなかった場合、失敗の理由を示すエラーメッセージが表示されます。その後、**[再試行]** を選択して問題を編集し、作成を再試行するか、**[破棄]** を選択して問題を破棄できます。どちらのオプションを選択した場合も、通知は解除されます。
**注記**  
プルリクエストの作成時に、プルリクエストを問題にリンクすることはできません。ただし、作成した後に[問題を編集](issues-edit-issue.md)して、プルリクエストへのリンクを追加できます。

## Amazon Q に割り当てた問題を作成および処理する際のベストプラクティス
<a name="issues-create-issue-assign-genai-best-practices"></a>

問題を作成すると、問題がなかなか解決されない場合があります。その原因は複雑でさまざまです。誰がその問題に取り組むべきかが明確でないことが原因である場合があります。また、問題によっては、コードベースの特定の部分に関する調査や専門知識が必要で、その作業に最適な担当者が他の問題で忙しいこともあります。他の緊急の作業が優先される場合もあります。こうした原因の 1 つまたはすべてが要因となり、問題が取り組まれない事態を招く可能性があります。CodeCatalyst には、Amazon Q と呼ばれる生成 AI アシスタントとの統合機能が組み込まれています。Amazon Q は、問題のタイトルとその説明に基づいて問題を分析できます。Amazon Q に問題を割り当てると、評価用のソリューションの試案を作成しようとします。これにより、すぐにリソースを割くことができない問題の解決には Amazon Q を活用しながら、自分やチームは注意が必要な問題に集中して取り組むことで最適化を図ることができます。

**注記**  
**Amazon Bedrock を利用**: [自動不正検出](https://docs.aws.amazon.com//bedrock/latest/userguide/abuse-detection.html) AWS を実装します。Amazon Q Developer Agent for Software Development の「**説明を記述する**」、「**内容の要約を作成する**」、「**タスクを推奨する**」、「**Amazon Qを使用してプロジェクトに機能を作成または追加する**」、「**Amazon Q に問題を割り当てる**」機能は Amazon Bedrock を基盤に構築されているため、ユーザーは Amazon Bedrock に実装されている統制を最大限に活用して、AI の安全性、セキュリティ、責任ある使用を徹底することができます。

Amazon Q は、単純な課題や簡単な問題で優れたパフォーマンスを発揮します。最良の結果を得るには、何をしてもらいたいかを明確に説明する簡潔な表現を使用してください。以下は、Amazon Q が取り組むために最適化された問題を作成するためのベストプラクティスです。

**重要**  
生成 AI 機能は、米国西部 (オレゴン) リージョンでのみ使用できます。
+ **シンプルにまとめる**。Amazon Q は、問題のタイトルと説明を見れば理解できる単純なコード変更や修正に最適です。あいまいなタイトルや飾りすぎた表現、矛盾する説明を含む問題を割り当てないでください。
+ **具体的に記述する**。問題を解決するために必要な変更についてより正確に多くの情報を提供できればできるほど、Amazon Q が問題の解決策を考案できる可能性が高くなります。可能であれば、変更する API の名前、更新するメソッド、変更が必要なテスト、その他考えられる詳細など、具体的な詳細を含めます。
+ **Amazon Q に割り当てる前に、問題のタイトルと説明にすべての詳細が含まれていることを確認してください**。Amazon Q に割り当てた後、問題のタイトルや説明を変更することはできません。そのため、Amazon Q に割り当てる前に、問題に必要なすべての情報が提供されていることを確認してください。
+ **1 つのソースリポジトリでのコード変更が必要な問題のみを割り当てる**。Amazon Q は、CodeCatalyst の 1 つのソースリポジトリのコードのみを処理できます。リンクされたリポジトリはサポートされていません。Amazon Q にその問題を割り当てる前に、問題が 1 つのソースリポジトリでの変更のみを必要とすることを確認してください。
+ **各ステップを承認するために、Amazon Q が推奨するデフォルトを使用する**。デフォルトでは、Amazon Q は実行する各ステップに対してユーザーの承認を必要とします。これにより、問題に関するコメントだけでなく、Amazon Q が作成するプルリクエストでも Amazon Q とやりとりできます。これにより、Amazon Q をよりインタラクティブに操作することができ、問題解決に向けた Amazon Q のアプローチを調整し、Amazon Q が作成したコードを改良できます。
**注記**  
Amazon Q は、問題やプルリクエストに関する個々のコメントには応答しませんが、アプローチを再検討したり、リビジョンを作成したりするように求められると、レビューを行います。
+ **Amazon Q が提案するアプローチを必ず慎重にレビューする**。アプローチを承認すると、Amazon Q はそのアプローチに基づいてコードの生成作業を開始します。作業を進めるように Amazon Q に指示する前に、アプローチが適切かどうか、想定されるすべての詳細が含まれていることを確認してください。
+ **Amazon Q がワークフローで作業させる場合は、そのワークフローをレビューする前にデプロイする可能性のある既存のワークフローがないことを確認してください**。プロジェクトで、プルリクエストのイベントで実行を開始するようにワークフローが設定されている場合があります。その場合、Amazon Q が作成する、ワークフロー YAML の作成または更新を含むプルリクエストは、プルリクエストに含まれるワークフローの実行を開始する可能性があります。ベストプラクティスとして、Amazon Q がワークフローファイルを操作することを許可しないでください。許可する場合は、Amazon Q が作成したプルリクエストをレビューして承認する前に、これらのワークフローを自動的に実行するワークフローがプロジェクトにないことを確認してください。

詳細については、「[チュートリアル: CodeCatalyst の生成 AI 機能を使用して開発作業を高速化する](getting-started-project-assistance.md)」および「[Managing generative AI features](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html)」を参照してください。

## 問題を見積もる
<a name="issues-issue-estimation"></a>

アジャイル開発では、*見積り*はストーリーポイントと呼ばれます。問題の見積もりを使用して、問題のあいまいさと複雑さのほかにも、必要な工数を表すことができます。リスク、難易度、不明点が多い問題については、見積りを高く設定することを検討してください。

問題の見積もりを開始する前に、まずプロジェクトに使用する見積りのタイプを選択する必要があります。デフォルトで、次の 2 つのタイプから選択できます。**[T シャツサイズ]** または **[フィボナッチ数列]** を効果的に使用するには、各サイズが何を表すのかについて、チーム内で合意する必要があります。各見積りがチームにとって何を表すかを一緒に決めた後、その見積りを各問題に適用し始めます。定期的なレビューを検討する 

CodeCatalyst の問題にかかる工数の見積もりの設定を行う手順は次のとおりです。

**問題の工数の見積もりを設定するには**

1. ナビゲーションペインで、**[問題]** を選択します。

1. **[アクティブな問題]** を選択して **[問題ビューのスイッチャー]** ドロップダウンメニューを開き、**[設定]** を選択します。

1. **[基本設定]** セクションの **[見積もり]** で、見積もり値の表示方法を選択します。利用可能な見積りのタイプは、**[T シャツサイズ]**、**[フィボナッチ数列]**、または **[見積りの非表示]** です。プロジェクトの見積り設定が **[見積りを非表示]** に設定されている場合、プロジェクトの問題に **[見積り]** フィールドは表示されません。

   見積もりタイプを更新すると、データは失われず、すべての問題の見積もり値が自動的に変換されます。次の表は、変換対応表です。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/codecatalyst/latest/userguide/issues-tracking-work.html)

問題の見積りを追加または変更するには、[問題を編集](issues-edit-issue.md)します。

# CodeCatalyst で問題の編集および共同作業を行う
<a name="issues-edit-collaborate-issue"></a>

**Contents**
+ [問題を編集する](issues-edit-issue.md)
+ [添付ファイルの使用](issues-attachments.md)
  + [添付ファイルを表示および管理する](issues-settings-attachments.md)
+ [問題のタスクを管理する](issues-tasks.md)
+ [問題を別の問題にリンクする](issues-link-issue.md)
+ [問題をブロック状態またはブロック状態解除としてマークする](issues-mark-as-blocked.md)
+ [コメントを追加、編集、削除する](issues-comment.md)
  + [コメントでメンションを使用する](issues-mentions-comment.md)

# 問題を編集する
<a name="issues-edit-issue"></a>

問題のタイトル、説明、ステータス、担当者、優先度、見積り、ラベルを編集する手順は次のとおりです。

**問題を編集するには**

1. 編集する問題を選択して、問題の詳細を表示します。問題の検索方法については、「[問題を検出して表示する](issues-view.md)」を参照してください。

1. 問題のタイトルを編集するには、タイトルを選択し、新しいタイトルを入力して Enter キーを押します。

1. 説明を編集するには、説明を選択し、新しい説明を入力して Enter キーを押します。Markdown を使用して書式を追加できます。

1. **[タスク]** では、問題のタスクを表示および管理できます。タスクがない場合は、Amazon Q に問題を分析させ、その問題を個別のタスクに分割し、各タスクをユーザーに割り当てることができるようタスクを提案させることができます。詳細については、「[問題のタスクを管理する](issues-tasks.md)」を参照してください。

1. **[ステータス]**、**[見積り]**、**[優先度]** を編集するには、それぞれのドロップダウンメニューからオプションを選択します。

1. **[ラベル]** では、既存のラベルの追加、新しいラベルの作成、ラベルの削除を行うことができます。

   1. 既存のラベルを追加するには、**[\$1 ラベルを追加]** を選択し、リストからラベルを選択します。フィールドに検索語を入力して、プロジェクト内のその語句を含むすべてのラベルを検索できます。

   1. 新しいラベルを作成して追加するには、**[\$1 ラベルを追加]** を選択し、検索フィールドに作成するラベルの名前を入力して Enter キーを押します。

   1. ラベルを削除するには、削除するラベルの横にある **[X]** アイコンをクリックします。すべての問題からラベルを削除すると、ラベルは問題の **[設定]** の**[ラベル]** セクションの **[未使用のラベル]** セクションに表示されます。フィルターを使用したり、問題にラベルを追加したりする際に、未使用のラベルはラベルのリストの末尾に表示されます。すべてのラベル (使用済みおよび未使用) の概要と、各ラベルを含む問題は、問題の **[設定]** で確認できます。

1. 問題を割り当てるには、**[担当者]** セクションで **[\$1 担当者を追加]** を選択し、リストから担当者を検索して選択します。**[\$1 自分を追加]** を選択すると、自分を担当者としてすばやく追加できます。

1. **[添付ファイル]** では、添付ファイルを追加、ダウンロード、削除できます。詳細については、「[添付ファイルの使用](issues-attachments.md)」を参照してください。

1. プルリクエストをリンクするには、**[プルリクエストをリンク]** を選択し、リストからプルリクエストを選択するか、URL または ID を入力します。プルリクエストのリンクを解除するには、リンク解除アイコンをクリックします。
**ヒント**  
問題にプルリクエストへのリンクを追加したら、リンクされたプルリクエストのリストでその ID を選択することで、問題にすばやく移動できます。プルリクエストの URL を使用して、問題ボードとは異なるプロジェクトにあるプルリクエストをリンクできますが、そのプロジェクトのメンバーであるユーザーのみがそのプルリクエストを表示する、またはそのプルリクエストに移動することができます。

1. (オプション) 既存のカスタムフィールドの追加および設定、新しいカスタムフィールドの作成、またはカスタムフィールドの削除を行います。問題には、複数のカスタムフィールドを含めることができます。

   1. 既存のカスタムフィールドを追加するには、リストからカスタムフィールドを選択します。フィールドに検索語を入力して、プロジェクト内のその語句を含むすべてのカスタムフィールドを検索できます。

   1. 新しいカスタムフィールドを作成して追加するには、作成するカスタムフィールドの名前を検索フィールドに入力し、Enter キーを押します。次に、作成するカスタムフィールドのタイプを選択し、値を設定します。

   1. カスタムフィールドを削除するには、削除するカスタムフィールドの横にある **[X]** アイコンをクリックします。すべての問題からカスタムフィールドを削除すると、カスタムフィールドは削除され、フィルタリング時に表示されなくなります。

# 添付ファイルの使用
<a name="issues-attachments"></a>

CodeCatalyst の問題に添付ファイルを追加することで、関連ファイルに簡単にアクセスできるようになります。問題の添付ファイルを管理する手順は次のとおりです。

問題に追加された添付ファイルのサイズは、スペースのストレージクォータにカウントされます。プロジェクトの添付ファイルの表示と管理については、「[添付ファイルを表示および管理する](issues-settings-attachments.md)」を参照してください。

**重要**  
問題への添付ファイルは、Amazon CodeCatalyst によってスキャンも分析もされません。どのユーザーでも、悪意のあるコードやコンテンツが含まれている可能性がある添付ファイルを問題に追加することができます。添付ファイルの管理、そして悪意のあるコード、コンテンツ、ウイルスからの保護に関するベストプラクティスをユーザーに周知徹底してください。

**添付ファイルを追加、ダウンロード、削除するには**

1. 添付ファイルを管理する問題を選択します。問題の検索方法については、「[問題を検出して表示する](issues-view.md)」を参照してください。

1. 添付ファイルを追加するには、**[ファイルのアップロード]** を選択します。オペレーティングシステムのファイルエクスプローラーで目的のファイルに移動し、選択します。**[開く]** を選択して添付ファイルとして追加します。添付ファイルのサイズ上限などのクォータ情報については、「[CodeCatalyst の問題のクォータ](issues-quotas.md)」を参照してください。

   添付ファイルの名前とコンテンツタイプには、次の制限があります。
   + ファイル名では、次の文字は使用できません。
     + 制御文字: `0x00–0x1f` および `0x80–0x9f`
     + 予約文字: `/`、`?`、`<`、`>`、`\`、`:`、`*`、`|`、`"`
     + Unix 予約ファイル名: `.` および `..`
     + 末尾のピリオドとスペース
     + Windows 予約ファイル名: `CON, PRN, AUX, NUL, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, and LPT9`
   + 添付ファイルのコンテンツタイプは、次のメディアタイプのパターンに従う必要があります。

     ```
     media-type = type "/" [tree "."] subtype ["+" suffix]* [";" parameter];
     ```

     例えば、`text/html; charset=UTF-8`。

1. 添付ファイルをダウンロードするには、ダウンロードする添付ファイルの横にある省略記号メニューをクリックし、**[ダウンロード]** を選択します。

1. 添付ファイルの URL をコピーするには、URL をコピーする添付ファイルの横にある省略記号メニューをクリックし、**[URL のコピー]** を選択します。

1. 添付ファイルを削除するには、削除する添付ファイルの横にある省略形メニューをクリックし、**[削除]** を選択します。

# 添付ファイルを表示および管理する
<a name="issues-settings-attachments"></a>

問題設定で、プロジェクトの問題に追加されたすべての添付ファイルを含む表を表示できます。この表には、各添付ファイルについて、コンテンツタイプ、追加日時、追加した問題とそのステータス、ファイルサイズなどの詳細が記載されています。

この表を使用すると、完了済みまたはアーカイブ済みの問題に添付された大きなファイルを簡単に特定して削除し、スペースのストレージ容量を解放できます。

**重要**  
問題への添付ファイルは、Amazon CodeCatalyst によってスキャンも分析もされません。どのユーザーでも、悪意のあるコードやコンテンツが含まれている可能性がある添付ファイルを問題に追加することができます。添付ファイルの管理、そして悪意のあるコード、コンテンツ、ウイルスからの保護に関するベストプラクティスをユーザーに周知徹底してください。

**プロジェクト内のすべての問題の添付ファイルを表示および管理するには**

1. ナビゲーションペインで、**[問題]** を選択します。

1. 省略記号アイコンをクリックし、**[設定]** を選択します。

1. **[添付ファイル]** タブを選択します。

# 問題のタスクを管理する
<a name="issues-tasks"></a>

*タスク*を問題に追加することで、その問題の作業をさらに分類、整理、トラッキングできます。タスクは自分で作成することも、Amazon Q を使用して、問題の分析とその複雑さに基づいてタスクを提案させることもできます。

Amazon Q Developer は、生成 AI を活用した会話アシスタントであり、 AWS アプリケーションの理解、構築、拡張、運用に役立ちます。構築を加速するために AWS、Amazon Q を強化するモデルは、より完全で実用的な参照された回答を生成するために、高品質の AWS コンテンツで強化されています。詳細については、「Amazon Q Developer ユーザーガイド」の「[What is Amazon Q Developer?](https://docs.aws.amazon.com/amazonq/latest/aws-builder-use-ug/what-is.html)」を参照してください。

**問題のタスクを管理するには**

1. タスクを管理する問題を選択します。問題の検索方法については、「[問題を検出して表示する](issues-view.md)」を参照してください。

1. **[タスク]** では、問題のタスクを表示および管理できます。

   1. タスクを追加するには、テキストフィールドにタスク名を入力し、Enter キーを押します。

   1. 問題にタスクがない場合は、**[タスクを推奨する]** を選択して、Amazon Q に問題を分析させ、問題のタイトル、説明、問題の複雑さの分析とリポジトリコードに基づいてタスクを作成することができます。問題のコードを含むソースリポジトリを指定する必要があります。**[タスク推奨分析を開始する]** を選択して、タスク推奨分析を開始します。このダイアログは閉じます。推奨が完了したら、**[推奨タスクを表示]** を選択してタスクを確認し、タスクの削除やリストへの追加、推奨タスクの順序変更など、必要なアクションを実行してから、**[タスクの作成]** を選択します。

      タスクが作成されたら、ユーザーに割り当てることができ、手動で作成したタスクと同じ方法で操作できます。

   1. タスクを完了としてマークするには、タスクのチェックボックスをオンにします。

   1. タスクの詳細を表示または更新するには、リストからタスクを選択します。

   1. タスクの順序を変更するには、チェックボックスの左側でタスクを選択してドラッグします。

   1. タスクを削除するには、タスクの省略記号メニューを選択し、**[削除]** を選択します。

# 問題を別の問題にリンクする
<a name="issues-link-issue"></a>

問題が別の問題での作業に関連する場合は、リンクできます。これは、作業項目間の依存関係を理解し、追跡するための簡単な方法です。

問題をリンクする場合、次の 4 つの状態から選択できます。
+ 関連: この状態を使用して、リンクされた問題に関連する作業を示します。
+ ブロック元: この状態を使用して、問題がリンクされた問題によって進行を妨げられていることを示します。
+ ブロック先: この状態を使用して、問題がリンクされた問題の進行を妨げていることを示します。
+ 重複: この状態を使用して、問題が別の問題でキャプチャされた作業と重複していることを示します。

リンクを作成した後にその状態を変更することはできません。リンクとそのリンク状態は、リンクの作成元の問題とリンク先の問題の両方の **[リンクされた問題]** に表示されます。リンクは、作成後に削除することもできます。

**問題を別の問題またはタスクにリンクするには**

1. 別の問題にリンクする問題を開きます。問題の検索については、「[問題を検出して表示する](issues-view.md)」を参照してください。

1. **[問題のリンク]** を選択します。

1. **[次としてマーク]** で、リンクの状態を選択します。

   **[問題番号]** で、問題の番号を入力するか、ドロップダウンリストから選択します。

1. 別のリンクを追加するには、**[リンクされた問題の追加]** を選択します。

1. 完了したら、**[更新]** を選択して、問題とリンクされた関係を持つすべての問題を更新します。

# 問題をブロック状態またはブロック状態解除としてマークする
<a name="issues-mark-as-blocked"></a>

何かが原因で問題に取り組めない場合は、*ブロック状態*としてマークすることをお勧めします。例えば、問題が、まだマージされていないコードベースの別の部分への変更に依存している場合、問題がブロック状態に陥る可能性があります。

問題をブロック状態としてマークすると、バックログやアーカイブ、またはボードで目立つように、赤色の **[ブロック状態]** ラベルが問題に追加されます。

外部要因が解決されたら、問題のブロック状態を解除できます。

**問題をブロック状態としてマークするには**

1. ブロック状態としてマークする問題を開きます。問題の検索については、「[問題を検出して表示する](issues-view.md)」を参照してください。

1. **[アクション]** を選択し、**[ブロック状態としてマーク]** を選択します。

**問題のブロック状態を解除するには**

1. ブロック状態を解除する問題を開きます。問題の検索については、「[問題を検出して表示する](issues-view.md)」を参照してください。

1. **[アクション]** を選択し、**[ブロック状態解除済みとしてマーク]** を選択します。

# コメントを追加、編集、削除する
<a name="issues-comment"></a>

問題にコメントを残すことができます。コメントでは、他のスペースメンバー、スペース内の他のプロジェクト、関連する問題、コードをタグ付けできます。

**問題にコメントを追加するには**

1. プロジェクトに移動します。

1. ナビゲーションバーで、**[問題]** を選択します。

1. コメントを追加する問題を選択します。問題の検索方法については、「[問題を検出して表示する](issues-view.md)」を参照してください。

1. **[コメント]** フィールドにコメントを入力します。Markdown を使用して書式を追加できます。

1. **[送信]** を選択します。

**コメントを編集するには**

問題に対して行ったコメントを編集できます。編集できるのは、自分が作成したコメントのみです。

1. プロジェクトに移動します。

1. ナビゲーションバーで、**[問題]** を選択します。

1. コメントを編集する問題を選択します。問題の検索方法については、「[問題を検出して表示する](issues-view.md)」を参照してください。

1. コメントを編集するには、編集するコメントを見つけます。
**ヒント**  
コメントは、古い順または新しい順で並べ替えることができます。コメントは一度に 10 個読み込まれます。

1. 省略記号をクリックし、**[編集]** を選択します。

1. コメントを編集します。Markdown を使用して書式を追加できます。

1. **[保存]** を選択します。コメントが更新されました。

**コメントを削除するには**

問題に対して行ったコメントを削除できます。削除できるのは、自分が作成したコメントのみです。コメントを削除すると、元のコメントテキストの代わりに、*[このコメントは削除されました]* という文言と共にユーザー名が表示されます。

1. プロジェクトに移動します。

1. ナビゲーションバーで、**[問題]** を選択します。

1. コメントを削除する問題を選択します。問題の検索方法については、「[問題を検出して表示する](issues-view.md)」を参照してください。

1. 省略記号アイコンをクリックして **[削除]** を選択し、**[確認]** を選択します。

# コメントでメンションを使用する
<a name="issues-mentions-comment"></a>

スペースメンバー、スペース内の他のプロジェクト、関連する問題、コードをコメントでメンションできます。これにより、メンションしたユーザーまたはリソースへのクイックリンクが作成されます。

**コメントで @mention を使用するには**

1. プロジェクトに移動します。

1. ナビゲーションバーで、**[問題]** を選択します。

1. 編集する問題を選択して、問題の詳細を表示します。問題の検索方法については、「[問題を検出して表示する](issues-view.md)」を参照してください。

1. **[コメントの追加]** テキストボックスを選択します。

1. 他のユーザーをメンションするには、「`@user_name`」と入力します。

1. プロジェクトをメンションするには、「`@project_name`」と入力します。

1. 別の問題をメンションするには、「`@issue_name`」または「`@issue_number`」と入力します。

1. ソースリポジトリ内の特定のファイルまたはコードをメンションするには、「`@file_name`」と入力します。
**注記**  
入力時に「`@mention`」に一致する用語を含む上位 5 つの項目 (ユーザー、ソースリポジトリ、プロジェクトなど) のリストが表示されます。

1. メンションする項目を選択します。項目がどこにあるかを示す経路がコメントテキストボックスに入力されます。

1. コメントを入力し終えたら、**[送信]** を選択します。

# 問題を検出して表示する
<a name="issues-view"></a>

以下のセクションでは、CodeCatalyst プロジェクト内の問題を効果的に検索して表示する方法を説明します。

## 問題を検索する
<a name="issues-search"></a>

 特定のパラメータを検索することで、問題を見つけることができます。検索の絞り込みに関する詳細については、「[CodeCatalyst でコード、問題、プロジェクト、ユーザーを検索するコード、問題、プロジェクト、ユーザーを検索する](search.md)」を参照してください。

**問題を検索するには**

1. プロジェクトに移動します。

1. 検索バーを使用して、問題または問題に関連する情報を検索します。クエリパラメータを使用して検索を絞り込むことができます。詳細については、「[CodeCatalyst でコード、問題、プロジェクト、ユーザーを検索するコード、問題、プロジェクト、ユーザーを検索する](search.md)」を参照してください。

# 問題をソートする
<a name="issues-sorting"></a>

デフォルトでは、CodeCatalyst の問題は **[手動順序]** でソートされます。手動順序では、問題がユーザーによって移動された順序で表示されます。手動順序でソートすると、問題をドラッグアンドドロップして順序を変更できます。このソートオプションは、問題のバックログを整理し、問題に優先順序を付ける際に役立ちます。

次の表は、グリッドビューとボードビューの両方で問題をソートする方法を示しています。


| グリッドビューのソートオプション | ボードビューのソートオプション | 
| --- | --- | 
|  手動順序  |  手動順序  | 
|  最終更新日  |  最終更新日  | 
|  Priority  |  優先度  | 
|  Estimate  |  見積り  | 
|  タイトル  |  タイトル  | 
|  ID  |    | 
|  ステータス  |    | 
|  ブロック  |    | 
|  カスタム フィールド  |    | 

問題のソート方法を変更する手順は次のとおりです。

**問題をソートするには**

1. プロジェクトに移動します。

1. ナビゲーションペインで、**[問題]** を選択します。デフォルトのビューは **[ボード]** です。

1. (オプション) **[アクティブな問題]** を選択して、**[問題ビューのスイッチャー]** ドロップダウンメニューを開き、別の問題ビューに移動します。

1. グリッドビューをソートするには、次の 2 つのオプションがあります。

   1. ソート基準にするフィールドの **[ヘッダー]** を選択します。**[ヘッダー]** を選択すると、昇順と降順が切り替わります。

   1. **[ソート基準]** ドロップダウンメニューを選択し、ソート基準として使用するパラメータを選択します。問題は昇順にソートされます。

1. ボードビューをソートするには、**[ソート基準]** ドロップダウンメニューを選択し、ソート基準として使用するパラメータを選択します。問題は昇順にソートされます。

# 問題をグループ化する
<a name="issues-grouping"></a>

グループ化を使用すると、担当者、ラベル、優先度などの複数のパラメータによってボード上の問題を整理できます。

**問題をグループ化するには**

1. プロジェクトに移動します。

1. ナビゲーションペインで、**[問題]** を選択します。デフォルトのビューは **[ボード]** です。

1. (オプション) **[アクティブな問題]** を選択して、**[問題ビューのスイッチャー]** ドロップダウンメニューを開き、別の問題ビューに移動します。

1. **[グループ]** を選択します。

1. **[グループ化の基準]** で、グループ化の基準として使用するパラメータを選択します。
   + **[担当者]** または **[優先度]** を選択した場合は、**[グループ順序]** を選択します。
   + **[ラベル]** を選択した場合は、ラベルを選択して **[グループ順序]** を選択します。

1. (オプション) **[空のグループを表示]** トグルを選択すると、現在割り当てられている問題のないグループを表示または非表示にできます。

1. 選択を行うと、ビューが更新されます。問題は、設定されたパラメータに一致するグループにのみ表示されます。

# 問題をフィルタリングする
<a name="issues-filter"></a>

フィルタリングを使用すると、指定された名前、優先度、ラベル、カスタムフィールド、または担当者を含む問題を検索できます。

**問題をフィルタリングするには**

1. プロジェクトに移動します。

1. ナビゲーションペインで、**[問題]** を選択します。

1. (オプション) **[アクティブな問題]** を選択して、**[問題ビューのスイッチャー]** ドロップダウンメニューを開き、別の問題ビューに移動します。
**注記**  
問題名または説明の文字列に基づいてフィルタリングするには、問題検索バーに文字列を入力します。

1. **[フィルター]** を選択し、**[\$1 フィルターを追加]** を選択します。

1. フィルター基準として使用するパラメータを選択します。複数のフィルターとパラメータを選択できます。フィルターを設定して、すべてのフィルターまたは個々のフィルターに一致する問題を表示するには、**[and]** または **[or]** を選択します。ビューが更新され、フィルターに一致する問題が表示されます。

# 問題を進行させる
<a name="issues-move-issue"></a>

どの問題にもライフサイクルがあります。CodeCatalyst では、問題は通常、バックログの下書きとして始まります。その問題に取り組み始めると、別のステータスカテゴリに移動し、完了するまでさまざまなステータスを経て、その後アーカイブされます。ライフサイクルを通じて問題を移動または進行させるには、次の方法があります。
+ バックログとボード間で問題を移動できます。
+ 進行中の問題を、さまざまな完了ステージに移動できます。
+ 完了した問題をアーカイブできます。

# バックログとボード間で問題を移動する
<a name="issues-move-backlog-board"></a>

問題に取り組み始めたら、バックログからボードに問題を移動できます。作業が延期された場合は、問題をバックログに戻すこともできます。

**バックログとボード間で問題を移動するには**

1. プロジェクトに移動します。

1. ナビゲーションペインで、**[問題]** を選択します。デフォルトのビューは **[ボード]** です。

1. 問題をボードからバックログに移動するには:

   1. 移動する問題を選択します。問題の検索については、「[問題を検出して表示する](issues-view.md)」を参照してください。

   1. ドロップダウンの **[ステータス]** メニューから **[バックログ]** を選択します。

1. 問題をバックログからボードに移動するには:

   1. バックログに移動するには、**[ボード]** を選択し、**[バックログ]** を選択します。

   1. 移動する問題を選択します。問題の検索については、「[問題を検出して表示する](issues-view.md)」を参照してください。

   1. **[ボードに追加]** を選択するか、**[バックログ]** 以外の**[ステータス]**を選択します。

# ボードでライフサイクルのステージを通じて問題を進行させる
<a name="issues-move-within-board"></a>

 ボード内の問題を、完了までさまざまなステータスに移動できます。

**ボード内で問題を移動するには**

1. ナビゲーションペインで、**[問題]** を選択します。デフォルトのビューは **[ボード]** です。

1. 次のいずれかを行います。
   + 問題を別のステータスにドラッグアンドドロップします。
   + 問題を選択し、ステータスドロップダウンメニューから **[ステータス]** を選択します。
   + 問題を選択し、**[*next-status* に移動]** を選択します。

   

   

問題のアーカイブについては、「[問題をアーカイブする](issues-archive-issues.md)」を参照してください。

# グループ間で問題を移動する
<a name="issues-move-groups"></a>

**[すべての問題]** ビューと **[ボード]** ビューで[問題をさまざまなパラメータでグループ化](issues-grouping.md)できます。問題がグループ化されている場合、あるグループから別のグループに移動できます。あるグループから別のグループへ問題を移動すると、ターゲットグループに一致するように問題のグループ化の基準となっているフィールドが自動的に編集されます。

シナリオの例として、CodeCatalyst を使用している会社で、Wang Xiulan と Saanvi Sarkar の 2 人に問題が割り当てられているとします。ボードは `Assignee` でグループ化されており、各担当者ごとに 1 つのグループ、つまり 2 つのグループがあります。Wang Xiulan グループから Saanvi Sarkar グループに問題を移行すると、問題の担当者が Saanvi Sarkar に更新されます。

# 問題をアーカイブする
<a name="issues-archive-issues"></a>

**注記**  
問題はプロジェクト内で削除されず、アーカイブされます。問題を削除するには、プロジェクトを削除する必要があります。

プロジェクトで不要になった問題はアーカイブできます。問題をアーカイブすると、アーカイブされた問題をフィルタリングするすべてのビューからその問題を削除します。アーカイブされた問題は、**[アーカイブされた問題]** のデフォルトビューで表示でき、必要に応じてアーカイブを解除できます。

次の場合に問題をアーカイブします。
+ 問題が完了し、**[完了]** 列に表示する必要がなくなった。
+ 取り組む予定がない。
+ 誤って作成した。
+ アクティブな問題の最大数に達した。

**問題をアーカイブするには**

1. アーカイブする問題を開きます。問題の検索については、「[問題を検出して表示する](issues-view.md)」を参照してください。

1. **[アクション]**、**[アーカイブ]** の順に選択します。

1. (オプション) **[完了]** ステータスにある複数の問題をすばやくアーカイブするには、ボード上の **[完了]** ステータスの上部にある縦の省略記号をクリックし、**[問題をアーカイブ]** を選択します。

**問題をアーカイブ解除するには**

1. アーカイブを解除する問題を開きます。アーカイブされた問題のリストを表示するには、**[問題ビューのスイッチャー]** ドロップダウンメニューから **[アーカイブされた問題]** ビューを開きます。問題の検索については、「[問題を検出して表示する](issues-view.md)」を参照してください。

1. **[アーカイブを解除]** を選択します。

# 問題をエクスポートする
<a name="issues-export-active-issues"></a>

現在のビューの問題を .xlsx ファイルにエクスポートできます。問題をエクスポートするには、次の手順を実行します。

**問題をエクスポートするには**

1. プロジェクトに移動します。

1. ナビゲーションバーで、**[問題]** を選択します。

1. **[アクティブな問題]** を選択して、**[問題ビューのスイッチャー]** ドロップダウンメニューを開き、エクスポートする問題を含むビューに移動します。ビューに表示される問題のみがエクスポートされます。

1. 省略記号メニューを選択し、**[Excel にエクスポート]** を選択します。

1. .xlsx ファイルをダウンロードします。デフォルトでは、プロジェクトの名前とエクスポートが完了した日付がタイトルになります。

# バックログ、ラベル、ボードを使用して作業を整理する
<a name="issues-organizing-work"></a>

すべてのチームが同じように作業するわけではありません。Amazon CodeCatalyst で問題の表示方法と割り当て方法を設定することで、作業内容とその作業のステータスを正確に把握できます。ユーザー全員が同じ見積もり手法を使用できるように、問題で使用する見積もり手法を選択できます。カスタムラベルとステータスを作成し、これを使用して、作業のビューをフィルタリングすることもできます。チームの仕組みに応じて、問題に複数の担当者を割り当てられるようにするか、1 人のユーザーにのみ問題を割り当てるかを設定できます。また、問題のカスタムビューを作成して、自分やチームに最も関連性の高い情報が見えるように作業のビューを調整することもできます。

# ラベルを使用して作業を分類する
<a name="issues-labels"></a>

問題のラベルをカスタマイズできます。これには、ラベルの編集と色の変更が含まれます。ラベルは、作業の分類と整理に役立ちます。例えば、ソフトウェアの特定の側面を表すラベルや、異なるグループやチーム用のラベルを作成できます。

**Topics**
+ [ラベルを作成する](#issues-create-label)
+ [ラベルを編集する](issues-edit-label.md)
+ [ラベルを削除する](issues-delete-label.md)

## ラベルを作成する
<a name="issues-create-label"></a>

CodeCatalyst でラベルを作成するには、問題を作成するとき、または既存の問題を編集するときにラベルを追加します。詳細については、「[CodeCatalyst で問題を作成する](issues-create-issue.md)」および「[CodeCatalyst で問題の編集および共同作業を行う](issues-edit-collaborate-issue.md)」を参照してください。

# ラベルを編集する
<a name="issues-edit-label"></a>

既存のラベルの名前または色を変更する手順は次のとおりです。

**ラベルを編集するには**

1. ナビゲーションペインで、**[問題]** を選択します。

1. **[アクティブな問題]** を選択して **[問題ビューのスイッチャー]** ドロップダウンメニューを開き、**[設定]** を選択します。

1. **[ラベル]** タイルには、プロジェクトで使用されるラベルのリストが表示されます。編集するラベルの横にある編集アイコンを選択します。次の 1 つ以上の操作を行います。

   1. ラベルの名前を編集します。

   1. 色を変更するには、色ホイールを選択します。ピッカーを使用して新しい色を選択します。

1. ラベルに加えた変更を保存するには、チェックマークアイコンをクリックします。

1. 変更されたラベルが、使用可能なラベルのリストに表示されるようになります。また、そのラベルを使用している問題の数も確認できます。
**注記**  
各ラベルの横に表示される番号を選択すると、**[すべての問題]** ページに移動し、そのラベルを含むすべての問題を表示できます。

# ラベルを削除する
<a name="issues-delete-label"></a>

現在、CodeCatalyst で問題ラベルを削除することはできません。すべての問題からラベルを削除すると、ラベルは問題の **[設定]** の**[ラベル]** セクションの **[未使用のラベル]** セクションに表示されます。フィルターを使用したり、問題にラベルを追加したりする際に、未使用のラベルはラベルのリストの末尾に表示されます。すべてのラベル (使用済みおよび未使用) の概要と、各ラベルを含む問題は、問題の **[設定]** で確認できます。

# カスタムフィールドで作業を整理する
<a name="issues-custom-fields"></a>

カスタムフィールドを作成して、プロジェクトの作業を整理して表示できます。カスタムフィールドは、**[フィルター]** で使用可能なフィルターのリストに追加されるため、カスタムフィールドで問題をフィルタリングできます。カスタムフィールドは名前と値のペアです。カスタムフィールドの名前でフィルタリングした後、そのカスタムフィールドの値でフィルタリングします。

問題には、複数のカスタムフィールドを含めることができます。

## カスタムフィールドを作成する
<a name="issues-add-custom-field"></a>

CodeCatalyst でカスタムフィールドを作成するには、問題を作成するとき、または既存の問題を編集するときにカスタムフィールドを追加します。詳細については、「[CodeCatalyst で問題を作成する](issues-create-issue.md)」および「[CodeCatalyst で問題の編集および共同作業を行う](issues-edit-collaborate-issue.md)」を参照してください。

## カスタムレンフィールドを削除する
<a name="issues-delete-custom-field"></a>

 カスタムフィールドを削除するには、追加されている各問題からカスタムフィールドを削除する必要があります。カスタムフィールドが削除されると、**[フィルター]** に表示されなくなります。フィルターを使用して、カスタムフィールドが追加されているすべての問題を表示し、問題を編集することで削除できます。詳細については、「[問題を検出して表示する](issues-view.md)」および「[問題を編集する](issues-edit-issue.md)」を参照してください。

# カスタムステータスを使用して作業を追跡する
<a name="issues-customize-statuses"></a>

ボードにカスタムステータスを追加できます。各カスタムステータスは、**下書き**、**未開始**、**開始**、または**完了**のいずれかのカテゴリに属している必要があります。ステータスカテゴリは、ステータスを整理し、デフォルトのビューに表示させるために使用されます。ステータスとステータスカテゴリの詳細については、「[ステータスとステータスカテゴリ](issues-concepts.md#issues-concepts-status-definition)」を参照してください。ビューの詳細については、「[問題を検出して表示する](issues-view.md)」を参照してください。

# ステータスを作成するには
<a name="issues-create-status"></a>

1. ナビゲーションペインで、**[問題]** を選択します。

1. **[アクティブな問題]** を選択して **[問題ビューのスイッチャー]** ドロップダウンメニューを開き、**[設定]** を選択します。

1. **[ステータス]** で、ステータスを表示するカテゴリの横にあるプラスアイコンをクリックします。

1. ステータスに名前を付け、チェックマークアイコンをクリックします。
**注記**  
ステータスの追加をキャンセルするには、X アイコンをクリックします。

   カスタムステータスがボードに表示され、問題の作成時にオプションとして表示されるようになります。

# ステータスを編集するには
<a name="issues-edit-status"></a>

1. ナビゲーションペインで、**[問題]** を選択します。

1. **[アクティブな問題]** を選択して **[問題ビューのスイッチャー]** ドロップダウンメニューを開き、**[設定]** を選択します。

1. **[ステータス]** で、編集または変更するステータスの横にある編集アイコンをクリックします。

1. ステータスを編集し、チェックマークアイコンをクリックします。

   編集されたステータスがボードに表示されるようになります。

# ステータスを移動するには
<a name="issues-move-status"></a>

1. ナビゲーションペインで、**[問題]** を選択します。

1. 省略記号アイコンをクリックし、**[設定]** を選択します。

1. **[ステータス]** で、移動するステータスを選択します。

1. ステータスをドラッグアンドドロップします。
**注記**  
ステータスを移動できるのは、そのステータスに指定されているカテゴリ内のみです。

   これで、ボードのステータスが並べ替えられます。

# ステータスを無効にするには
<a name="issues-deactivate-status"></a>

1. ナビゲーションペインで、**[問題]** を選択します。

1. **[アクティブな問題]** を選択して **[問題ビューのスイッチャー]** ドロップダウンメニューを開き、**[設定]** を選択します。

1. **[ステータス]** で、非アクティブ化するステータスを選択します。

1. 非アクティブ化するステータスで、ステータスのトグルをクリックします。これでステータスがグレーアウトされます。
**注記**  
非アクティブ化されたステータスは、すべての問題がそのステータスボードから外されるボードに表示されます。問題を非アクティブ化されたステータスに追加することはできません。

1. 非アクティブ化されたステータスを再アクティブ化するには、ステータスのトグルをクリックします。ステータスのグレーアウトが解除されます。
**注記**  
各カテゴリには、少なくとも 1 つのアクティブなステータスが必要です。カテゴリにステータスが 1 つしかない場合は、そのステータスを無効にすることはできません。

# 問題にかかる工数の見積もりを設定する
<a name="issues-settings-estimation"></a>

CodeCatalyst の問題にかかる工数の見積もりの設定を行う手順は次のとおりです。

**問題の工数の見積もりを設定するには**

1. ナビゲーションペインで、**[問題]** を選択します。

1. **[アクティブな問題]** を選択して **[問題ビューのスイッチャー]** ドロップダウンメニューを開き、**[設定]** を選択します。

1. **[基本設定]** セクションの **[見積もり]** で、見積もり値の表示方法を選択します。利用可能な見積りのタイプは、**[T シャツサイズ]**、**[フィボナッチ数列]**、または **[見積りの非表示]** です。見積もりタイプを更新すると、データは失われず、すべての問題の見積もり値が自動的に変換されます。次の表は、変換対応表です。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/codecatalyst/latest/userguide/issues-settings-estimation.html)

# 複数の担当者を有効または無効にする
<a name="issues-settings-multiple-assignees"></a>

CodeCatalyst の問題に対して複数の担当者の設定を行う手順は次のとおりです。

**複数の担当者を有効または無効にするには**

1. ナビゲーションペインで、**[問題]** を選択します。

1. **[アクティブな問題]** を選択して **[問題ビューのスイッチャー]** ドロップダウンメニューを開き、**[設定]** を選択します。

1. **[基本設定]** セクションの **[担当者]** で、インジケータを切り替えて、複数の担当者を同じ問題に割り当てることができるようにします。問題には最大 10 人の担当者を割り当てることができます。このオプションを有効にしない場合、問題に割り当てることができる担当者は 1 人のみです。

# 問題ビューを作成する
<a name="issues-creating-view"></a>

[ビュー](issues-concepts.md#issues-concepts-views-definition)を作成すると、特定のフィルターセットに一致する問題をすばやく表示できます。これにより、時間を節約し、以前にフィルタリング、グループ化、ソートした問題をすばやく表示できます。

**問題ビューを作成するには**

1. ナビゲーションペインで、**[問題]** を選択します。

1. (オプション) ユースケースによっては、既存のビューからビューを作成することもできます。別のビューに移動するには、**[アクティブな問題]** を選択して **[問題ビューのスイッチャー]** ドロップダウンメニューを開き、ビューを選択します。

1. (オプション) ビューを作成する前に、フィルター、グループ化、ソートを設定します。ビューの作成中に追加することもできますが、事前に追加しておくと、ビューに表示される内容を作成前にプレビューできます。

1. ヘッダーバーから **[問題ビューのスイッチャー]** ドロップダウンメニューを開きます。ステータスに基づいて問題が列に表示されるボードビューを作成するには、**[ボード]** 列で **[\$1]** をクリックします。問題がリストに表示されるグリッドビューを作成するには、**[グリッド]** 列で **[\$1]** をクリックします。気が変わった場合は、作成する前にビューのタイプを変更することができます。

1. **[ビューの作成]** ダイアログボックスにビューの **[名前]** を入力します。

1. **[フィルター]**、**[問題のグループ化の基準]**、**[問題のソート基準]** は、現在のビューの設定に基づいて入力されます。必要に応じて更新します。

1. **[ビューを作成]** を選択してビューを作成し、そのビューに切り替えます。

# CodeCatalyst の問題のクォータ
<a name="issues-quotas"></a>

次の表は、Amazon CodeCatalyst の問題のクォータと制限を示しています。Amazon CodeCatalyst でのクォータの詳細については、「[CodeCatalyst のクォータ](quotas.md)」を参照してください。


| [リソース]  | デフォルトのクォータ | 
| --- | --- | 
| アクティブな問題 |  プロジェクトあたり最大 1,000 件。  | 
| 添付ファイルサイズ |  添付ファイルあたり最大 500 MB。 添付ファイルストレージの最大合計は、スペースの全体的なストレージ制限の影響を受けます。詳細については、「[料金](https://codecatalyst.aws/explore/pricing)」を参照してください。  | 
|  問題の合計数 (アクティブおよびアーカイブ済み)  |  プロジェクトあたり最大 100,000 件。  | 
| 保存されたビュー |  プロジェクトごとに最大 50 個の保存された問題ビュー。  | 
| 問題にリンクできるプルリクエストの数 | 問題ごとに最大 50 件のプルリクエスト。 | 
| ステータス (プロジェクトごと) | プロジェクトあたり最大 50 個。 | 
| ステータス (問題ごと) | 問題ごとに最大 50 個。 | 
| ラベル (プロジェクトごと) | プロジェクトあたり最大 200 個。 | 
| ラベル (問題ごと) | 問題ごとに最大 50 個。 | 
| カスタムフィールド (問題ごと) | 問題ごとに最大 50 個。 | 
| 担当者 | 問題ごとに最大 10 人。 | 
| コメント |  問題あたり最大 1,000 件。  | 
| タスク | 問題ごとに最大 100 件。 | 