Dynamically-built Confluence page built based on parameters passed from other system?

Question

Hi folks,

I'm working on documentation for a system where users will be working on

- a particular task

- within a particular domain

- with a specific version of one or more rules they need to follow (that cannot be automated -- so the user needs to refer to them in the correct version)

So what I'm wanting to do is create a bunch of excerpts or pages in Confluence, then pass the

- task

- domain

- version

to Confluence, have Confluence build the page of doc that the user needs on the fly, and serve it up.

Is this possible? I've seen Scroll Versions and that gets us part of the way there, but I don't see a way to use Scroll Versions with passed parameters.

Thanks for any guidance you can provide!

MD

JP _AC Bielefeld Leader_ · Accepted Answer

HI,

you might want to contact the K15t support (Scroll Versions) directly. I'm sure they will we happy to support you.

https://www.k15t.com/company/contact

Best

JP

James Dellow · Accepted Answer

There are likely a couple of ways of doing this using a combination of standard macros, like the Include Page Macro, page naming conventions, and a custom User Macro to dynamically set the macro parameters to retrieve the appropriate task, domain, and version pages.

How were intending to pass the task, domain, and version parameters - will the user select them or click link from elsewhere with the values pre-populated?

How many different versions of the task, domain, and version pages will there be?

Robert Reiner _smartics_ · Accepted Answer

I do not know if your use case can be solved with tools provided by Confluence.

If not, then there is a feature called Remote Control in our projectdoc Toolbox, a commercial add-on for Confluence Server. I am a developer of this add-on so my view is certainly biased. :)

Remote Control allows you to control the rendering of a page configured via macro parameters by overriding these macro parameters with HTTP request parameters.

Example: You have a page that defines transclusions/excerpts, dynamic lists (queries on pages), and links with macros of the projectdoc Toolbox. What is actually rendered on this page is dependent on the values of these macros' parameters. There is a "Where" parameter that specifies a query on content to be transcluded, another "Where" parameter of another macro controls the rendering of references to related documents. With request parameters you can override these macro parameters. The request parameter references the macro by ID (such as "references") and the parameter of the macro by name (such as "Where").

Our use case for Remote Control is "Error code information": A page on Confluence is passed the error code, a user role, some tags to grab further references, and the use case from within an application. Confluence renders a page based on this information. But I assume to provide such a platform with modular information that can be seamlessly composed will still be quite tricky.

In our 'daily' work we use this feature to control the columns and result set of a document query. For instance: A page has a table with 6 columns. For some reasons we want to show only two of them and remove all references to documents that have been marked as "Deprecated".

In case this seems to be a possible approach for a solution to your use case, there is a short tip Remote Control that has some screenshots that may be helpful. There you'll find an example of how a request URL would look like.

The drawback of this approach is this: You need to add a properties macro (used for query matches similar to Page Properties) and section macros (content to be transcluded, similar to Excerpts) to your pages (we call this projectdoc Documents). If you start from scratch this is probably no problem. In case you already have a large number of Confluence pages, altering them may not be feasible.

EPS Software Engineering AG_7haxya · Accepted Answer

Hi @MD

As I understand your requirements, you could use our Page Tree Creator and use the REST interface to create the page tree with all documents and tasks for the employees.

Our support team will be happy to help you with the details. You can find the Page Tree Creator at the Marketplace.

Regards,
Stephan (CEO of EPS Software Engineering AG, the vendor of the Page Tree Creator)