Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Panel
panelIconIdatlassian-info
panelIcon:info:
panelIconText:info:
bgColor#F4F5F7

This page is about Assets & Inventory Plugin for Jira Cloud. Using Server or Data Center? Click here.

Stay informed about whereabouts of your assets by subscribing to filters. A subscription delivers periodic notifications about assets that match the criteria you define in an asset filter.

Creating a Subscription

There are two ways to subscribe to an asset filter:

  1. From the Asset Navigator:

    • On the Asset Navigator, run a filter, and click Details > Add a new one.

      image-20240313-224301.png

Contents

Table of Contents
minLevel1
maxLevel6
outlinefalse
styledisc
typelist
printablefalse
  1. From the Filters Menu:

    • Open the Filters screen from the app's top menu.

    • Locate the desired filter and click the three-dot icon next to it.

    • select Add subscription.

      image-20240313-224443.png

Configuring the Subscription

  1. Subscription name – Provide a clear and descriptive name for your subscription.

    image-20240313-225317.png
  2. Recipients – Choose who will receive notifications. This can include groups, individual users, or project roles. You can also keep the subscription private or send notifications to your entire organization.

Note

Recipient groups receive notifications for assets they have permission to browse.

  1. Schedule – Configure the notification frequency (e.g., "At 09:30, every day"). Choose from daily, specific weekdays, or specific days of the month. For more complex scheduling options, use Cron expressions (more information available at http://www.cronmaker.com/). Schedule and day period are required, while start time is optional.

Note

If you’re using the Advanced option, please enter Cron expressions in minutes only, as years won’t be considered.

  1. Decide whether to receive an email even if the filter doesn't find any matching assets.

The email notification will look something like this:

image-20240314-220651.pngImage Added

When the Notify via email even if no assets are found by this filter option is selected and the filter doesn’t return any assets, this is the email that the users will receive:

image-20240314-220552.pngImage Added
image-20240314-220742.pngImage Added

Within the report, certain attributes are prefixed with "asset." This prefix indicates that these attributes are system-related. We have added this prefix to differentiate them from normal attributes and reserved keywords.

Managing Subscriptions

Access and manage all your subscriptions from the Subscriptions screen. You can find it by navigating to the Filters page and clicking Subscriptions >.

image-20240313-225942.png

Here you can:

  • Search: Easily locate specific subscriptions using the search bar.

  • Filter: View subscriptions for a particular filter.

    Screenshot 2024-03-14 at 02.00.11.png
  • Edit: Modify existing subscriptions to update notification details.

  • Delete: Remove subscriptions you no longer need.

  • Run Now: Manually trigger a subscription to receive immediate updates.

    Screenshot 2024-03-14 at 02.00.41.png

Anyone with permission to view the filter can also see its subscriptions; however, only the recipients of a subscription can edit it.

Example: Receiving Notifications for Expiring Licenses

Scenario – You have a "License" asset type with a "Subscription end" date attribute. You want to receive notifications 2 days (or any other specified time period) before a license subscription ends.

Steps –

  1. Create a Filter:

    • Open the Asset Navigator.

    • From the More fields dropdown, select the License Expiration Date attribute.

      image-20240313-233443.png
    • In the popup, select the desired Field configuration.

      Screenshot 2024-03-14 at 02.35.07.png
      • If you want to pick a Range, select the start and end dates.

      • If you don't want the filter to have a Range, check the box next to it, and select one specific date instead.

    • Go to Asset type filter and add License.

      Screenshot 2024-03-14 at 02.39.21.png
    • Click Save as filter and name the filter.

  2. Subscribe to the Filter:

    • On the Asset Navigator, click the Details button for the saved filter.

    • Under SUBSCRIPTIONS, click Add a new one.

    • Name the subscription (e.g., "Subscription is ending in 2 days").

    • Select the recipient groups. You must ensure recipients have appropriate permissions to access the license information.

    • Set a schedule.

    • Decide whether you want to be notified even if no assets are found by the filter.

    • Click Save.

The subscriptions will execute at the scheduled times, sending asset lists to recipients.