Simple Uses of Captiva’s Multi Module – Part 0

In this series of posts I will examine some simple uses of the Captiva Multi module.  Specifically, I will demonstrate how use Multi to accomplish the following tasks:

  • Remove dividers sheets from batch – dividers are used by scan operators to help them organize and manage batch content, but are not part of the final batch. Dividers consist of colored pages with the work “DIVIDER” printed on them in English, and as a Code39 barcode.
  • Remove blank pages from batch – blank pages can occur organically in scanned document, or as a result of double-sided scanning of a single-sided page.
  • Process Kodak Patch 3 separators sheets in batch – when a Patch 3 separator sheet is encountered, it indicates that every following page is to be split into a separate document until another Patch 3 sheet is encountered, or the end of the document is encountered.
  • Remove blank documents from batch – due to the actions of any of the above tasks, it is possible to create empty documents in the Captiva node tree (i.e., a document with no pages).

Some of these tasks, like removing blank pages, can be accomplished by the scanner/ScanPlus at scan-time. However, these tasks can also be accomplished using the Captiva Multi module and some simple scripting. This is the way I chose to implement them due to their location in my CaptureFlow (they are contained in a rescan “loop”, so to speak, and can be executed more than once in a single process). Here is a snippet of my CaptureFlow where I implement these tasks.


As the name might imply, the Multi module can do multiple things: it can insert and delete nodes from the Captiva node tree; change the trigger level of tasks; delete batches when they are completed; and emit a beep when a module completes its work. The Multi module is fairly unique among Captiva modules in that it does not have a user interface, and can only be run as a service. The only way to interact with the module is to set a trigger IA value named Ready. The following table lists available values for the Ready trigger, their constant names, and their purpose.

Constant Name Value Purpose
IAMULTI_READY 8 No op. Multi holds this node until it finishes processing the entire batch and releases it unchanged.
IAMULTI_DELETE 16 Deletes the specified node (e.g., page, document).
IAMULTI_BEEP 32 Sounds a beep on the Multi machine after the specified module finishes processing.
IAMULTI_PARENT 64 Performs the indicated operation at the trigger level.
IAMULTI_SPLIT_LEVELn [1..6] Inserts a level n node before a level n-1 node.

The Ready trigger can be set using IA value assignment in the CaptureFlow, or using scripting before the Multi module is triggered. This series of blog posts will examine both approaches for using Multi. In the next post, I will examine removing divider pages, blank pages, and empty documents using IA value assignment in Captiva Designer.

You can also find examples using the Multi module in the Sample Captiva Designer project distributed with Captiva 7.


About Scott
I have been implementing Documentum solutions since 1997. In 2005, I published a book about developing Documentum solutions for the Documentum Desktop Client (ISBN 0595339689). In 2010, I began this blog as a record of interesting and (hopefully) helpful bits of information related to Documentum, and as a creative outlet.

2 Responses to Simple Uses of Captiva’s Multi Module – Part 0

  1. Pingback: Simple Uses of Captiva’s Multi Module – Part 1 | dm_misc: Miscellaneous Documentum Information

  2. Pingback: Simple Uses of Captiva’s Multi Module – Part 2 | dm_misc: Miscellaneous Documentum Information

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google+ photo

You are commenting using your Google+ account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

%d bloggers like this: