Integrating with ServiceDesk Plus


ServiceDesk Plus is a web-based Help Desk and Asset Management software, offered by ManageEngine. With ServiceDesk Plus installed in your network, you can automatically log trouble tickets for specific alarms and maintain a Configuration Management Database (CMDB) that allows you to plot out your IT infrastructure from Applications Manager.

ServiceDesk Plus - MSP

ServiceDesk Plus - MSP help-desk software is specifically built for managed service providers. ServiceDesk Plus - MSP helps service providers. With the integrated Applications Manager and ServiceDesk Plus management solution, service providers like can get end-to-end visibility of your client's IT infrastructure.

ServiceDesk Plus (SDP) On-Demand

ManageEngine ServiceDesk Plus (SDP) On-Demand is an online help desk software built on the ITIL framework with integrated asset management capability.

Logging trouble tickets:

Applications Manager has the ability to automatically log trouble tickets for a specific alarms and to notify the concerned technician when a particular process exceeds the set threshold point. Along with the provision to e-mail, SMS, and other notifications, alarms can also be tracked by automatically logging trouble tickets to ServiceDesk Plus. Applications Manager takes care of the two way synching of Alerts & Tickets status from SDP. For example, you can automatically log a ticket when an alarm is raised, reopen the ticket whenever an alarm is reoccured or close the ticket if the alarm is cleared.

For logging the trouble ticket to ServiceDesk Plus correctly, the following needs to be ensured:

Configuration Management Database

From a CMDB perspective, all the components monitored in Applications Manager are referred to as Configuration Items (CI). With the ServiceDesk Plus integration, Applications Manager takes care of :

  • Identification of CIs in your IT environment,
  • Mapping the relationship between the CIs and
  • Helping you predict the impact of CIs before performing any change.

You can track of all the pending requests, problems and change raised for the CI Type. Once a problem ticket is logged you can also assign a technician for the ticket. Any impact cause by the malfunctioning of these CIs and other CI details can be identified with Relationship Mapping, and specific measures can be adapted to minimize the effect.

Configuring ServiceDesk Plus in Applications Manager:

