KnowledgeTree Hot Folders 1.1.1

From KnowledgeTree Document Management Made Simple

Jump to: navigation, search

This is a production-ready, maintenance release of KnowledgeTree Hot Folders 1.1.1

Contents

[edit]

Overview

KnowledgeTree Hot Folders for Windows is a simple, high-volume integration interface for third party applications, such as back-office document imaging workflow applications and fax servers that are capable of writing documents directly to a Windows® file share. 

Find out more about KnowledgeTree Hot Folders in the KnowledgeTree Client Tools User Guide. Note that 
KnowledgeTree Hot Folders replaces KnowledgeTree Document Workflow Integration (DWI) Service.


[edit]

Release Date

KnowledgeTree Hot Folders 1.1.1 - 24 June 2009

[edit]

Installation and Upgrades

SYSTEM REQUIREMENTS:

  • KnowledgeTree Commercial server - version 3.5.4a and above
  • Microsoft Windows® environment - XP SP3, Server 2003 32-bit, Vista 32-bit SP2
  • Microsoft .Net Framework version 2.0

Note: Currently, Server 2003 64-bit and Vista 64-bit are not supported.


PRE-REQUISITES:

  • Disable caching on the KnowledgeTree server.
  • If you are upgrading from KnowledgeTree Hot Folders version 1.0.0; then, please uninstall the older version through Add/Remove Programs, before installing KnowledgeTree Hot Folders 1.1.1

Note: Caching may be enabled and disabled through KnowledgeTree's Web interface, in DMS Administration - System Configuration.


[edit]

How to Install KnowledgeTree Hot Folders

  1. Download KnowledgeTree Hot Folders
  2. Click setup.exe to launch the KnowledgeTree Hot Folders Setup Wizard.
  3. During the installation, you will be required to enter the URL to your KnowledgeTree server, and your KnowledgeTree login details


[edit]

Known Issues

  • IWI-222: Certain characters prevent XML validation, causing upload to fail

XML requires that the following characters are replaced when used as field values in an XML:

& (Ampersand): &

< (Left angle bracket): <

> (Right angle bracket): >

" (Quotation mark): "

' (Apostrophe): &apos;

Example: <KT:Title>&ExampleTitle</KT:Title> should be <KT:Title>&ExampleTitle</KT:Title>).


  • IWI-292: Empty folders remain in the folder structure in the watchfolder and are not added to KnowledgeTree

This issue occurs only when the empty folder is a leaf folder. The workaround for uploading empty folders is to add a dummy file, __ktdummy.txt, to the empty leaf folder. The empty folder is uploaded, but not the dummy file. Note that for Advanced mode, an XML must be created for the dummy txt file.


  • IWI-293: On Windows 2003 Server 32-bit, folder upload fails when using Move instead of Copy to place folders into the watchfolder

Copying a folder structure to the watchfolder (using Ctrl-C or right click menu Copy option) allows successful upload, moving a folder structure to the watchfolder (using Ctrl-X or the right click Cut option) causes upload to fail. Related calls: IWI-372


  • IWI-365: KnowledgeTree Hot Folders Service stops automatically when the 'Watch Folder' is created on the Desktop

Defining the path to the KnowledgeTree Hot Folders 'watchfolder' as 'Desktop' stops KnowledgeTree Hot Folders from working, and the following error displays in the log file: 'The directory name C:\Documents and Settings\admin\Desktop\WF is invalid.' The workaround is to ensure that the watchfolder is placed in C:/ root. Related call: IWI-366


  • IWI-366: KnowledgeTree Hot Folders (watch, archive and failure) do not work when placed on the Desktop

This issue occurs on Microsoft Windows Server 2003, XP, and Visa. In these environments, only services that are running under the 'System account' are allowed to interact with the Desktop. For security reasons, KnowledgeTree Hot Folders does not run under this account, so its processing folders (watch, archive, failure) will not work when placed on the Desktop. Related call: IWI-365


  • IWI-368: When uploading a large number of files, some files fail to upload and are dropped in the failurefolder with the following system message: 'Upload error: Could not add files to the system. Please inspect the log file. DB Error: constraint violation'. The workaround is to move the affected files from the failurefolder to the watchfolder. Related call: IWI-364


  • IWI-372: On Windows 2003 Server 32-bit, when attempting to upload files to the KnowledgeTree Hot Folders 'watchfolder' using a 'move' action, the following error message displays: 'System.UnauthorizedAccessException: Access to the path is denied.' The workaround is to use the 'copy' action, not the 'move' action, to upload files to the watchfolder. Note that this issue has passed testing and does not occur in the following environments: Microsoft Windows Vista, Microsoft Windows XP. Related calls: IWI-203, IWI-293
[edit]

Defect Repairs

  • IWI-293: Folders not uploaded when a 'move' action is used instead of a copy action to get folders into the watchfolder

This issue is fixed on Microsoft Windows Vista and on Microsoft Windows XP. This issue still occurs on Microsoft Server 2003 (see Known Issues above). Related call: IWI-372


  • IWI-361: Unhandled exception when moving default folders to a non-existent directory.

If the folder cannot be found, the user may click through to the KnowledgeTree Hot Folders Settings dialog box where they can specify the relevant folder. Fixed. Closed.


  • IWI-372: System.UnauthorizedAccessException: Access to the path is denied' error when attempting to upload files using a 'move' method

This issue is fixed on Microsoft Windows Vista and on Microsoft Windows XP. This issue still occurs on Microsoft Server 2003 (see Known Issues above). Related call: IWI-293

[edit]

Documentation


Back to Main Release Notes

Retrieved from "http://wiki.knowledgetree.com/KnowledgeTree_Hot_Folders_1.1.1"
Personal tools