PDFKeeper 3.0.0: Release Notes

Product Release Information

Product: PDFKeeper
Release Number: 3.0.0
Release Date: 201x/mm/dd
Customer Support: For more information or support, please visit website or send an email to rffrasca@gmail.com

Introduction

This document contains the release notes for PDFKeeper version 3.0.0. The following sections describe the release in detail and provide late-breaking or other information that supplements the main documentation.

What's New?

  • This is a major release including feature replacements and enhancements; and fixes.
  • .NET Framework 4 Client Profile or Extended is now required.
  • Installation now uses Windows Installer.
  • User Guide has been replaced by a window-level help system.
  • Oracle Data Provider for .NET, Managed Driver is now required inplace of Oracle Data Access Components.
  • Information Properties Editor and folder watcher has been replaced by Document Capture.
  • Seemless conversion support is now provided in Document Capture for the XPS document type.
  • Conversion support is now provided in Document Capture for the HTML file type using wkhtmltopdf.
  • Sumatra PDF has been updated.
  • iTextSharp has been updated.
  • The source code for this release is available at website.
  • Improvements to the product's quality and reliability. See "Recent Changes" below for details.

Recent Changes

  • FIX 1247 Update links in source and documentation to new project site
  • FIX 1264 Using mouse scroll wheel following seach results in scrolling in Search Text combo box instead of list view
  • FIX 1272 Modify update check to use new project site for verification
  • ENHANCEMENT 1246 Target .NET Framework 4 Client Profile.Target .NET Framework 4.0 Client Profile when building application
  • ENHANCEMENT 1248 Migrate installation to Windows Installer
  • ENHANCEMENT 1249 Create window-level help system for application forms
  • ENHANCEMENT 1254 Migrate to ODP.NET, Managed Driver from unmanaged version
  • ENHANCEMENT 1255 Enable database connection pooling to improve performance
  • ENHANCEMENT 1256 Third-Party Software Update: Sumatra PDF
  • ENHANCEMENT 1257 Third-Party Software Update: iTextSharp
  • ENHANCEMENT 1258 Add XPS to PDF document conversion to Document Capture
  • ENHANCEMENT 1259 Add HTML to PDF document conversion to Document Capture
  • ENHANCEMENT 1261 Redesign About form
  • ENHANCEMENT 1262 Create "Document Capture"; a centralized, document intake process
  • ENHANCEMENT 1263 Add menu item for reporting new issue
  • ENHANCEMENT 1265 Set form font to SystemFonts.MessageBoxFont to improve appearance on Windows Vista and later

Upgrade Notes

Deprecated Components Information

Since PDFKeeper 2.0.0, the server-side components have been deprecated. If not upgrading a system that has only the server-side components from PDFKeeper 1.0.0 or 1.1.0 installed, please uninstall PDFKeeper from that system. From the server; remove the Document Loader scheduled task, Document Upload Folder, and delete the PDFKEEPER_UPLOAD environment variable. From each client, remove the shortcut to the Document Upload folder.

If used in a prior version, the Information Properties Editor Folder Watcher settings will be discarded as that functionality has been replaced by Document Capture.
If PDFKeeper was upgraded from version 2.7.0, the PDFKeeper folder in the My Documents folder is no longer used by PDFKeeper.
Database Changes
In PDFKeeper 1.0.0 and 1.1.0, the Oracle Text WORLD_LEXER was used to provide broad language support during PDF document indexing. However, a bug exists with this lexer in the Oracle Database 10g Express Edition, see the Known Problems and Workarounds below for details. As a result of this bug, starting with PDFKeeper 2.0.0, the BASIC_LEXER is now used. This change will only affect a database schema built in PDFKeeper 2.0.0 or later; an existing database schema will need to be altered if an ORA-03113 error is encountered while uploading documents or adding/updating Document Notes.
For more information on the BASIC_LEXER, including the languages supported, please refer to the Oracle Text 10g Release 2 (10.2) Documentation or Oracle Text 11g Release 1 (11.1) Documentation.

Known Problems and Workarounds

  • ORA-03113: end-of-file on communication channel following the upload of a PDF document and your database schema was built using the Database Setup included with PDFKeeper 1.0.0 or 1.1.0. Note, once this condition occurs, any subsequent insert, update, or delete will trigger this error.
    • CAUSE: PDFKeeper uses the Oracle Text WORLD_LEXER to provide broader language support during indexing of documents. This error is the result of a bug (5036380 worldlexer index creation can dump(drlwtkn)) with Oracle Database 10.2.0.1 (including Express Edition) that was fixed in a 10.2.0.3 patchset; however, patchsets are not available for Orace Database Express Edition.
    • WORKAROUND: Note, the steps below will switch from the WORLD_LEXER to the BASIC_LEXER. For more information on the BASIC_LEXER, including the languages supported, please refer to the Oracle Text 10g Release 2 (10.2) Documentation.
      1. Do not proceed until all users are out of PDFKeeper. In addition, it's highly recommended that you perform an Oracle Backup and back-up the Flash Recovery Area.
      2. On the system that has Oracle Server installed, log into Windows as the user that installed Oracle Server.
      3. Open Run SQL Command Line from Start | All Programs | Oracle Database 10G Express Edition
      4. Type: connect / as sysdba and then press Enter
      5. Type: drop index pdfkeeper.docs_idx; and then press Enter
      6. Type: exec ctx_ddl.drop_preference('ctxsys.pdfkeeper_lexer') and then press Enter
      7. Type: exec ctx_ddl.create_preference('ctxsys.pdfkeeper_lexer','basic_lexer') and then press Enter
      8. Type: exec ctx_ddl.set_attribute('ctxsys.pdfkeeper_lexer','printjoins','_-') and then press Enter
      9. Type: create index pdfkeeper.docs_idx on pdfkeeper.docs(doc_dummy) and then press Enter
      10. Type: indextype is ctxsys.context and then press Enter
      11. Type: parameters ('datastore ctxsys.pdfkeeper_multi and then press Enter
      12. Type: lexer ctxsys.pdfkeeper_lexer sync (on commit)'); and then press Enter
      13. Type: quit and then press Enter
Company Proprietary
Copyright © 2009-2013 Robert F. Frasca