Crons

Documentation: Scheduling Predefined Functions in DataPump with Cron

The DataPump tool provides the ability to schedule predefined functions using Cron jobs. These functions are designed to handle the import of core data into the Shopranos platform. However, since DataPump allows for the execution of JavaScript code within these functions, you can leverage them to schedule and execute any operation, regardless of the function name.

Predefined Functions:

The following predefined functions are available for scheduling in DataPump:

ProductsImport

Imports product data into the Shopranos platform.

CategoriesImport

Imports category data into the Shopranos platform.

BrandsImport

Imports brand data into the Shopranos platform.

AttributesImport

Imports product attributes into the Shopranos platform.

AttributeSetsImport

Imports attribute sets into the Shopranos platform.

ProductsSourceTagsImport

Imports product source tags into the Shopranos platform.

QuantityImport

Imports product quantities into the Shopranos platform.

UnitsImport

Imports product units into the Shopranos platform.

CustomersImport

Imports customer data into the Shopranos platform.

10.

CustomerSourceTagsImport

Imports customer source tags into the Shopranos platform.

11.

OrdersImport

Imports order data into the Shopranos platform.

Flexibility of Scheduled Functions:

While these functions are named according to their intended purposes, you can use them to schedule and execute any JavaScript code, allowing for a wide range of operations beyond their original scope. This is possible because the functions are executed as JavaScript code blocks within the DataPump tool.

For example:

You can use ProductsImport to run a custom script that checks the availability of a remote resource.

You can use OrdersImport to send notifications or perform any other custom task.

How to Schedule a Function:

Define the Cron Job:

Use Cron syntax to define the schedule for your function. This allows you to specify when and how often the function should run (e.g., daily, hourly, or at a specific time).

Write Custom Logic:

Within the predefined function, you can write any JavaScript code to perform your desired operations. The function will execute according to the schedule you set in the Cron job.

Deploy the Schedule:

After setting up the schedule and writing the function logic, DataPump will handle the execution of the function based on your Cron configuration.

Example Usage:

Scheduling ProductsImport for Custom Task:

Scheduling OrdersImport for Another Task:

Important Considerations:

Naming Flexibility:

The function names suggest specific import operations, but you are free to use them for any purpose, making them versatile tools for scheduling tasks within DataPump.

Cron Syntax:

Ensure that your Cron expressions are correctly configured to schedule the functions at the desired times.

Custom JavaScript:

Since the functions allow for arbitrary JavaScript, make sure to test your code thoroughly to avoid unintended consequences during execution.

By utilizing the predefined functions in DataPump, you can not only manage imports for Shopranos but also schedule a variety of custom tasks, making it a powerful tool for automating operations within your environment.

Additional Feature: Testing Functions with the Playground

In addition to scheduling predefined functions with Cron, DataPump offers a convenient way to test the operation of these functions before setting them up in a live environment. You can use the Playground feature to manually execute functions and verify that they behave as expected.

How to Test Functions in the Playground:

Open the Playground:

The Playground is a dedicated space within DataPump where you can experiment with functions.

Enter the Function Name:

Simply type the name of the function you wish to test (e.g., ProductsImport, OrdersImport, etc.) in the input field.

Write Custom Logic (Optional):

If you need to test specific logic, you can modify the function's code directly within the Playground.

Run the Function:

Click the Run Function button to execute the function. The Playground will simulate the function's behavior and display the output or results in real-time.

Verify Output:

Check the output or logs to ensure that the function performs as expected. This allows you to troubleshoot and fine-tune your logic before scheduling it with Cron.

Example:

Testing ProductsImport Function in the Playground:

After writing the logic, click Run Function to see the output.

Benefits of Using the Playground:

Immediate Feedback:

The Playground provides instant feedback on the function's execution, helping you identify any issues or errors quickly.

Safe Testing Environment:

By testing in the Playground, you can experiment with different scenarios without affecting your live data or scheduled tasks.

Iterative Development:

You can iteratively develop and refine your function’s logic, ensuring that it works correctly before integrating it into your workflow.

By using the Playground feature, you can confidently test and validate your functions, making the process of scheduling and automating tasks in DataPump even more efficient and reliable.

Crons

Documentation: Scheduling Predefined Functions in DataPump with Cron#

Predefined Functions:#

Flexibility of Scheduled Functions:#

How to Schedule a Function:#

Example Usage:#

Important Considerations:#

Additional Feature: Testing Functions with the Playground#

How to Test Functions in the Playground:#

Example:#

Benefits of Using the Playground:#