ServiceRequest Web-services

General

Mandatory input for each operation

• 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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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