イシューを作成する

イシューを作成する際、イシューのフィールドへの入力が求められます。イシューに割り当てる値がわかっている場合は、クイックアクションを使用して入力できます。

GitLabでは、次の複数の方法でイシューを作成できます:

• プロジェクトから
• グループから
• 別のイシューまたはインシデントから
• イシューボードから
• メールを送信する
• 値を事前に入力したURLを使用する
• サービスデスクを使用する

プロジェクトから

前提要件:

• プロジェクトのゲストロール以上が必要です。

イシューを作成するには:

1. 左側のサイドバーで、検索または移動先を選択して、プロジェクトを見つけます。

2. 次のいずれかの操作を行います:

   • 左側のサイドバーでPlan > イシューを選択し、右上隅にある新規イシューを選択します。
   • 左側のサイドバーの上部にあるプラス記号（ ）を選択し、このプロジェクト内で、新規イシューを選択します。

3. フィールドに入力します。

4. イシューの作成を選択します。

新しく作成されたイシューが開きます。

グループから

イシューはプロジェクトに属していますが、グループに所属している場合、グループ内のプロジェクトに属するイシューにアクセスしたり、作成したりできます。

前提要件:

• グループ内のプロジェクトに対するゲストロール以上が必要です。

グループからイシューを作成するには:

1. 左側のサイドバーで、検索または移動先を選択して、グループを見つけます。
2. Plan > イシューを選択します。
3. 右上隅で、Select project to create issue（イシューを作成するプロジェクトを選択）を選択します。
4. イシューを作成するプロジェクトを選択します。選択したプロジェクトがボタンに反映されます。
5. New issue in <project name>（で新規イシュー）を選択します。
6. フィールドに入力します。
7. イシューの作成を選択します。

新しく作成されたイシューが開きます。

最近選択したプロジェクトが、次回のアクセス時のデフォルトになります。同じプロジェクトのイシューを頻繁に作成する場合、これにより時間を大幅に節約できます。

別のイシューまたはインシデントから

既存のイシューから新しいイシューを作成できます。2つのイシューを関連付けることができます。

前提要件:

• プロジェクトのゲストロール以上が必要です。

別のイシューからイシューを作成するには:

1. 既存のイシューで、Issue actions（イシューアクション）（ ）を選択します。
2. New related issue（新規関連イシュー）を選択します。
3. フィールドに入力します。新しいイシューフォームには、Relate to issue #123（イシュー#123に関連付ける）チェックボックスがあります。123はoriginのイシューのIDです。このチェックボックスをオンにすると、2つのイシューがリンクされます。
4. イシューの作成を選択します。

新しく作成されたイシューが開きます。

イシューボードから

イシューボードから新しいイシューを作成できます。

前提要件:

• プロジェクトのゲストロール以上が必要です。

プロジェクトイシューボードからイシューを作成するには:

1. 左側のサイドバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. Plan > イシューボードを選択します。
3. ボードリストの上部で、イシューの新規作成（ ）を選択します。
4. イシューのタイトルを入力します。
5. イシューの作成を選択します。

グループイシューボードからイシューを作成するには:

1. 左側のサイドバーで、検索または移動先を選択して、グループを見つけます。
2. Plan > イシューボードを選択します。
3. ボードリストの上部で、イシューの新規作成（ ）を選択します。
4. イシューのタイトルを入力します。
5. プロジェクトで、イシューを割り当てるグループ内のプロジェクトを選択します。
6. イシューの作成を選択します。

イシューが作成され、ボードリストに表示されます。リストの特性を共有するため、リストのスコーピングがラベルFrontendに設定されている場合、新しいイシューにもこのラベルが設定されます。

メールを送信する

プロジェクトのイシューページで、プロジェクト内にイシューを作成するメールを送信できます。

前提要件:

• ご利用のGitLabインスタンスで、すべてをキャッチするメールボックスを使用して、受信メールを設定する必要があります。
• イシューリストに、少なくとも1つのイシューが必要です。
• プロジェクトのゲストロール以上が必要です。

プロジェクトにイシューをメールで送信するには:

1. 左側のサイドバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. Plan > イシューを選択します。
3. ページの下部にあるEmail a new issue to this project（新規イシューをこのプロジェクトにメールで送信）を選択します。
4. コピー（ ）を選択して、メールアドレスをコピーします。
5. メールクライアントから、このアドレスにメールを送信します。件名が新しいイシューのタイトルとして使用され、メール本文が説明になります。Markdownとクイックアクションを使用できます。

新しいイシューが作成され、ユーザーが作成者になります。このアドレスをメールクライアントの連絡先として保存すると、再度使用できます。

メールアドレスを再生成するには:

1. イシューページで、Email a new issue to this project（新規イシューをこのプロジェクトにメールで送信）を選択します。
2. reset this token（このトークンをリセット）を選択します。

値を事前に入力したURLを使用する

フィールドが事前に入力された新しいイシューページに直接リンクするには、URLでクエリ文字列パラメータを使用します。外部HTMLページにURLを埋め込んで、特定のフィールドが事前に入力されたイシューを作成できます。

事前に入力された値でイシューを作成するためのURLを構築するには、以下を組み合わせてください:

1. プロジェクトまたはグループのイシューページURLの後に続く/new。例: https://gitlab.com/gitlab-org/gitlab/-/issues/new。

2. パラメータのリストを開始する?。

3. URLパラメータの後に続く=と値。例: issue[title]=My%20test%20issue。

4. （オプション）追加のパラメータを結合する&。

GitLab 17.8以降では、イシューテンプレートを選択すると、URLが変更されて使用するテンプレートが表示されます。

これらの例を参考に、フィールドが事前に入力された新しいイシューURLを作成してください。GitLabプロジェクトでイシューを作成するには、次のように指定します:

• 事前に入力されたタイトルと説明:

  https://gitlab.com/gitlab-org/gitlab/-/issues/new?issue[title]=Whoa%2C%20we%27re%20half-way%20there&issue[description]=Whoa%2C%20livin%27%20in%20a%20URL

• 事前に入力されたタイトルと説明テンプレート:

  https://gitlab.com/gitlab-org/gitlab/-/issues/new?issue[title]=Validate%20new%20concept&issuable_template=Feature%20Proposal%20-%20basic

• 事前に入力されたタイトル、説明、および機密としてマーク:

  https://gitlab.com/gitlab-org/gitlab/-/issues/new?issue[title]=Validate%20new%20concept&issue[description]=Research%20idea&issue[confidential]=true

サービスデスクを使用する

メールサポートを提供するには、プロジェクトに対してサービスデスクを有効にします。

顧客が新しいメールを送信すると、適切なプロジェクトに新しいイシューが作成され、そこからフォローアップできます。

新しいイシューフォームのフィールド

新しいイシューを作成するときは、次のフィールドに入力できます:

• タイトル
• プロジェクト: デフォルトは現在のプロジェクト
• タイプ: イシュー（デフォルト）またはインシデント
• 説明テンプレート: 説明テキストボックス内のすべてを上書きします
• 説明: Markdownとクイックアクションを使用できます
• イシューを機密にするためのチェックボックス
• 担当者
• ウェイト
• エピック （イシューの新しい外観が有効になっている場合は親という名前が付けられています）
• 期限 （イシューの新しい外観が有効になっている場合は日付という名前が付けられています）
• マイルストーン
• ラベル
• イテレーション
• ヘルスステータス （イシューの新しい外観を有効にする必要があります）
• 連絡先 （イシューの新しい外観を有効にする必要があります）