30th of April, 2016

Structure.Pages is our new extension for Structure add-on. Today we are happy to announce general availability of Structure.Pages 1.0.

Structure and Structure.Pages Demo Server 
Quick Start Guide

1. The Ultimate JIRA-Confluence Collaboration Tool

Structure.Pages is an extension for the Structure add-on that lets you create, manage and organize Confluence pages alongside JIRA issues right inside Structure.

You can view, track and manage everything from requirements to tasks to tests and documentation, all in a single interface. Structure with Structure.Pages lets you build a project library with pages from different spaces and related issues to make all project content easily discoverable.

Structure.Pages is a commercial add-on. You can get a 30-day evaluation license from Atlassian Marketplace, and you can buy a license at the Atlassian Marketplace or from ALM Works directly.

2. Feature Highlights

  • Confluence pages as "items" in structures

  • Text- or CQL-based search for Confluence pages
  • All main Structure features are applicable to pages – combining pages into hierarchies of unlimited depth, mixing and matching with issues ("first-class citizen" support for pages)
  • Viewing all details of a Confluence page in the "Item Details" panel
  • Adding new Confluence pages from the Structure board
  • Editing and commenting Confluence pages inside Structure board in JIRA
  • Automation: expanding hierarchy by adding all children pages from Confluence
  • Automation: expanding hierarchy by adding linked Confluence pages under issues
  • Updating Confluence space hierarchy through drag-and-drop in Structure
  • Update issue-to-page links through drag-and-drop in Structure

Please see User's Guide for an in-depth introduction to these features.

3. Compatibility and Supported Versions

Structure.Pages 1.0 requires the following components:

  • Atlassian JIRA Server, version 6.3 – 7.1+, any edition (JIRA Software, JIRA Core, JIRA Service Desk). 
    • JIRA Data Center is supported.
  • Structure add-on, version 3.1.0 or later. (There are separate versions for JIRA 6 and JIRA 7, make sure you install the correct one.)
  • Atlassian Confluence Server, version 5.7 – 5.9+. 
    • (warning)Confluence Data Center is not yet supported. (Update with DC support is coming soon.)
  • Structure.Pages Helper add-on, version 1.0.0 or later, installed on Confluence.

Confluence server requires some additional configuration, and JIRA and Confluence instances must be linked together via Application Links. See more details in the Quick Start Guide.

Support for multiple Confluence instances is coming in later versions of Structure.Pages.

3.1. About Structure.Pages Helper Add-on

Structure.Pages requires a "system" add-on to be installed on Confluence.

This add-on does not interfere with how the users normally work with Confluence, but it enables Structure.Pages to display Confluence content in JIRA and provide features for working with the content from the Structure board.

4. Installation and Configuration

A system with Structure and Structure.Pages contains a number of moving parts, some of them from ALM Works, some of them from Atlassian. Therefore, it is very important to correctly install and configure all these parts before trying to build structures with pages.

In brief, the procedure is:

  1. Make sure you have compatible versions of JIRA and Confluence.
  2. Install Structure and Structure.Pages on JIRA.
  3. Install Structure.Pages Helper on Confluence.
  4. Configure Confluence to accept Remote API calls.
  5. Configure Application Link between JIRA and Confluence, or make sure it is configured correctly.
  6. Enable Confluence integration in Structure system settings.
  7. Monitor JIRA and Confluence logs for messages from Structure.

For a detailed description of the procedure, please see the User's Guide.

4.1. Upgrading from Pre-Release Versions

If you have Structure.Pages beta installed and working, then you have already figured out the correct configuration. The upgrade should be straightforward:

  1. Uninstall Structure.Pages beta.
  2. Upgrade Structure add-on to at least version 3.1.0.
  3. Install Structure.Pages 1.0, either from the Marketplace or from Download page.
  4. On Confluence side:
    1. uninstall Structure.Pages Helper beta.
    2. Install Structure.Pages Helper 1.0.0.
  5. Verify that all plugins are enabled and that on Administration | Structure | Confluence Integration you have the link to your Confluence enabled.
  6. Monitor JIRA and Confluence logs for messages from Structure.

5. Tell Us What You Think!

Please send us feedback about Structure.Pages. We'd love to hear what works for you and what doesn't, what problems are you trying to solve with Structure and Structure.Pages and what features you'd like to see next.

Our devoted support team is always ready to answer any of your questions or help with solving a problem.