Kofax Capture Ascent® 7.5 Release Script for Hummingbird DM 6.
© 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 ...................................................................................................................................2 Hummingbird DM Server Support .................
Contents Releasing to Records Management ...................................................................................................10 Search Criteria for Duplicate Folders ...............................................................................................10 DM Check Box Attributes Requires Numeric Values ....................................................................11 Releasing to Localized Versions of Hummingbird DM ...............................................................
Contents eDocument Name Not Preserved at Release ...................................................................................34 Images, PDF Documents, and eDocuments Display in Versions Tab .........................................34 “Error 75 – Path/File Access” Error .................................................................................................34 Select a Version to Publish Dialog Box Displays During Release ................................................
Contents vi Kofax, Inc.
Ascent® 7.5 Release Script for Hummingbird DM 6.0 Release Notes Introduction This document contains the release notes for Ascent 7.5 Release Script for Hummingbird DM, which supports Hummingbird DM 6.0. This release script releases images, OCR full text files, PDF documents, eDocuments, and index values from Ascent Capture into your DM repository. Please read these notes carefully as they contain information not included in the Ascent Capture Help or printed documentation.
Ascent® 7.5 Release Script for Hummingbird DM 6.0 Release Notes System Requirements Ascent 7.5 Release Script for Hummingbird DM requires the following components to be installed prior to installing this release script. Hummingbird DM Server Support Ascent 7.5 Release Script for Hummingbird DM requires the following network server components: Hummingbird DM Server 6.0 Hummingbird DM Web Server 6.0 Hummingbird DM API 6.0 Hummingbird DM Extension API 6.
Ascent® 7.5 Release Script for Hummingbird DM 6.0 Release Notes Source Code The source code for Ascent 7.5 Release Script for Hummingbird DM is provided and it is located on the Ascent 7.5 Release Script for Hummingbird DM 6.0 installation CD in the Hummingbird\DM6 folder. The source code can be opened, edited, and compiled in Visual Basic 6.0 with Service Pack 6. X To modify the release script 1 Install the Hummingbird DM release script.
Ascent® 7.5 Release Script for Hummingbird DM 6.0 Release Notes Features This section contains information about features provided with Ascent 7.5 Release Script for Hummingbird DM. Ascent Capture Value {Document GUID} The Ascent Capture Value {Document GUID} is a new value that can be used for index fields and release values. This Ascent Capture value is a type of document ID that is unique across the central site and all remote sites that comprise an Ascent Capture installation.
Ascent® 7.5 Release Script for Hummingbird DM 6.0 Release Notes Versioning Options Ascent 7.5 Release Script for Hummingbird DM supports two methods for versioning documents: Version using Document Number Instead of the Document Name: This is a feature that allows you to version your documents using the Hummingbird DM document number. The document number is created by Hummingbird DM. This feature is available on the General Settings tab.
Ascent® 7.5 Release Script for Hummingbird DM 6.0 Release Notes Release to Records Management System Ascent 7.5 Release Script for Hummingbird DM copies document images, OCR full text files, PDF documents, eDocuments, and index values from Ascent Capture into your DM repository. Optionally, you can release documents into your Hummingbird Records Management system. For more information about releasing to Records Management, refer to the Help that is available with the Ascent 7.
Ascent® 7.5 Release Script for Hummingbird DM 6.0 Release Notes Image Support This release script supports the following file formats/compression formats: Multipage TIFF with Group 3, Group 3/2D, and Group 4 Compression Multipage TIFF with JPEG Compression Multipage TIFF — Uncompressed JPG with JPEG Compression Kofax PDF Adobe PDF from JPEG Adobe PDF from TIFF Kofax PDF Support With Ascent 7.
Ascent® 7.5 Release Script for Hummingbird DM 6.0 Release Notes Additional Information This section contains additional information about Ascent 7.5 Release Script for Hummingbird DM. Unsupported Ascent Capture Features Ascent 7.5 Release Script for Hummingbird DM does not support the following Ascent Capture feature. File Name Retention This release script does not support file name retention. Therefore, the original imported file name will not be retained and the default numeric name will be used.
Ascent® 7.5 Release Script for Hummingbird DM 6.0 Release Notes {Index Operator’s Station ID} Ascent Capture Values The Ascent Capture Value {Index Operator’s Station ID} has been deprecated, and replaced by {Validation Operator’s Station ID}. It is strongly recommended that you use {Validation Operator’s Station ID} instead. Context Menu Removed From the Folder Hierarchy In Ascent 7.
Ascent® 7.5 Release Script for Hummingbird DM 6.0 Release Notes Application and Document Type Fields When you are creating a user-defined folder for release, the Application and Document Type folder profile attributes must be set to “FOLDER,” which is the default choice. If you attempt to change this value, you will receive an error message at release and the value will be returned to “FOLDER.” Releasing to Records Management If you are releasing to Records Management via Ascent 7.
Ascent® 7.5 Release Script for Hummingbird DM 6.0 Release Notes DM Check Box Attributes Requires Numeric Values The Hummingbird DM release script allows you to establish links between DM index fields and Ascent Values. However, the DM check box data type only accepts numeric string values. You must use “1” for a checked value and any other numeric string value for an unchecked value (for example, “0” or “2”). Note The numeric values must be in quotation marks.
Ascent® 7.5 Release Script for Hummingbird DM 6.0 Release Notes X To create the ACFusion.INI file 1 From Windows Explorer, select Program Files | Ascent. 2 On the File menu, click New and then Text Document. 3 Rename the file to ACFusion.INI. 4 Right-click the ACFusion.INI file in the Ascent folder, and select “Open with” from the context menu. Use any text editor to edit this file. 5 Insert a section heading titled [Profile Display Names].
Ascent® 7.5 Release Script for Hummingbird DM 6.0 Release Notes Sharing Data Among Release Scripts The Ascent Capture Release Script Information Interchange feature is useful when more than one release script has been configured for a particular batch class and document class combination. The sharing of information is accomplished by allowing the release script to pass information to other release scripts.
Ascent® 7.5 Release Script for Hummingbird DM 6.0 Release Notes OCR Full Text Options To release OCR full text files, you must enable Ascent Capture OCR full text processing in your applicable document class and add the OCR Full Text module to your applicable batch class. For details about how OCR full text files and non-image files are released to the DM repository, refer to the Help available with Ascent 7.5 Release Script for Hummingbird DM (Help keyword: File format combinations).
Ascent® 7.5 Release Script for Hummingbird DM 6.0 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. For details about how Kofax PDF documents and non-image files are released to the DM repository, refer to the Help available with Ascent 7.5 Release Script for Hummingbird DM (Help keyword: File format combinations).
Ascent® 7.5 Release Script for Hummingbird DM 6.0 Release Notes Adobe Acrobat Capture Options Ascent 7.5 Release Script for Hummingbird DM supports Adobe Acrobat Capture. This section contains information related to using Adobe Acrobat Capture for your Adobe PDF documents. For additional details about creating Adobe PDF documents, refer to your Adobe Acrobat Capture documentation.
Ascent® 7.5 Release Script for Hummingbird DM 6.0 Release Notes For complete image conversion for Image Only page content, the Adobe Acrobat Capture workflow needs to be called “PDF Image Only” and contain at least three steps, in the following order: 1 Convert Image to PDF 2 Combine PDFs 3 Store File (PDF) Note When creating workflows, do not include manual steps such as Quick Fix Page, Review Document, and Zone Images.
Ascent® 7.5 Release Script for Hummingbird DM 6.0 Release Notes Installing the Release Script You can install Ascent 7.5 Release Script for Hummingbird DM on an Ascent Capture client workstation or standalone workstation. Important Note About Installation To install Ascent 7.5 Release Script for Hummingbird DM you must have Windows administrator privileges.
Ascent® 7.5 Release Script for Hummingbird DM 6.0 Release Notes Replacing a Previous Version of the Release Script Ascent 7.5 Release Script for Hummingbird DM does not support upgrading from previous versions. If you attempt to upgrade, you may receive the following error message: Error upgrading release script “Ascent 7.5 for Hummingbird DM 6.0” for batch class “” and document class “.
Ascent® 7.5 Release Script for Hummingbird DM 6.0 Release Notes Application Maintenance This section describes how to repair and remove Ascent 7.5 Release Script for Hummingbird DM. Users with full administrative privileges can: Install the release script Remove the release script (from Add or Remove Programs or Application Maintenance) Repair the release script (from Application Maintenance) Users with Power User privileges can repair the release script from Application Maintenance. Figure 1.
Ascent® 7.5 Release Script for Hummingbird DM 6.0 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.5 Release Script for Hummingbird DM 6.0 installation CD into your CD drive. 2 From your Windows task bar, select Start | Run, browse to the Hummingbird\DM6 folder on the CD, and run Setup.exe.
Ascent® 7.5 Release Script for Hummingbird DM 6.0 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.5 Release Script for Hummingbird DM 6.0 Release Notes Figure 3. DM Login Information Dialog Box The Library Name combo box lists the default primary library and all available remote and independent libraries. If this is the first time you are logging on to the Hummingbird DM release script, then this setting defaults to the primary library. Notice that the library name you choose will display in the title bar of the Ascent 7.5 Release Script for Hummingbird DM 6.
Ascent® 7.5 Release Script for Hummingbird DM 6.0 Release Notes Figure 4. Ascent 7.5 Release Script for Hummingbird DM 6.0 — Release Setup Dialog Box 8 24 Refer to the next section, Setting Up the Release Script, for information about the set up options. Kofax, Inc.
Ascent® 7.5 Release Script for Hummingbird DM 6.0 Release Notes Setting Up the Release Script The following sections describe the setup options available with the Ascent 7.5 Release Script for Hummingbird DM. Note For more details about the setup options, refer to the Help available from Ascent 7.5 Release Script for Hummingbird DM 6.0 — Release Setup dialog box. Document Settings Tab This tab allows you to select from a list of available DM profile attributes, and link Ascent Values to DM index fields.
Ascent® 7.5 Release Script for Hummingbird DM 6.0 Release Notes Folder Settings Tab This tab allows you to specify or create a DM folder location for your released documents. At release, the released documents will be linked to the selected folder. Figure 6. Folder Settings Tab 26 Kofax, Inc.
Ascent® 7.5 Release Script for Hummingbird DM 6.0 Release Notes Security Settings Tab The options on this tab allow you to specify which DM groups and users will have access to the released documents and/or user-defined folders. In addition, you can specify the profile access rights for the selected DM groups and users. Figure 7. Security Settings Tab Kofax, Inc.
Ascent® 7.5 Release Script for Hummingbird DM 6.0 Release Notes Image Format Tab This tab allows you to specify the desired image formats for releasing your images. You can specify a primary format and a secondary format. If Adobe PDF is selected as an image format, the PDF Settings on this tab will become available for selection. Figure 8. Image Format Tab 28 Kofax, Inc.
Ascent® 7.5 Release Script for Hummingbird DM 6.0 Release Notes General Settings Tab This tab allows you to specify a temporary storage location to be used at release time, and specify whether to skip the first page of each document at release. 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 scanned images of the separator sheets.
Ascent® 7.5 Release Script for Hummingbird DM 6.0 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 recommended actions for fixing the problems.
Ascent® 7.5 Release Script for Hummingbird DM 6.0 Release Notes Releasing Batches With Ascent 7.5 Release Script for Hummingbird DM, 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.5 Release Script for Hummingbird DM 6.0 Release Notes Known Problems This section contains information about known problems with Ascent 7.5 Release Script for Hummingbird DM. FOLDER_PROF Folder Profile This release script does not support specifying a folder profile type other than FOLDER_PROF. Note that if you attempt to use any other folder profile from the Profile drop-down list on the Folder Settings tab, it will create duplicate folder names for every document released in the batch.
Ascent® 7.5 Release Script for Hummingbird DM 6.0 Release Notes Error 1904. Module failed to register. HRESULT –2147467259. Contact your support personnel. Workaround: The error message is incorrect and can simply be ignored. Click the Ignore button and the release script will successfully install and register the release script. If you click the Abort button, the installation will end. If you click the Retry button, you will receive the above error message again.
Ascent® 7.5 Release Script for Hummingbird DM 6.0 Release Notes not displayed in the normal design view. This minor problem has been reported to Hummingbird and will likely be resolved in a future Hummingbird DM Patch. (SPR 00011020) If this presents a problem, your DM system administrator can use the DM Designer application to resolve the problem. To view the hidden profile attributes, click “Show Hidden Objects” from the Edit menu. Then, remove the duplicate “Billable” attribute and save the profile.
Ascent® 7.5 Release Script for Hummingbird DM 6.0 Release Notes Select a Version to Publish Dialog Box Displays During Release If you have enabled the “Publish new documents to the library” check box on the General Settings tab and release, the “Select a Version to Publish” dialog box will display as shown in Figure 13. This dialog box will display each time a document is to be published, and you will need to click the OK button each time this dialog box is displayed.
Ascent® 7.5 Release Script for Hummingbird DM 6.0 Release Notes {Release Error Script #1 (Hummingbird DM) [9530 The attachment “TXT” cannot be versioned for the document . (9530)} Workaround: None. The Hummingbird DM API does not allow versioning of documents with an OCR full text attachment. Possible Memory Leak When Releasing Documents When releasing a large number of documents to an existing folder, you may experience a possible memory leak.
Ascent® 7.5 Release Script for Hummingbird DM 6.0 Release Notes Multiple Release Problems The following sections describe a couple of known multiple release problems. Using Duplicate User Names If you attempt to run multiple DM release scripts from one workstation using different user names, the release script will use the login properties from the last logged in user.
Ascent® 7.5 Release Script for Hummingbird DM 6.0 Release Notes Appendix A – Data Type Conversion The tables in this appendix map Ascent Capture data types to Hummingbird DM 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.5 Release Script for Hummingbird DM 6.0 Release Notes Appendix B – 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.