Working with reports

Still need help?

The Atlassian Community is here for you.

Ask the community

In Assets, you can create reports to visualize your object schema in a variety of formats. Once your report is ready, you can share it with other users, export it to a file, print it or add it to your Jira dashboard for easy access to your data. The data in your reports is automatically updated in regular intervals, so you always have an up-to-date view of your assets.

Report types

Here are all report types that you can create in Assets:

Attribute value count report

A pie chart showing how the objects of an object type are distributed based on attributes.

Attribute value report

A chart showing attribute totals reported for one or more objects of a specific type.

Catalog report

A catalog of objects and their attributes.

Issue count report

A line or bar chart showing historical totals of issues reported for one or more object types or objects.

Map report

A world map showing the location of objects based on an attribute with geographical data. The objects must have a text attribute with a comma-separated latitude and longitude, for example -33.8,151.2 (Sydney).

Object count report

A line chart showing historical totals of objects for one or more object types.

Object search

A table showing the objects of an object type and their attributes. This report is based on a saved quick search (filter) from the Assets Object Search View. When you open an object search report, you can select the Quick search link to view the filter that generates the table.

Payroll report

A chart showing payroll expenditures.

Two-dimensional report

A table showing the objects of an object type and their attributes.

User report

A table showing the total of one or more objects assigned to one or more users.

Creating a report

To create a report, you must have access to the object schema and object type that your report will contain.

  1. In the top navigation bar, select Assets > Reports.
  2. Select New Report.
  3. Select a report type.
  4. Give your new report a name, select how frequently you want to refresh the data in your report, and select the required parameters. Optionally, you can also add labels and a description to your report.
  5. Select Generate preview to see a preview of the report or select Create to generate the report. 

Once you start creating reports, they'll appear in the Report manager. This is where you can order and filter them, or do many other things, such as printing, sharing, and syncing your reports. To see the list of available actions for your reports, select More options next to each report. To learn more about each available option, see Working with reports in the Report manager.

Working with reports in the Report manager

Your reports (as well as reports that have been shared with you) are stored in the Report manager. In addition to viewing the reports, you can also perform actions such as editing, printing or sharing reports with other users. To open the Report manager, in the top menu go to Assets > Reports.

Grouping reports

Organize your report view by grouping the reports.

  1. Select Group by.
  2. Select one of the following options:
    1. Label - group reports based on their labels.
    2. Owner - group reports based on who created the report.
    3. Type - group reports based on report types.
Ordering reports

You can order your reports alphabetically or by the date they were created. Select Order by to change the way your reports are ordered.

Editing a report

To edit a report, select More actions > Edit next to the name of the report you want to edit.

You can change any of the parameters of your report. When you’re done, select Generate preview to see a preview of your updated report or select Update to immediately save your changes.

Printing a report

To print your report, select the report you want to print. In the dialog, select More actions  > Print.

Exporting a report

To export your report, select the report you want to print. In the dialog, select Export and select the format of your export (CSV, JSON, XML).

Sharing a report

The visibility of the data in the reports you share is based on your own permissions. This means that the people or groups your share a report with will be able to see the data, even if they don’t have access to the object schemas or object types included in your report. 

To share a report, select More actions > Share next to the name of the report you want to share.

  1. In the dialog, select the name of a user or group.
  2. Select the permissions you want to give to the user or group:
    1. View - users or groups you share the report with can only view this report.
    2. Edit - users or groups you share the report with can view and edit this report.
    3. Delete - users or groups you share the report with can view, edit, and delete this report.
  3. Select Add. Repeat this process to add more users or groups.
  4. When you’re ready to share, select Share.
Updating data in a report manually

The data in your report is updated automatically based on the frequency you selected when you created your report. You can also update the data in your report manually, instead of waiting for a scheduled update.

Updating the data may take several minutes, or longer, depending on the amount of data in your report.

To update data manually, select More actions  > Resync next to the name of the report you want to synchronize.

Adding a report to your favorites

To add a report to your favorites, select Add to favorite next to the name of the relevant report.

Filtering reports

You can filter your reports based on a few options:

  • My favorites - displays only those reports that you’ve added to your favorites.
  • Shared with me - displays only those reports that others have shared with you.
  • Shared by me - displays only those reports that you have shared with others.
  • Report name - enter a name or part of a name.
  • Labels - select one or more labels. If you select more than one label, the filter will show only those reports that have all of the labels you selected.
  • Owned by - displays only those reports owned by the person you selected.

To clear your filters, select Clear filter.

Deleting a report

To delete a report, select More actions  > Delete next to the name of the report you want to delete.

Displaying a report on your Jira dashboard

To display a report on a Jira dashboard, add an Assets Widget to your dashboard. Learn more about configuring your dashboard.

  1. In the top menu, select Dashboards > (name of your dashboard).
  2. Select Add gadget.
  3. In the dialog, search for Assets Widget and select Add gadget. If you don’t see Assets Widget, select Load all gadgets.
  4. Configure your gadget:
    1. Widget: select the report you want to display.
    2. Refresh interval: select how frequently you want to refresh the report.
  5. Select Save.

Viewing audit logs related to reports

To view audit logs, you must be logged in as a user with the Jira Administrators or Jira System Administrators global permission.

Some user activities surrounding Assets reports are tracked in the Jira audit log. If you’re a Jira admin, you can see who viewed, printed or shared reports. 
Learn more about auditing in Jira.
See all audit logs used for Assets reports.

Last modified on Dec 5, 2022

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.