My Assets Portal

Overview

My Asset Portal is a Jira Forge app designed to help users efficiently manage their assets by executing Asset Query Language (AQL) in the background. This app requires users to configure API credentials for seamless operation.

This documentation will guide you through the process of configuring the API credentials and using the AQL feature in the My Asset Portal app.

Table of Contents

Setting up API credentials

In order to use My Asset Portal, you will need to generate an API token. Follow these steps to create an API token for your Atlassian account:

  1. Visit the official Atlassian documentation on API tokens: Manage API tokens for your Atlassian account.

  2. Follow the instructions provided to create and save your API token.

  3. Once you have the API token, open the My Asset Portal app in Jira.

  4. Navigate to the app settings or configuration page.

  5. Enter your API token in the designated field and save your changes.

Now your My Asset Portal app is configured with the necessary API credentials.

Using the AQL Filter

My Asset Portal allows you to execute AQL queries to filter the assets for the customer. The AQL feature supports the use of variables, such as {{userID}}, which represents the current user's ID.

To execute an AQL query in My Asset Portal:

  1. Open the My Asset Portal App Settings

  2. Locate the AQL query input field.

  3. Enter your desired AQL query.

  4. Click on Save

Example: Filtering assets by current user

To filter assets assigned to the current user, you can use the {{userID}} variable in your AQL query. Here's an example:

"Assigned User" = {{userID}}

This query will return assets assigned to the current user.