This documentation supports the 9.0 version of Remedy IT Service Management Suite.

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

Report annotation

With BMC Remedy Smart Reporting you can add specific comments to your trend reports in the form of annotations. There are three types of annotations to assist users of a report:

  • Report Level Annotations
  • View Level Annotations
  • Organization Level Annotations

Annotations assist your reports readers to understand the reports and data that they are viewing. They can only be added when a report is ACTIVE and the annotate drop down menu is visible.


Annotations are available only for Trend reports.

The figure above shows the three places annotations are displayed.

  1. Annotation Flag highlighting the date, or start of date range, on the time series x axis, with a descriptive roll over that is editable from the report page.


    If the Annotation is set to Private the flag will be colored red.
  2. Highlighting on a time series chart when the annotation has been applied to a date range rather than a single date.
  3. A descriptive roll over on the table displayed on the date, or start of the date range, that is editable from the report page.

Enabling annotations

There are two things you must do in order to use annotations in BMC Remedy Smart Reporting;

  1. You must get an administrator to enable annotation permissions for our role. There are Create,  Read, Update, and Delete options available.
    1. The administrator should go to Administration > Admin Console > Roles > Admin > Collaboration and edit your role
    2. They will need to ensure the Annotations role is enabled
  2. The report you wish to view annotations on must be correctly enabled
    1. While the report is in draft mode, open the Display menu
    2. Ensure that Display on Charts and/or Display on Tables is set to Yes
    3. Activate the report

Creating annotations

In order to create annotations you will need to complete the following:

  1. Ensure your report is Active (not in Draft mode)
  2. In the Annotate menu, click on the Add Annotation button
  3. The Annotation window will open, providing you with the following options:


Nominate the date, or date range that your annotation should be displayed for. If a date range is selected, you will also be able to choose a color for chart highlighting.


The optional Filter setting allows you to associate the Annotation with a filter value. This results in the Annotation only being available if the report viewed contains the filter, and the specified value is available.

In order to link your Annotation to a filter value, you will need to complete the following:

  1. Add the required filter to your report, ensuring that it is:
    1. User Prompt
    2. Cached
  2. Select the Filter from the first drop down list in the Annotation window
  3. Select the desired value from the second drop down list in the Annotation window


If you apply a Filter link to your Annotation, the Visibility options will be reduced to Report and View. This is because the filter is linked to a view field and as such cannot be applied to reports based on other views.


Here you should select the level of your Annotation. This will restrict what content it can appear on. There are three levels available:

  1. This Report (Report Level): These annotations are only attached to a single report. Any date that falls on the specified date, or within the range, will be annotated.
  2. Multi-Report - View (View Level): Any annotation applied to the view level will be displayed on all reports written off the selected view. This is where tags become more important. For example, if you add an annotation about an invoicing system you should apply a tab, such as ‘Invoicing’. This will allow you to hide the annotation when you are viewing a report about Date of Births, where invoicing is irrelevant.
  3. Multi-Report – Global (Organisation Level): Anyone who belongs to the same organization as the annotation creator will be able to see these annotations on any reports with the matching date data. Again, tagging is important here, as you are dealing with a wide range of reports.


If the Annotation is linked to a filter, the Global (Organization) level will not be available, as the filter is linked to a view field and as such cannot be applied to reports based on other views.


Specify a tag to categories your Annotation. This can be left blank, but it’s suggested that tags are used where possible in order to make it easier for the users to view content relevant to them.

A new tag can be added by typing the description of the tag in the text box at the bottom of the list and clicking Add.


Enter the Subject of your Annotation


This is where you should enter the details of your Annotation, and format as desired.


Annotations are set to Public by default. In order to restrict visibility of the annotation, complete the following:

  1. Click on the + Add people to make private link
  2. From here you are able to search through BMC Remedy AR System users and groups. Enter a search term in order to locate a user or group allowed to view the annotation. You will notice that groups have this symbol next to them.
  3. Click the user or group you wish to add and continue until you have all the users required. Note: the creator of the annotation will always have permission to view it, and will be added by the system automatically.

Viewing annotations

By default, a report will display an Annotation if the following criteria are met:

  1. The Report and/or Time Series Chart contains the matching date or range specified in the Annotation.
  2. Annotations display is enabled during report creation.
  3. The Filters used in the Report match those used in the Annotation (if specified).
  4. The Annotation is Untagged OR matches a tag specified in the Report Save Menu.

Annotation display options

There are options available in the Annotation Menu of an active report, that allow the user to restrict the Annotations seen on the report.

From this menu, the user can select which Level of Annotations they wish to view on the report, by ticking or unticking the appropriate check boxes.

The user can then specify which Annotations they wish to view by the tags that have been applied to them (or untagged as the case may be).

Was this page helpful? Yes No Submitting... Thank you