articleschannelstagsspacestoolkit
Atlassian Developer Blog

10 ways to customise Jira, Confluence and more with Forge

View Original
thumbnail

  1. Add the Jira issue panel to your Forge app: You can customize your Forge app by adding the Jira issue panel, which allows you to display relevant information about an issue within the Jira interface. This can be done by invoking the GET /rest/api/3/issue/{issueIdOrKey} API to retrieve issue details.

  2. Customize Confluence with Forge: If you want to customize Confluence, you can use Forge to create a Confluence macro or use the confluence-macro Custom UI template. You can also add external permissions if you need to use a floor plan API from an external resource.

  3. Integrate with other systems: You can enhance the functionality of your app by making API calls to other systems to implement your business logic. This allows you to connect your app with external services and retrieve or update data as needed.

  4. Add comments to Jira issues: With Forge, you can easily add comments to Jira issues by invoking the POST /rest/api/3/issue/{issueIdOrKey}/comment API. Use api.asApp() to authenticate the API call since api.asUser() cannot be used in a product trigger context.

  5. Listen to issue created events: If you want your app to be notified when a new issue is created in Jira, you need to add the read:jira-work permission to your Forge app manifest. This allows your app to listen to the issue created events and perform any necessary actions.

  6. Implement external conditions for workflow transitions: You can customize Jira workflows by implementing external conditions using Forge. This allows you to prevent workflow transitions unless certain external conditions are met. This can be useful for enforcing business rules or approval processes within your app.

  7. Capture and manage specialized data with Jira: If you need to capture and manage specialized data in Jira, you can use Forge to create custom fields. This can be done by using the jira-custom-field-ui-kit template or adding the jira:customField module to your app manifest.

  8. Track SLA violations in Jira: If you want to track SLA violations in Jira, you can use Forge to periodically invoke the GET /rest/api/3/search API with JQL to retrieve the number of matching issues. This can be done using the scheduled trigger API to automate the process.

  9. Collaborate on decisions between Jira and Confluence: If you have a decision-making process that involves both Jira and Confluence, you can use Forge to create a Jira issue and a linked decision page in Confluence. This allows you to collaborate on the decision in Confluence while having the necessary sign-off in Jira.

  10. Create custom UI components with Compass: If you want to create custom UI components for your Forge app, you can use the compass-component-page Custom UI template or add the compass:componentPage module to your app manifest. This allows you to design and implement custom UI elements tailored to your app's needs.