Kofax Export Connector 8.0.0 User Manual

Kofax�Export
Connector�8.0.0
for�Documentum
Content�Server
Release Notes
2012-08-17
©
1994-2012 Kofax, Inc., 15211 Laguna Canyon Road, Irvine, California 92618, U.S.A. All rights reserved.
Third-party software is copyrighted and licensed from Kofax’s suppliers.
THIS SOFTWARE CONTAINS CONFIDENTIAL INFORMATION AND TRADE SECRETS OF KOFAX, INC. USE, DISCLOSURE OR REPRODUCTION IS PROHIBITED WITHOUT THE PRIOR EXPRESS WRITTEN PERMISSION OF KOFAX, INC.
Kofax, the Kofax logo, and the Kofax product names stated herein are trademarks or registered trademarks of Kofax, Inc. in the U.S. and other countries. All other trademarks are the trademarks or registered trademarks of their respective owners.
U.S. Government Rights Commercial software. Government users are subject to the Kofax, Inc. standard license agreement and applicable provisions of the FAR and its supplements.
You agree that you do not intend to and will not, directly or indirectly, export or transmit the Software or related documentation and technical data to any country to which such export or transmission is restricted by any applicable U.S. regulation or statute, without the prior written consent, if required, of the Bureau of Export Administration of the U.S. Department of Commerce, or such other governmental entity as may have jurisdiction over such export or transmission. You represent and warrant that you are not located in, under the control of, or a national or resident of any such country.
DOCUMENTATION IS PROVIDED “AS IS” AND ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID.

Contents

Legal Notice .......................................................................................................................................................................... 2
New Features ........................................................................................................................................................................5
Changes in Behavior ............................................................................................................................................................7
Routing Tab ......................................................................................................................................................................7
Image Format Tab ...........................................................................................................................................................7
Multipage Document Export Support .........................................................................................................................7
Resolved Issues .....................................................................................................................................................................9
Inherited Document Lifecycles Not Available on Routing Tab .............................................................................. 9
Known Issues ......................................................................................................................................................................11
Upgrade Not Supported .............................................................................................................................................. 11
Documentum 6.0 Error with More Than 201 Table Fields .....................................................................................11
Versioning Documents with Duplicate Names ........................................................................................................11
Search Fields Fail With Repeating Attributes .......................................................................................................... 12
Exporting to a Workflow Requires Input Port 0 ..................................................................................................... 12
Latest Version Option .................................................................................................................................................. 12
Dynamically Select Object Type ................................................................................................................................. 12
Workflows with the Same Name ............................................................................................................................... 13
Unexpected Behavior With the Export Working Directory ................................................................................... 13
Kofax Export Connector 8.0.0 for Documentum Content Server Release Notes
3
Contents
4
Kofax Export Connector 8.0.0 for Documentum Content Server Release Notes
Chapter 1

New Features

The new features in Kofax Export Connector for Documentum Content Server include the following:
▪ Support for an MSI-based installer
▪ Ability to export batches from Kofax Express
▪ Support for Unicode
Other enhancements include:
▪ Conversion of the export connector to .NET technology (to replace Visual Basic 6)
▪ Discontinued use of the COM bridge
Kofax Export Connector 8.0.0 for Documentum Content Server Release Notes
5
New Features
6
Kofax Export Connector 8.0.0 for Documentum Content Server Release Notes
This chapter describes changes to the product in this release. For details, see the Help.

Routing Tab

On the Routing tab, the following changes were made:
▪ The Instructions field was renamed to Comments.
▪ The Priority setting was removed.

Image Format Tab

Support for the following Adobe PDF file formats was removed:
▪ Adobe PDF from TIFF
Chapter 2

Changes in Behavior

▪ Adobe PDF from JPEG
▪ Adobe PDF from PCX
As a result, “For Adobe PDF” has been removed as an image type selection. “PDF Settings” has also been removed.

Multipage Document Export Support

In this version, settings related to single page document export have been removed from the setup window; the current settings relate only to the export of multipage documents.
Kofax Export Connector 8.0.0 for Documentum Content Server Release Notes
7
Changes in Behavior
8
Kofax Export Connector 8.0.0 for Documentum Content Server Release Notes

Resolved Issues

This chapter lists previously reported issues that are fixed in this release.

Inherited Document Lifecycles Not Available on Routing Tab

When you select a child document on the Document Settings tab on the setup window, the Routing tab does not display the list of lifecycles inherited from the parent document. (SPR00088994)
Chapter 3
Kofax Export Connector 8.0.0 for Documentum Content Server Release Notes
9
Resolved Issues
10
Kofax Export Connector 8.0.0 for Documentum Content Server Release Notes

Known Issues

