ServiceDesk Plus On-Premise

Integration with ServiceDesk Plus On-Premise

Analytics Plus seamlessly integrates with Servicedesk Plus, and enables you to analyze your Servicedesk Plus data and keep track of key help desk metrics easily. This allows help desk managers create intuitive reports and dashboards, with the ability to drill down into specifics. You can also set up advanced analytics for all the Service Desk instances configured under your ESM Directory. 

General

  1. What is Analytics Plus?
  2. What are the highlights of this integration?

Setup

  1. How do I integrate Analytics Plus with Servicedesk Plus?
  2. How to configure single-sign-on for ServiceDesk Plus users in Analytics Plus?
  3. How long should I wait for my Servicedesk Plus data to initially appear in Analytics Plus?
  4. Can I access blended reports built on data from different applications?
  5. What should I do when the data synchronization fails?
  6. Can I edit the synchronization settings?
  7. Can I trigger a synchronization of my Servicedesk Plus data on-demand?
  8. How do I create custom reports over my Servicedesk Plus data?

Reporting Features

  1. What are the report types supported by Analytics Plus?
  2. Can I modify the pre-built reports created on integrating with ServiceDesk Plus?
  3. How do I create reports using fields/columns across different ServiceDesk Plus modules?
  4. What are formulas in reports?
  5. Is it possible to create custom formulas in Analytics Plus?
  6. Can I modify the tables imported from ServiceDesk Plus?
  7. Can I add new columns to the tables imported from ServiceDesk Plus?
  8. Can I import new tables into the ServiceDesk Plus workspace?
  9. Can I combine data from other sources with the data from ServiceDesk Plus, and create reports and dashboards?
  10. What are Query Tables?

Sharing & Collaboration

  1. How do I share reports, dashboards, and tables in Analytics Plus?
  2. Why are my colleagues unable to access the reports I create?
  3. Can other users create reports using the tables in the ServiceDesk Plus workspace?
  4. Is it possible to share the same report to multiple users such that they each see different data?
  5. Can I export a report or a dashboard?
  6. How do I print the reports and dashboards created in Analytics Plus?
  7. Can I email reports and dashboards at scheduled times?
  8. Can I embed reports?

Known Issue

  1. Sync issue as a result of self-signed certificate used in Analytics Plus.

Help & Support

  1. How do I get technical support on Analytics Plus?
  2. Can I have get a personalized demo of this integration?

General

1. What is Analytics Plus?

ManageEngine Analytics Plus is an on-premises reporting and business intelligence application that helps you analyze your IT data and create insightful reports & dashboards for informed decision-making. It offers the following important capabilities:

  • Import data from local filesweb feedslocal and cloud databases, and cloud storage/drive.

  • Displays data in an easy-to-view excel format.

  • Build custom reports and dashboards easily, with the drag-and-drop report builder.

  • Supports powerful visualizations in the form of chartspivot tables , summary views, tabular views, and dashboards

  • Generate reports and KPIs in seconds with Zia, Analytics Plus' intelligent analytics assistant powered by Machine Learning and Artificial Intelligence.

  • Create custom formulas using the built in formula engine that contains a wide range of mathematical, statistical and logical functions.

  • Share reports and dashboards with your colleagues easily, through a wide range of collaboration features. 

  • Export and publish reports and dashboards in various formats, and configure permissions and filters for the views.

  • Supports out-of-the-box integrations with a wide number of applications, to give you pre-built reports and dashboards on your application's data within minutes.

2. What are the highlights of this integration?

Analytics Plus seamlessly integrates with Servicedesk Plus, allowing you to create intuitive reports and live dashboards for a high level view of your help desk. 

The data from the following modules will be synchronized into Analytics Plus on setting up this integration.

  • Request
  • Request transition history
  • Task
  • Worklog
  • Service Catalog
  • Change Management
  • Asset Management

For a full list of reports offered, click here. You can also access advanced analytics for other Service Desk instances configured under the ESM Directory, such as HR, Facilities, etc. 

Setup

1. How do I integrate Analytics Plus with Servicedesk Plus?

