ブロードキャストメッセージ

GitLabはGitLabインスタンスのユーザーにブロードキャストメッセージを表示することができます。ブロードキャストメッセージには2種類あります：

  • バナー
  • 通知

ブロードキャストメッセージはブロードキャストメッセージAPIを使って管理できます。

バナー

バナーはページのトップに表示され、オプションでGitリモート・レスポンスとしてコマンドラインに表示されます。

Broadcast Message Banner

$ git push
...
remote:
remote: **Welcome** to GitLab :wave:
remote:
...

一度に複数のバナーがアクティビティになっている場合は、作成順にページの一番上に表示されます。コマンドラインでは、最新のバナーのみが表示されます。

通知

通知はページの右下に表示され、プレースホルダを含むことができます。プレースホルダーはアクティビティユーザーの属性に置き換えられます。プレースホルダは、{{name}}のように中括弧で囲む必要があります。利用可能なプレースホルダは以下のとおりです：

  • {{email}}
  • {{name}}
  • {{user_id}}
  • {{username}}
  • {{instance_id}}

ユーザーがサインインしていない場合、ユーザー関連の値は空になります。

Broadcast Message Notification

一度に複数の通知がアクティビティである場合、最新のものだけが表示されます。

ブロードキャストメッセージの追加

GitLabインスタンスのユーザーにメッセージを表示するには、ブロードキャストメッセージを追加します。

ブロードキャストメッセージを追加するには

  1. 左のサイドバーで、Search を選択するか、次のページに進んでください。
  2. Admin Areaを選択します。
  3. メッセージ]を選択します。
  4. 新しいメッセージを追加]を選択します。
  5. メッセージフィールドにメッセージのテキストを追加します。Markdown、絵文字、a およびbr HTMLタグを br a使用して、メッセージの内容をスタイル設定できます。a br タグは br改行を挿入します。 aHTMLa タグは a、以下のCSSプロパティを持つclass とstyle 属性を受け入れます：
    • color
    • border
    • background
    • padding
    • margin
    • text-decoration
  6. テーマを選択してください。デフォルトのテーマはindigo です。
  7. ユーザーがブロードキャストメッセージを解除できるようにするには、[解除可能]チェックボックスを選択します。
  8. オプション。Gitリモート・レスポンスとしてブロードキャスト・メッセージがコマンドラインに表示されないようにするには、Gitリモート・レスポンス・チェックボックスをオフにします。
  9. オプション。選択したロールを持つユーザーにのみブロードキャストメッセージを表示するには、［対象ロール］を選択します。メッセージはグループ、サブグループ、プロジェクトページに表示され、Git リモートレスポンスには表示されません。
  10. 必要に応じて、そのパスに一致する URL にのみブロードキャスト・メッセージを表示する［ターゲット・パス］を追加します。ワイルドカード文字* を使うと、複数の URL にマッチさせることができます（例：mygroup/myproject*.
  11. メッセージの開始と終了の日時(UTC) を選択します。
  12. Add broadcast messageを選択します。

ブロードキャスト・メッセージが期限切れになると、ユーザー・インターフェースには表示されなくなりますが、ブロードキャスト・メッセージのリストには表示されます。

ブロードキャストメッセージの編集

ブロードキャストメッセージを変更する必要がある場合は、編集することができます。

ブロードキャストメッセージを編集するには

  1. 左のサイドバーで、Search を選択するか、次のページに進んでください。
  2. Admin Areaを選択します。
  3. メッセージ]を選択します。
  4. ブロードキャストメッセージのリストから、メッセージの編集ボタンを選択します。
  5. 必要な変更を行ったら、Update broadcast messageを選択します。

期限切れのメッセージは、終了日を変更することで再度アクティビティにすることができます。

ブロードキャストメッセージの削除

ブロードキャストメッセージが不要になった場合は、削除することができます。ブロードキャストメッセージはアクティビティ中でも削除できます。

ブロードキャストメッセージを削除するには

  1. 左のサイドバーで、Search を選択するか、次のページに進んでください。
  2. Admin Areaを選択します。
  3. メッセージ]を選択します。
  4. ブロードキャストメッセージのリストから、メッセージの削除ボタンを選択します。

ブロードキャストメッセージが削除されると、ブロードキャストメッセージのリストから削除されます。