Contact 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

Notes:

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

getContact

Id: 33
Returns an excerpt pertaining to the specified the contact.


Input Parameters
Contact Id


Output
Business Segment, Time Zone, Contractor Contact ID, Contractor, Created By Contact ID, Created By, Created On, Department, Deputy/Alternate Contact ID, Deputy/Delegate, Email, Employee ID, End Date, Disable Service Feedbacks, First Name, HR Generalist Contact ID, HR Generalist, Enable Login, Job Title, Last Name, Office/Cube, Managed Entity, managed_entity, managed_function, Manager Contact ID, Manager, Middle Name, Modified By Contact ID, Modified By, Modified On, Title, Notification Mechanism, org_id, Details, Out of Office, Pager Email Address, Pager Type, Phone Type 1, Phone Type 2, Phone Type 3, Phone Type 4, phone1, phone2, phone3, phone4, Pin #, Status, Row ID, Start Date, User ID,  License Type, System User ID, VIP, 

listContacts

Id: 34
Returns the list of all the active contacts matching the specified search criteria.


Input Parameters
Search Text


Output
Email, Full Name, Job Title, Phone Details, Phone Number, ID

addContact

Id: 215
Adds a new contact with the supplied contact profile information.


Input Parameters
Title, First Name, Middle Name, Last Name, Email, Job Title, Department, Location, Pin, Timezone ID, TimezoneName, ocale, Locale ID, Is a VIP, Phone Number (1) Type, Phone Number (1), Phone Number (2) Type, Phone Number (2), Phone Number (3) Type, Phone Number (3), Phone Number (4) Type, Phone Number (4)


Output
Row Id

updateContact

Id: 216
Updates an existing contact profile identified by the Contact Row ID.


Input Parameters
Contact Id, Title, First Name, Middle Name, Last Name, Email, Job Title, Department, Location, Pin, Timezone ID, TimezoneName, ocale, Locale ID, Is a VIP, Phone Number (1) Type, Phone Number (1), Phone Number (2) Type, Phone Number (2), hone Number (3) Type, Phone Number (3), Phone Number (4) Type, Phone Number (4)


Output
Row Id

setContactStatus

Id: 217
Sets/updates the status of the existing contact i.e. marks the contact as either Active or Inactive. 


Input Parameters
Contact Id, Contact Status


Output
None

addLocation

Id: 230
Adds a new active Organization (Organization-Site-Location) for the specified Contact.


Input Parameters
Contact Id, Relationship. Organization Id, Site Id, Location Id


Output
contact_org_rel_id

listLocation

Id: 231
Returns a list of all the active Organization (Organization-Site-Location) for the specified Contact.


Input Parameters
Contact Id


Output
Address, Building, Contact Location ID, Floor, Organization, Organization ID, Primary Organization,Relationship, Site,Status,Suite

updateLocation

Id: 232
Updates an existing Organization (Organization-Site-Location) for the specified Contact.


Input Parameters
Contact ID, Contact_org_rel_id, Relationship, Organization ID, Site ID, Location ID


Output
contact_org_rel_id

unrelateLocation

Id: 233
Unrelates an existing Organization (Organization-Site-Location) for the specified Contact.


Input Parameters
Contact Id, Relationship. Organization Id, Site Id, Location Id, Contact_org_rel_id.


Output
None

listOpenItems

Id: 234
Returns a list of all the open support requests (tickets) that are related to the  specified Contact.


Input Parameters
Contact Id


Output
Case ID, Description, Reason Code, Row ID, Status, Type, ticket_type

setPrimaryLocationStatus

Id: 235
Marks an existing Organization (Organization-Site-Location) as primary Organization for the specified Contact.


Input Parameters
Contact Id, Contact_org_rel_id


Output
None

resetPassword

Id: 236
Resets the User password for the specified Contact.


Input Parameters
Contact Id


Output
None

addSupportGroup

Id: 237
Relates/associates an existing Support Group identified by the Row ID to the specified Contact.


Input Parameters
Contact Id, Support Group Id


Output
None

addRole

Id: 238
Relates/associates an existing Role identified by the Row ID to the specified Contact.


Input Parameters
Contact Id, Role Id


Output
None

setPrimaryGroupStatus

Id: 239
Sets a group as primary group for the contact.


Input Parameters
Contact Id, Support Group Id


Output
None

removeSupportGroup

Id: 240
Unrelates or removes the relationship with an existing Support Group identified by the Row ID from the specified Contact.


Input Parameters
Contact Id, Support Group Id


Output
None

removeRole

Id: 241
Unrelates or removes the relationship with an existing Role identified by the Row ID from the specified Contact.


Input Parameters
Contact Id, Role Id


Output
None

listNotes

Id: 242
Returns a list of all the special notes pertaining to a Contact.


Input Parameters
Contact Id


Output
Created By, Created Date, Modified By, Modified Date, Note, Row ID, State

listAttachments

Id: 243
Returns a list of all the related attachment document(s) pertaining to the specified Contact.


Input Parameters
Contact Id


Output
Created By, Created Date, Description, Row ID, Type, attach_file_name, attach_is_global

getNote

Id: 244
Retrieves note specified by row_id associated with the contact.


Input Parameters
Contact Id, Note Id


Output
Contact Id, Created By, Created Date, Modified By, Modified Date, Note, Row ID, State

addNote

Id: 245
Adds a new special note for the specified contact.


Input Parameters
Contact Id, Relationship State, Note


Output
Note Id

updateNote

Id: 246
Updates an existing special note identified by the Row ID associated with the specified contact.


Input Parameters
Contact ID, Note ID, Relationship State, Note


Output
Note Id

deleteNote

Id: 247
Deletes an existing special note identified by the Row ID associated with the specified contact.


Input Parameters
Contact Id, Note Id


Output
None

unrelateAttachment

Id: 248
Unrelates/dissociates an existing attachment document from the specified contact.


Input Parameters
Contact Id, Attachment Id


Output
None

relateAttachment

Id: 249
Relates/associates an existing attachment document to the specified contact.


Input Parameters
Contact Id, Attachment Id


Output
rel_attach_id

listRelatedCI

Id: 250
Returns a list of all the configuration items associated with the specified contact.


Input Parameters
Contact Id


Output
CI Name, Function, Identifier,Status, Class, category. Attribute 1, Attribute 2, Attribute 3

listDependentData

Id: 251
Returns a list of all the dependent data associated with the contact.


Input Parameters
Contact Id


Output
Entry Name, Description, Action On Termination, Count

updateUserLoginDetails

Id: 252
Updates user_login details, license type and disable service feedbacks for the specified contact.


Input Parameters
Contact ID, Login Enabled, User Login, License Type


Output
Row Id

listRoles

Id: 253
Returns a list of all the roles that are related to the specified Contact.


Input Parameters
Contact Id


Output
Primary Group, Role, Row ID

listSupportGroups

Id: 254
Returns a list of all the support group that are related to the specified Contact.


Input Parameters
Contact Id


Output
Primary Group,Row ID, Support Group

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