イシューの作成
issueを作成すると、issueのフィールドを入力するプロンプトが表示されます。イシューに割り当てたい値がわかっている場合は、クイックアクションを使用して入力することができます。
GitLabでは様々な方法でイシューを作成することができます:
プロジェクトから
前提条件:
- 少なくともプロジェクトのゲストロールを持っている必要があります。
イシューを作成するには
- 左のサイドバーで「検索」または「移動」を選択してあなたのプロジェクトを検索します。
-
どちらか:
- 左サイドバーで「プラン > イシュー」を選択し、右上隅で「新規イシュー」を選択します。
- 左サイドバーの上部にあるプラス記号({plus})を選択し、[このプロジェクトでは]で[新規イシュー]を選択します。
- フィールドを入力します。
- イシューの作成]を選択します。
新しく作成されたイシューが開きます。
グループから
イシューはプロジェクトに属しますが、グループに所属している場合、グループ内のプロジェクトに属するイシューにアクセスし、作成することができます。
前提条件:
- グループ内のプロジェクトのゲストロール以上を持っている必要があります。
グループからイシューを作成するには
- 左のサイドバーで、Search(検索)を選択するか、Go to(移動)を選択してグループを探します。
- プラン > イシューを選択します。
- 右上隅で、[プロジェクトを選択してイシューを作成]を選択します。
- イシューを作成するプロジェクトを選択します。選択したプロジェクトがボタンに反映されます。
-
New issue in
<project name>
を選択します。 - フィールドを入力します。
- イシューの作成 を選択します。
新しく作成されたイシューが開きます。
一番最近選択したプロジェクトが、次回のデフォルトになります。同じプロジェクトでイシューを作成することが多い場合、時間を大幅に節約できます。
別のイシューまたはインシデントから
既存のイシューから新しいイシューを作成することができます。2つのイシューを関連としてマークすることができます。
前提条件:
- 少なくともプロジェクトのゲストロールを持っている必要があります。
別のイシューからイシューを作成するには
- 既存のissueで、Issue actions () を選択します。
- 新規関連イシュー を選択します。
-
フィールドに入力してください。新しいissueフォームには、Issue #123 に関連付けるチェックボックスがあります。
123
は発行元のissueのIDです。このチェックボックスをオンにすると、2つのイシューがリンクされます。 - イシューの作成]を選択します。
新しく作成されたイシューが開きます。
イシューボードから
イシューボードから新しいイシューを作成できます。
前提条件:
- 少なくともプロジェクトのゲストロールを持っている必要があります。
プロジェクトのイシューボードからイシューを作成するには、以下の手順に従います:
- 左のサイドバーで「検索」または「移動」を選択してあなたのプロジェクトを検索します。
- プラン > イシューボード]を選択します。
- ボードリストの上部で、新しいイシューを作成({プラス四角})を選択します。
- イシューのタイトルを入力します。
- イシューの作成]を選択します。
グループissueボードからイシューを作成します:
- 左のサイドバーで、Search(検索)を選択するか、Go to(移動)を選択してグループを探します。
- プラン > イシューボード]を選択します。
- ボードリストの上部で、新しいイシューを作成({プラス四角})を選択します。
- イシューのタイトルを入力します。
- プロジェクト]で、イシューが属するグループのプロジェクトを選択します。
- イシューの作成]を選択します。
イシューが作成され、ボード・リストに表示されます。これはリストの特性を共有するので、例えばリストがラベルFrontend
にスコープされている場合、新しいイシューもこのラベルを持ちます。
電子メールを送ることによって
プロジェクトのイシュー一覧ページで、プロジェクトにイシューを作成するためのメールを送信できます。
前提条件:
- GitLabインスタンスで、受信メールが メールサブアドレスまたはキャッチオールメールボックスで設定されている必要があります。
- イシューリストに少なくとも1つのイシューがあること。
- 少なくともプロジェクトのゲストロールを持っている必要があります。
プロジェクトにイシューをメールするには
- 左のサイドバーで「検索」または「移動」を選択してあなたのプロジェクトを検索します。
- プラン > イシューを選択します。
- ページの下部で、[このプロジェクトに新しいイシューをメールする]を選択します。
- メールアドレスをコピーするには、コピー({copy-to-clipboard})を選択します。
- 電子メールクライアントから、このアドレスに電子メールを送信します。件名が新しいイシューのタイトルとして使用され、メール本文が説明になります。Markdownと クイックアクションを使用できます。
ユーザを作成者として新しいイシューが作成されます。このアドレスをメールクライアントの連絡先として保存し、再度使用することができます。
メールアドレスを再生成するには
- イシューリストで、「このプロジェクトに新しいイシューをメールする」を選択します。
- このトークンをリセット]を選択します。
プリフィルド値付きURLの使用
プリフィルドフィールドを持つ新しいイシューページに直接リンクするには、URLにクエリ文字列パラメータを使用します。外部 HTML ページに URL を埋め込むことで、特定のフィールドがプリフィルドされたイシューを作成できます。
項目 | URLパラメータ | 備考 |
---|---|---|
タイトル | issue[title] | URLエンコードされている必要があります。 |
イシューの種類 | issue[issue_type] |
incident またはissue のいずれか。 |
説明テンプレート | issuable_template | URLエンコードされている必要があります。 |
説明 | issue[description] |
URLエンコードされている必要があります。issuable_template 、またはデフォルトのイシュー・テンプレートと組み合わせて使用すると、issue[description] の値がテンプレートに追加されます。 |
Confidential | issue[confidential] |
true の場合、イシューは機密扱いとなります。 |
関連… | add_related_issue | 数値のissue ID。指定された場合、イシュー・フォームには新しいissueを指定された既存のissueにリンクするための[関連づける]チェックボックスが表示されます。 |
これらの例を参考に、新しいイシューの 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
サービスデスクの利用
Eメールサポートを提供するには、プロジェクトのサービスデスクを有効にしてください。
これで、顧客が新しいメールを送信すると、適切なプロジェクトに新しいイシューが作成され、そこからフォローアップできます。
新規イシューフォームのフィールド
新しいイシューを作成する際に、以下のフィールドを入力することができます: