Advanced Roadmaps Integration

In this page

What is Advanced Roadmaps?

(supported since Better PDF Exporter 1.4.0)

Advanced Roadmaps is Atlassian's Project Portfolio Management (PPM) solution, an agile roadmapping and project planning app for Jira Software.

Advanced Roadmaps integration features

• You can export Due date values (system field) and Start date values (standard Date Picker custom field type) to PDF.
• You can export the Advanced Roadmaps-managed custom field types like Parent Link, Team, Target start and Target end, to PDF.

(Need more features? Tell us in a support ticket!)

Advanced Roadmaps integration vs. the Advanced Roadmaps built-in PDF exports

You may want to ask: if Advanced Roadmaps has a built-in PDF export feature, why would you use another app for the same?

While the Advanced Roadmaps built-in PDF exports may be sufficient for basic use cases, the Better PDF Exporter integration is more powerful in, at least, these:

• It is extremely customizable.
  Instead of accepting the pre-defined export types in Advanced Roadmaps, you can define your own types via PDF templates.
• It supports all the powerful PDF features.
  You can use custom calculations in Groovy (sorting, complex math, data integration, etc.), embedded attachments, PDF bookmarks, charts, graphics (in Groovy, SVG, etc.), among others.
• It is integrated with all the popular Jira apps.
  You can freely combine Advanced Roadmaps data and other apps' data in the same PDF file.
• It comes with powerful templates optimized for Advanced Roadmaps.
  You can use those "as is", or customize them to your needs.
• It is well-documented with the customization guide, the Expression Reference Manual, the recipes, and such.

If at least one of these is important for you, give the app a try.

Tutorial video

The Better PDF Exporter app enables exporting the issues in an Advanced Roadmaps plan to customizable PDF documents. (Although the video below was captured about the app's Server version, the Cloud version is very similar.)

Advanced Roadmaps PDF export samples

Configuration

Configuring the Advanced Roadmaps custom fields

There is nothing to do. Better PDF Exporter will automatically recognize the Advanced Roadmaps-managed fields and export them accordingly.

Exporting issues in an Advanced Roadmaps plan

Advanced Roadmaps offers a general-purpose JQL function to find issues in plans recursively. Use this JQL function in the Issue Navigator to search for the issues to export, sort the issues, then export the result using Better PDF Exporter.

To search for the issues in an Advanced Roadmaps program, use this JQL:

issuekey IN portfolioChildIssuesOf(FOO-12) OR issuekey IN portfolioChildIssuesOf(FOO-34)

...where "FOO-12" and "FOO-34" are the top-level plan items.

Exporting issues of a certain type in an Advanced Roadmaps plan

To search for the issues of a certain issue type, i.e. for the issues on one level in an Advanced Roadmaps plan, use this JQL:

(issuekey IN portfolioChildIssuesOf(FOO-12) OR issuekey IN portfolioChildIssuesOf(FOO-34)) AND type = "Story"

...where "FOO-12" and "FOO-34" are the top-level plan items.

Exporting issues within the hierarchy, by team and by target dates

Similarly to the use cases discussed in the previous sections, you can use JQL to search for:

• the issues linked via the Parent Link custom field
• the parents of issues
• the children of issues
• the issues assigned to a team

See the Advanced Roadmaps documentation for examples.

Learn more about Advanced Roadmaps

• Advanced Roadmaps product information (at its own vendor)
• Advanced Roadmaps documentation