Step 1. Installation

Step 2. Authorize the app

Both Macro for Assets and Dashboard Gadget for Assets are build on Atlassian Forge. This means that they are running on Atlassians servers and we as the vendor has no access to the data. Backups are part of the Atlassians overall backup strategy

Authorization process allow the app to read / store data in your instance, this needs do be done in order to use the app.

This is done by simply pressing Allow access

Open

Allow access screen

Open

Confirm the data that the app has access to

Why does the app need to read data from the following domains?

Data

For reading Jira asset data, the app needs access to subdomains of Atlassian.com and Altassian.net

• *.atlassian.net

• *.atlassian.com

Images / User avatars

To fetch and show the app icon the app needs access to Rixter AB, the app vendors, s3 bucket containing the icons:

• https://rixter-forge-app-icons.s3.eu-west-1.amazonaws.com/

To show Atlassian user avatars the app needs access to Gravatar, which is part of WordPress.com network:

• https://secure.gravatar.com/avatar/*

• *.wp.com

Step 3. Setup a connection

1. Navigate to the Apps menu from the Cog.

2. Click on Dashboard Gadget for Assets (Apps->Link on the right side) or on Macro for Assets (Manage Apps)

3. Enter a name of the connection, this will be displayed as a drop-down when selecting from where to load Assets data.

4. Enter the Jira site that has Assets installed, use the URL ending with atlassian.net

5. Enter the email of the user that will be used to access the Assets data

6. Enter the API token of the user that will be used to access the Assets data. For how to create an access token view https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/

7. Optional specify the group that can use this connection.
   This is useful if you want to secure some data for a set of persons. In that case you can use multiple connections with different group setups.
   Empty field means all users can see the data in the Macro / Gadget

8. Click Add
   You may need to refresh the page if the row does not appear directly after clicking add.

9. Expected result a table with the connection in it

Step 4. Add a Dashboard Gadget or Confluence Macro

Step 4. Configure what to see

To configure the view;

1. Select the connection from the drop-down list

2. Enter the Asset Query Language (AQL) to what objects to display

3. To configure the table click on the settings symbol and select what attributes to show.

Object Schema

Object schema is the schema from which the objects in Assets lives in.

Attributes

Attributes is displayed when selecting an object schema, these are the attributes associated with the object that you want to show in the table.

Display as

This the render option of showing it as a Table or as a Card

How it looks when the app has rendered

Asset function fields

We support currentUser() function to filter on the logged in user.

Example