外部参加者

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

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

概要については、GitLab Service Deskの複数の外部参加者を参照してください。

サービスデスクチケット

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

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

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

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

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

前提要件:

• プロジェクトのメンテナーロール以上が必要です。

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

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。

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