Intelligent Service Management Connector

Automation Center is only available in the ISM Service Management edition. This feature is not available in the ISM Service Desk edition.

The Intelligent Service Management connector helps you automate various operations in the Serviceaide Intelligent Service Management system. As a designer you can create and update assets, create, and update a (Service Request, Change Request, Incident Request) ticket. This section provides following information for the Intelligent Service Management connector:

Credentials

Credential Parameter

                                                Description

Encrypted

Authentication Method

The type of authentication method the SOAP service uses. Supported: BASIC & AUTHTOKEN.

Yes

User Name

The username for accessing the web service

No

Password

The password for accessing the web service

Yes

Operations

Input and Output Parameters

Create Change Request

Input Parameters
NameDescriptionRequired?Type
Requester NameSpecify the name of the requester submitting the change request.TRUEString
DescriptionSpecify the description of the change request.TRUEString
DetailsSpecify the detailed information pertaining to the change request.TRUEString
Affected ServiceSpecify the business change (configuration item) affected by this change request.FALSEString
Categorization ClassSpecify the categorization class for classification of the change request.FALSEString
Categorization CategorySpecify the categorization category for classification of the change request.FALSEString
Categorization TypeSpecify the categorization type for classification of the change request.FALSEString
Categorization ItemSpecify the categorization item for classification of the change request.FALSEString
SourceSource category indicates the prioritization for the change request.FALSEString
ImpactSpecify the business impact to indicate the prioritization for the change request.FALSEString
UrgencySpecify the urgency level to indicate the prioritization for the change request.FALSEString
PrioritySpecify the priority to indicate the prioritization for the change request.FALSEString
Outage Total Time (HH:MM)Specify the total down-time expected due to the change implementation.TRUEString
Business CriticalitySpecify the criticality category of the change request.FALSEString
Reason CodeSpecify the reason code that is associated with the status.FALSEString
StatusSpecify the ticket statusFALSEString
Output Parameters   
NameDescriptionRequired?Type
Ticket IDSpecify the ticket identifier for the change request ticket.TRUEInteger
Success(Boolean) Specifies the change request operation that is succeeded, where the value is either:TRUEBoolean
True - success.
False - failure.
Result CodeResult code indicates the success or failure status of the operation.TRUEInteger
Result MessageThe verbose result message indicates the status of the operation.FALSEString
Last Modified UserNameSpecify the last Modified UserName of the change request.FALSEString
AffectedserviceSpecify the affected change of the change request.FALSEString
Creation User NameSpecify the Creation User Name of the change request.FALSEString
Long DescriptionSpecify the long Description of the change request.FALSEString
PhaseSpecify the phase of the change request.FALSEString
Requester EmailSpecify the requester Email of the change request.FALSEString
Requester PhoneSpecify the requested For UserName of the change request.FALSEString
Requested For UserNameSpecify the requested For UserName of the change request.FALSEString
Assigned GroupSpecify the assigned Group of the change request.FALSEString
PrioritySpecify the priority of the change request.FALSEString
Assigned IndividualSpecify the assigned Individual of the change request.FALSEString
Creation TimestampSpecify the Creation Timestamp of the change request.FALSEString
Last Modified TimestampSpecify the last modified Timestamp of the change request.FALSEString
Description of TicketSpecify the description of the change request.FALSEString
Charge CategorySpecify the charge Category of the change request.FALSEString

Update Change Request

Input Parameters
NameDescriptionRequired?Type
Ticket IdentifierSpecify the identifier of the change request.TRUEInteger
Affected ServiceSpecify the business service (configuration item) affected by this change request.

Requester NameSpecify the name of the requester submitting the change request.TRUEString
DescriptionSpecify the description of the change request.TRUEString
DetailsSpecify the detailed information pertaining to the change request.TRUEString
ImpactSpecify the business impact to indicate the prioritization for the change request.FALSEString
PrioritySpecify the priority to indicate the prioritization for the change request.FALSEString
Business CriticalitySpecify the criticality category of the change request.FALSEString
Output Parameters
NameDescriptionRequired?Type
Ticket IDSpecify the ticket identifier for the change request ticket.TRUEInteger
Success(Boolean) Specifies the change request operation that is succeeded, where the value is either:TRUEBoolean
True - success.
False - failure.
Result CodeResult code indicates the success or failure status of the operation.TRUEInteger
Result MessageThe verbose result message indicates the status of the operation.FALSEString