There are two ways to do this: 

Download and integrate manually

To download and integrate Analytics Plus with ServiceDesk Plus, follow the steps detailed in the below presentation. 

Integrate using the Quick Setup option

Analytics Plus also offers a quick setup method of integrating with ServiceDesk Plus. This installs Analytics Plus on your ServiceDesk Plus server automatically, setting up the integration within minutes. 

The following are the minimum system prerequisites for integrating Analytics Plus with ServiceDesk Plus using the Quick Setup option.

  • For Windows installations, 

    • 50GB free disk space 
    • 16GB RAM 
    • 2GHz Quad core processor
  • For Linux installations,

    • The operating system should be Ubuntu 18.04 LTS or above.

If you face any issues during set up, and ServiceDesk Plus is installed within the Program Files folder in your server, please follow the instructions below and try again.

  • Navigate to where ServiceDesk Plus is installed in your server. Right click the folder, select the Properties option and navigate to the Security tab.

  • Provide the Full Control permission for the All Application Packages and the All Restricted Packages groups that are listed under the Security tab. 

To integrate Analytics Plus with ServiceDesk Plus using the Quick Setup option, follow the steps detailed in the below presentation.

2. How to configure single-sign-on for ServiceDesk Plus users in Analytics Plus?

Analytics Plus allows ServiceDesk Plus administrators to enable single sign-on functionality which allows users to access Analytics Plus seamlessly from within the ServiceDesk Plus interface, without providing any login credentials.

The following are the various steps involved in enabling single sign-on:

Note: Ensure the OpenSSL package is available in your workstation to enable single sign-on for ServiceDesk Plus users. 

Step 1: Generate SAML keys

To enable single sign-on functionality, SAML keys need to be generated. Follow the steps below to do this.

For Windows installations:

  • Navigate to the <Analytics Plus home>\bin folder, and run the genKey.bat file (from the command prompt).

  • The aa_rsaprivkey.der and aa_rsapubkey.pem keys will be generated under the <Analytics Plus home>\conf\SAML\ME folder.

  • Copy both keys and paste them in the <ServiceDesk_Plus home>\conf\saml folder.

For Linux installations:

  • Navigate to the <Analytics Plus home>\bin folder, and run the genKey.sh file (from the command prompt).

  • The aa_rsaprivkey.der and aa_rsapubkey.pem keys are generated under the <Analytics Plus home>\conf\SAML\ME folder.

  • Copy both keys and paste them in the <ServiceDesk_Plus home>\conf\saml folder.

Step 2: Update Advanced Analytics configuration

  • Open your ServiceDesk Plus installation, and navigate to the Admin > Advanced Analytics section.

  • Click the Enable SSO checkbox and click Save.

Step 3: Associate SSO configuration with Analytics Plus users

On configuring single sign-on between ServiceDesk Plus and Analytics Plus, you can easily enable single sign-on for ServiceDesk Plus users by associating them to the appropriate configuration.

  • Log in to Analytics Plus account as Administrator.

  • Navigate to Settings > User Management > Users tab.

    Analytics Plus allows you to associate SSO configuration with both the new and existing users. Click Add User to add a new user or click the edit icon that appears on mouse over the corresponding user.

  • In the page that appears, select the Enable Single Sign-on checkbox.

  • Select the required ServiceDesk Plus application name (in which the SSO option is enabled) from the Single Sign-on via drop down, and click Save.

The configured ServiceDesk Plus user can now access the Analytics Plus workspace from within the ServiceDesk Plus interface by clicking the Advanced Analytics button.

3. How long should I wait for my ServiceDesk Plus data to initially appear in Analytics Plus?

After setting up the integration, you might have to wait some time for the initial fetch to happen. Depending on the amount of data in your application, the reports and dashboards might take up to 5 minutes to display all the metrics. If you access the workspace before the initial fetch, it will not display any data.

4. Can I access blended reports built on data from different applications?

