Task Processing

When a task is executed to process by the Services Framework, the logic found in the runTask() method is executed.
public CompleteStatus runTask() throws TaskProcessingException
The runTask() method is where all processing logic begins. When the method is run by the Services Framework, the task is fully initialized with all the information needed for processing. The following items identify some of the important pieces of data available to the task for processing:
  • Configuration parameters, if defined
  • User entered manual runtime parameters, if defined
  • A database connection to the FTM database
  • Unit of work data , if supplied
  • Ability to identify the type of run request (New, Restart, or Resume)
When processing work, it is required for the task to update its job description. Updating the job description:
  • Updates the task activity record for this run to a status of running. Calling this method as early as possible in the runTask() method properly reflects when the task is processing.
  • Allows the task to give a detailed description of what the run is to do. Most tasks work from a unit of work object, which contains dynamic runtime information. The job description should reflect a detailed description of the task's responsibility for this unit of work.
Note: The job description is visible in the task activity page of the Services Framework user interface.