Cheshire3 Configuration - Workflows¶
Workflow Configuration Elements¶
Contains an ordered list of <object>s. The results of the first object is given to the second and so on down the chain. It should be apparent that subsequent objects must be able to accept as input, the result of the previous.
A call to an object within the system. <object> s define the following attributes:
- type [ mandatory ]
Specifies the type of the object within the Cheshire3 framework. Broadly speaking this may be a:
- A reference to a configured object within the system. If unspecified, the current Session is used to determine which Server, Database, RecordStore and so forth should be used.
- The name of the method to call on the object. If unspecified, the default function for the particular type of object is called.
For existing processing objects that can be used in these fields, see the object documentation.
Log text to a Logger object. A reference to a configured Logger may be provided using the ref attribute. If no ref attribute is present, the Database ‘s default logger is used.
Assign a specified value to a variable with a given name. Requires both of the following attributes:
- from [ mandatory ]
- the value to assign
- to [ mandatory ]
- a name to refer to the variable
Feed the current input into each processing fork. [ more details to follow in v1.1]
Allows for error catching. Any errors that occur within this element will not cause the Workflow to exit with a failure. Must be followed by one <except> elements, which may in turn also be followed by one <else> element.
Specifies the action to take in the event that no errors occur within the preceding <try>.
Skip remaining processing steps, and move on to next iteration while inside a <for-each> loop element. May not contain any further elements or attributes. This can be useful in the error handling <except> element, e.g. if a document cannot be parsed, it cannot be indexed, so skip to next Document in the DocumentFactory.
Break out of a <for-each> loop element, skipping all subsequent processing steps, and all remaining iterations. May not contain any further elements or attributes.