Yes. Analytics Plus provides out-of-the-box blended reports that combine data from ManageEngine ServiceDesk Plus and ManageEngine Endpoint Central. Follow the steps below to do this: 

  • Navigate to your ServiceDesk Plus workspace, click the Create button from the side panel, and select the New table / Import Data option. 

  • Select the Endpoint Central tile, enter the Endpoint Central application URL and the API key and click Authenticate Endpoint Central. To learn more about generating the API key, refer this documentation.

  • In the page that appears, select the required Endpoint Central modules. To generate Analytics Plus' out-of-the-box reports and dashboards for Endpoint Central, select the Create default reports checkbox. To generate blended reports that combine data from ServiceDesk Plus and Endpoint Central, select the Data blending checkbox. Click Create to set up the integration.

  • You can also modify the lookup columns between the ServiceDesk Plus and Endpoint Central data by clicking the Customize link. 

The following is an out-of-the-box blended dashboard built on data from ServiceDesk Plus and Endpoint Central. 

5. What should I do when the data synchronization fails?

The import or synchronization process of your ServiceDesk Plus data can fail sometimes, due to a variety of reasons. Please write to analyticsplus-support@manageengine.com if the issue persists.

6. Can I edit the synchronization settings?

Follow the steps below to edit the connection and synchronization settings.

  • Open your ServiceDesk Plus application and navigate to the Admin tab. 

  • Click the Advanced Analytics option under the Integrations section.

  • Navigate to the Additional Setup tab and modify the settings as required.

  • After modifying the necessary settings, navigate to the Initial Setup tab and click the Re-Sync button.

7. Can I trigger a synchronization of my ServiceDesk Plus data on-demand?

Yes. To do this, open your ServiceDesk Plus application. Navigate to Admin > Advanced Analytics, and click the Additional Setup tab. The Instant Sync button allows you to trigger a data synchronization manually. This action can be done a maximum of seven times in a day.

8. How do I create custom reports over my ServiceDesk Plus data?

You can easily create custom reports in the form of chartspivot tables, summary and tabular views in Analytics Plus. Click the corresponding links to learn more about creating reports. These reports can also be organized together to form intuitive dashboards. Refer this documentation to learn more about creating dashboards.

Reporting Features

1. What are the report types supported by Analytics Plus?

Analytics Plus supports a wide variety of reports, in the form of charts, pivot tables, summary views and tabular views. To know more about the various types of reports, click here. To know more about dashboards and KPI widgets, click here.

2. Can I modify the pre-built reports created on integrating with ServiceDesk Plus?

Yes. If you are the Server Administrator or a workspace administrator of the workspace in which the integration is set up, click the Edit Design button in a report's toolbar and make the required changes. If you are a user to whom a report is shared, save a copy of the report by clicking Save > Save As, and modify the copied version as needed.

3. How do I create reports using fields/columns across different ServiceDesk Plus modules?

Columns from different ServiceDesk Plus modules are joined by default. Therefore, reports can be created over this data by simply dragging and dropping the respective columns in the report builder. Click here to learn more about creating reports. 

4. What are formulas in reports?

Formulas are calculations that can be defined using the powerful formula engine in Analytics Plus, to create required reports. Refer this documentation to know more. There are also several default formulas created based on the ServiceDesk Plus modules. To view the default formulas, open the required table, click Add and select the Edit Formulas option.

5. Is it possible to create custom formulas in Analytics Plus?

Yes. Refer this documentation to learn more.

6. Can I modify the tables imported from ServiceDesk Plus?

The data from ServiceDesk Plus is synchronized with Analytics Plus automatically, and stored in the form of various tables. Therefore, it is not possible to add data or modify the existing data present in these tables.

7. Can I add new columns to the tables imported from ServiceDesk Plus?

No. However, you can add Formula Columns and Aggregate Formulas to these tables, to help create custom reports. Refer this documentation to know more.

8. Can I import new tables into the ServiceDesk Plus workspace?

To do this, open the ServiceDesk Plus workspace, click Create from the side panel and select the New Table / Import Data option. You can integrate with other applications, or choose to import data stored in local filesweb URLslocal databasescloud databases and cloud drives. Click the corresponding links to know more.

