Notes Related Operations

The notes related operations on specific request such as adding new notes, updating, deleting and viewing the existing notes are discussed under this section.

To perform the notes related operations on an existing request, the following URL patterns should be used.

For adding notes to a request:

http://<servername>:<port number>/sdpapi/request/<request id>/notes

For operations on a specific note for a request:

http://<servername>:<port number>/sdpapi/request/<request id>/notes/<notes id>

Contents

Adding Note
Editing Note
Viewing Note
Viewing all the Notes
Deleting Note

Adding Note

Say, you are running ServiceDesk Plus - MSP with the server name as "localhost" in the port "8080". You are adding a note for an existing request for which the input and output XML format is given below,

For adding a note to an existing request, the URL is given as:

http://<servername>:<port number>/sdpapi/request/<request id>/notes

So for the above scenario, the URL is: http://localhost:8080/sdpapi/request/24/notes/

Key Points:

The operation name "ADD_NOTE" should be sent as a "POST attribute" with key "OPERATION_NAME"
The technician key should be sent as a "POST attribute" with key "TECHNICIAN_KEY"
Input is an XML string sent as "POST attribute" with key "INPUT_DATA".

Note: Please note that the Input and Output XML formats have been changed. But for compatibility reasons, the Input operation will support both the formats.

Input - Format 1:

<Notes>

<Note>

<name>isPublic</name>

<value>false</value>

</parameter>

<name>notesText</name>

<value>Text added to the note</value>

</parameter>

</Note>

</Notes>

</Details>

</Operation>

Input - Format 2:

<Notes>

<Note>

<isPublic>false</isPublic>

<notesText>Text added to the note</notesText>

</Note>

</Notes>

</Details>

</Operation>

Output:

<?xml version="1.0" encoding="UTF-8"?>

<status>Success</status>

<message>Note added successfully for request 24</message>

</result>

</operation>

Editing Note

To edit a note of an existing request, the URL is given as:

http://<servername>:<port number>/sdpapi/request/<request id>/notes/<note id>

Assume the Note ID to edit the note is 301, then the URL is: http://localhost:8080/sdpapi/request/24/notes/301

Key Points:

The operation name "EDIT_NOTE" should be sent as a "POST attribute" with key "OPERATION_NAME"
The technician key should be sent as a "POST attribute" with key "TECHNICIAN_KEY"
Input is an XML string sent as "POST attribute" with key "INPUT_DATA".

Note: Please note that the Input and Output XML formats have been changed. But for compatibility reasons, the Input operation will support both the formats.

Input - Format 1:

<Notes>

<Note>

<name>notesText</name>

<value>edited the subject</value>

</parameter>

</Note>

</Notes>

</Details>

</Operation>

Input - Format 2:

<Notes>

<Note>

<notesText>edited sub</notesText>

</Note>

</Notes>

</Details>

</Operation>

Output:

<?xml version="1.0" encoding="UTF-8"?>

<status>Success</status>

<message>Note 301 successfully edited for request 24</message>

</result>

</operation>

Viewing Note

To view one of the notes of an existing request, the URL is given as:

http://<servername>:<port number>/sdpapi/request/<request id>/notes/<note id>

Assume the Note ID to view the note is 301, then the URL is: http://localhost:8080/sdpapi/request/24/notes/301

Key Points:

The operation name "GET_NOTE" should be sent as a "POST attribute" with key "OPERATION_NAME"
The technician key should be sent as a "POST attribute" with key "TECHNICIAN_KEY"
Input is not required in this case.

Note: Please note that the Input and Output XML formats have been changed. But for compatibility reasons, the Input operation will support both the formats.

Output:

<?xml version="1.0" encoding="UTF-8"?>

<status>Success</status>

<message>Note details fetched successfully</message>

</result>

<Notes>

<Note>

<name>userid</name>

</parameter>

<name>ispublic</name>

<value>false</value>

</parameter>

<name>notesText</name>

<value>Text added to the note</value>

</parameter>

<name>username</name>

<value>Shawn Adams</value>

</parameter>

<name>notesid</name>

</parameter>

<name>notesdate</name>

</parameter>

<name>workorderid</name>

</parameter>

</Note>

</Notes>

</Details>

</Operation>

Viewing all the Notes

To view all the notes of a request, the URL is given as:

http://<servername>:<port number>/sdpapi/request/<request id>/notes/

Assume the Request ID to view all the notes is 24, then the URL is: http://localhost:8080/sdpapi/request/24/notes

Key Points:

The operation name "GET_NOTES" should be sent as a "POST attribute" with key "OPERATION_NAME"
The technician key should be sent as a "POST attribute" with key "TECHNICIAN_KEY"
Input is not required in this case.

Note: Please note that the Input and Output XML formats have been changed. But for compatibility reasons, the Input operation will support both the formats.

Output:

<?xml version="1.0" encoding="UTF-8"?>

<status>Success</status>

<message>Notes details fetched successfully</message>

</result>

<Notes>

<name>ispublic</name>

<value>false</value>

</parameter>

<name>notesText</name>

<value>Note added to the request</value>

</parameter>

<name>username</name>

<value>Shawn Adams</value>

</parameter>

<name>notesdate</name>

</parameter>

</Note>

<name>ispublic</name>

<value>false</value>

</parameter>

<name>notesText</name>

<value>Text added to the note</value>

</parameter>

<name>username</name>

<value>Shawn Adams</value>

</parameter>

<name>notesdate</name>

</parameter>

</Note>

</Notes>

</Details>

</operation>

Deleting Note

To delete a note of an existing request, the URL is given as:

http://<servername>:<port number>/sdpapi/request/<request id>/notes/<note id>

Assume the Note ID to delete the note is 301, then the URL is: http://localhost:8080/sdpapi/request/24/notes/301

Key Points:

The operation name "DELETE_NOTE" should be sent as a "POST attribute" with key "OPERATION_NAME"
The technician key should be sent as a "POST attribute" with key "TECHNICIAN_KEY"
Input is not required in this case.

Note: Please note that the Input and Output XML formats have been changed. But for compatibility reasons, the Input operation will support both the formats.

Output:

<?xml version="1.0" encoding="UTF-8"?>

<status>Success</status>

<message>Note deleted successfully</message>

</result>

</operation>