Skip to main content

Item details

View and edit an item's data and relationships​

When you select an item in an Alloy app, the Item Viewer will appear. Depending on the situation, it may appear full screen, as a central overlay, or as a side panel.

The coloured header bar displays the item's title and subtitle, along with various item actions that you can perform. At the top, the Last activity field indicates when the item was last modified.

The item canvas is displayed below, which displays the item's data and relationships in multiple interactive sections.

alt text
Note

The icon and colour of the header bar is set by the item's design. However, they can be customised on individual items 🎨.

Item actions​

The following item actions are available in the coloured item header:

  • Copy link to item - copy the item's URL to your device's clipboard, so you can send it to other Alloy users. They must belong to the same customer project as you!

  • Clone item - create and open an identical copy of the item.

  • Add to favourites - add the item to your Favourites list.

  • Item Menu:

    • Switch view - for a different perspective, choose from a list of available views. This changes the order and visibility of the item's canvas sections ⬇️.

    • Make template - convert the item to a template, if allowed by its design.

    • Archive - remove the item from active service, if allowed by its design.

    • Unarchive - restore the archived item to active service.

    • Delete - remove the item permanently.

Action availability depends on the current item. For example, items typically need to be archived before they can be deleted.

Note

On mobile devices 📱, all actions may be inside the Item Menu to fit the screen.

Items often have Link attributes that store references to other items. These are typically displayed in the General section (unless hidden by an item form). Select the button beside a Link attribute to view its contents in the Data Explorer app.

By default, the contents of important Link attributes are displayed in separate sections on the item canvas, such as Defects, Jobs and Reports. The Parents section also displays other items with Link attributes that reference the current item! Select an item in these sections to view its details.

As you move from item to item, a breadcrumb trail appears above the coloured item header to illustrate the path you've taken. Select any item along the path to return to it. Alternatively, use your browser's back button ⬅️.

The breadcrumb trail of an image attachment, showing the path taken from the asset, to a job, to the attachment
Appearance on mobile 📱

If the breadcrumb path gets too long, it shortens itself to save space. To return to a previous item that's hidden, select ... and choose it from the list.

The same breadcrumb trail as before, compacted to fit a mobile screen

Canvas sections​

Item data is displayed across multiple sections on the item canvas. Each section displays a distinct set of data or a list of related items. Most are interactive and let you edit the data they display or perform a related action (if you have permission).

By default, all sections relevant to the current item are displayed.

However, one or more canvas views may be available for the item's design (or an interface it implements), which can display the item's data in different ways. These are either created by yourself or shared with you by other users. To switch to another canvas view, open the Item Menu in the coloured item header and choose Switch view .

To hide the contents of a section, select the button in its header to collapse it.

Note

To create canvas views with custom section layouts, see the Designer app.