Configuring a Scheduler

Configuring a Scheduler

Feature Availability

Configuring a Scheduler 

A scheduler is triggered at the specified time to complete the defined action. The action to be performed is written as a custom function using Deluge scripts in the scheduler handler. The following attributes are passed to the custom function when the scheduler is triggered: Name 
 
Name
Data Type
Description 
Network 
Map
The details of your network
User
Map
Details of the configuration owner. 
 
Let's consider a scheduler that collects the list of tasks you are assigned to for the day, from Zoho Connect and shares through a bot in Cliq. This scheduler is executed daily (Monday to Friday) at 10 AM to track the task list for the day. First, create the scheduler by giving the name, description followed by the recurring period and the time of execution. 
 
The sample code for this example case is as follows:  
  1. returnMap = Map();

    scopeId = network.get("id");//Network id on which the scheduler getting executed

    //zohoconnectoauth authtentication to fetch data from Zoho Connect

    response = invokeurl

    [

     url :"https://connect.zoho.com/pulse/api/tasks"

     type :GET

     parameters:{"dates":"today","scopeID":scopeId}

     connection:"zohoconnectoauth"

    ];

    info response;

    if(response.containKey("result") && response.get("result") == "failure")

    {

     returnMap.put("status","failure");

    }

    else

    {

     tasks = response.get("tasks").get("tasks");

     formatedDate = response.get("tasks").get("todayFormattedDate");

     rows = list();

     for each task in tasks

        {

      row = map();

      row.put("Title", task.get("title"));

      row.put("Section", "["+task.get("section").get("name")+"] ("+task.get("section").get("url")+")");

      row.put("Board", task.get("partition").get("name"));

      row.put("Status", task.get("taskStatus").get("name"));

      row.put("Priority", task.get("taskPriority").get("name"));

      rows.add(row);

        }

    //Use a message format that is compatible with Cliq

     content = "Task to be completed by "+formatedDate+".";

     message = {"text":content,"card":{"title":"Today's task", "thumbnail":"https://play-lh.googleusercontent.com/_g", "theme":"modern-inline"},"slides":[{"type":"table", "title":"Tasks", "data":{"headers":["Title","Section","Board","Status", "Priority"],"rows":rows}}]};

    info message;

    //post message on the Cliq bot using `zohocliqoauth` `

     

Trail Run

Once the scheduler is created, click the Save & Execute option found in the top-right corner of the code editor to know if the scheduler is working as intended. 
 
In certain cases, the execution of the scheduler may be marked as a 'success' even if the scheduled action is not complete. In the example case given above, the invoking of Zoho Cliq API from the function may have failed because of invalid authentication or a bad request, and the message will not be posted in the bot. However, in the logs, the result is given as 'success'. Therefore, to avoid such discrepancies, the return value of the custom function should be based on the status of the action performed.  

  1. cliqResponse=zoho.cliq.postToBot ("A new task",message, "zohocliqoauth");

    if(cliqResponse == null || cliqResponse.containKey("status") == false || cliqResponse.get("status") != "success")

    {

    returnMap.put("status","failure");

    }


In the above sample code, the scheduler execution is logged as 'success' only when the message is shared in Cliq. 

Execution Failure

If there is a failure in the scheduler execution, the configuration owner will be notified about the failure. They can access the logs and manually run the scheduler if the failure is due to errors in script, connection, or authentication until they resolve the issue. However, if there are 100 continuous failed attempts, the configuration will be automatically disabled. 
 
If you have any questions regarding schedulers, please reach out to us at support@zohoconnect.com.

    Access your files securely from anywhere

      Zoho CRM Training Programs

      Learn how to use the best tools for sales force automation and better customer engagement from Zoho's implementation specialists.

      Zoho CRM Training
        Redefine the way you work
        with Zoho Workplace

          Zoho DataPrep Personalized Demo

          If you'd like a personalized walk-through of our data preparation tool, please request a demo and we'll be happy to show you how to get the best out of Zoho DataPrep.

          Zoho CRM Training

            Create, share, and deliver

            beautiful slides from anywhere.

            Get Started Now


              Zoho Sign now offers specialized one-on-one training for both administrators and developers.

              BOOK A SESSION









                                            You are currently viewing the help pages of Qntrl’s earlier version. Click here to view our latest version—Qntrl 3.0's help articles.




                                                Manage your brands on social media

                                                  Zoho Desk Resources

                                                  • Desk Community Learning Series


                                                  • Digest


                                                  • Functions


                                                  • Meetups


                                                  • Kbase


                                                  • Resources


                                                  • Glossary


                                                  • Desk Marketplace


                                                  • MVP Corner


                                                  • Word of the Day


                                                    Zoho Marketing Automation

                                                      Zoho Sheet Resources

                                                       

                                                          Zoho Forms Resources


                                                            Secure your business
                                                            communication with Zoho Mail


                                                            Mail on the move with
                                                            Zoho Mail mobile application

                                                              Stay on top of your schedule
                                                              at all times


                                                              Carry your calendar with you
                                                              Anytime, anywhere




                                                                    Zoho Sign Resources

                                                                      Sign, Paperless!

                                                                      Sign and send business documents on the go!

                                                                      Get Started Now




                                                                              Zoho TeamInbox Resources



                                                                                      Zoho DataPrep Resources



                                                                                        Zoho DataPrep Demo

                                                                                        Get a personalized demo or POC

                                                                                        REGISTER NOW


                                                                                          Design. Discuss. Deliver.

                                                                                          Create visually engaging stories with Zoho Show.

                                                                                          Get Started Now









                                                                                                              • Related Articles

                                                                                                              • Configuring a section action to move tasks to another board in Zoho Connect

                                                                                                                Overview of Section Actions Automate recurring steps for the tasks within the section of your board by configuring section actions. Users can apply a set of actions, like assigning tasks to specific members, setting the due date or priority level to ...
                                                                                                              • Configuring Email and Push Notifications

                                                                                                                Overview Notifications lets you stay informed on any new activity in your network. Zoho Connect sends notifications through email, or if you are a user of Zoho Connect's mobile app, you'll receive push notifications. To weigh down the number of ...
                                                                                                              • Configuring Workflows in Zoho Connect

                                                                                                                Feature Availability Overview Workflows allow you to create a set of rules for Zoho Connect modules based on which defined actions would be performed. These rules automate the process of assigning tasks, creating events, and adding users to a Group ...
                                                                                                              • Configuring the web tab to open in a new browser tab

                                                                                                                The URLs of websites that don't support loading or embedding their content within another app can still be added as a web tab and configured to be opened in a new browser tab. To do this: Login to your Zoho Connect network. Click the ellipsis (...) ...
                                                                                                              • Basics of Schedulers

                                                                                                                Feature Availability Overview Using schedulers in Zoho Connect you can automate your routine tasks without any user input. The schedulers can be set to repeat at certain intervals, such as everyday, weekly or every month. Here are a few ways to use ...
                                                                                                                Wherever you are is as good as
                                                                                                                your workplace

                                                                                                                  Resources

                                                                                                                  Videos

                                                                                                                  Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.



                                                                                                                  eBooks

                                                                                                                  Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.



                                                                                                                  Webinars

                                                                                                                  Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.



                                                                                                                  CRM Tips

                                                                                                                  Make the most of Zoho CRM with these useful tips.



                                                                                                                    Zoho Show Resources