Uploaded image for project: 'Confluence Data Center'
  1. Confluence Data Center
  2. CONFSERVER-98191

Advanced Roadmaps for Jira in Confluence macro fails to load if there is a mismatch in the Application URL used in the AppLink and the Roadmap Link

XMLWordPrintable

      Issue Summary

      The Advanced Roadmaps for Jira in Confluence macro added to a Confluence page fails to load a Roadmap from a Jira On-prem instance if there is a mismatch in the Application URL used in the AppLink and the URL from the Roadmap Link.

      The issue only affects versions 1.2.0 and above of the app Advanced Roadmaps for Jira in Confluence.

      Steps to Reproduce

      Tested on Confluence 7.4 and 7.13 linked to a Jira 8.18 instance:

      1. Install Jira 8.18.
      2. Install Confluence 7.4 or 7.13.
      3. Create an Application link between them using the same URL as Application URL and Display URL:
      4. Install the Advanced Roadmaps for Jira in Confluence app (version 1.1.0) on Confluence.
      5. Add an Advanced Roadmaps macro to a Confluence page and link it to a valid Roadmap from Jira.
      6. If the URL from the Roadmap Link and the Application URL from the AppLink match (see example below), the macro works as expected :
      7. Edit the AppLink and change the Application URL to a different but valid URL such as http://127.0.0.1:8080 (which points to the same location as localhost, in this case).
      8. Check the page where the macro was added and it is still working as expected. 
      9. Update the app to version 1.2.0 or higher.
      10. Check the page where the macro was added and it is no longer working as expected. 

      Expected Results

      The Roadmap would be displayed on the Confluence page.

      Actual Results

      The message below is displayed instead:

      Error rendering macro 'portfolio-for-jira-plan'

      It looks like you've entered a URL to a Jira that is not connected to Confluence. Contact your administrator to configure an Application Link

      Additional Notes

      If we go back to the Release Notes for Release Notes for v1.2.0 of this app, we can see the following:

      Note to administrators: This new version pulls Advanced Roadmaps data from Jira using Application Links. To ensure a smooth upgrade, please make sure that the Application Link between your Confluence and Jira servers is set up. If you update to the new version without this connection, your Macro might not work as intended

      We have some cases where customers set an AppLink between Confluence and Jira using different URLs for Display URL and Application URL.

      This is done, for example, when setting an unproxied application link. Usually, the Display URL will match the Base URL for the Jira instance, which is not the same URL set for the Application URL.

      When generating the Roadmap Link on Jira, it will use the Base URL as a reference.

      Workaround

      The user can use one of the following workarounds:

      1. Downgrade the app Advanced Roadmaps for Jira in Confluence to version 1.10, as long as you are running a Confluence version compatible with it; or
      2. Set the Application URL in the AppLink to be equal to the Display URL, if possible; or
      3. When adding the Roadmap Link to the macro on a Confluence page, manually change the URL to use the Application URL from the AppLink (see step 10 in the Steps to Reproduce section).

              kkanojia Kunal Kanojia
              fthozeski@atlassian.com Felipe Thozeski (Inactive)
              Votes:
              15 Vote for this issue
              Watchers:
              28 Start watching this issue

                Created:
                Updated:
                Resolved: