As part of Simpplr's app tiles feature, we offer several out-of-the-box app tiles your org can set up on home and site dashboards. The article linked below gives an overview of how app tiles work, permissions around setting them up, and various requirements. 

Setting Up Out-of-the-Box App Tiles on Dashboards

This article explains the JIRA tile.

JIRA tile

With the JIRA app tile, we can conveniently fetch assigned tickets directly from your JIRA instance specific to the logged-in intranet user. Clicking on any of these tickets will take the user directly to the ticket in JIRA.

To add a tile:

1. From the App tile option, choose JIRA.
2. Within this modal, choose View assigned tickets from the Tile type dropdown and provide an appropriate tile title.
3. Configure settings: Choose between different configurations from the settings section for different parameters as per the requirements and proceed with Add to home.
   

Depending on this configuration, users will be able to customize how they want their tickets to display, both by type and priority.

Before setting up the JIRA integration, ensure you have the following:

1. JIRA admin access: You must have admin access to the JIRA account from which you wish to fetch assigned tickets.
2. JIRA username: Obtain the username associated with the JIRA account. You will need this when setting up the integration in Simpplr.
3. JIRA token: Generate an API token from your JIRA account. This token will serve as the password for authentication purposes. To create a token, navigate to https://id.atlassian.com/manage-profile/security/api-tokens and choose to create a new token and provide an appropriate label for reference. You will need this when setting up the integration in Simpplr.
4. JIRA URL: Determine the URL of your JIRA instance. You will need this when setting up the integration in Simpplr.

Note that in order for a successful connection, the user's accurate email address is required. Every user using the JIRA tile should have an email associated with their account in the Simpplr platform for it to function correctly.

Connection verification is also required. The verification of the connection setup at the app level happens only when a corresponding JIRA tile is rendered. If the connection is incorrectly set, then users will see a `Something went wrong` on the tile itself.

Setting up your org's JIRA Integration

To integrate JIRA with the intranet:

1. In Simpplr, as the App manager, navigate to the Manage > Application > Integrations > Support & Ticketing.
2. Click the checkbox next to Atlassian JIRA.
3. Provide the following details:

   • Username: Enter the JIRA username associated with the admin account

   • API Token: Input the API token generated from the JIRA account
   • JIRA URL: Specify the URL of your JIRA instance
4. Click Save. Note that these details will not be verified right away to ensure they are correct or not.
   

JIRA JQL tile

In addition to displaying recent JIRA tickets, you can also showcase tickets using custom JQL queries with the JIRA tile. App and site managers can easily add the Display tickets using JQL tile to home or site dashboards, selecting it from a library of pre-built app tiles.

The JQL query input can be user-defined or site manager-defined. Once you select the option, input the JQL query into the blank field, then click Add to site dashboard.
\

The end result based on the query will appear on the dashboard.

View recently reported Jira tickets

This tile displays the most recent Jira tickets reported by the user. 

Displays:

• Ticket ID
• Summary
• Status
• Created date
• (Placeholder for Screenshot)

Required Inputs:

• Jira project name
• User authentication

Prerequisites & Setup:

• Users must authenticate using their Jira account.
• OAuth Configuration – An OAuth app must be set up within Jira.
• Navigate to Manage > Application > Integrations > Custom apps > Add new app > Add prebuilt app, then select and add the JIRA app.
• Configure OAuth details as needed, then enable the app.

Create a JIRA Service Desk ticket

This tile allows users to submit a new JIRA Service Desk support request directly from their dashboard. It displays:

• Ticket creation form
• Summary
• Description
• Priority selection
• (Placeholder for Screenshot)

Required Inputs:

• JIRA Service Desk project name
• User authentication

Prerequisites & Setup:

• Users must authenticate using their JIRA account.
• OAuth Configuration – An OAuth app must be set up within JIRA.
• Navigate to Manage > Application > Integrations > Custom apps > Add new app > Add prebuilt app, then select and add the JIRA Service Desk app.
• Configure OAuth details, enable the app, and access it under Add tile.