Tutorial: IT Device Catalog

In this tutorial, you’ll build a Confluence page that displays your organization’s approved device types with full specifications and a list of assigned devices for each type.

What you’ll create: A page showing a device type’s full specification sheet and photo, a table of all devices of that type, and a dropdown to switch between device types.

Prerequisites: An object schema in Jira Assets with “DeviceType” and “Device” object types. DeviceType should have attributes like Name, Vendor, Display Size, Battery, Chipset, Storage, and Photo URL. Device should have attributes like Name, Serial Number, and a reference to DeviceType.

Step 1: Create the Filter

1. Edit a Confluence page
2. Insert a Beautiful Assets Filter macro
3. Configure it:
   • Name: Device Catalog
   • Schema: Select your schema (e.g., “Company Directory”)
   • Object Type: Select “DeviceType”
4. In the Results Preview, verify you see your device types
5. Check “Show object selection in View Mode” to add a dropdown so viewers can pick a device
6. Click Save

Step 2: Add a List Macro for Specifications

Add a detail section that shows the full spec sheet for whichever device type is selected.

1. Insert a Beautiful Assets List macro
2. Select the “Device Catalog” filter
3. Add attribute rows:
   • Name
   • Vendor
   • Display Size
   • Battery
   • Dimensions
   • Weight
   • Chipset
   • Storage
4. Click Save

The List macro displays attributes in a vertical key-value format. When a viewer selects a different device type from the dropdown, the list updates automatically.

Step 3: Add an Image Macro

1. Insert a Beautiful Assets Image macro
2. Select the “Device Catalog” filter
3. Select the “Photo URL” attribute
4. Click Save

The device photo displays next to the specifications. It updates when the viewer selects a different device type.

Note: Only images from allowed domains will display.

Step 4: Add a Device Filter

Now create a second filter that shows all individual devices of the selected type. This filter does not need object selection because it just feeds data to a table.

1. Insert another Beautiful Assets Filter macro
2. Configure it:
   • Name: Devices of Type
   • Schema: Select your schema (e.g., “Company Directory”)
   • Object Type: Select “Device”
   • Add a rule: set the attribute to Device Type, the operator to matchesFilter, and select Device Catalog from the dropdown. This references the first filter, so the results update when a different device type is selected
3. In the Results Preview, verify you see devices matching the currently selected type
4. Leave “Show object selection in View Mode” unchecked
5. Click Save

Step 5: Add a Table Macro for Assigned Devices

1. Insert a Beautiful Assets Table macro
2. Select the “Devices of Type” filter
3. Add columns:
   • Name (the device identifier)
   • Serial Number
   • Assigned To (who the device is assigned to)
4. Click Save

The table displays all devices of the selected type with sortable column headers.

Step 6: Publish and Browse

1. Click Publish
2. The page shows the first device type’s specifications, photo, and assigned devices
3. Use the object selection dropdown to pick a different device type. The List, Image, and Table macros all update automatically

Final Result

Your page now has:

• A dropdown to browse device types
• A full specification sheet for the selected device type
• A device photo
• A table of all individual devices of that type with serial numbers and assignments

All data is fetched live from Jira Assets on each page load.