Console Banner

overview console banners are notifications that appear at the top of the console ui they enable your users to be informed about important updates like scheduled maintenance or system outages these banners are visible across relevant pages and are intended to ensure that users stay informed about critical events based on the selected date, time, tenant or solution banners are created and managed by os1 platform or product admins and can be enabled to be shown at different levels for all tenants in a stack, specific tenant, or a specific solution level a typical banner includes title a brief summary of the notification message detailed information about the notification active period the time frame during which the banner is relevant banner example title scheduled maintenance message system maintenance from 2 00 pm to 6 00 pm edt the application will be unavailable during this period active september 25, 2023, 2 00 pm to 6 00 pm edt note only platform or product admins with the appropriate access can create and manage banners to obtain admin access, reach out to us by visiting the os1 portal http //portal os1 delhivery com/ and click the contact us button to request access use cases scheduled maintenance notifications inform users about upcoming maintenance activities and expected downtimes service outages notify users immediately about service disruptions or critical updates promotional banners highlight important announcements, features, or updates relevant to users key features real time communication display time sensitive notifications to users priority levels banners are categorized by priority (stack, tenant, and solution level), ensuring the most critical alerts are visible first customizable banners can be tailored for specific solutions and tenants time sensitive banners are displayed based on pre configured date ranges creating and managing banners as a product or platform admin, you can leverage the banner api to create and manage banners using the banner api to get step by step instructions on how to do this, refer to our banner developer guide displaying banners in console a banner is displayed in the console as per the date range, solution, and tenant configured by the product admin the banner is visible to all user types (all roles) within the selected solution and will appear on all application pages of the selected tenant as a sticky banner at the top of your console ui your end users will be able to see banners created by administrators here’s what you need to know banner types banners are categorized into three types, each with a different level of importance stack level banners it is typically used for critical system wide notifications this level is used for actions involving core or foundational services that impact all tenants within the system for example, if a critical service needs to be updated, a stack level banner notifies all users about the maintenance and its implications tenant level banners this level is used for specific tenant actions that affect only a subset of users, such as issues impacting a single tenant's customer base for example, if a tenant's payment is overdue, a targeted notification will alert only the relevant tenant users solution level banners this level is used to inform users about changes or updates that are specific to a particular solution they are using for example, the solutions team needs to perform maintenance on a specific solution , like dispatchone or tms solution, and users need to be informed about the scheduled downtime banner priority when multiple banners are active simultaneously, they are displayed according to a set priority and their active time range the following rules apply priority by banner type if multiple banners are active at the same time, they are displayed based on their type in the following order of priority stack highest priority tenant medium priority solution lowest priority handling overlapping banners if banners of different types overlap, (for example , a stack banner and a tenant banner are both active at the same time), the banner with the longest active time range will be displayed first banner visibility and behavior sticky banners banners will remain visible at the top of the console interface as you navigate through different pages visibility across all pages banners are displayed when they are active based on the specified activefromtime and activeuntiltime attributes they will be visible to all user roles within the selected solution and will appear as sticky banners on all application pages of the tenant role based visibility banner is visible to all user roles within the selected solution and tenant banner display time and session management dismissal when a user dismisses a banner, its id is stored in session storage to prevent it from reappearing during the current session the banner will not be shown again in the current tab until the user logs out, but it may appear in new tabs if it is still active info to dismiss a banner, click the 'x' or 'close' button typically located in the top right corner of the banner time stamp dates and times displayed on banners are converted to the tenant's timezone based on the api response the activefromtime and activeuntiltime are compared against the server’s current time (utc) to determine banner’s visibility for example if a banner is configured to be active from "2024 10 08t09 00 00z" to "2024 10 08t011 00 00z", it will appear utc time active from 09 00 am to 11 00 am utc local time for a user in est (utc 5) , the banner is active from 04 00 am to 06 00 am est additionally, the date and time within the banner message (in the content data attribute) are converted accordingly customizable banners can be tailored for different solutions and tenants time sensitive banner display is based on configured date ranges no caching api responses are cached for 15 minutes to reduce network calls the cache is refreshed when this period expires or when a page reload occurs