/
Getting started

Getting started

Installing

Install Assets Datatable plugin from the Atlassian Marketplace

Finding global configuration page

There are two ways to access configuration page:

  1. From the Manage app view (you already probably are there if you just installed our plugin), under User-installed apps, select Assets Datatable plugin and click on Configure

  2. Or, from Confluence administration area, in the left main menu, scroll all the way to the bottom and find APPS → Assets Datatable

Configuring credentials

You must enter credentials for accessing Assets data. This must be done only once and these credentials are kept securely (encrypted) in Atlassian’s servers. Following information is needed:

Instance URL, from which you want to use your Assets data. This is used in object detail view for creating URL shortcut for current object.

Instance URL should be in the format like: one-atlas-fupt.atlassian.net

 

image-20250221-195018.png
Finding workspace ID

Workspace ID, which matches the instance URL. This is used for actually fetching the Assets data. The workspace ID can be found by going to this URL: https://<your-site-name>.atlassian.net/rest/servicedeskapi/assets/workspace and copying the workspaceId value.

Workspace ID should be in the format like: 2d2e45ca-e37e-5e38-aa6a-4bb4160b5581

 

Atlassian user’s email which you use to log in into the instance defined above. User must have a JSM licence and access to Assets (the users viewing the data do not need any additional licence).

 

Atlassian user’s API token. Generate the token here and copy-paste it into the token field.

image-20250221-172531.png
Viewing API tokens
image-20250221-172602.png
Creating new token

Expiration date

Make sure you select the expiration date as far in the future as possible (currently the limit is up to 1 year).

It is also recommended to add a calendar reminder for that date to create a new access token - otherwise at some point in the future the Datatable suddenly is not showing any data because the access token has expired.

 

image-20250221-195626.png
Configured credentials

Click Submit button and your credentials will be encypted and securely stored. If everything is as it should, you should see similar view:

 

 

 

 

image-20250224-084015.png

Configure permissions

Don’t forget to set who can edit Datatable macro configurations.

  • You can either allow all users to do it

  • Or specify users who can configure Datatable macros

 

 

 

Now you are ready to configure your macros!

Have a look at Configuration overview page to read more about the macro configuration.