Skip to main content

Managing card queries

How to add and remove card queries​

After creating a card, you can add queries to it, so that users can see key statistics at a glance. While the system cards provided with Alloy contain queries that can't be changed, you can add new queries alongside them.

A card can display four queries at once and will cycle through the rest at regular intervals.

alt text

Add a card query​

To add a query to a new or existing card:

  1. Open the Settings dashboard card and select Cards.

    Alternatively, select Search in the right panel menu and choose the Cards category (select to clear the previous search if necessary). You can then search by keyword or scroll the list of available cards.

Cards listed in the Search panel

  1. Select the desired card to view its details in the right panel. The Context property indicates whether it's a system card or created by your organisation (see Item context).

  2. Use the tab bar to switch to the Queries tab. Select More in the action bar and choose Add query.

The Queries tab of the selected card, with the Add Query button displayed

  1. In the left panel, fill in the following fields, and then select Create:

    • Name * - enter a distinct name that clearly describes the query. This will displayed in the card.

    • AQS * - use the AQS Builder to create a statistics query that returns either the count of qualifying items or the aggregation of values for a selected attribute on those items. The query can target items of any design/interface (not just the ones the card applies to).

An diagram of an example AQS statistics query
The fields of the Create Query process

The new query's details will appear in the right panel. The Validity property indicates whether it can be used. If you need to edit the query, select Edit in the action bar and then select the AQS field.

The General tab of the new query

To return to the card's details, select its name in the top coloured header, or use your browser's Back button.

Edit a card's queries​

When viewing the Queries tab of a card, you can reorder and delete those queries:

  1. Select Edit in the action bar.

  2. To reorder the list of queries, select and hold one to start dragging it around the list. This determines the order that queries will be displayed on the card.

  3. To delete a query, select its button.

  4. Select Save to finish.

The bottom query is being dragged up the list