This chapter contains information about known issues in this product release.

Upgrade Not Supported

A product upgrade from earlier versions of this export connector is not supported. (SPR00042905)

Documentum 6.0 Error with More Than 201 Table Fields

When 201 or more Table Rows are added in Validation, the export fails with the error:
Object variable or With block variable not set.
Log entry for this error:
Chapter 4
2009-10-01 10:32:15, 0x00000018, 0, 0x0000005B, 0x00000000, 0x00000000, C: \Program Files\Kofax\CaptureSS\ServLib\Bin, Kofax Capture Release, DCTM65SVR,
8.00.461, clsDCTMFront.CreateDocument, 130, Object variable or With block variable not set
Workaround: Limit the number of table fields to 200 or fewer.

Versioning Documents with Duplicate Names

If versioning is enabled and you attempt to export a document with the same name as one that already exists in the Documentum repository, the document being exported may not be versioned.
This is because Documentum allows duplicate document names within a folder, which may cause problems when searching for documents with identical names. (SPR00009808)
For example, assume that the Documentum repository contains two documents named Doc01. When exporting documents, the export connector searches the repository until it finds the first occurrence of a document with the name Doc01. Then, the export connector uses the document ID to search within the virtual document for an occurrence of the document. If the document ID exists in the virtual document, the export connector will version the document.
However, if the document ID does not exist in the virtual document, the connector assumes that the document being exported is a new document and creates a duplicate document within the virtual document.
Workaround: To ensure uniqueness within a virtual document, define search fields that determine if an exported document is a duplicate, or needs to be versioned. To define search fields, click Search Fields on the Document Settings tab to select Documentum properties to
Kofax Export Connector 8.0.0 for Documentum Content Server Release Notes
11
Known Issues
use as search fields. All Documentum properties associated with the selected object type will be available.
For more information, click Help on the Document Settings tab.

Search Fields Fail With Repeating Attributes

When repeating attributes containing multiple values are used for search fields, documents are not versioned properly at export time. Instead, duplicate documents are created without generating an error. (SPR00009793)
Workaround: With search fields, use single values for repeating attributes.

Exporting to a Workflow Requires Input Port 0

Exported documents can be sent to a Documentum workflow, as long as the initial step of the workflow accepts documents on input port 0. If this is not the case, the following error occurs, export fails, and the batch is sent to the Kofax Capture Quality Control module.
The package <package name> is not in the specified input port, Input: <port number>.; ERRORCODE: 100; NEXT: null] Please update your workflow so the initial step is set to input port 0, remove the released documents from 4i, and run the batch again.
Workaround: To resolve the problem, redefine the first step in the workflow so that it uses input port 0.
Open your batch in the Quality Control module, clear the rejected status, and then process the batch.
Refer to the documentation that came with your Documentum product for details about defining workflows.

Latest Version Option

If the latest version of the exported document is not the current version, and you select the “Latest version” option on the Document Settings tab, the export connector automatically creates a new version of the exported document corresponding to the option marked “Current version” in Documentum. (SPR00009962)

Dynamically Select Object Type

The “Dynamically select object type at release using the following Ascent Value” check box on the Document Settings tab is used to dynamically assign an object type to your exported documents at export time. Note that if the object type cannot be matched or resolves to a NULL value at export time, the Export Setup window will receive an error message and the document is not exported. The error message is written to the error log.
12
In addition, if you attempt to delete a linked index field, the login prompt is displayed so you can log in and validate the data in the export connector. Once logged in, notice that the assigned object types have been unlinked. If you click Cancel, the export connector prompts you to save the data. If you click “No,” the next time you set up the export connector, the “Dynamically select object type at release using the following Ascent Value” check box is not
Kofax Export Connector 8.0.0 for Documentum Content Server Release Notes
cleared and the dynamic object types are unlinked. If you attempt to export, the export fails with an error message. (SPR00014585)
Workaround: Click Apply or OK to allow the Documentum export connector to validate the changes.

Workflows with the Same Name

With Documentum, you can create workflows with identical names. Be aware that problems can develop when a user specifies the wrong workflow at export setup and then exports a batch. This occurs because the export connector uses the workflow name instead of the object’s unique identifier. (SPR00012262)
Workaround: Create unique names for each of your Documentum workflows.

Unexpected Behavior With the Export Working Directory

If you do not specify an export working directory on the General Settings tab, you are given the option to create the directory at export setup time. If you click “Yes,” the export connector creates the directory. However, if you click “No,” the export connector still saves the changes. (SPR00009945)
Known Issues
Kofax Export Connector 8.0.0 for Documentum Content Server Release Notes
13
Known Issues
14
Kofax Export Connector 8.0.0 for Documentum Content Server Release Notes
Loading...