Kofax Capture Ascent® 7.0 Release Script for IBM DB2 Content Manager Enterprise 8.3-8.
© 1994 - 2010 Kofax, Inc., 15211 Laguna Canyon Road, Irvine, California 92618, U.S.A. All rights reserved. Use is subject to license terms. Third-party software is copyrighted and licensed from Kofax's suppliers. This product includes software developed by the Apache Software Foundation (http://www.apache.org/). This product is protected by U.S. Patent No. 6,370,277. THIS SOFTWARE CONTAINS CONFIDENTIAL INFORMATION AND TRADE SECRETS OF KOFAX, INC.
Contents Introduction ...................................................................................................................................................1 Additional Documentation ..................................................................................................................1 System Requirements ...................................................................................................................................
Contents Sharing Data Among Release Scripts ...............................................................................................10 Invalid Characters ...............................................................................................................................11 OCR Full Text Options .......................................................................................................................12 Kofax PDF Options ..........................................................
Contents Releasing Date Fields ..........................................................................................................................33 Releasing eDocuments with 0 Bytes .................................................................................................33 Scanning Non–Image Documents .....................................................................................................34 Upper ASCII Character Limitations ......................................................
Contents vi Kofax, Inc.
Ascent® 7.0 Release Script for IBM DB2 Content Manager Enterprise 8.3/8.4 Release Notes Introduction This document contains the release notes for the Ascent 7.0 Release Script for IBM DB2 Content Manager Enterprise, which supports DB2 Content Manager Enterprise Edition 8.3/8.4. This release script copies document images, OCR full text files, PDF documents, and eDocuments to permanent storage and writes document / index data to your DB2 Content Manager system.
Ascent® 7.0 Release Script for IBM DB2 Content Manager Enterprise 8.3/8.4 Release Notes System Requirements The Ascent 7.0 Release Script for IBM DB2 Content Manager Enterprise requires the following components to be installed prior to installing this release script. IBM DB2 Content Manager Enterprise Server Support The Ascent 7.0 Release Script for IBM DB2 Content Manager Enterprise requires the following network server components: DB2 Content Manager Enterprise Edition 8.3/8.
Ascent® 7.0 Release Script for IBM DB2 Content Manager Enterprise 8.3/8.4 Release Notes Administration and Release Workstations – Additional Requirements The Ascent Capture Administration and Release workstations must have the following components installed: Ascent Capture 7.0, Ascent Capture 7.5, Kofax Capture 8, or Kofax Capture 9 For IBM DB2 Content Manager Enterprise Edition 8.3: DB2 Runtime Client 8.1 with Fix Pack 7A or DB2 Runtime Client 8.
Ascent® 7.0 Release Script for IBM DB2 Content Manager Enterprise 8.3/8.4 Release Notes Source Code and the Information Integrator for Content (II4C) Connector In order to compile the source code for Ascent 7.0 Release Script for IBM DB2 Content Manager Enterprise, the IBM DB2 Information Integrator for Content (II4C) connector must be installed to the default directory (for example, C:\Program Files\IBM).
Ascent® 7.0 Release Script for IBM DB2 Content Manager Enterprise 8.3/8.4 Release Notes Features This section contains information about features provided with the Ascent 7.0 Release Script for IBM DB2 Content Manager Enterprise. Ascent Capture Values / Content Manager Attributes The Ascent 7.0 Release Script for IBM DB2 Content Manager Enterprise provides an easy-to-use interface for linking Ascent Capture Ascent Values to Content Manager document attributes and folder attributes.
Ascent® 7.0 Release Script for IBM DB2 Content Manager Enterprise 8.3/8.4 Release Notes Multiple Values The Ascent 7.0 Release Script for IBM DB2 Content Manager Enterprise supports properties that contain multiple values. You can specify the desired delimiter to separate the values when entering multiple values for the child component attributes, dynamic processes, and dynamic priorities using the Multi-value separator option as specified on the General Settings tab.
Ascent® 7.0 Release Script for IBM DB2 Content Manager Enterprise 8.3/8.
Ascent® 7.0 Release Script for IBM DB2 Content Manager Enterprise 8.3/8.4 Release Notes Additional Information This section contains additional information about the Ascent 7.0 Release Script for IBM DB2 Content Manager Enterprise. Unsupported Ascent Capture Features Ascent 7.0 Release Script for IBM DB2 Content Manager Enterprise does not support the following Ascent Capture feature. File Name Retention This release script does not support file name retention.
Ascent® 7.0 Release Script for IBM DB2 Content Manager Enterprise 8.3/8.4 Release Notes Text Searching Options The following sections describe what is required to make your documents text-searchable for images, eDocuments, OCR full text files, and PDF documents. Images and eDocuments The “Make documents text-searchable” check box as specified on the General Settings tab, enables the text-searchable feature.
Ascent® 7.0 Release Script for IBM DB2 Content Manager Enterprise 8.3/8.4 Release Notes Multi-value Separator Option The Multi-value separator option as specified on the General Settings tab, allows you to enter only valid printable ASCII characters. This option cannot contain the following characters: Carriage return Escape New line Space Tab Warning The multi-value separator should not be part of your value. For example, if you specify a period (.
Ascent® 7.0 Release Script for IBM DB2 Content Manager Enterprise 8.3/8.4 Release Notes Invalid Characters The Ascent 7.0 Release Script for IBM DB2 Content Manager Enterprise will not allow the following characters at validation. Content Manager data types are validated during release setup and release. Table 1. Invalid Characters Kofax, Inc.
Ascent® 7.0 Release Script for IBM DB2 Content Manager Enterprise 8.3/8.4 Release Notes OCR Full Text Options This release script allows you to select OCR full text options at release setup time. For example, you can specify that you want to release OCR full text files as part of the image or as the base of a released document. The OCR Full Text options for the release script are available on the General Settings tab.
Ascent® 7.0 Release Script for IBM DB2 Content Manager Enterprise 8.3/8.4 Release Notes Kofax PDF Options To release Kofax PDF documents, you must enable Ascent Capture Kofax PDF generation in your applicable document class and add the Kofax PDF Generator module to your applicable batch class. Refer to the Content Manager Help for details about how Kofax PDF documents and non-image files are released to the DB2 Content Manager system repository (Help keyword: File format combinations).
Ascent® 7.0 Release Script for IBM DB2 Content Manager Enterprise 8.3/8.4 Release Notes Adobe Acrobat Capture Options The Ascent 7.0 Release Script for IBM DB2 Content Manager Enterprise supports Adobe Acrobat Capture. This section contains information related to using Adobe Acrobat Capture or your Adobe PDF images. For additional details about creating Adobe Acrobat Capture PDF documents, refer to the documentation that came with your Adobe Acrobat Capture product.
Ascent® 7.0 Release Script for IBM DB2 Content Manager Enterprise 8.3/8.4 Release Notes Multipage TIFFs If you are releasing multipage TIFFs, you must use the Split Multipage TIF step in your Adobe Acrobat Capture workflow. Releasing from Multiple Ascent Capture Standalone Workstations If you use multiple Ascent Capture standalone workstations and one Adobe Acrobat Capture hub, you must create unique Adobe Acrobat Capture “workflows” and “watched folders” for each Ascent Capture standalone workstation.
Ascent® 7.0 Release Script for IBM DB2 Content Manager Enterprise 8.3/8.4 Release Notes Installing the Release Script You can install the Ascent 7.0 Release Script for IBM DB2 Content Manager Enterprise on an Ascent Capture client workstation or standalone workstation. Important Note About Installation To install the Ascent 7.0 Release Script for IBM DB2 Content Manager Enterprise, you must have Windows administrator privileges.
Ascent® 7.0 Release Script for IBM DB2 Content Manager Enterprise 8.3/8.4 Release Notes Upgrading the Release Script If you are currently using Ascent Capture for Content Manager version 5.51, 5.61, 5.71, Ascent Capture 6.0 Release Script for IBM Content Manager, Ascent Capture 6.05 Release Script for IBM Content Manager, or Ascent Capture 6.1 Release Script for IBM Content Manager, you can upgrade to the Ascent 7.0 Release Script for IBM DB2 Content Manager Enterprise, if desired.
Ascent® 7.0 Release Script for IBM DB2 Content Manager Enterprise 8.3/8.4 Release Notes Application Maintenance This section describes how to repair and remove the Ascent 7.0 Release Script for IBM DB2 Content Manager Enterprise. Figure 1. Application Maintenance Dialog Box Repairing the Release Script The Repair option replaces missing, renamed, or deleted files. X To repair the release script 18 1 Insert your Ascent 7.
Ascent® 7.0 Release Script for IBM DB2 Content Manager Enterprise 8.3/8.4 Release Notes Removing the Release Script The Remove option will delete the release script. X To remove the release script 1 Insert your Ascent 7.0 Release Script for IBM DB2 Content Manager Enterprise installation CD into your drive. 2 From your Windows task bar, select Start | Run, browse to the IBM\CM8 folder on the CD, and run Setup.exe.
Ascent® 7.0 Release Script for IBM DB2 Content Manager Enterprise 8.3/8.4 Release Notes Logging on to the Release Script Once you have associated a document class with a batch class in Ascent Capture, you may specify the release script to use when releasing your images, OCR full text files, PDF documents, eDocuments, and index data. X To log on to the release script 1 Start the Ascent Capture Administration module. The module’s main screen will display.
Ascent® 7.0 Release Script for IBM DB2 Content Manager Enterprise 8.3/8.4 Release Notes Figure 3. Ascent Capture Content Manager Login Information Dialog Box Note The login information will be saved and used during release. 6 To prompt for a user ID and password if the release script is not able to log on to IBM DB2 Content Manager at release time, select the “If unable to log in during release, prompt for valid login information” check box.
Ascent® 7.0 Release Script for IBM DB2 Content Manager Enterprise 8.3/8.4 Release Notes Figure 4. Ascent 7.0 Release Script for IBM DB2 Content Manager Enterprise 8.3/8.4 – Release Setup Dialog Box 8 22 Refer to the next section, Setting Up the Release Script, for information about the set up options. Kofax, Inc.
Ascent® 7.0 Release Script for IBM DB2 Content Manager Enterprise 8.3/8.4 Release Notes Setting Up the Release Script The following sections describe the setup options available with the Ascent 7.0 Release Script for IBM DB2 Content Manager Enterprise. Note For more details about the setup options, refer to the Help available from the Ascent 7.0 for IBM DB2 Content Manager Enterprise 8.3/8.4 — Release Setup dialog box.
Ascent® 7.0 Release Script for IBM DB2 Content Manager Enterprise 8.3/8.4 Release Notes Folder Settings Tab This tab allows you to specify new or existing folders to use for storing documents in the DB2 Content Manager system. In addition, you can specify a Content Manager item type to use for assigning Content Manager attribute values to folders in the folder hierarchy.
Ascent® 7.0 Release Script for IBM DB2 Content Manager Enterprise 8.3/8.4 Release Notes Document Routing Tab This tab allows you to route released documents or route the parent folder for the current folder to the IBM DB2 Content Manager processes. You have the option of either defining static processes or defining dynamic processes. In addition, you can assign priorities for the processes. Figure 7. Document Routing Tab Kofax, Inc.
Ascent® 7.0 Release Script for IBM DB2 Content Manager Enterprise 8.3/8.4 Release Notes Image Format Tab This tab allows you to specify the desired image format for releasing your images. If Adobe PDF is selected as an image type, the PDF Settings on this tab will become available for selection. Figure 8. Image Format Tab 26 Kofax, Inc.
Ascent® 7.0 Release Script for IBM DB2 Content Manager Enterprise 8.3/8.4 Release Notes General Settings Tab This tab allows you to specify a temporary storage location to be used at release time. In addition, you can specify whether to skip the first page of each document. You may want to skip the first page if you are using standalone separator sheets to separate your documents, and you do not want to release the separator sheets.
Ascent® 7.0 Release Script for IBM DB2 Content Manager Enterprise 8.3/8.4 Release Notes Publishing a Batch Class After you select all your batch class settings, you must publish your batch class before you can use it. The publishing process checks the integrity of the settings in your batch class, and makes the batch class available for use. If problems are found with any of the settings, error and warning messages will display along with the recommended actions for fixing the problems.
Ascent® 7.0 Release Script for IBM DB2 Content Manager Enterprise 8.3/8.4 Release Notes Releasing Batches With the Ascent 7.0 Release Script for IBM DB2 Content Manager Enterprise, the Ascent Capture Release module will process batches based on the settings of the associated batch classes. The Release module is responsible for releasing documents, as well as index data using the attributes defined during release setup.
Ascent® 7.0 Release Script for IBM DB2 Content Manager Enterprise 8.3/8.4 Release Notes Known Problems This section contains information about known problems with the Ascent 7.0 Release Script for IBM DB2 Content Manager Enterprise. Issues with CM Decimal Attribute When setting the CM Decimal attribute in the DB2 Content Manager system, be aware that the released value that expands beyond the working precision will simply be truncated. No error message will be displayed.
Ascent® 7.0 Release Script for IBM DB2 Content Manager Enterprise 8.3/8.4 Release Notes FLOAT and REAL Data Types When the Ascent Values FLOAT and REAL fields are copied to Content Manager attributes, the data types will not convert to the Content Manager Double data type. However, the values will convert to Content Manager Character and Variable Character data types. Problems When Installing on Windows XP If you are installing the Ascent 7.
Ascent® 7.0 Release Script for IBM DB2 Content Manager Enterprise 8.3/8.4 Release Notes MIME Types Must Exist in Content Manager When releasing an eDocument with a MIME type that does not exist on the Content Manager server, an error similar to the following will occur and the eDocument will be rejected. (SPRs 28153 and 28252) Method '~' of object '~' failed.
Ascent® 7.0 Release Script for IBM DB2 Content Manager Enterprise 8.3/8.4 Release Notes Releasing Single Page TIFFs If you are having problems releasing documents as single page TIFFs, make sure that you have the latest Fix Packs from IBM. Releasing numerous images may cause the release to fail with the following parsing error message.
Ascent® 7.0 Release Script for IBM DB2 Content Manager Enterprise 8.3/8.4 Release Notes Scanning Non–Image Documents If you enable the “Release OCR as base (image discarded)” option on the General Settings tab and use the Kofax Advanced OCR Full Text Recognition profile for the document class properties, you will receive the following error message while scanning in non-image documents. (SPR 30456) You have selected to release OCR Full Text as base, but this document does not contain OCR Full Text files.
Ascent® 7.0 Release Script for IBM DB2 Content Manager Enterprise 8.3/8.4 Release Notes Using the Dynamic Item Types Feature with Child Component Attributes Due to a limitation with Content Manager, you will not be able to create a child component attribute name that has the same name as another child component attribute in another item type. Therefore, you cannot use the dynamic item types feature with child component attributes.
Ascent® 7.0 Release Script for IBM DB2 Content Manager Enterprise 8.3/8.4 Release Notes Minimum Cardinality Not Met On the Content Manager back end, you can set the minimum cardinality for a child component. When you set the minimum cardinality equal to zero (the default setting), then you can leave some of the child attributes unlinked. However, if the minimum cardinality is greater than or equal to one, then all the child attributes must be linked.
Ascent® 7.0 Release Script for IBM DB2 Content Manager Enterprise 8.3/8.4 Release Notes The following will succeed. You link all your child attributes. For example: Model Chevrolet;;Ford;GM Year 2004;;1998;1987 Workaround: Make sure that the minimum cardinality of each set of multiple values entered in each child component attribute is equal, even if the attribute value is left blank.
Ascent® 7.0 Release Script for IBM DB2 Content Manager Enterprise 8.3/8.4 Release Notes Appendix A – Data Type Compatibility The figures in this appendix map Ascent Capture data types to Content Manager data types, and indicate which combinations are valid. Refer to your Ascent Capture Help for more information about Ascent Capture data types (Ascent Capture Help keyword: Data types). You can display Ascent Capture Help from the Help menu available from any Ascent Capture module.
Ascent® 7.0 Release Script for IBM DB2 Content Manager Enterprise 8.3/8.4 Release Notes Ascent Capture Values The following figure lists the Ascent Capture values for Content Manager attributes. Refer to your Ascent Capture Help for more information about Ascent Capture values (Ascent Capture Help keyword: Ascent Capture > values) Figure 11. Ascent Capture Values Ascent Capture Text Constants The following figure lists the supported Content Manager attributes for Ascent Capture text constants.
Ascent® 7.0 Release Script for IBM DB2 Content Manager Enterprise 8.3/8.4 Release Notes Appendix B – Quick Reference for Releasing OCR Full Text Files The following figure provides a quick reference for setting up the release of OCR full text files to IBM DB2 Content Manager. It lists the following: OCR full text options are supported by the IBM DB2 Content Manager Enterprise release script. The options are available from the General Settings tab.
Ascent® 7.0 Release Script for IBM DB2 Content Manager Enterprise 8.3/8.4 Release Notes Appendix C – Kofax Technical Support For additional technical information about Kofax products, visit the Kofax Web site at www.kofax.com and select an appropriate option from the Support menu.
Ascent® 7.0 Release Script for IBM DB2 Content Manager Enterprise 8.3/8.4 Release Notes 42 Kofax, Inc.