Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

 

Table of Contents
maxLevel3
minLevel2

General

Edit

Mandatory input for each operation

  • Credeintials Credentials - Web Service Client User authentication credentials
  • extendedSettings - Extended Settings such as response format.

Each Operation returns -

  • DefaultServiceResponse JavaBean container which stores the specific bean response for Web Services operation
  • While creating an entity, values for fields such as Row ID (Unique system generated), Entity ID (System generated )should not be entered as input parameter values.
  • While updating an entity, values for fields that already contain a Read only value should not be entered as input parameter values.

getServiceRequest

Edit

Id: 84
Returns an excerpt of the primary details (general information) pertaining to the specified the service request.


Input Parameters
ticketIdentifier - Ticket Identifier for which details should be fetched.


Output
Row ID, Case ID, Case#, Ticket Type, Received In Mailbox,  
person1_address_id, Email, Requester Phone, person1_contact_id, Organization, Site, Location, person1_org_id, person2_address_id, Email, Phone, person2_contact_id, Organization, Site, Location, person2_org_id, Requested For, Requester Name, vip_flag, vip_flag_person1, vip_flag_person2, 
Description, Details, Affected Service ID, Affected Service, Class, Category, Type, Item, CCTI ID, Impact, Impact Code,  Priority, Priority Code,  Source, Source Code, Urgency, Urgency Code, Total Time Spent (HH:MM), Assigned Individual ID, Assigned Group ID, Assigned Group, Assigned Individual, Phase, Status, Reason Code, Create By, Created On,  Closed By, Closed On, Modified By, Last Modified, Parent Ticket ID, Parent Ticket Identifier,  Cause, Resolution, KB Article ID, Resolved Using Case#, Resolved Using Item ID, 

listServiceRequests

Edit

Id: 85
Returns the list of all open service requests for the logged in user and his groups matching the specified search criteria.


Input Parameters
searchText - String to match the Status, Assigned Group, Assigned Individual, Organization, Site etc.


Output
Assigned Group, Assigned Individual, Created Date, Requester Organization, Modified Date, Requester, Row ID, Case#, Description, Priority, Reason Code, Status, Type

logServiceRequest

Edit

Id: 86
Creates/Logs the new service request ticket with the provided details.


Input Parameters
Row ID, Case#, Parent Row ID, Parent Case#, Case ID, Phase, Status, Reason Code, Assigned Individual, 
Assigned Contact ID, Assigned Group, Assigned Group ID, Created By, Modified By, Created On, Last Modified, Closed On, Closed By, Requester Contact ID, Requester Email, Requester Name


Output
ticket_identifier, item_id

updateServiceRequest

Edit

Id: 87
Updates an existing service request identified by the row id with the provided details.


Input Parameters
Row ID, Workflow action Id,Case#, Parent Row ID, Parent Case#, Case ID, Phase, Status, Reason Code, Assigned Individual, 
Assigned Contact ID, Assigned Group, Assigned Group ID, Created By, Modified By, Created On, Last Modified, Closed On, Closed By, Requester Contact ID, Requester Email, Requester Name


Output
item_id, ticket_identifier 

listWorklogs

Edit

Id: 88
Returns the list of all the worklogs pertaining to the specified service request matching the specified search criteria.


Input Parameters
ticketIdentifier - Ticket Identifier for which worklogs should be fetchedsearchText - String to match the User etc.


Output
Row ID, Worklog Date, Created By, Created On, Worklog Description, Time Spent (Min), Work Log Type

addWorklog

Edit

Id: 89
Adds a new service request specific worklog entry into the database and relates it to the respective ticket.


Input Parameters
workglogBean - Workglog Bean containing details which must be used to add the worklog.
Row ID / Ticket Identifier / Item ID / Ticket Type / Worklog Type Code / Worklog Type / Client Viewable / Time Spent (Min) / Worklog Description / Worklog Date / Work Created By / Work Created By Contact ID / Work Created  Date / Work Modified By / Work Modified By Contact ID /Work Modified Date.


Output
worklog_id

updateWorklog

Edit

Id: 90
Updates an existing service request specific worklog details.


Input Parameters
workglogBean - Workglog Bean containing details which must be used to update the worklog.
Ticket Identifier/ Item ID/ Ticket Type/ Worklog Type Code/ Worklog Type/ Client Viewable/ Time Spent (Min)/ Worklog Description/ Worklog Date/ Work Created By/ Work Created By Contact ID/ Work Created Date/ Work Modified By/ Work Modified By Contact ID/ Work Modified Date/  


Output
Worklog_Id

listCommunications

Edit

Id: 91
Returns the list of all the communications pertaining to the specified service request matching the specified search criteria.


Input Parameters
ticketIdentifier - Ticket Identifier for which communications should be fetchedsearchText - String to match the User etc.


Output
Created Date, Status, Communication ID, Send To, Subject, Direction, Type, Related To Form, Created By

sendCommunication

Edit

