OPBinder Dialog Box
Use options in this dialog box to activate and configure the OPBinder component in a workflow.
General tab
Option |
Description |
---|---|
Activate |
Activate the component according to a condition. The condition is evaluated at run time. For more information, see Conditional fields under Appendices. |
File Type |
Select the type of file to accumulate the pages of the input documents into one document. You can select either TIFF or PDF file type. |
Pass through |
Select this check box to pass the documents to subsequent components in the workflow. If this check box is selected and the release condition is evaluated to be FALSE, the document is added to the specified volume and passed for additional processing. |
Working directory |
Enter the path to the working directory that the component uses to keep temporary files into which the input documents are added until the release condition is satisfied. |
Add to volume |
Enter the identifier of the document which will accumulate the pages of the input documents. When the component starts to process input documents, it creates a temporary directory named by the specified ID within the working directory. In this directory, depending on the filetype selection made in General tab, the component creates the OPBinder.tif or OPBinder.pdf file, which binds all the pages of the input documents. Input documents are added to this file as long as the release condition remains FALSE. The invalid symbols (\ / " : < > | * ?) will be replaced by the underscore symbol (_). |
Output file name |
Enter the name of the file that will be passed to subsequent components in the workflow for further processing. Invalid symbols (\ / " : < > |* ?) will be replaced by the underscore symbol (_). |
Release condition |
Enter the condition that determines when the component releases documents into the process. As long as the condition is evaluated to be FALSE, the component accumulates input documents and adds them to a temporary file. When the value of the condition changes to TRUE, the resultant document is passed to the further processing and the temporary directory is deleted. You can use an RRT to obtain a condition value from this or previous components. For example, when the RRT scheme is ~OBD::TotalCount~>=10, the document will be released when the number of pages in the document reaches or exceeds 10. If the value of the condition is TRUE and the component receives a document, it will be simply passed to the next component rather than being bound to subsequent documents. The syntax of the release condition is the same as for activation (see Conditional fields under Appendices). You can initially set the condition to FALSE and then change it manually to TRUE after all documents are accumulated. |
Check after adding each page |
The component will add the document page by page and check the condition after adding each page. Otherwise, the condition will be evaluated after the whole input document is added to the temporary file. For example, if you have input documents with different number of pages and want the output documents to have the same number of pages, you can select this option and set the release condition like this ~OBD::TotalCount~=10. If you do not select this option, the release condition might
never be satisfied.
|
Limits on volume |
This group contains additional restrictions on the output file. This is a preventive measure to avoid the situation of an incorrect release condition (which cannot be satisfied, for example, or which is too specific), in which the output file will grow indefinitely. If these options are used the document will be released when one of the limits is reached regardless of whether the release condition is met or not.
The minimum value for Max page count and Max file size is 1, and the maximum value is 4294967295. As the size of TIFF files is limited to 2GB, the OPBinder component automatically releases (without user interaction) the created temporary TIFF file when its size is approaching 2GB. A notification about this is displayed on the Status Monitor and appears in the log. |
Output file options |
This group defines whether to save and where to save processed and rejected files.
If you process several documents with condition value FALSE and
then stop the process, depending on the filetype selection made in General tab,
the OPBinder.tif or OPBinder.pdf file
stays in the temporary directory. If you start the process again and send several
documents with condition value FALSE, the component continues to accumulate
documents pages in this file.
|
Release Condition Examples
- Release the document when its size exceeds 1MB
-
The condition should be "greater or equal" and not simply "equal", because file size is rarely equal to a specified number. In this case, you could use the condition ~OBD::FileSize~>=1073741824.
- Release the document when its number of pages reaches 10
-
Make sure that the number of pages can be reached. For instance, if you add only 2-page documents, every 5 files will amount to one 10-page document. If you have only 3-page documents, then they will never attain 10 pages.
-
To split documents by pages, you can use the condition ~OBD::TotalCount~=10 and select the Check after adding each page option.
-
To avoid splitting documents, you can use the condition ~OBD::TotalCount~>=10 to assure that documents do not get stuck.
-
- Release the document on a specific date
-
To release a document on Christmas day, you could use the condition (~OBD::%m~=12) & (~OBD::%d~=25).
- Use RRTs of preceding components
-
When the FTP Poll component captures files from an FTP location, you can use the condition "~FTP::FileName~"=="last.tiff" to release a captured file.