Supplier References

Overview

Suppliers provide access to data and other values in a simple but flexible manner, giving apps access to information they would not normally have.

They are mostly used for apps made by ServiceRocket, such as:

However, they can also be used by any compatible app, such as Comala Document Management. In addition, Comala Document Management provides its own Supplier – the Workflow Supplier – which can be used in ServiceRocket apps and any other compatible app.

Where can they be used

They can be used in any macro that supports Value References or Conditions – see Conditions, Content and Value References for a list.

Available suppliers

Comala Workflow Supplier
Metadata Supplier – see also: Metadata references
ServiceRocket Suppliers

How to use them

First, you must install the Reporting for Confluence app – this provides a numerous Suppliers, but more importantly it enables their use via Parameter Injection.

You can access information from any ServiceRocket-compatible Supplier by using a Supplier Keychain, without the "%" symbols, in a Value Reference.

For example, if you want to display a message when a page is updated, but only if that page has child pages, you could use the children key of the Page Supplier

this key returns a list (a collection), which can be inspected using a Collection Supplier to determine the number of child pages via its size key. This can be used in a custom Condition on a trigger macro and also in the body of a set-message macro like so:

{workflow:name=Check child pages}
   {state:Test|description=Update the page to test the trigger}
   {state}
   {trigger:pageupdated|state=Approved|@content:children > size@=!0}
      {set-message}Please check the content of the @content:children > size@ child page(s){set-message}
   {trigger}
{workflow}

All examples

Page:

Make tasks disable a review — Two ways to use tasks to disable a review. The first way uses a precursor task state where the tasks can be set and completed. The second example uses a Value Reference as a condition to check that all tasks are complete. For the value reference method, you will need the Reporting for Confluence app in addition to Comala Document Management.
Page:

Scaffolding app - Retrieve list-data via supplier reference