Id: 92
Sends a new ticket-specific communication and relates it to the respective ticket.


Input Parameters
commBean - Communication Bean containing details which must be used to send the communication.
Row ID / Ticket Identifier /Item ID / To/ Cc/ Bcc/ Subject/ Message/ Reply-To Display Name/ Communication Created By/ Do not deliver before/ Communication Delivery Status/Communication Template ID/ Communication Trace Log/ Communication Type/ Communication Type Mask/ Fb Form Notification ID/ Sched Task ID/ Regenerate message on Send.


Output
Communication Id

listAttachments

Edit

Id: 93
Returns the list of all the related attachment document(s) matching the specified search criteria  pertaining to the specified change request.


Input Parameters
ticketIdentifier - Ticket Identifier for which attachments should be fetched.


Output
Created Date, Description, Attachment File Name, Type, Attachment ID, Can be used as Global, Attachment Name, Attachment Name, Created By, Case#, rel attach id, Ticket Type

relateAttachment

Edit

Id: 94
Relates specified attachment document to the specified service request.


Input Parameters
ticketIdentifier - Ticket Identifier to which a passed in Attachment is to be related.
attachmentId - Attachment Id which must be related to the change request.


Output
Attachment File Name, Attachment ID, Attachment Name, Can be used as Global, Case#, Created By,  Created Date, Description, Ticket Type, Attachment Type, rel attach id

unrelateAttachment

Edit

Id: 95
Unrelates specified attachment document associated with the specified service request.


Input Parameters
ticketIdentifier - Ticket Identifier from which an attachment is to be unrelated.
attachmentId - Attachment Id which must be related to the change request.


Output
None

listRelatedConfigurationItems

Edit

Id: 96
Returns the list of all the configuration items related to the specified support request (ticket) matching the specified search criteria.


Input Parameters
ticketIdentifier - Ticket Identifier for which related Configuration Items should be fetched.


Output
CI ID, CI Name, Identifier, Purpose, Category, Class, Status, Attribute 1, Attribute 2, Attribute 3

relateConfigurationItem

Edit

Id: 97
Relates the Configuration Item (CI) identified by either the Row ID or CI Identifier (Row ID will take precedence over CI Identifier if both are specified) to the specified service request.


Input Parameters
ticketIdentifier - Ticket Identifier to which a passed in Configuration Item is to be related.
configurationItemIdentifier - Configuration Item Identifier which must be related to Service request.


Output
CI ID / Identifier/ Name/ Purpose/ Status/ Category/ Class/ Attribute 1/ Attribute 2/ Attribute 3 / 

unrelateConfigurationItem

Edit

Id: 98
Unrelates the Configuration Item (CI) identified by either the Row ID or CI Identifier (Row ID will take precedence over CI Identifier if both are specified) from the specified service request.


Input Parameters
ticketIdentifier - Ticket Identifier to which a passed in Configuration Item is to be related.
configurationItemIdentifier - Configuration Item Identifier which must be unrelated from the Service request.


Output
None

listRelatedTickets

Edit

Id: 99
Returns the list of all the support requests (tickets) including task tickets related to the specified service request matching the specified search criteria.


Input Parameters
ticketIdentifier - Ticket Identifier for which related tickets should be fetched.


Output
Case ID, rel_type_mask, Case#, Description, Other Information, Status, Ticket Type

relateTicket

Edit

Id: 100
Relates the selected support request (ticket) to a service request.


Input Parameters
parentTicketIdentifier - Ticket Identifier to which a passed in Ticket is to be related.
relateTicketIdentifier - Ticket Identifier which must be related to the Service request.


Output
Case #, Description, Status, Other Information, Ticket Type, Case ID, rel_type_mask

unrelateTicket

Edit

Id: 101
Unrelates the specified support request (ticket) associated with a specified service request.


Input Parameters
parentTicketIdentifier - Ticket Identifier from which a passed in Ticket is to be unrelated.
relateTicketIdentifier - Ticket Identifier which must be unrelated from the Service request.


Output
None

listActivities

Edit

Id: 102
Returns the list of all historical activity including communications pertaining to the specified service request matching the specified search criteria.


Input Parameters
ticketIdentifier - Ticket Identifier for which historical activity should be fetched
searchText - String to match the Type, User etc.


Output
Case ID, User, Date, Description, history_row_id, Case#, Ticket Type, Type

listSLAComplianceLevels

Edit

Id: 103
Returns the list of all service level agreement (SLA) compliance being monitored, measured and acted upon for alters or escalations pertaining to the specified service request matching the specified search criteria.


Input Parameters
ticketIdentifier - Ticket Identifier for which service level agreement (SLA) compliance should be fetched
searchText - String to match the Target Name, Compliance Status etc.


Output
Agreement ID, SLA Compliance Target, Threshold, Violation Threshold, Due By , Start Time,  Due By, Measured Time, Threshold Compliance Status, Affected Service, Assigned Group, Compliance Notes