Rate this page:
This module will eventually replace the Issue glance module, which will eventually be deprecated from both Connect and Forge. If your app uses the Issue glance module, you can refactor your app now to prepare for its replacement. If you are interested in implementing Issue context from scratch, refer to our Connect and Forge Issue Context module instructions.
The Issue context module allows your app to provide information to users in the Issue view. This functionality is similar to the Issue glance module, but the Issue context module makes your app show up as a collapsible panel on the Issue view. This provides better visibility and improves the experience of updating your app.
The Issue context module uses the same properties as Issue glance. This means much of your current implementation will still apply to Issue context. Your focus will be testing that your app’s data loads properly and displays sensibly in the new implementation.
The following table summarises the differences between the panels provided by both modules:
|Situation||Context panels||Glance panels|
|When collapsed||When expanded|
|On page load||Nothing loads||Loads the app iframe||Loads the app iframe in background (app not visible to user)|
|On panel click|
|Panel state||Expanded/collapsed state is remembered per user per project||N/A|
|Panel height||N/A||Fixed height with sticky panel header||Height of the issue view page|
|On mobile app||Shown by default||Not shown by default|
Add the module to your app descriptor. You can use your existing properties for the module.
Remember to add the module to your app descriptor.
If you remove the module from your app descriptor before we deprecate it, customers may stop seeing your app.
When both and are defined, only one of them will be displayed at any given time. By default, will be displayed.
The module uses an event that triggers your app to fetch more relevant data. This event is no longer supported by the module.
If you use the event, you’ll need to refactor your implementation to handle large data fetches on page load. This is because the Issue context panel can be expanded by default.
Check if your app looks and behaves as expected in the Issue context UI. You may need to make changes to your app’s look and feel. We recommend that you follow these tips to ensure optimal implementation of the Issue context module in your app. Even if you don’t follow these recommendations, you’ll still be able to add Issue context panels the way you want.
Since the issue view’s context section has a limited width, use a short app name and label to ensure both are displayed fully.
The Issue context panel may be expanded when the issue view loads, depending on each user’s preference. Setting focus on an element in your app will draw focus away from the issue view. This may hinder the user’s interaction with the issue view in unexpected ways, like preventing the use of shortcuts.
Rate this page: