This documentation applies to the 8.1 version of Remedy Action Request System, which is in "End of Version Support."

To view the latest version, select the version from the Product version menu.

Modifying an out-of-the-box Web report with the BIRT Report Designer

This section explains how you can export the .rptdesign file of a Web report from the Report form, modify the report in the BIRT Report Designer, and then import the modified .rptdesign file back to the AR System server using the Report form.


Before modifying an out-of-the-box Web report with BIRT, BMC recommends saving a copy of the report definition file (.rptdesign file) and its corresponding record in the Report form.

To make sure that future upgrades do not overwrite your modified Web report, set Status to Pending or Inactive.

You can also import your original exported Web report (.rptdesign file) to a different AR System server. See Importing a Web report to a different AR System server.

To export a .rptdesign file from the Report form to the BIRT Report Designer

  1. To open the Report form, type the following URL into your browser:
    http:// midTierServer/arsys/forms/ARSystemServer/Report
  2. Search for an out-of-the-box Web report that you want to edit, and select the report from the search results.
  3. In the Instance ID field, copy the Instance ID value of the report you want to edit.

    Copying the Instance ID in the Report form
    (Click the image to expand it.)
  4. Open the Report Definition form, paste the Instance ID you copied in the previous step from the Report form into the Report Definition GUID field, and then click Search.
  5. In the search result, right-click the attached .rptdesign file, and then click Save.
  6. Save the .rptdesign file to a folder where you store reports.

To modify an imported report in the BIRT Report Designer


Make sure the Report Definition GUID does not change during editing. If the GUID of the report definition changes, the GUID will not be associated with the correct report.
  1. In the BIRT report tool, choose File > Open File, and open the .rptdesign file you exported from the Report form.
  2. Edit the report using the BIRT Report Designer, and then save the edited file.


For details about modifying reports with the BIRT Report Designer, such as adding a row or column, see the BIRT Report Designer help.

Modifying reports with BIRT Report Designer is discussed further in Examples for modifying reports with the BIRT Report Designer.

To import the .rptdesign file from the BIRT Report Designer to the Report form

  1. In the Report Console, open the Report form, and search for a Web report.
  2. In the Report Definition File area, right-click the .rptdesign file, and click Add.
  3. In the Confirm Save Request dialog box, click Yes.
  4. In the Add Attachment dialog box, click Choose File, then browse and select the .rptdesign file you edited in the BIRT Report Designer, and click OK.

To modify an out-of-the-box ITSM application report

  1. Follow the same procedure as To modify an imported report in the BIRT Report Designer, with the following exceptions:
    1. When you search for an out-of-the-box report in the Report form, select the Print Incident report.
    2. In the BIRT Report Designer, open the Print Incident report.
    3. Right-click the data set, choose Edit > Query > Add, and select Work Detail in the Available Fields dialog box.
    4. Import the report back into an AR System server.

This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.


  1. David k Hill


    I followed the steps update a modifying report.  I ran into all sorts of problem attempting to upload the report.  I ended up just creating a report via the report designer, then replacing the report file from my modified report.  This seems to work best to uploaded to an existing Report form record.

    However, in modifying my report, the dataset query said:

    This does not validate correctly.  Nor creating my own query like '1' NOT $NULL# etc..

    I ended up leaving the query that was stated and it looks like it works fine that way.

    It would be nice if there was some sort of explanation regarding the proprietary "backslashese" that is stored in the query.




    Jul 05, 2016 07:01
    1. Anagha Deshpande

      Hello David,

      I will discuss this with SME and will update you soon.




      Jul 07, 2016 12:58