Create Incident Ticket

Input Parameters
NameDescriptionRequired?Type
Requester NameSpecify the name of the requester submitting the incident ticket.TRUEString
Symptom DescriptionSpecify the visible and directly experienced aspects of an incident ticket.TRUEString
Symptom DetailsSpecify the detailed information pertaining to the visible and directly experienced aspects of an incident ticket.FALSEString
Affected ServicesSpecify the business service that this incident ticket is affected by.FALSEString
Categorization ClassSpecify the categorization class for classification of the incident ticket.FALSEString
Categorization CategorySpecify the categorization category for classification of the incident ticket.FALSEString
Categorization TypeSpecify the categorization type for classification of the incident ticket.FALSEString
Categorization ItemSpecify the categorization item for classification of the incident ticket.FALSEString
SeveritySpecify the criticality category of the incident ticket.FALSEString
SourceSource category indicates the prioritization for the incident ticket.FALSEString
ImpactBusiness impact indicates the prioritization for the incident ticket.FALSEString
UrgencyUrgency level indicates the prioritization for the incident ticket.FALSEString
PriorityPriority to indicate the prioritization for the incident ticket.FALSEString
Reason CodeSpecify the reason code that is associated with the status.FALSEString
StatusSpecify the ticket status.FALSEString
Output Parameters
NameDescriptionRequired?Type
Ticket IDSpecify the ticket identifier for the change request ticket.TRUEInteger
Success(Boolean) Specifies the change request operation that is succeeded, where the value is either:TRUEBoolean
True - success.
False - failure.
Result CodeResult code indicates the success or failure status of the operation.TRUEInteger
Result MessageThe verbose result message indicates the status of the operation.FALSEString
Last Modified UserNameSpecify the last modified UserName of the change request.FALSEString
AffectedserviceSpecify the affected change of the change request.FALSEString
Creation User NameSpecify the creation User Name of the change request.FALSEString
PhaseSpecify the phase of the change request.FALSEString
Requester EmailSpecify the requester Email of the change request.FALSEString
Requester PhoneSpecify the requested For UserName of the change request.FALSEString
Requested For UserNameSpecify the requested For UserName of the change request.FALSEString
Assigned GroupSpecify the assigned Group of the change request.FALSEString
PrioritySpecify the priority of the change request.FALSEString
Assigned IndividualSpecify the assigned Individual of the change request.FALSEString
Creation TimestampSpecify the creation Timestamp of the change request.FALSEString
Last Modified TimestampSpecify the last modified Timestamp of the change request.FALSEString
Description of TicketSpecify the description of the change request.FALSEString

Update Incident ticket

Input Parameters
NameDescriptionRequired?Type
Ticket IdentifierSpecify the identifier of the incident ticket.TRUEInteger
Requester NameSpecify the name of the requester submitting the incident ticket.TRUEString
Symptom DescriptionSpecify the visible and directly experienced aspects of an incident ticket.TRUEString
Symptom DetailsSpecify the detailed information pertaining to the visible and directly experienced aspects of an incident ticket.FALSEString
Affected ServicesSpecify the business service that is affected by this incident ticket.FALSEString
ImpactSpecify the business impact to indicate the prioritization for the incident ticket.FALSEString
PrioritySpecify the priority to indicate the prioritization for the incident ticket.FALSEString
Output Parameters
NameDescriptionRequired?Type
Ticket IDSpecify the ticket identifier for the incident ticket.TRUEInteger
SuccessSpecify if the incident ticket operation succeeded, where the value is either:TRUEBoolean
True - success.
False - failure.
Result CodeResult code indicates the success or failure status of the operation.TRUEInteger
Result MessageThe verbose result message indicates the status of the operation.FALSEString

Create Configuration Item

