Reporting

Intelligent Service Management offers two types of main reporting capabilities, General and Advanced, which are accessed from the Reports, SERVICE DESK main navigation panel. 

General Reports
General Reports are documented here. 

• Standard Reports offer 76 pre-defined reports with filters that you can set before running, or schedule to run. The reports and the layouts cannot be modified.
• Adhoc Reports offer 59 pre-defined reports that can be run, schedule or exported. You can create new reports in this space but you cannot modify the layout of the report.
• Dashboards offer limited features compared to the Dashboards for Advanced Reports which replaced them. They are available in the system in order to support customers who created general dashboards before the advanced ones were available.

Advanced Reports
Advanced Reports provide comprehensive and interactive reporting and data analysis capabilities to Intelligent Service Management. It is built using Jaspersoft Reports and offer more flexibility in designing and formatting reports than the general options. Read about Advanced Reporting here.
Examples of tasks you can perform with advanced reporting include:

• Create new reports that are based on views that are designed in a web-based, drag and drop Ad Hoc editor.
• Schedule reports for distribution through email and storage in a repository.
• Add several reports in a single and integrated view as Dashboards to display the business trends.

Intelligent Service Management provides 11 reports and 1 dashboard out of the box. These reports cannot be modified or inactivated, but they can be run and scheduled. The steps to take before creating new reports include:

1. Synchronize custom attributes with the domain so they can be reported on
2. Create an ad hoc view with the fields to show in the report
3. Save the ad hoc view as a report
4. Format the look and feel of the report
5. Assign permissions to users to manage, view and create reports. See here for instructions on assigning permissions.

Review Advanced Reports

From the Home tab you can:

• Run and schedule reports
• Create, edit and delete an Ad Hoc view
• View, schedule and delete reports created from your Ad Hoc Views
• Create a Dashboard from existing reports and delete a non-CA Dashboard

Actions Button

The Actions button on the Advanced Reports overview tab provides access to:

• Edit Domain
• Create Ad Hoc View
• Create Dashboard
• Synchronize your Custom Fields

Assign Reporting Permissions

In order for analysts to have permissions to view, create or manage reports, they must have the correct reporting roles applied to their contact record. In this example, Greg is a manager with a floater license to Intelligent Service Management and requires access to create ad hoc views and reports. 
Greg must be able to access the Report module. Permissions for modules are managed in the Navigation Menu. The documentation wiki, under Assign Permissions here, provides instructions on accessing the Navigation Pane. The REPORTS navigation menu group has the Administration group and five reporting roles automatically assigned to it, as seen below. 

If our analyst Greg has either the Administration group, or any of the roles associated with his contact record he will inherit permissions to view the Advanced Reporting navigation menu. The easiest thing to do would be to add Greg to a group or role that has permissions to the navigation pane, but we can also select the Manage Permissions button and add him individually. 
Greg will need the Advanced Reporting Admin role assigned to his user record in order to access all the content in Advanced Reporting. To do this update the Roles tab on his contact record by selecting Relate Existing. 

Run an out-of-the box report

To test security, we will log into Intelligent Service Management as Greg and access the Advanced Reporting.

1. Navigate to REPORTS> SERVICE DESK> Advanced Reporting
2. Select View Report for Tickets Created By Organization
   
   1. Hovering over a piece of the pie will show additional details for that slice
   2. Selecting the Chart Types icon will allow you to change the look of the chart
      
   3. From the report, you can modify the date filter, save the report, or export it into several different formats.
3. Close the Report window

Synchronize your Custom Attributes

In order to report on any custom attributes that you have added to your tickets, such as the one we created in process workflow example above, we must synchronize them with the dataset. The data type will automatically be presented in the correct format, so there is no need to calculate fields to get the data to display properly. 
Follow instructions 1-5 on the documentation wiki here to Sync Custom Fields to Domain. In our case, we are using the Cloud SM domain as this is the out of the box domain with no previous updates.

Example: Create a Simple Table Report

In this example we will create a new Ad Hoc view using the custom attribute from the process workflow example, and save it as a report.

1. Navigate to REPORTS> SERVICE DESK>, Advanced Reporting
2. Click Actions
3. Choose Create Ad Hoc View
4. From the Select Data window, select Cloud SM and Choose Data…
5. In the Source column, select on Tickets and click on the  icon to move it to the right side Selected Fields column.
6. Click on the Display option
7. Under Source Name column, scroll down to Custom Attributes and click the arrow to expand it
8. Rename the Display Label field from Select Database Server Type to DB Server Type by clicking on the field:
   
9. Click OK

New Ad Hoc View
The New Ad Hoc View window should now be open with the chart type set to Table  by default.

1. Expand Tickets under both the Fields and Measures sections in the left pane to show the available fields.
    
   Fields in the domain are defined as a Measure or dimension field, which affects how data is represented in visualizations. Measures typically contain numeric data that can be aggregated in crosstab fashion.
2. Drag and Drop or double click on the following fields to move them to the Columns row.
   You can also multi-select fields and drag them to the column or row location.
   • Assign to Individual
   • Category
   • Created Date
   • Priority
   • Status
   • Ticket ID
   • Ticket Age (in Days)
   • Custom Attributes->DB Server Type
3. Drag the Assign To Group to the Groups row.
   
4. Change the order of the columns by dragging and dropping the fields in the Columns row at the top of the New Ad Hoc View window. Ex. drag Ticket ID to the first field in the Columns row.
5. Change the width of a column by dragging the column lines right or left
6. Right click on the Ticket Age (in Days) field and select Use for Sorting
    
