Skip to main content

Create an Item data source

How to create an Item data source

An Item data source represents the attribute data of a single item of a particular design/interface.

It can be thought of as a table with a single row and the selected attribute as column headers.

Note

To fetch attribute data from multiple items, see Creating an AQS data source.

Create an Item data source

To create an Item data source in the Report Builder:

  1. Open the Data sources tab and select Create data source.
alt text
  1. Supply a meaningful Name. Users will see this when running the report, so ensure it describes the data source clearly. To ensure the data source can't be left empty, enable Required.

  2. Select Type and choose Item.

alt text
  1. Fill in the remaining form fields:
  • Link report to item? - if enabled, when the report is run, Alloy will automatically create a link from the generated report item (parent) to the data source's item (child). This makes the linked item discoverable from the report item and vice versa.

    Details

    When viewing the report item, the linked item will appear in the Items Reported On link on its General tab.

    When viewing the linked item, the generated report item will appear on its Reports tab.

  • Design or interface - choose the design/interface to pick an item from.

  • Default item - we recommend setting an appropriate default item if possible. This helps to ensure your report will always run successfully. Users can change it beforehand if they wish!

  • Collections - select the collection(s) that can be searched when picking the item. The list shown depends on the chosen design/interface. By default, only the Live collection is searched.

  • Tags - if your report is intended to be run from an item, it's possible for the data source to be automatically populated with that item! To do this, select Tags and set the Incoming item id tag.

    Details
    alt text
  1. Select Create to finish.
alt text

Customise sorting and headers

If you edit the data source after it's been created, there will be two more optional fields to configure: