In the second part of the tour, you will learn how to set
up an error task route. This task route moves the metadata file to
a location that is not monitored by the collector so that problematic
documents can be reprocessed. In addition, it provides recovery tasks
for the content files that were routed to the error task route.
About this task
The content files that are described in the metadata file
are not related to each other. If the P8 File Document in Folder task
fails for one of the content files, the other content files should
not be affected by the error. The error task route moves the metadata
file to an error location. In addition, the error task route identifies
any content files that were successfully archived and filed into a
folder. The error task route also identifies any documents that were
archived, but not filed into a folder.
Procedure
To configure the error task route:
- Click the Switch between
main and error task route icon to switch to the error
task route.
The text in the task route toolbar tells you
whether you are currently looking at the main task route or at the
error task route.
- Include an audit log task as the first task to record everything
that was routed to the error task route.
Configure the
audit log task.
- To create a separate log file for this task, specify
a unique file identifier for the audit log.
- Select to record at least the following metadata properties:
<File, Full Path>
<Task Status, Task Success>
<Task Status, Task Result>
<FSC Metadata, Content File Line Number>
<FSC Metadata, Content File Order Number>
Recording these properties can make it easier to determine what
went wrong and to recover from this error.
- Include a decision point with three rules.
- Configure rule number one, which is the rule for processing
the metadata file.
Tip: Use a name that lets
you easily identify the purpose of the rule.
The expression
to be evaluated is
<FSC Metadata, Is Metadata>.
Use the
Expression Editor to
configure the expression:
- Select Advanced and start the Expression Editor.
- Select Replace as edit action.
- In the Prototype Expressions section,
double-click MetadataReference.
- Select the FSC Metadata source
and the Is Metadata property.
- Click OK to save the expression.
- Configure processing in this branch:
- Include an FSC Post Processing task
in this branch.
- Configure the task to move the metadata file to an error
location.
- Connect this branch to the end of the error task route.
- Drag the rule to the left to make room for the other rules.
- Add and configure rule number two, which is the rule for
processing content files that were successfully filed in a folder.
The expression to be evaluated is:
And(TestMetadataReference(<P8 File Document In Folder>, <File Paths>),
<Task Status, Task Success>)
Do not include any tasks
in this branch.
- Add and configure rule number three, which is the rule
for processing content files that were not yet filed in a folder.
The expression to be evaluated is:
And(TestMetadataReference(<P8 Create Document>, <Connection Name>),
<Task Status, Task Success>)
- Include a P8 File Document in Folder task
in this branch.
- Configure the task exactly as in the main task route.
Tip: You can also copy and paste the
task between the main and the error task route.
- Join the second and the third branch and include a postprocessing
task to replace the files with shortcuts.
Configure it
exactly as in the main task route.
Tip: You can also copy and paste the
task between the main and the error task route.
- Connect the postprocessing task that you added in the previous
step to the end of the error task route.
- Move the task so that the whole task route is visible in
the Task Route Designer.
- Include an audit log task in this branch to document the
results.