Power of Automation :: Track the progress of the Tasklists and update at the Milestone & Project levels.

Power of Automation :: Track the progress of the Tasklists and update at the Milestone & Project levels.

Hello Everyone,


A custom function is a software code that can be used to automate a process and this allows you to automate a notification, call a webhook, or perform logic immediately after a workflow rule is triggered. This feature helps to automate complex tasks and calculations.


Lets take the below requirement from a customer - 


A customer would like to monitor the progress of current week & last week tasklists and update in the custom fields at Milestone and projects levels.

Lets say, there are 4 Tasklists under a Milestone, the current week progress of these four Tasklists should be updated in the custom field of associated Milestone. Likewise, the progress of the previous week should be populated in another custom field.


Similarly, it should be rolled up and displayed in a custom field at Project level.


A custom function can be used to fulfil this need. However, this has to be implemented for each project i.e. ID of the project should be passed directly in the arguments. I have attached the screenshots of Arguments & schedule.


Establishing a connection with the scopes "zohoprojects.milestones.ALL , zohoprojects.projects.ALL" is all that is required. Below link will let you know how to establish a connection.


https://help.zoho.com/portal/en/kb/projects/integration/connections/articles/connections-23-5-2022#How_to_establish_a_Connection


endPoint = "https://projects.zoho.com/restapi/portal/";

endPointV3 = "https://projects.zoho.com/api/v3/portal/";

// project cf id

projectCurrentWeekCustomFieldName = "xxxxxx"; // project current week cf name

milestoneCompletionPercent = 0;

divideBy100 = 0;

isTrue = false;

projectCurrentWeekValue = 0;

getAllMilestones = invokeurl

[

url :endPoint + portalId + "/projects/" + projectId + "/milestones/"

type :GET

connection:”******”

];

for each  milestone in getAllMilestones.get("milestones")

{

milestoneId = milestone.get("id_string");

getMilestoneDetails = invokeurl

[

url :endPointV3 + portalId + "/projects/" + projectId + "/milestones/" + milestoneId

type :GET

connection:”******”

];

CurrentWeekFieldId = "xxxxxxx";

// milestone cf id

LastWeekFieldId = "xxxxxx";

// milestone cf id

milestoneParameter = Map();

if(getMilestoneDetails.get("custom_fields").get(CurrentWeekFieldId).get("value").equalsIgnoreCase("-"))

{

milestoneParameter.put(CurrentWeekFieldId,getMilestoneDetails.get("completion_percent").toString());

isTrue = true;

}

else

{

milestoneParameter.put(LastWeekFieldId,getMilestoneDetails.get("custom_fields").get(CurrentWeekFieldId).get("value").toString());

milestoneParameter.put(CurrentWeekFieldId,getMilestoneDetails.get("completion_percent").toString());

}

milestoneCompletionPercent=milestoneCompletionPercent+getMilestoneDetails.get("completion_percent");

divideBy100 = divideBy100 + 100;

updateMilestoneDetails = invokeurl

[

url :endPointV3 + portalId + "/projects/" + projectId + "/milestones/" + milestoneId

type :POST

parameters:toString(milestoneParameter)

connection:"*********"

];

}

projectMilestoneCompletionPercentage = (milestoneCompletionPercent / divideBy100) * 100;

// Update Project

projectCurrentWeekFieldId = "xxxxxx";

// project cf id

projectLastWeekFieldId = "xxxxxxx";

projectsParameter = Map();

if(isTrue)

{

projectsParameter.put(projectCurrentWeekFieldId,toString(projectMilestoneCompletionPercentage));

}

else

{

getProjectResponse = invokeurl

[

url :endPoint + portalId + "/projects/" + projectId + "/"

type :GET

connection:"*********"

];

customFields = getProjectResponse.get("projects").get(0).get("custom_fields");

for each customField in customFields{

if(customField.containKey(projectCurrentWeekCustomFieldName)){

projectCurrentWeekValue = customField.get(projectCurrentWeekCustomFieldName);

}

}

projectsParameter.put(projectLastWeekFieldId,projectCurrentWeekValue);

projectsParameter.put(projectCurrentWeekFieldId,toString(projectMilestoneCompletionPercentage));

}

updateProjectResponse = invokeurl

[

url :endPoint + portalId + "/projects/" + projectId + "/"

type :POST

parameters:projectsParameter

connection:"***********"

];


Creating custom functions in Zoho Projects is straightforward and well-documented. Watch this space for more such custom function codes. 




      • Sticky Posts

      • Time Log Reminder

        Tracking the time spent on tasks and issues is one of the most important functions of a timesheet. However, users may forget to update the time logs because they have their own goals to achieve. But, time logs must be updated at regular intervals to keep

      • Introducing the Zoho Projects Learning Space

        Every product has its learning curve, and sometimes having a guided path makes the learning experience smoother. With that goal, we introduce a dedicated learning space for Zoho Projects, a platform where you can explore lessons, learn at your own pace,

      • Update on V2 API End-of-Life Timeline

        Dear Users, Earlier this year, we shared the launch of the V3 APIs and requested users to migrate from the older V2 APIs by December 2025. We have received valuable feedback from our users and partners regarding their migration timelines. We are happy

      • Automation Series: Auto-update Phase Status

        Hello Folks! You can auto-update your phase's status based on status of underlying tasks using custom functions. In this series, we will showcase how to create and run custom functions, using Deluge, with ease. Follow the steps below and automate your

      • Automate Timesheet Approvals with Multi-level Approval Rules

        Introducing Approval Rules for Timesheets in Zoho Projects. With this automation, teams can manage how timesheets are reviewed and approved by setting up rules with criteria and assigning approvers to handle submissions. Timesheet, when associated to