Portal Announcements Suite

Empower your JSM with dynamic banners. Use the JQL-based banners to display query results or schedule custom announcements banners to convey your own message at a convenient time.

Comment

Inspiration

The initial idea was inspired by the Atlassian Status page. We wanted to keep our customers informed for specific messages and open requests like Incidents, Bugs and more. And this functionality to be integrated in Jira and applicable to all types of projects, not just limited to ITSM. This way we can help a vast array of businesses such as facility management, internal company organizations, ITSM, etc.

What it does

The app improves the Portal Banners and Notifications experience of the portal customers by adding dynamic data functionality. Project admins can set up several JQL queries by project to configure banner generation on the customer portal, controlling what information to display to the customers. The location of the dynamic request-based banners can also be set up - the Help Center page, the project portal or both. Additionally, admins can schedule custom announcements, allowing users to subscribe and receive email notifications for updates.

How we built it

We built the project using Forge with React and TypeScript. Having prior experience with Forge allowed us to quickly set up the project skeleton and streamline development.

Challenges we ran into

We encountered several challenges, especially building a Forge app for Jira Service Management. Many JSM APIs don’t work with customer-level permissions when using asUser(), so we had to come up with creative alternatives.

We also had troubles with creating a scheduler that will be responsible for sending emails to the subscribed customers when a Portal Announcement has a delayed start.

Accomplishments that we're proud of

We are most proud of our app's design and flow, as it seamlessly aligns with the Jira Service Management Portal, providing a cohesive and effortless experience for our users.

Despite the REST API limitations, we successfully achieved our project’s core goals and brought our idea to life.

We are also very happy with how the scheduling turned out using the Forge scheduler that runs every hour.

What we learned

We discovered that Forge significantly speeds up the setup and development of Atlassian applications, making it easier to build efficiently.

What's next for Portal Announcements Suite

Next, we plan to add the possibility of configuring multiple banners at the same time with different scheduling options.

Share this project:

Updates