Input Parameters
NameDescriptionRequired?Type
CI NameSpecify the configuration item nameTRUEString
CI IdentifierSpecify the configuration item identifierFALSEString
FunctionSpecify the configuration item function descriptor.FALSEString
DescriptionSpecify the configuration item descriptionFALSEString
StatusSpecify the current status of the configuration item.FALSEString
Organization NameSpecify the primary organization that owns the configuration item.TRUEString
Categorization ClassSpecify the categorization class for classification of the configuration item.TRUEString
Output Parameters
NameDescriptionRequired?Type
Configuration Item IDSpecify the identifier for the configuration item. FALSEInteger
Success(Boolean) Whether the CI-related operation succeeded, where the value is either:FALSEBoolean
True - success.
False - failure.
Result CodeResult code indicates the success or failure status of the operation.FALSEInteger
Result MessageThe verbose result message indicates the status of the operation.FALSEString
Change Approver NameSpecify the Change Approver Name of the configuration item.FALSEString
Configuration DescriptionSpecify the Configuration Description of the configuration item.FALSEString
Configuration StatusSpecify the Config Status of the configuration item.FALSEString
Configuration IDSpecify the Configuration ID of the configuration item.FALSEString
Creation User Name Specify the Creation User Name of the configuration item.FALSEString
OpenRelated Ticket CountSpecify the Open Related Ticket Count of the configuration item.FALSEString
Config Owner User Name Specify the Config Owner User Name of the configuration item.FALSEString
Configuration Item NameSpecify the Config Name of the configuration item. FALSEString
Related Asset IDSpecify the Related Asset ID of the configuration item.FALSEString
Related Asset NameSpecify the Related Asset Name of the configuration item.FALSEString
Categorization Class ResultSpecify the Categorization Class Result of the configuration item.FALSEString

Update Configuration Item

Input Parameters
NameDescriptionRequired?Type
Configuration Item IDSpecify the internal system identifier of the configuration item.TRUEInteger
CI NameSpecify the configuration item nameFALSEString
CI IdentifierSpecify the configuration item identifierFALSEString
FunctionSpecify the configuration item function descriptor.FALSEString
DescriptionSpecify the configuration item descriptionTRUEString
StatusSpecify the current status of the configuration item.TRUEString
Organization NameSpecify the primary organization that owns the configuration item.FALSEString
Categorization ClassThe categorization class for classification of the configuration itemFALSEString
Output Parameters
NameDescriptionRequired?Type
Configuration Item IDSpecify the identifier for the configuration item. FALSEInteger
Success(Boolean) Specifies whether the CI-related operation succeeded, where the value is either:TRUEBoolean
True - success.
False - failure.
Result CodeResult code indicates the success or failure status of the operation.FALSEInteger
Result MessageThe verbose result message indicates the status of the operation.FALSEString

Create Service Request

Input Parameters
NameDescriptionRequired?Type
Affected ServicesSpecify the business service (configuration item) affected by this service request.FALSEString
DetailsSpecify the detailed information pertaining to the service request.FALSEString
Categorization CategorySpecify the categorization category for classification of the service request.FALSEString
Categorization ClassSpecify the categorization class for classification of the service request.FALSEString
Categorization ItemSpecify the categorization item for classification of the service request.FALSEString
Categorization TypeSpecify the categorization type for classification of the service request.FALSEString
DescriptionSpecify the description of the service request.TRUEString
ImpactSpecify the business impact to indicate the prioritization for the service request.FALSEString
PrioritySpecify the priority to indicate the prioritization for the service request.FALSEString
Reason CodeSpecify the reason code that is associated with the status.FALSEString
Requester NameSpecify the name of the requester submitting the service request.TRUEString
SourceSpecify the source category to indicate the prioritization for the service request.FALSEString
StatusSpecify the ticket statusFALSEString
UrgencySpecify the urgency level to indicate the prioritization for the service request.FALSEString
Output Parameters
 NameDescriptionRequired?Type
