---
title: "Design a Report"
slug: "design-report"
description: "Use our out-of-the-box reports to evaluate, track and measure you help desk, assets, users and more. In addition, you can create your own reports, and customize them as needed."
updated: 2023-04-03T10:46:08Z
published: 2023-04-03T10:46:08Z
canonical: "documentation.sysaid.com/design-report"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.sysaid.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Design a Report

SysAid includes a large variety of out-of-the-box reports that allow you to evaluate the performance of your help desk, track inventories, measure the progress of your various tasks and projects, and more. You can build new reports using SysAid's Report form or a third-party application, such as iReport. Once a report is created in SysAid, it is not editable (with exception of iReport files) and all out-of-the-box report are set as Read Only.

In an upcoming version, all SysAid reports will be editable from within SysAid.

SysAid offers two methods for designing new reports:

- [Create a new customized report from an external .jrxml file](/docs/design-report#create-a-customized-report-from-a-jrxml-file)
- [Build a report from the Report form](/v1/docs/report-form)

  

For general information on reports in SysAid, see [Reports](/v1/docs/reports). To customize and/or run existing reports see [Customize and Run a Report](/v1/docs/customize-and-run-a-report). To edit report properties, see [Edit Reports](/v1/docs/edit-reports). To organize reports on the page, see [Organize Reports](/v1/docs/organize-reports).

## Create a new report

You can add new reports to the [All Reports](/v1/docs/customize-and-run-a-report) tab. If you want to create a customized report, see the [Customized Report](/docs/design-report#create-a-customized-report-from-a-jrxml-file) section below.

Creating Reports

[Embedded content](https://player.vimeo.com/video/802600939)

To create a new report

1. Click **Create New**.
2. Click **Create** **New Report**.
3. In the New Report Options dialog, in the Report Type drop-down, select an entity to report on.
4. In the Report Name field, enter a name for the report.
5. From the Category drop-down, select the category in which you want the report to be located.
6. To limit the report to specific admin groups
  1. Click within the Accessible to field.
  2. Select a group from the drop-down.
  3. Repeat to add as many groups as you want.
  4. If you want remove a group, click the X corresponding to that group.
7. Click **Done**.
8. Your report is created in the All Reports tab. To further customize the report, click on the newly created report to open it's [Report form](/v1/docs/report-form).

## Create a clustered report

You can create clustered reports that consolidate multiple reports into a single PDF report. This allows admins to more efficiently get the results they need for multiple reports that they need to run regularly. Currently this option is only available for SysAid Cloud accounts.

Please note that clustered reports must consist of reports of the same entity and only reports that were created with the report builder can be selected for Clustered reports. Customized or legacy reports cannot be selected.

To create a new report

1. Click **Create New**.
2. Click **Create** **New Clustered Report**.
3. In the New Clustered Report Options dialog, in the Report Type drop-down, select the entity for the reports you want to include.
4. In the Report Name field, enter a name for the clustered report.
5. From the Category drop-down, select the category in which you want the clustered report to be located.
6. To limit the clustered report to specific admin groups
  1. Click within the Accessible to field.
  2. Select a group from the drop-down.
  3. Repeat to add as many groups as you want.
  4. If you want remove a group, click the X corresponding to that group.
7. Add reports to the clustered report
  1. Click within the Clustered Reports field.
  2. Select a report from the drop-down.
  3. Repeat to add as many reports as you want.
  4. If you want remove a group, click the X corresponding to that group.
8. Click **Done**.  
![MnAnalyzerEditfilesClusteredReportDialog.png](https://cdn.document360.io/52d3cb6c-cc81-43c2-b6f7-cbabcb449271/Images/Documentation/MnAnalyzerEditfilesClusteredReportDialog.png)

Your report is created in the All Reports tab. Clustered reports are displayed with a Unique icon.

![MnAnalyzerEditfilesClusteredReportIcon.png](https://cdn.document360.io/52d3cb6c-cc81-43c2-b6f7-cbabcb449271/Images/Documentation/MnAnalyzerEditfilesClusteredReportIcon.png)

## Duplicate a Report

You can use an existing report as a template for a new report by duplicating it. Let's say you have a report and you'd like to create another report just like it with some adjustments to the filters, a different chart type, and modified text on the cover page. Instead of creating the new report from scratch, you can duplicate the existing report and perform the small modifications in a fraction of the time.

To duplicate a report

1. In the All Reports tab, locate the report you want to duplicate and click ![MnAnalyzerEdit2filesActionItem1.jpg](https://cdn.document360.io/52d3cb6c-cc81-43c2-b6f7-cbabcb449271/Images/Documentation/MnAnalyzerEdit2filesActionItem.jpg).
2. Select **Duplicate Report**.
3. Enter a name for the new report.
4. Click **Done**.
5. Open the new report to modify it as you like.

## Create a customized report from a jrxml file

You can create a customized report from an external jrxml file that contains the body of your report, including headers and footers. Customized reports can also include sub reports, prompt code and a script. If you are creating a static report, you only need to edit the jrxml, the prompt and script are not necessary.

Sub reports add extra design output and allow you to create more complex reports. For example, you can use sub reports to divide an **Open/Closed requests by Company** report, between local companies and regional companies. You can include as many sub reports as you want.

The Prompt contains the code for the [Report form](/v1/docs/report-form). This code allows you to make your reports more dynamic by including filters, date ranges, etc. If you know HTML and Velocity script, you can edit the fields that appear in the Report form. Click [here](https://velocity.apache.org/) to learn more about Velocity script.

The parameters that you choose in the Report form when running a report must be processed before they can be fed into the jrxml that generates your report. The Groovy code Script is responsible for this processing. For more information about Groovy, click [here](http://groovy.codehaus.org/).

To create a customized report

1. In the All Reports tab, click **Create New**.
2. Select **Create new Report**.
3. From the Report Type drop-down, select **Customized Report**.
4. In the Report Name field, enter a unique name for the report.
5. From the Category drop-down, select the category in which you want the report to be located.
6. To limit the report to specific admin groups
  1. Click within the Accessible to field.
  2. Select a group from the drop-down.
  3. Repeat to add as many groups as you want.
  4. If you want to remove a group, click the X corresponding to that group.
7. Click **Add jrxml report file**. Select the jrxml file you want to base the report on and click **OK**.
8. If you want to include a sub report, click **Add sub report**. Select the jrxml file you want, and click **OK**.
9. If you are including a prompt code, add it in the Prompt text box.
10. If you are including a script, add the Groovy code in the Script text box.
11. If you want to limit the report to specific admin groups, remove the All Groups parameter and enter the names of the groups you want to grant access to the report.
12. Click **Done**.
