Function: Adds task, insert in the audit log and sends an email alert.
Web service call: https://proworkflow2.net/pwfaccountname/api/v2/tasks.cfm?customerkey=84DC6CF8-BF78-D79D-B25B-0C0D20229F17&api_call=addtask&UserID=xxx
Method: POST
XML Request Data:
  1.  
  2. <?xml version="1.0" encoding="UTF-8"?>
  3. <addtask>
  4. <taskassignedto>5</taskassignedto> REQUIRED FIELD
  5. <tasktimeallocated>120</tasktimeallocated>
  6. <taskdatestart>02-Jan-2009</taskdatestart>
  7. <taskdatedue>02-Feb-2009</taskdatedue>
  8. <tasktype>normal</tasktype>
  9. <tasktitle>Website Update</tasktitle> REQUIRED FIELD
  10. <taskbillable>yes</taskbillable> (1 for Yes, 0 for No)
  11. <taskorder>1.2</taskorder>
  12. <taskjobid>957</taskjobid> (Not required for General Task)
  13. <taskcatid>2</taskcatid>
  14. <taskdescription>Sample description</taskdescription>
  15. <taskpriority>3</taskpriority>
  16. <taskactive>yes</taskactive>
  17. <taskdependent>no</taskdependent>
  18. </addtask>
  19.  
URL Parameters: UserID is mandatory.
Notes: Required fields must be included, other fields can be omitted.
Return Data: XML data packet is constructed by the web service and sent to the user. It contains the success or failure message.
Status messages: Success, Failure or Error.

 

Example of return data:
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <addtask>
  3. <status>Success</status>
  4. <details>
  5. <message>Task added</message>
  6. <taskid>1796</taskid>
  7. </details>
  8. </addtask>
  9.  
  10. OR
  11.  
  12. <?xml version="1.0" encoding="UTF-8"?>
  13. <addtask>
  14. <status>Failure</status>
  15. <details>
  16. <message>Error: Please define type of task.</message>
  17. </details>
  18. </addtask>
  19.  
  20. OR
  21.  
  22. <?xml version="1.0" encoding="UTF-8"?>
  23. <addtask>
  24. <status>Failure</status>
  25. <details>
  26. <message>Error: You don't have permission to perform this action.</message>
  27. </details>
  28. </addtask>
VN:F [1.7.5_995]
Was this article useful?