7.3.5.1 Adding a Task

Add new tasks to a selected Batch Definition.

To add new task:

1. In the Scheduler Service (Define Task), select the Batch for which you want to add a new task from the drop-down list.
2. Click Actions on the page and then click Add to access the Add Task page.
3. Enter the following details:
   • Task Code - Enter a unique alphanumeric code for the new task.

     The code must begin with letters, should not include spaces, and has a maximum limit of 60 characters. Special characters except underscore (_) are not allowed.

   • Task Name - Enter a unique name for the new task.

     The name should start with letters, not contain spaces, and have a maximum limit of 60 characters. Special characters except underscore (_) are not allowed.

   • Task Description - The description/details for the task.

     The description should begin with a letter and not exceed 250 characters. Avoid using phrases like "Select From" or "Delete From" in the description.

   • Task Type - Select the task type from the drop-down list.
   • Component - Select the custom or the seeded component associated with the task.
4. By default, all Batch Level Parameters are added and enabled as task parameters in the Task Parameters pane.

   Note:

   You can edit the parameters only for custom components.
   1. Enter the Parameter name in the Param Name field.
   2. Enter the Parameter value in the Param Value field.
   3. For FTP Propagation or Advanced FTP Propagation components, select the Execution Mode from the drop-down list:
      • Single Query Approach: Select this option to process small or medium-sized datasets (less than 500,000 records). This mode provides faster execution with minimal overhead and is suitable for manageable data volumes.
      • Sliced Queries Approach: Select this option for very large datasets (500,000 records or more) that might cause memory or performance issues if processed in a single query. This mode divides the dataset into smaller slices, improving query execution performance and reducing overall processing time.
   To delete a parameter, click on Delete next to the respective parameter.

   Note:

   Legal Entity and Scenario Parameters for Allocation Engine and Allocation Model Engine Components

   For tasks using the Allocation Engine or Allocation Model Engine components, two additional task parameters are available:

   • Legal Entity — A dropdown listing all leaf members of the Legal Entity dimension.
   • Scenario — A dropdown listing all leaf members of the Scenario (Consolidation Code) dimension.

   Providing a value for these parameters is not mandatory in the task-parameter screen. However, their requirement at runtime is conditional on the rules being executed:

   • These parameters apply only to rules defined as LE Variable and/or Scenario Variable respectively. Rules not defined as such will ignore these values and execute using the dimension values specified in their rule metadata.
   • If any rule being executed is defined as LE Variable, a value for Legal Entity must be provided. If left blank, rule execution will fail with an appropriate log message.
   • If any rule being executed is defined as Scenario Variable, a value for Scenario must be provided. If left blank, rule execution will fail with an appropriate log message.
   • Batches created in prior releases that do not include these parameters in their JSON will continue to execute without issue — the batch component handles the absence of these parameters gracefully for backward compatibility.
5. Click Save to add the new task to task summary in the Define Task page.

   Note:

   Sync task will remain active if execution time is more than 15 minutes at target service and till acknowledge status is generated from target API after the execution.