Announcement Reference

This reference describes the announcement fields and their rules, the severity levels, who can manage each kind of announcement, and where Self-Service shows an announcement. It covers Platform Manager 17.0.0 and later.

Type

Reference

Goal

Look up the rules for an announcement field, a severity level, or who can manage an announcement.

Audience

Tenant Admins and Super Admins who publish announcements.

When to use

Use this reference when a field is rejected, or when checking who can manage an announcement and where users see it.

Contents

The sections below cover each area in this reference:

Announcement fields

The create and edit forms hold these fields:

Field Required Description

Title

Yes

1 to 100 characters on a single line. Tabs, line breaks and other control characters are rejected.

Severity

Yes

One of Critical, Warning, Information. See Severity levels.

Message

Yes

1 to 1000 characters. Line breaks and tabs are allowed; other control characters are rejected.

Time zone

Yes

The time zone the start and expiration are entered in. Defaults to the browser’s time zone.

Start date

Yes

When the announcement becomes visible. Must be before the expiration date. Defaults to the current date and time, which publishes the announcement straight away. Format: YYYY-MM-DD and HH:MM (00:00 to 23:59).

Expiration date

Yes

When the announcement stops being visible. Must be in the future and after the start date. Format: YYYY-MM-DD and HH:MM.

The form trims spaces at the start and end of the title and the message.

Severity levels

The severity sets the colour and icon of the banner and the card:

Severity Appearance

Critical

Red accent and a circle with an exclamation mark

Warning

Amber accent and a triangle with an exclamation mark

Information

Blue accent and a circle with an "i"

Permissions

Viewing active announcements is open to every logged-in user. Managing them depends on the kind:

Action Tenant announcement Platform announcement

See active announcements

Every user of the tenant

Every user of every tenant

Create, edit, delete

Tenant Admin, or Super Admin on their own tenant

Super Admin

A tenant announcement always belongs to the tenant of the admin who publishes it. Admins of one tenant can’t see or change another tenant’s announcement.

Where announcements show

Self-Service shows active announcements on these pages:

Page Shown as Can be closed

Dashboard

Banner at the top of the page

No

Overview, Topics, Applications, Environments, Schemas, Users, Service Accounts, Groups, Instances, Clusters, Tenants

Card in the bottom right corner

Yes, until the browser tab is closed or the announcement is edited

Detail and edit pages, the tenant settings page, Insights

Not shown

Not applicable

When two announcements are active, the more severe one comes first; of equal severity, the one with the latest start comes first. Self-Service checks for changes every 60 seconds.