Scheduled Functions

AssetExplorer allows administrators to execute custom schedules using a built-in script execution tool called scheduled functions. The scheduled function scripts can be built from scratch using Deluge, Zoho's propriety scripting language.

Scheduled functions can be used to build your own automation operations such as sending notifications or updating asset status by analyzing the queries fetched from reports.

Role Required: SDAdmin

To create scheduled functions, go to Admin > Developer Space > Custom Functions > Scheduled Function.

You can create scheduled functions as Custom Actions or Global Functions.

Custom Actions 

Custom actions are actionable custom functions that allow users to manipulate data in AssetExplorer and other external applications. You can write a script to fetch data from query reports and execute an action based on the fetched data.

Create Custom Actions

Use the New button to create a custom action. Provide a name and description for your custom action.

Use the simple drag-and-drop action to select objects from the deluge script editor onto the canvas.

You must write the scheduled function with reportObj as the argument. After executing the scheduled function, the Map data type will be returned in the following format:

{
"message":"Executed successfully",

"status":"success/failure"
}

You can perform the specified action by returning the map from the scheduled function. The format used in scheduled functions is same as the python script and class. For more details, visit this page.

Within scheduled functions, you can call global functions that can store information essential to connect with external applications, common functionalities, and configurations.

Test Execution of Scripts 

1. Click Save and Test to test run the custom action.
2. Choose a sample report from the list of reports displayed.
3. The data that will be passed to the scheduled function will be displayed under the parameter reportObj.
4. Click Execute.
5. The script will be executed, and the output will be printed along with info statements that are used for debugging.

If you make any API calls by using invokeurl while testing the scheduled function, the API will be invoked. Ensure that you don't invoke an API that might result in unintended consequences.

Debugging Tip 

When you test a scheduled function, you can debug the code and print the output by using a statement called info. For example, to understand the structure of reportObj and context, you can simply run the following script and study the response.

info reportObj;

info context;

return true;

After a custom action is created, you can use it to create custom schedules. The custom schedule where the custom action is active is displayed in the custom action list view.

Custom Actions List View 

After creating custom actions, you can manage them from the list view as follows:

• Click the  icon to edit or delete a custom action. To delete custom actions in bulk, select the custom actions and go to Actions > Delete.
• Click the  icon to disable a custom action. Disabled custom actions are indicated using the  icon that you can click to enable a custom action. To enable/disable in bulk, select the custom actions and go to Actions > Mark as Active/Mark as Inactive.
• Use keywords to search custom actions from the search bar.
• Click the filter drop-down to display all custom actions or just the ones used in custom schedules.