7. Set the sort order to descending by clicking the field until the arrow is pointed downward for descending – largest to smallest
   
8. Click OK in the Sort Box

Add A filter

Now we'll add a filter so that only tickets with no analysts assigned show up in the list.

1. Right click on the Assign to Individual field from either in the report, on the Columns row field, or from the left side field under Fields.
   The Filters tab will open.
2. In the far right filter pane, keep the default of "equals" with a value of [Null] and click Apply at the bottom of the Filter column
3. Add a Title to your report by clicking on Click to add a title. For example: Unassigned Ticket List
4. Select the gear icon and select Details and Totals.
   
5. Now that we've filtered on tickets with no assignee, we should remove the Assign To Individual field since it will always be empty. Right click on the field and select Remove from Table.

Creating a Calculated field in Ad Hoc View

Now we will create two new calculated fields to use in our report to show the busiest day of the week and ticket age in hours. These calculated fields are valid only for this Ad Hoc View.

1. In the left Fields column, select the Create Calculated Field icon 
2. Select Create Calculated Field…
    
   
   
3. Create calculated field: Created Day. In the formula Editor enter:
   1. Field Name: Created Day
   2. In Functions column scroll down and double click on DayName. This will move the function toe the formula area.
      
   3. Edit the formula field to replace DayName("DateFieldName") by highlighting "DateFieldName" in the formula field and double clicking on Created Date in column Fields and Measures.
       
   4. Click Validate button, a confirmation message should appear.
   5. Click Create Field, a yellow band appears on the top of the screen confirming your creation.
4. Create calculated field:Ticket Age (in Hours). For Ticket Age (in hours), specify:
   1. Field Name: Ticket Age (in Hours)
   2. In the Fields and Measures column scroll down and double click on Ticket Age (in Days)
   3. Edit the formula field to read: "Ticket Age (in Days)" * 24
   4. Click Validate button, a confirmation message should appear.
   5. Click Create Field.
   Once these calculated fields created, they can be used as any other fields in the Ad Hoc Editor. They will be displayed at the end of the list with a special icon  . They can also be edited if the formula has to be modified.
5. Drag and drop fields to create the Ad Hoc View.
6. Our Ad Hoc View will look like this:
   

Save the Report

1. Save your Ad Hoc View and create a report from the menu bar by selecting the save icon
2. Select: Save Ad Hoc View and Create Report
   
   You can save your view and report to a server folder where you and others with proper security access can see it.
3. Enter:
   1. Data View Name: Unassigned Ticket List
   2. Report Name: Unassigned Ticket Report
   Jaspersoft has a folder structure to make it easier to organize content.
4. Select the Shared folder under your slice folder and save to the adhoc and Reports folders
   
5. Click Save
6. Close the Ad Hoc Editor tab
7. Refresh the Advanced Reporting Overview list. You should see your Ad Hoc View and the Report.

Format your report

Now that you have a report, you can format how it looks. Basic Formatting can be applied at 3 levels, on a column by column basis:

• Headings: set font, size, color… and also modify the column headings.
• Group by field: set font, size, color for group heading tables
• Detail Rows: set font, size, color at row level.

In this example we'll create conditional coloring for all tickets that have an Approved status. By selecting a column heading, you can modify content.

1. Click on the drop down next to your report and select View Report
   
2. Click on the Status column
   You can see the available formatting options for this column, such as moving and hiding columns.
3. Click Formatting from the Column options icon
   
4. Modify the column header to underline it with blue text
   
5. Select the Conditional Formatting tab
   In this use case we want Approved tickets displayed with a green background.
6. Click  hyperlink under the Conditions List
7. Specify the condition as:
   1. Operator: Equals
   2. Condition: Approved
   3. Specify green background
   4. Click the OK button
      
8. Your report's Status column should now look like this:
   

Example: Create a Simple Crosstab and Chart Report

This example will demonstrate how easy it is to create a crosstab report.

1. Navigate to REPORTS> SERVICE DESK> Advanced Reporting
2. Click Actions
3. Choose Create Ad Hoc View
4. From the Select Data window, select Cloud SM and Choose Data…
5. In the Source column, select on Tickets and click on the  icon to move it to the right side Selected Fields column.
6. Expand Tickets under both the Fields and Measures sections in the left pane to show the available fields.
7. Select Crosstab from the report type dropdown
8. Drag the Priority field to Columns
9. Drag the Ticket Type field to Rows
10. Drag the Ticket Count measure to Rows (tip: it's at the bottom)
    
11. Give your Ad Hoc View a name: Number of Tickets by Type
    Your crosstab report should look similar to this:
    
12. Save your Ad Hoc View as you did before.
13. Change the type of view from Crosstab to Chart
    
14. The chart visualizer lets you zoom through various levels of data.
    1. Move the Data Levelbars back and forth to watch the report presentation change
    2. Select the gears icon  and select Chart Format
       
15. To change the rotation of the Ticket Type text, update the X Axis.
    1. Update the X Axis rotation to 0 to save room on the report
       
    2. Click Apply
    3. Click OK
    4. Select the gear again and select Chart Types
       
16. A pallet of available chart types is presented.
    1. Change the chart type to a Stacked Column
       
    2. Set both data level bars to the far right to see the most detailed data level
       
17. Save and Close your Ad Hoc View