ConversionTask

‘ConversionTask’ Items are created automatically based on enabled Conversion Rules. Each ‘Conversion Task’ represents one File being converted by a Conversion Server.

All properties and relationships are automatically populated.

Properties:

• Status: Current status of the Task. Can be ‘Not Started’, ‘In Progress’, ‘Succeeded’, ‘Failed’, or ‘Discarded’.

• Rule: Points to the Conversion Rule that was used for the creation of this Conversion Task.

• File Type: The type of File that is being converted.

• File: The ID of the File being converted.

• Started On: Date that the Conversion Task started.

• Finished On: Date that the Conversion Task finished.

• User Data: Text (most probably XML) that could be used by a specific converter to carry the converter-specific data that has to be eventually passed to the process that performs actual conversion of the physical file (e.g., conversion options; list of supplementary files that must be given to the converter in order to convert the file; etc.).

• Error: Error description in case the task status is Failed or Discarded.

Relationships:

• Dependencies (‘ConversionTaskDependency’): Null Relationship

Displays the Type and ID of Items that can be claimed by methods during the processing of the Conversion Task.

• Results (‘ConversionTaskResult’): Null Relationship

Displays the File IDs that have been created because of the Conversion Task and an additional string ‘kind’ to possibly describe why it was created / what it was created for.

• Event Handlers (‘ConversionTaskEventHandler’): Relationship to ‘Method’

Events copied from the ‘Task Event Templates’ Relationship on the ‘Conversion Rule’ ItemType.

Displays the status of each Event during the processing of the Conversion Task with the following properties:

• Error […]: Error message set if the Method failed.

• User Data […]: Used by the event handler to pass some information between different invocations of the event handler (e.g., in case the event handler failed it could save in this property some information about what it managed to finish before it failed so that the next invocation of the method does not try to do it again).

• Started On […]: Date when the first invocation of the method started.

• Finished On […]: Date when the last invocation of the method finished.

• Execution Attempt: The number of times the Method has been called by this Conversion Task.

• Status: Status of the Event. It can be Not Started, In Progress, Failed, or Succeeded.