Schedules are automated, user-defined actions that can be executed as custom functions or commands either at a specific time or on a recurring basis. These actions allow you to create customized scheduling scenarios that run periodically based on your needs.
Prerequisites
Schedules are associated to pre-defined actions such as custom functions and commands. Therefore, it is necessary that the relevant actions are configured and available before you proceed with creating the schedule.
Creating Schedules
To create a new schedules:
- Access the Developer Application.
- Click the Automate tab on the top.
- Click the Schedules option in the left pane. The schedules rules available (if any) are displayed in the right.
- Click the Add Schedule button in the top right corner. The New Schedule addition form is displayed.
- Provide the name for the schedule.
- Select the frequency at which the schedule must be run from the drop down list. You can choose either Once, Hourly, Daily, Weekly, Monthly or Yearly. For example, if you choose to set the frequency on a daily basis, then your schedule will run every day from the specified start and time.
7. Select the days at which the action will be executed using the Schedule action will execute every {0} day(s) option. By default, the day(s) is set as 1(one). If you want the schedule to run every two days, select 2(two).
8. Provide the start date and time for the schedule.
9. Use the Set Active Days option to configure the week days at which the schedule is to be run. Using this option, you can skip running the schedule on certain days of the week even though you have configured daily, weekly, etc. For example, if you want to run the daily schedule only on weekdays, you can select Mon through Fri.
10. Provide the date at which the execution should end.
11. Provide description.
12. Set whether the schedule is currently active or inactive using the Status toggle button.
13. Configure the action to be performed in the schedule.
14. Click Create.
Configuring Actions
Every schedule must be associated with an action. The two schedule actions that you can configure in Zoho IOT are: custom functions and commands.
To configure a custom function action:
- Select Custom Function from the Add Action drop down list. The available custom functions are displayed in a list view.
- Select the custom function you want to associate and click the Associate button on the top of the list view.
Refer to the Understanding Custom Functions document for more details.
The associated custom function is associated and displayed in the form.
3. Click Create.
To configure a command action:
- Select Execute Command from the Add Action drop down list.
- Select the command options in the Select Command section. The command should already be created using the commands feature.
Refer to the Adding Commands document for more details.
4. Click Next.
5. Provide the values in the
Set Value section.
6. Click Save & Associate.
Executing a Schedule
All the failed schedules can be viewed under the Failures tab.
- Access the Developer Application.
- Click the Automate tab on the top.
- Click the Schedules option in the left pane.
- Select the Failures tab to view the schedules that failed on execution.
Editing Schedules
You can edit the existing custom schedules whenever required.
To edit a schedule:
- Access the Developer Application.
- Click the Automate tab on the top.
- Click the Schedules option in the left pane. The schedules rules available (if any) are displayed in the right.
- Select Edit from the left of the schedule name.
- Modify the required values.
- Click Save.
Deleting Schedules
To delete a schedule:
- Access the Developer Application.
- Click the Automate tab on the top.
- Click the Schedules option in the left pane. The schedules rules available (if any) are displayed in the right.
- Select Delete from the left of the schedule name.
- Click Delete in the confirmation popup to delete the schedule permanently.
.
See Also