Custom Function for Milestone Auto-Complete

Custom Function for Milestone Auto-Complete

A custom function is a of software code that can help automate a process. Users can write their own Custom Functions using deluge and call them from a workflow. Let us take a look at how custom functions can help organizations manage their workflow.

Custom Functions can be used by organizations that want to automatically mark their milestones as complete once all of the tasks within the milestone have been completed. First we need to establish a connection, define a workflow rule and then associate a custom function to that workflow rule.

Create a new connection
  1. Navigate to the Setup icon and select Marketplace.
  2. Click Connections under Marketplace and then Create Connection.
  3. Click Default Services under Pick your service.
  4. Select Zoho Projects.
  5. Enter ZP MS Autocomplete as the Connection name and select the scopes ZohoProjects.milestones.UPDATE, ZohoProjects.bugs.READ, ZohoProjects.tasks.READ, and Zoho Projects.milestones.ALL

  6. Click the Create and Connect button.

  7. You will be prompted to connect to the newly established connection
  8. Click the Proceed button.

  9. The connection will be created once the accept button is clicked.

Note : Remember that 'Use Credentials of Login User' has to be switched off.

Workflow rule for automatically completing a milestone
  1. Click in the top navigation bar.
  2. Navigate to Task Automation and click Workflow Rules.
  3. Click New Workflow Rule.
  4. Enter the workflow name, description, and select the required layout.
  5. Under Execute on, choose 'Update' then Choose 'Field Specific and Select 'Status' from drop down menu.
  6. Click Next.

Create and associate the custom function to the workflow

Next, we will create a custom function and associate it with the workflow rule.
  1. Click on Add Action and then select Associate Custom Function.
  2. Click Create Custom Function in the Associate Custom Function page.

  3. In the Create Custom Function page type in the function name as Milestone Auto Complete.
  4. Add Arguments for project id, portal id, and milestone id as shown in the image below.

  5. Use this as the Sample Code and click Save.
  6. Associate the created Custom Function.

  7. Click Save Rule.


Sample Code: 
  1. // Construct parameter to filter the open tasks
    taskParam = Map();
    taskParam.put("status","notcompleted");
    taskParam.put("milestone_id",milestoneId);
    // Invoke get tasks API
    //Add your connection name as last parameter
    taskResponse = zoho.projects.getRecords(portalId,projectId,"tasks",taskParam,1,"zpmsautocomplete");
    info taskResponse;
    // Variable declaration and assign value , Endpoint of the API
    // This Varibale used to decide the milestone completion
    isMilestoneUpdate = false;
    // If task response is empty it will check any open bugs are available
    if(taskResponse.isEmpty())
    {
    // construct parameter for filter only open bugs
    milestoneList = list();
    milestoneList.add(milestoneId);
    bugParam = Map();
    bugParam.put("statustype","open");
    bugParam.put("milestone",milestoneList);
    info "bugParam:" + bugParam;
    //Add your connection name as last parameter
    bugResponse = zoho.projects.getRecords(portalId,projectId,"bugs",bugParam,1,"zpmsautocomplete");
    info bugResponse;
    if(bugResponse.isEmpty())
    {
    isMilestoneUpdate = true;
    }
    }
    info "TaskResponse Is Empty :" + taskResponse.isEmpty() + ", isMilestoneUpdate:" + isMilestoneUpdate;
    info "---------------------";
    if(!milestoneId.isNull() && isMilestoneUpdate)
    {
    //Modify the status of the milestone.(1 - notcompleted, 2 - completed)
    milestoneParam = Map();
    milestoneParam.put("status",2);
    info milestoneParam;
    info "---------------------";
    // Enter The Connection option Example : connection:"your_conection_name"
    updateMilestoneResponse = invokeurl
    [
    url :projectsAPIEndPoint + "/portal/" + portalId + "/projects/" + projectId + "/milestones/" + milestoneId + "/status/"
    type :POST
    parameters:milestoneParam
    connection:"zpmsautocomplete"
    ];
    info updateMilestoneResponse;
    info "-------------------------------------";

    }
We hope you found this post to be helpful.
If you have any questions, please leave them in the comments section below or email us at support@zohoprojects.com.




            • Sticky Posts

            • Zoho Projects: Quarterly Updates | Q1 2022

              We would like to share the quarterly updates for the period January to March. User Hierarchy: Users can enable Hierarchy settings to maintain a tree structure based on user roles. You can assign reporting managers and approve Timesheets based on the reporting
            • Custom Function for Milestone Auto-Complete

              A custom function is a of software code that can help automate a process. Users can write their own Custom Functions using deluge and call them from a workflow. Let us take a look at how custom functions can help organizations manage their workflow. Custom
            • Auto-update the Successor Task Status.

              Hello folks! We have come up with a new use case for custom function to help you automate the workflow of your tasks. Users can write their own Custom Functions using deluge and call them from a workflow. Consider a scenario where the status of the successor
            • Time Log Threshold for Reminders

              In Zoho Projects, the admins can now set a threshold for Time Log reminders. The user will be notified if the entered log hours are less than specified duration. For instance, if the admin sets 9 hours as the threshold and if a user logs 8 hours, a reminder
            • Tip #33: Restricting time logs for past and future dates

              Here's a tip on how to restrict users from entering log hours for the past or future dates in the Timesheet. Once timesheets are approved the invoice is generated for the month. If an employee makes changes to the past dates, the changes will reflect in the reports of the subsequent month. Reconciling this data with the previous month's invoice can be confusing and time-consuming. To avoid errors, the users are denied permission to add or edit past hours in the Timesheet by choosing the Don't Allow

            Zoho Pagesense Resources

              Zoho SalesIQ Resources



                    Zoho TeamInbox Resources

                      Zoho DataPrep Resources



                        Zoho CRM Plus Resources

                          Zoho Books Resources


                            Zoho Subscriptions Resources

                              Zoho Desk Resources

                                Zoho Projects Resources


                                  Zoho Sprints Resources


                                    Qntrl Resources


                                      Zoho Creator Resources


                                        Zoho WorkDrive Resources




                                            Zoho Campaigns Resources

                                              Zoho CRM Resources

                                                      Design. Discuss. Deliver.

                                                      Create visually engaging stories with Zoho Show.

                                                      Get Started Now


                                                        Zoho Show Resources