外部参加者

外部参加者とは、GitLabアカウントを持たないユーザーで、イシューまたはサービスデスクチケットにメールのみでやり取りできるユーザーです。彼らは、イシューまたはチケットに対する公開コメントについて、サービスデスクのメールで通知を受け取ります。

1つのイシューまたはチケットにおける外部参加者の最大数は10人です。

概要については、GitLabサービスデスクにおける複数の外部参加者を参照してください。

サービスデスクチケット

GitLabは、サービスデスクチケットの外部作成者を外部参加者として追加します。これは通常、チケットを作成した最初のメールのFromヘッダーにあるメールアドレスです。

Ccヘッダーから外部参加者を追加

デフォルトでは、GitLabはサービスデスクチケットを作成するメールの送信者のみを外部参加者として追加します。

GitLabを設定して、Ccヘッダーのすべてのメールアドレスもサービスデスクチケットに追加できます。これは、最初のメールと、thank_youメールへのすべての返信に対して機能します。

Ccヘッダーから追加された外部参加者は、チケットに追加されたことを知らせるために、thank_youメールの代わりにnew_participantメールを受け取ります。

前提条件:

• プロジェクトのメンテナーまたはオーナーロールが必要です。

プロジェクトの設定を有効にするには:

1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. 設定 > 一般を選択します。
3. 展開するサービスデスク。
4. Add external participants from the Cc headerを選択します。
5. 変更を保存を選択します。

外部参加者として

外部参加者は、イシューまたはチケットに対する各公開コメントについて、サービスデスクのメールを使用して通知を受け取ります。

通知メールへの返信

外部参加者は、受信した通知メールに返信できます。これにより、イシューまたはチケットに新しいコメントが作成され、GitLabのユーザー名の代わりに外部参加者のメールアドレスが表示されます。メールアドレスの後に(external participant)が続きます。

通知メールの購読解除

外部参加者は、デフォルトのサービスデスクのメールテンプレートの購読解除リンクを使用して、イシューまたはチケットの購読を解除できます。

もしthank_you、new_participant、およびnew_noteのメールテンプレートをカスタマイズする場合、%{UNSUBSCRIBE_URL}プレースホルダーを使用して購読解除リンクをテンプレートに追加できます。

外部参加者が正常に購読を解除するには、GitLabインスタンスに到達可能である必要があります（たとえば、パブリックインターネットから）。そうでない場合は、テンプレートから購読解除リンクを削除することを検討してください。

GitLabからのメールには、サポートされているメールクライアントやその他のソフトウェアが外部参加者を自動的に購読解除できる特別なヘッダーも含まれています。

GitLabユーザーとして

外部参加者のメールアドレスを表示するには、プロジェクトのレポーター、デベロッパー、メンテナー、またはオーナーロールが必要です。

外部参加者のメールアドレスは、以下の両方の条件が真の場合に難読化されます:

• あなたがプロジェクトのメンバーではないか、ゲストロールを持っている場合。
• イシューまたはチケットが公開されている（非機密）場合。

その後、外部参加者のメールアドレスは以下で難読化されます:

• サービスデスクチケットの作成者フィールド。
• 外部参加者について言及するすべてのシステムノート。
• RESTおよびGraphQL API。
• コメントエディタの下の警告メッセージ。

例:

外部参加者に送信される通知

外部参加者は、イシューに対するすべての公開コメントについて通知を受け取ります。非公開のコミュニケーションには、内部メモを使用します。

外部参加者は、その他のイシューまたはチケットイベントに関する通知を受け取りません。

すべての外部参加者を表示

新しいコメントに対してサービスデスクのメールを受け取るすべての外部参加者の概要を表示します。

前提条件:

• プロジェクトのレポーター、デベロッパー、メンテナー、またはオーナーのロールが必要です。

すべての外部参加者のリストを表示するには:

1. イシューまたはチケットに移動します。
2. コメントエディタまでスクロールします。
3. イシューまたはチケットに外部参加者がいる場合、コメントエディタの下に、すべての外部参加者を一覧表示する警告が表示されます。

外部参加者を追加

いつでも会話に含めたい場合は、/add_emailクイックアクションを使用して外部参加者を追加します。

追加されると、外部参加者はサービスデスクのメールを使用して通知を受け取り始めます。

新しい外部参加者は、チケットに追加されたことを知らせるためにnew_participantメールを受け取ります。GitLabは、手動で追加された外部参加者に対してthank_youメールを送信しません。

外部参加者は、/add_emailクイックアクションを含むコメントに対する通知メールを受け取らないため、専用のコメントで外部参加者を追加する必要があります。

前提条件:

• プロジェクトのプランナー、レポーター、デベロッパー、メンテナー、またはオーナーロールが必要です。

イシューまたはチケットに外部参加者を追加するには:

1. イシューまたはチケットに移動します。
2. クイックアクション/add_email user@example.comのみを含むコメントを追加します。メールアドレスを最大6つまで連結できます。例: /add_email user@example.com user2@example.com。

成功メッセージと、メールアドレスを含む新しいシステムノートが表示されるはずです。

外部参加者を削除

イシューまたはサービスデスクチケットから外部参加者を削除するには、/remove_emailクイックアクションを使用して、通知を受け取らないようにします。

イシューまたはチケットから削除した後、彼らは新しい通知を受け取りません。しかし、彼らは以前に受信したメールに返信したり、イシューまたはチケットに新しいコメントを作成したりすることはできます。

前提条件:

• プロジェクトのプランナー、レポーター、デベロッパー、メンテナー、またはオーナーロールが必要です。
• イシューまたはチケットには、少なくとも1人の外部参加者がいる必要があります。

イシューまたはチケットから既存の外部参加者を削除するには:

1. イシューまたはチケットに移動します。
2. クイックアクション/remove_email user@example.comのみを含むコメントを追加します。メールアドレスを最大6つまで連結できます。例: /remove_email user@example.com user2@example.com。

成功メッセージと、メールアドレスを含む新しいシステムノートが表示されるはずです。