---
title: "Supplier References"
canonical: "https://support.appfire.com/space/CDML/649532510/Supplier%20References"
format: markdown
---
> Macro (aura-html)


## 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:

- [Reporting for Confluence app](https://marketplace.atlassian.com/plugins/net.customware.confluence.plugin.reporting/server/overview)
- [Scaffolding Forms and Templates app](https://marketplace.atlassian.com/plugins/net.customware.confluence.plugin.scaffolding/server/overview)
- [Salesforce & Confluence Server Connector app](https://marketplace.atlassian.com/plugins/net.customware.confluence.plugin.salesforce.confluence-salesforce-plugin/server/overview)

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](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649726882) – 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](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649694302) or [Conditions](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649694110) – see [Conditions, Content and Value References](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649957347) for a list of macros.

## Available suppliers

- [Comala Workflow Supplier](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649726882)
- [Metadata Supplier](https://appfire.atlassian.net/wiki/spaces/COMALACM/pages/655889773) – see also: [Metadata references](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649925583)
- [Appfire (formerly ServiceRocket) Suppliers](https://appfire.atlassian.net/wiki/spaces/SUPSR/pages/479035655)

## How to use them

First, you must install the [Reporting for Confluence app](https://marketplace.atlassian.com/plugins/net.customware.confluence.plugin.reporting/server/overview) – this provides numerous Suppliers, but more importantly, it enables their use via [Parameter Injection](https://appfire.atlassian.net/wiki/spaces/SUPSR/pages/479035812).

You can access information from any of the suppliers from apps such as Reporting and Scaffolding, by using a [Supplier Keychain](https://appfire.atlassian.net/wiki/spaces/SUPSR/pages/479035487), without the "`%`" symbols, in a [Value Reference](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649694302).

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](https://appfire.atlassian.net/wiki/spaces/SUPSR/pages/479035993)

- this key returns a list (a collection), which can be inspected using a [collection supplier](https://appfire.atlassian.net/wiki/spaces/SUPSR/pages/479035989) to determine the number of child pages via its `size` key

This can be used in a custom [Condition](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649694110) on a [trigger macro](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649859133) and also in the body of a [set-message macro](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650153597) like so:

```plaintext
{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

> Macro (contentbylabel)

## See also

**Other app links**

- [Supplier Documentation](https://appfire.atlassian.net/wiki/spaces/SUPSR/pages/479035655)
- [Developer Guide for ](https://appfire.atlassian.net/wiki/spaces/REPS/pages/472914669)[Creating Suppliers](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650315581)
- [Scaffolding Data Suppliers](https://appfire.atlassian.net/wiki/spaces/SUPSR/pages/479036216)

[Integration Guides](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649396230)

- [Reporting for Confluence app](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649759324)
- [Scaffolding Forms and Templates app](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650315581)
- [Workflow Supplier](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649726882)

  


| [‹ Back to Value References](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649694302) |
| --- |