This section describes the method in which ServiceDesk Plus Settings are to be configured in Applications Manager:

    1. Under Admin Tab, click on Add-On/Product Settings under Applications Manager Server Settings.
    2. An Add-on/Product Settings Table is displayed.
    3. Click on Add action for Service Desk. This takes you to the ManageEngine ServiceDesk Plus Server Details page.
    4. Configuring ServiceDesk Plus Settings in Applications Manager can be done in two ways: Using REST APIs or Using Credentials.
      1. Using REST APIs:This feature supports Applications Manager with ServiceDesk Plus integration using SDP REST API Keys and automatic closing of tickets. Follow the steps below to configure ServiceDesk Plus Settings in Applications Manager:
        • Under the Use Rest API tab enter the ServiceDesk Plus Server Details, specify the product that you wish to add - ServiceDesk Plus orServiceDesk Plus - MSP.
        • Name of the server and port number where ServiceDesk Plus is running
        • Enter the REST API key. ( While a ticket action is created, and a technician is assigned from the Log a Ticket form, the technician must have an SDAdmin privilege in SDP. Make sure that the technician whose key you're using has SDAdmin privilege in SDP.)
        • Select one of the given protocols: http or https(SSL).
        • By checking the Advanced Settings checkbox you have the option to configure
        • Test if the connection is working and save the settings.
      2. Using Credentials
        • Under Admin Tab, click on ServiceDesk Settings
        • Enter the ServiceDesk Plus Server Details
          • Enter the Name of the server where ServiceDesk Plus is running.
          • Enter the Port Number of that server.
        • Enter the Authentication Details of the ServiceDesk Plus Server - Login and Password.
        • Enter the Email Address configured in ServiceDesk Plus. All the trouble tickets generated would be sent to that Email ID.
        • Enter the Email Address from which the trouble tickets should be sent.
        • Test if the connection is working and save the settings.
Note:
  • It is mandatory to have sample account and site if you are using SDP-MSP as add-on product. In case, if the sample account and site are deleted from SDP-MSP, tickets action will not getting executed.
  • The 'Using Credentials' operation will not be supported if the SDP version is above 9101.
  • CMDB should be enabled only if SDP version is 9 or above.
  • If you select ServiceDesk Plus - MSP, you will not be able to use the CMDB modules.

Integrate ServiceDesk Plus (SDP) On-Demand with Applications Manager

Obtain the api key for ServiceDeskPlus On-Demand instance:

  • Login to SDP OnDemand.
  • Click the below URL to generate the API key: https://accounts.zoho.com/apiauthtoken/create?SCOPE=SDPOnDemand/sdpodapi
  • Copy the API key.

Setting up Applications Manager:

      1. Go to Admin --> Add on products --> Helpdesk and click on add.
      2. Now, choose ServiceDesk Plus OnDemand from the SDP Product option.
      3. You can add an SDP OD instance by two methods:
      4. Using REST API:
        • Enter your URL and REST API key. 
        • If your instance name is itdesk, when you launch sdpod, the url will be similar to that of the following. Type it completely in the URL field. Eg: https://sdpondemand.localmanageengine.com/app/itdesk
        • The authtoken obtained using the link( https://accounts.zoho.com/apiauthtoken/create?SCOPE=SDPOnDemand/sdpodapi ) should be added to the API Key field.
      5. Using OAuth:
        •  If you choose to add an SDP OD instance via OAuth, enter the URL and select the OAuth provider from the drop-down menu. 
        •  If you want to add a new OAuth provider, click on Add OAuth Provider.
      6. Check Advanced Settings and Enable Ticleting option to configure Ticket settings.

Ticket Settings

You can configure the following settings:

      • Set Applications Manager to perform one of the following actions when an alarm is raised again for a closed ticket:
        • To reopen the ticket whenever an alarm is reoccured.
        • To reopen the ticket within a certain number of days from the closed time. If the ticket is not reopened a new ticket is automatically created. (To reopen the ticket whenever an alarm is reoccured within a certain number of days else open a new ticket.)
        • To create a new ticket or to open a new ticket whenever an alarm has re-occured.
      • Set Applications Manager to perform one of the following actions when an alarm is cleared for a ticket:
        • To close the ticket
        • To update the notes associated with that ticket.
      • Add notes for the ticket whenever an annotation is made for the alarm.
      • Enable on-demand ticket generation using :
        • Raise a ticket action, so that you can raise a ticket on demand using a ticket action from alarms page. The new on-demand tickets are mapped to the respective configuration items.
        • Request Form, so that you can raise a ticket on demand using the request form from alarms page. The new on-demand tickets are mapped to the respective configuration items.
      • Access ticket details from Application Manager. User can access the ticket details from the ticket details link in the alert details page.
      • Launch Read only ticket. When selected, the ticket details launched from AppManager would be read only.
      • Update the ticket only if there is a status change in the alarm.
        • If enabled, action is triggered only when there is a status change in alarm.
      • Over-write the request template with the fields selected in the action profile.
        • This option is disabled by default. In Log a ticket action, on selecting the Incident template, the other fields will be hidden. The default values of the Incident template chosen would be used to log the trouble ticket in ServiceDesk Plus.
        • If enabled, the other fields will become visible, thereby, allowing the user to modify the default fields of the Incident template (https://www.manageengine.com/products/service-desk/help/adminguide/configurations/helpdesk/request_template.html).

Configuration Item Details and Relationship Mapping

Once the ServiceDesk Plus Settings are be configured, Applications Manager identifies all the monitors (unless you have configured to exclude a monitor(s) or a selected monitor type(s)) and adds them as Configuration Items in ServiceDesk Plus CMDB.

You can change the following Configuration Item Settings by clicking on the Advanced Settings checkbox and then enabling the Enable Configuration Item (CI) sync option.

      • Delete the CI if the corresponding monitor is deleted
      • Exclude the monitor(s) of the selected monitor type(s). Users can select the monitors types that they wish to exclude from the list provided to be added as CI(s). Select the monitors that you wish to exclude from the first list and move it to the second list.
      • Configure custom fields of the monitor as attributes of a configuration item. The new custom field need not get added in Service Desk Plus.
      • Users can access configuration item and relationship details from Application Manager in the monitor snapshot page.

To View the details of a Configuration Item and view Relationship Maps:

    • Go to the Monitors tab.
    • From the Select View list, choose the Bulk Configuration View.
    • Open the List View which will give you a list of all the monitors.
    • In the list, click on the  icon near a monitor to view the CI Details.
    • Click on the  icon to view the Relationship Map.