Ticket IDSpecify the ticket identifier for the service request ticket.TRUEInteger
Success(Boolean) Whether the service request operation succeeded, where the value is either:TRUEBoolean
True - success.
False - failure.
Result CodeResult code indicates the success or failure status of the operation.TRUEInteger
Result MessageThe verbose result message indicates the status of the operation.FALSEString
Last Modified UserNameSpecify the Last Modified UserName of the service request.FALSEString
Affected ServiceSpecify the affected service of the service request.FALSEString
Creation User NameSpecify the Creation User Name of the service request.FALSEString
Long DescriptionSpecify the Long Description of the service request.FALSEString
PhaseSpecify the Phase of the service request.FALSEString
Requester EmailSpecify the Requester Email of the service request.FALSEString
Requester PhoneSpecify the Requested For UserName of the service request.FALSEString
Requested For UserNameSpecify the Requested For UserName of the service request.FALSEString
Assigned GroupSpecify the Assigned Group of the service request.FALSEString
PrioritySpecify the Priority of the service request.FALSEString
Assigned IndividualSpecify the Assigned Individual of the service request.FALSEString
Creation TimestampSpecify the Creation Timestamp of the service request.FALSEString
Last Modified TimestampSpecify the Last Modified Timestamp of the service request.FALSEString
Description of TicketSpecify the Description of the service request.FALSEString

Update Service Request

Input Parameters
NameDescriptionRequired?Type
Ticket IdentifierSpecify the identifier of the service request.TRUEInteger
Requester NameSpecify the name of the requester submitting the service request.TRUEString
DescriptionSpecify the description of the service request.TRUEString
DetailsSpecify the detailed information pertaining to the service request.FALSEString
ImpactSpecify the business impact to indicate the prioritization for the service request.FALSEString
PrioritySpecify the priority to indicate the prioritization for the service request.FALSEString
Affected ServicesSpecify the business service (configuration item) affected by this service request.FALSEString
Output Parameters
NameDescriptionRequired?Type
Ticket IDSpecify the ticket identifier for the service request ticket.TRUEInteger
Success(Boolean) Specifies if the service request operation succeeded, where the value is either:TRUEBoolean
True - success.
False - failure.
Result CodeThe Result code indicates the success or failure status of the operation.TRUEInteger
Result MessageThe verbose result message indicates the status of the operation.FALSEString

Create Asset

Input Parameters
 NameDescriptionRequired?Type
Asset NameSpecify the name of the asset.TRUEString
Asset TypeSpecify the Asset Type.FALSEString
Discovery SourceDiscovery Source defines the source of discovery. For example, Native or Other Discovered Sources.FALSEString
Serial NumberSpecify the Asset Serial number.FALSEString
ActiveSpecify that the Asset is active or not.FALSEString
Bring Your Own DeviceSpecify the True if the Asset is an own device otherwise false.FALSEString
ModelSpecify the Asset model.FALSEString
OrganizationSpecify the Asset organization.FALSEString
VendorSpecify the Asset vendor.FALSEString
User Login of OwnerSpecify the Asset Owner.FALSEString
Asset TagSpecify the Asset asset tag.FALSEString
Asset HostnameSpecify the Asset Host Name.FALSEString
Purchase Order NumberSpecify the Asset purchase order number.FALSEString
Output Parameter
 NameDescriptionRequired?Type
Ticket IDSpecify the ticket identifier for the asset,TRUEInteger
Success(Boolean) Specifies whether the CI-related operation succeeded, where the value is either:TRUEString
True - success.
False - failure.
Result CodeResult code indicates the success or failure status of the operation.TRUEString
Result MessageThe verbose result message indicates the status of the operation.FALSEString
Discovery Source of AssetDiscovery Source defines the source of discovery. For example, Native or Other Discovered Sources.FALSEString
Type of AssetSpecify the Asset Type.FALSEString
Name of AssetSpecify the Name of Asset.FALSEString
Creation Date of AssetSpecify the Name of creation Date.FALSEString
ActiveSpecify that the Asset is active or not.FALSEString

Associate Ticket to Asset

Input Parameter
NameDescriptionRequired?Type
Asset NameSpecify the Name of Asset.TRUEString
Output Parameter
NameDescriptionRequired?Type
Success(Boolean) Specifies whether the service request operation succeeded, where the value is either:TRUEBoolean
True - success.
False - failure.
Result CodeResult code indicates the success or failure status of the operation.TRUEInteger
Result MessageThe verbose result message indicates the status of the operation.FALSEString




Update Asset

