Atlassian uses cookies to improve your browsing experience, perform analytics and research, and conduct advertising. Accept all cookies to indicate that you agree to our use of cookies on your device. Atlassian cookies and tracking notice, (opens new window)
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 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 – that can be used with these apps and any other compatible app.
Where can they be used?
Use in any macro that supports Value References or Conditions – see Conditions, Content and Value References for a list of macros.
Available suppliers
Metadata Supplier – see also: Metadata references
How to use them
First, you must install the Reporting for Confluence app – this provides numerous Suppliers, but more importantly, it enables their use via Parameter Injection.
You can access information from any of the suppliers from apps such as Reporting and Scaffolding, 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
sizekey
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
-
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.
-
See also
Other app links
Need support? Create a request with our support team.