9. Can I combine data from other sources with the data from ServiceDesk Plus, and create reports and dashboards?

Yes. To do this, import or add a new table to the ServiceDesk Plus workspace and define a lookup relationship between the added data and the existing data in the workspace. To define a lookup relationship between two tables, it is essential that the tables have at least one column in common between them. Follow the below steps to establish a lookup relationship.

  • Open the corresponding table, right click the column header and select the Change to Lookup Column option.

  • In the dialog that opens, select the column from the second table to look up.

  • Click OK.

Click here to learn more about lookup columns. 

10. What are Query Tables?

Using query tables, Analytics Plus allows you to import the required data required by writing standard SQL queries. This feature also allows you to combine data from different tables, and create reports from the combined data. Refer this documentation to know more.

Sharing & Collaboration

1. How do I share reports, dashboards, and tables in Analytics Plus?

You can share the out-of-the-box reports, dashboards and tables, and the ones you create, with other users easily. Refer this documentation to know more.

2. Why are my colleagues unable to access the reports I create?

The ServiceDesk Plus workspace can be accessed only by the administrator who set up the integration. To allow other users to access the out-of-the-box reports and dashboards, you can share the reports and dashboards as needed. Refer this documentation to know more. You can also share the entire workspace with a user. Refer this documentation to know more. 

3. Can other users create reports using the tables in the ServiceDesk Plus workspace?

Yes. To do this, share the required table with the users with the required permissions and filters. Refer this documentation to know more.

4. Is it possible to share the same report to multiple users such that they each see different data? 

Yes, you can do this by creating Variables. This allows you to share the report to several users, with associated filter criteria so that each user can access only the data specific to them. To learn more, refer this documentation.

5. Can I export a report or a dashboard?

Yes, you can export the report or dashboard in various formats such as CSV, EXCEL, PDF, HTML and image. To learn more, refer this documentation

6. How do I print the reports and dashboards created in Analytics Plus?

To do this, export the report or dashboard in the required format and print the exported file. To learn more about exporting a view in Analytics Plus, refer this documentation

Note: To export a shared report or dashboard, the Export permission has to be enabled. Refer this documentation to learn more about permissions.

7. Can I email reports and dashboards at scheduled times?

Yes, you can easily set up email schedules. Refer this documentation to learn more.

8. Can I embed reports? 

Yes. You can easily embed reports and dashboards into websites, applications or blogs. Refer this documentation to know more.

Known Issue

1. Sync issue as a result of self-signed certificate used in Analytics Plus.

The following error occurs while integrating ServiceDesk Plus with Analytics Plus installations that use a self-signed certificate.

Error message: Sync failed due to a known SSL certificate issue. Follow the instructions in this link and try again.

Please follow the instructions below to resolve this by creating an SSL certificate for Analytics Plus with a custom hostname or IP address.

  • Log in to the server in which your Analytics Plus application is running.
  • Open command prompt/terminal and change the directory to <Analytics Plus home>\bin
  • Run the script genSSLCert.bat (genSSLCert.sh on Linux installations) with the custom DNS name, server hostname, or IP address of the Analytics Plus server as arguments.

    Example: If your Analytics Plus server's hostname is analytics-server, IP address is 192.168.1.1 and the DNS name is analytics-server.acmecorp.com, then run the command as

    genSSLCert.bat dns:analytics-server,ip:192.168.1.1,dns:analytics-server.acmecorp.com

    Note:

    1. We recommend including all possibilities while running the script. If IP address is used, prefix the same with "ip:". If hostname, FQDN, or DNS name is used, prefix it with "DNS:".
    2. You should be on Analytics Plus build number 5220 or above to use this script file.
  • The script will generate a self-signed SSL certificate with the custom names/IP address mentioned.
  • Restart the Analytics Plus server and trigger the integration from ServiceDesk Plus.

Help & Support

1. How do I get technical support on Analytics Plus?

Technical support is free for all users, even during the trial period. You can contact technical support through:

You can also get answers straight from our community

2. Can I have get a personalized demo of this integration?

Yes, please register for a demo using the form on this page.

Share this post : FacebookTwitter