Input Parameter
NameDescriptionRequired?Type
Asset NameSpecify the name of the asset.TRUEString
Asset TypeSpecify the Asset Type.FALSEString
Discovery SourceDiscovery Source defines the source of discovery. For example, Native or Other Discovered Sources.FALSEString
Serial NumberSpecify the Asset Serial number.FALSEString
ActiveSpecify that the Asset is active or not.FALSEString
Bring Your Own DeviceSpecify as True if the asset is an own device of an employee otherwise false.FALSEString
ModelSpecify the Asset model.FALSEString
OrganizationSpecify the Asset organization.FALSEString
VendorSpecify the Asset vendor.FALSEString
User Login of OwnerSpecify the Asset Owner.FALSEString
Asset TagSpecify the Asset asset tag.FALSEString
Asset HostnameSpecify the Asset Host Name.FALSEString
Purchase Order NumberSpecify the Asset purchase order number.FALSEString
Output Parameter
NameDescriptionRequired?Type
Success(Boolean)Specifies whether the service request operation succeeded, where the value is either:TRUEBoolean
True - success.
False - failure.
Result CodeThe Result code indicates the success or failure status of the operation.TRUEInteger
Result MessageThe verbose result message indicates the status of the operation.FALSEString

Add Worklog to Ticket

Input Parameters   
NameDescriptionRequired?Type
Ticket IdentifierSpecify the identifier of the change request.TRUEInteger
Worklog TypeSpecify the type classification for the worklog.FALSEString
Ticket TypeSpecify the Ticket Type classification for the worklog.FALSEString
Worklog Text DescriptionSpecify the worklog text describing the work/activity performed.TRUEString
Time SpentSpecify the time that is spent on the activity.TRUEString
Client ViewableIndicate whether the worklog is visible to end users.TRUEBoolean
Output Parameter
NameDescriptionRequired?Type
Success(Boolean) Specifies whether the service request operation succeeded, where the value is either:TRUEString
True - success.
False - failure.
Result CodeThe Result code indicates the success or failure status of the operation.TRUEString
Result MessageThe verbose result message indicates the status of the operation.FALSEString
Ticket IDSpecify the ticket identifier for the change request ticket.FALSEString
Worklog IDSpecify the worklog identifier for the change request ticket worklog.FALSEString
Worklog Actual DataSpecify the Worklog Actual Data of the ticket worklog.FALSEString
Worklog Text DescriptionSpecify theWorklog Text Description of the ticket worklog.FALSEString
Last Modified UserNameSpecify the Last Modified UserName of the ticket worklog.FALSEString
Creation User Name Specify the Creation User Name of the ticket worklog.FALSEString

Add CI to Ticket

Input parameters
NameDescriptionRequired?Type
Ticket IdentifierSpecify the identifier of the change request.TRUEString
Configuration Item IDSpecify the configuration item identifier to relate to the change request.TRUEInteger
Output Parameter
NameDescriptionRequired?Type
Success(Boolean) Specifies whether the service request operation succeeded, where the value is either:TRUEBoolean
True - success.
False - failure.
Result CodeThe Result code indicates the success or failure status of the operation.TRUEInteger
Result MessageSpecify the verbose result message indicates the status of the operation.FALSEString
Ticket IDSpecify the ticket identifier for the change request ticket.FALSEString 

Associated Workflows

  • Create User and Set Password for a Remote Linux Host
  • Start an Instance
  • Create a VM Image
  • Set VM Image Power Status
  • Clone a VM Image
  • Create a VM Image using Template 
    Provision an EC2 instance and create Asset record
  • Terminate an Amazon EC2 Instance and update Service Request
  • Restart an Amazon EC2 Instance
  • Terminate a VM Image
  • Stop Amazon EC2 Instance
  • Create a User
  • Create User and Set Password for a Remote Linux Host
  • Register BYOD Asset
  • On/Off Telnet Services on a Remote Linux Host
  • Reset Password for a Specified User on Remote Linux Host
  • Retrieve Release Status

You can automate Asset creation using the Intelligent Service Management Automation Connector.

© 2019 Serviceaide 1-650-206-8988 http://www.serviceaide.com info@serviceaide.com