Chapter 7. Document Assembly

Table of Contents

1. Configuration
2. Damis.xml

Document Assembly is specialized user interface for batch processing. It is usually used for document identification. It have to be used together with Damis Server backend - description of this server component is in separate documentation.

1. Configuration

This function can be enabled in the Tahiti.xml. Main option is called Damis.Enable - switch on/off the component.

Table 7.1. Document Assembly Configuration

ConfigurationGlobalDescription
Damis.EnableYEnable/disable component. 0 - disabled, 1 - enabled
Damis.Menu.Revoke.BadContent.AllowNAllow to revoke unreadable item and send it back for re-scan. 0 - disabled, 1 - enabled
Damis.Menu.Revoke.UnableToProceed.AllowNAllow to revoke documents which use. 0 - disabled, 1 - enabled
Damis.Tree.SortNSort the tree by default. 0 - disabled, 1 - enabled
Damis.InputPluginsNList of input plugins used for first time when document is opened. Detail description is in the following chapter.
Damis.OnReceived.InputPluginsNList of plugins used when document is received. Detail description is in the following chapter.
Damis.ExportPluginsNList of plugins used to export selected documents.

Note

Global configuration options cannot be overriden in domain specific configuration.

Configuration of connection is stored in file called damis.xml. This file can be placed in the domain configuration directory or in the repository.

2. Damis.xml

File contains list of Damis servers. Tahiti can connect to these servers and process stored documents. It is also possible to send new documents from the scanning to them (if allowed).

Example 7.1. Example of Damis.xml

<?xml version="1.0" ?> 
<DistrScanConfig>
 <Server name="server1" address="10.2.0.2" port="80"
         prefix="/DamisServer/Upload"
         menuScan="Send to Damis"
         uploadUniqueAttribute="FileNumber"
         uploadSplitAttribte="SplitId"
         uploadDomain="scan"
 /> 
 <Server name="server2" address="10.2.0.2" port="80" 
         prefix="" interval="600" simulation="1" /> 
 <Server name="server3" address="10.2.0.2" port="80"
         prefix="/DamisServer/DamisServlet" 
         interval="600"
         autoRequest="1"
 /> 
</DistrScanConfig>

Server is defined in the tag Server. Each server have to be identified by the name and address where to connect.

Table 7.2. Damis.xml, tag Server

AttributeMandatoryDescription
nameYName of the server, used as symbolic name
addressYServer address
portYServer port
prefixNPrefix where is Damis running on the server. If empty no prefix is used.
intervalNInterval in seconds to periodicly check if package is valid. Common value is 300 or 600s (10 minutes). 0 - no periodical checks.
simulationNSimulation of connection - used for development. 0 - not used, 1 - connection is simulated
autoRequestNAutomaticly request pending jobs. 0 - off, 1 - on
menuScanNText which will be displayed in the scanning menu allowing to send documents to the given Damis server. If this item is not defined documents cannot be uploaded.
uploadOnlyActiveNSet if only active version or all versions should be uploaded. N - all versions will be uploaded, Y - only active version will be uploaded
uploadDomainNName of Damis domain used for upload. This have to be name of existing and valid domain.
uploadUniqueAttributeNIf menuScan is specified. uploadUniqueAttribute or requestUniqueAttribute have to be s defined .This attribute have to be unique for each document set. Documents have to have this attribute.
requestUniqueAttributeNIf menuScan is specified. uploadUniqueAttribute or requestUniqueAttribute have to be s defined .This attribute have to be unique for each document set. Attribute is issued by server.
uploadSplitAttributeNThis is name of attribute used to split selected batch with documents into smaller packages. Usually uploadUniqueAttribute is used. If this attribute is not specified unique attribute will be issued by server.
blockSizeNSize of block for data transmition. When set batch is uploaded to server in data blocks of size blockSize, when communication fail Tahiti try to resend last block of data. When doesn't set (attribute is missing) batch is uploaded in one large block. Recomended value > 64000.