Problem Web-services

Owned by priti.hota (Deactivated)
Last updated: Sept 20, 2017
5 min read

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.

getProblem

Id: 64
Returns an excerpt of the primary details (general information) pertaining to the specified the problem.


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


Output
Row ID, Case ID,Ticket Type, Requester Name, Affected User, 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, vip_flag_person1, vip_flag_person2
Affected Service ID, Affected Service, Assigned Individual ID, Assigned Group ID, Assigned Group, Assigned Individual, Status, Reason Code, Closed By, Closed On, Modified By, Last Modified,
Cause, Category, Class, CCTI ID, Item, Type, Created By, Created On, Symptom Details, Related To Global Item ID, Related To Global ID
Parent Ticket ID, Parent Ticket Identifier, Resolution, , Severity, Resolved Using Case#, Resolved Using Item ID, Received In Mailbox, This ticket is -, Symptom Description, Case#, Impact, Impact Code, Phase, Priority, Priority Code, , KB Article ID, Source, Source Code, Urgency, Urgency Code, Total Time Spent (HH:MM), , Custom Fields <on Additional Information tab>

listProblems

Id: 65
Returns the list of all open problem tickets 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

reportProblem

Id: 66
Creates the new problem ticket with the provided details.


Input Parameters
prbBean - Problem Bean containing details which must be used to log the ticket
row_id, ticket_identifier, parent_row_id, parent_ticket_identifier, case_id, ticket_phase, ticket_status, ticket_reason_code, assigned_to_individual_name, assigned_contact_id, assigned_to_group_name, assigned_group_id, created_by_name, modified_by_name, created_date, modified_date, last_closed_date, last_closed_by_name, person1_contact_id, person1_alt_email, requester_name, person1_alt_phone, person1_lvl1_org_name, person1_lvl2_org_name,  person1_lvl3_org_name, person1_org_id, person1_address_id, vip_flag_person1, person2_contact_id
person2_alt_email, requested_for_name, person2_alt_phone, person2_lvl1_org_name, person2_lvl2_org_name
person2_lvl3_org_name, person2_org_id, person2_address_id, vip_flag_person2, affected_ci_name. affected_ci_identifier, affected_ci_id, ticket_description, description_long, ticket_source_code
ticket_source, ticket_priority_code, ticket_priority, ticket_urgency_code, ticket_urgency, ticket_impact_code, ticket_impact, ccti_id, ccti_class, ccti_category, ccti_type, ccti_item, total_worklog_time_spent, resolution, ticket_solution_id, solution_used_from_item_id, solution_used_from_item_case, severity, this_ticket_is, related_to_global_issue_id, custom_attributes.


Output

updateProblem

Id: 67
Updates an existing problem ticket identified by the row id with the provided details.


Input Parameters
prbBean - Problem Bean containing details which must be used to update the ticket 
row_id,Workflow action Id, ticket_identifier, parent_row_id, parent_ticket_identifier, case_id, ticket_phase, ticket_status, ticket_reason_code, assigned_to_individual_name, assigned_contact_id, assigned_to_group_name, assigned_group_id, created_by_name, modified_by_name, created_date, modified_date, last_closed_date, last_closed_by_name, person1_contact_id, person1_alt_email, requester_name, person1_alt_phone, person1_lvl1_org_name, person1_lvl2_org_name,  person1_lvl3_org_name, person1_org_id, person1_address_id, vip_flag_person1, person2_contact_id

person2_alt_email, requested_for_name, person2_alt_phone, person2_lvl1_org_name, person2_lvl2_org_name
person2_lvl3_org_name, person2_org_id, person2_address_id, vip_flag_person2, affected_ci_name. affected_ci_identifier, affected_ci_id, ticket_description, description_long, ticket_source_code
ticket_source, ticket_priority_code, ticket_priority, ticket_urgency_code, ticket_urgency, ticket_impact_code, ticket_impact, ccti_id, ccti_class, ccti_category, ccti_type, ccti_item, total_worklog_time_spent, resolution, ticket_solution_id, solution_used_from_item_id, solution_used_from_item_case, severity, this_ticket_is, related_to_global_issue_id, custom_attributes 


Output
item_id, ticket_identifier 

listWorklogs

Id: 68
Returns the list of all the worklogs pertaining to the specified problem ticket 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: 69
Adds a new problem ticket specific worklog entry into the database and relates it to the respective ticket.


Input Parameters
workglogBean - Worklog Bean containing details which must be used to add the worklog. 
row_id, ticket_identifier, item_id, ticket_type, work_type, work_type_code, work_view_type
work_time_spent, work_description


Output
workglogBean - Worklog Bean containing details which must be used to add the worklog.
row_id, ticket_identifier, item_id, ticket_type, work_type, work_type_code, work_view_type
work_time_spent, work_description
work_created_date, work_created_by, work_modified_date, work_modified_by, work_created_by_contact_id, Work_modified_by_contact_id

updateWorklog

Id: 70
Updates an existing problem ticket specific worklog details.


Input Parameters
workglogBean - Workglog Bean containing details which must be used to update the worklog. 
row_id, ticket_identifier, item_id, ticket_type, work_type, work_type_code, work_view_type
work_time_spent, work_description


Output
workglogBean - Worklog Bean containing details which must be used to add the worklog.
row_id, ticket_identifier, item_id, ticket_type, work_type, work_type_code, work_view_type
work_time_spent, work_description
work_created_date, work_created_by, work_modified_date, work_modified_by, work_created_by_contact_id, Work_modified_by_contact_id

listCommunications

Id: 71
Returns the list of all the communications pertaining to the specified problem ticket matching the specified search criteria.


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


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

sendCommunication

Id: 72
Sends a new ticket-specific communication and relates it to the respective problem 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: 73
Returns the list of all the related attachment document(s) matching the specified search criteria  pertaining to the specified problem ticket.


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: 74
Relates specified attachment document to the specified problem ticket.


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


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

unrelateAttachment

Id: 75
Unrelates specified attachment document associated with the specified problem ticket.


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: 76
Returns the list of all the configuration items related to the specified problem 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: 77
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 problem ticket.


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 the change request.


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

unrelateConfigurationItem

Id: 78
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 problem ticket.


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 problem.


Output
None

listRelatedTickets

Id: 79
Returns the list of all the support requests (tickets) including task tickets related to the specified problem ticket 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: 80
Relates the selected support request (ticket) to a problem ticket.


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


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

unrelateTicket

Id: 81
Unrelates the specified support request (ticket) associated with a specified problem ticket.


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


Output
None

listActivities

Id: 82
Returns the list of all historical activity including communications pertaining to the specified problem ticket 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: 83
Returns the list of all service level agreement (SLA) compliance being monitored, measured and acted upon for alters or escalations pertaining to the specified problem ticket matching the specified search criteria.


Input Parameters
ticketIdentifier - Ticket Identifier for which service level agreement (SLA) compliances 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, Measured, Threshold
Compliance Status, Affected Service, Assigned Group, Compliance Notes,  Violation Threshold, Due By , Start Time, Measured,

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