Using Cliq forms to add a task in Projects

Using Cliq forms to add a task in Projects

Forms in Cliq are platform components that can take in multiple user inputs in a single go, standardize the way work gets kicked off in an organization and helps you automate your everyday workflow. 
Let's understand forms better by considering the following scenario.

Scenario 
Assume, your team is now working on a new project and your lead decides to assign the tasks to the concerned person in Zoho Projects. As a first step, let's connect Zoho Projects with Cliq and add tasks right from the Cliq window using forms. To do this,
 
1. Connect Cliq with Zoho Projects by giving your connection a name followed by specifying the scopes. 
2.  The scopes required to add a task in Zoho Projects are,
  •  ZohoProjects.portals.READ
  •  ZohoProjects.projects.READ
  •  ZohoProjects.users.READ
  • ZohoProjects.tasks.CREATE
3. The required method is POST and the URL to connect Zoho Projects with Cliq is 
https://projectsapi.zoho.com/restapi/portal/[PORTALID]/projects/[PROJECTID]/tasks/

4. Once after you initiate the connection use the deluge code generated, in your script.

5. To know more about the scopes available in Zoho Projects head on over here.
 
The bots menu handler and form submit handler code to add a task in Zoho Projects is attached here. Try copying the code in your deluge editor and execute it.

Bot menu handler code
  1. response = Map();
  2. inputs = list();
  3. inputs.add({"type":"text","name":"taskname","label":"Task Name","placeholder":"Specify the task name","mandatory":true,"value":"Enter the task name here"});
  4. inputs.add({"type":"textarea","name":"desc","label":"Add Description","placeholder":"A small description of the task","mandatory":false,"value":"A small description about the task"});
  5. inputs.add({"type":"date","name":"startdateinfo","label":"Start Date","placeholder":"01-01-2020","mandatory":false});
  6. inputs.add({"type":"date","name":"duedateinfo","label":"Due Date","placeholder":"01-01-2020","mandatory":false});
  7. inputs.add({"type":"select","name":"prior","label":"Priority","placeholder":"None","mandatory":false,"value":"None","options":[{"label":"None","value":"none"},{"label":"High","value":"high"},{"label":"Medium","value":"medium"},{"label":"Low","value":"low"}]});
  8. por = invokeurl
  9. [
  10. url :"https://projectsapi.zoho.com/restapi/portals/"
  11. type :GET
  12. connection:"Your connection name"
  13. ];
  14. portals = por.get("portals");
  15. user_listing=Collection();
  16. for each portal in portals
  17. {
  18. id = portal.get("id_string");
  19. pro = invokeurl
  20. [
  21. url :"https://projectsapi.zoho.com/restapi/portal/" + id + "/projects/"
  22. type :GET
  23. connection:"Your connection name"
  24. ];
  25. projects = pro.get("projects");
  26. for each project in projects
  27. {
  28. pid = project.get("id_string");
  29. users = invokeurl
  30. [
  31. url :"https://projectsapi.zoho.com/restapi/portal/"+id+"/projects/"+pid+"/users/"
  32. type : GET
  33. connection:"Your connection name"
  34. ];
  35. for each user in users.get("users")
  36. {
  37. user_id=user.get("id");
  38. user_name=user.get("name");
  39. user_listing.insert({"label":user_name,"value":user_id});
  40. }
  41. }
  42. }
  43. inputs.add({"type":"select","max_selections":"2","multiple":true,"name":"assignee","label":"Owner","placeholder":"Add a user","mandatory":true,"value":"Olivia","options":user_listing});
  44. form = {"type":"form","title":"New Task","hint":"Add a new task in Projects","name":"addtasks","version":1,"button_label":"Add","action":{"type":"invoke.function","name":"tasks"},"inputs":inputs};
  45. return form;
 Form submit handler code
  1. response = Map();
  2. param = Map();
  3. formValues = form.get("values");
  4. priority = formValues.get("priority");
  5. param.put("name",formValues.get("taskname"));
  6. param.put("description",formValues.get("desc"));
  7. param.put("start_date",formValues.get("startdateinfo").toString("MM-dd-yyyy"));
  8. param.put("end_date",formValues.get("duedateinfo").toString("MM-dd-yyyy"));
  9. param.put("priority",formValues.get("prior").get("label"));
  10. param.put("person_responsible",(formValues.get("assignee").get("0").get("value")).toString());
  11. por = invokeurl
  12. [
  13. url :"https://projectsapi.zoho.com/restapi/portals/"
  14. type :GET
  15. connection:"Your connection name"
  16. ];
  17. portals = por.get("portals");
  18. for each portal in portals
  19. {
  20. id = portal.get("id_string");
  21. pro = invokeurl
  22. [
  23. url :"https://projectsapi.zoho.com/restapi/portal/" + id + "/projects/"
  24. type :GET
  25. connection:"Your connection name"
  26. ];
  27. user_listing_map = Map();
  28. projects = pro.get("projects");
  29. for each project in projects
  30. {
  31. pid = project.get("id_string");
  32. tasks = invokeurl
  33. [
  34. url :"https://projectsapi.zoho.com/restapi/portal/" + id + "/projects/" + pid + "/tasks/"
  35. type :POST
  36. parameters:param
  37. connection:"Your connection name"
  38. ];
  39. }
  40. }
  41. return {"text":"Hurray! Successfully added a task in Projects :happy:"};




With a multitude of possibilities available with forms, Zoho Cliq let's you build dynamic forms using a form builder. A form builder in Cliq is a form building platform for non coders to build interactive forms easily.
Here's a small video on building a form using the form builder.



There you go! A small example to understand how forms can come in handy to get your works done on the go. In case of any doubts or queries, do comment below. We'd be happy to assist you.

Regards,
Divya P
Zoho Cliq