WAN Twain Device Interface

Wide Area Network ( WAN ) Twain Device Interface Setup (TWAINWAN)

This article also applies to running the software through Terminal Server on a LAN

SCANNING AND IMAGES - TWAIN LAN AND WAN DEVICES

Compulink software utilizes TWAIN compliant devices to capture and transfer images/data to the various sections of the patient’s demographic screen or medical records. In most cases, the devices with a TWAIN data source file or “.ds” extension located in Windows “TWAIN_32” directory will enable Advantage software to acquire images from a TWAIN compliant device.

Due to the wide variety of devices and their associated drivers available on the market, it is impossible to guarantee which devices/peripherals will successfully work with Advantage software. Compulink recommends the use of peripherals that are tested and researched by our IT lab. Visit www.compulinkadvantage.com for details.

Wide-Area-Network: Clients utilizing Windows 2008 R2 or Windows 7 workstations will not able to utilize Compulink’s remote scanning solution due to security restrictions. Third-party remote scan solutions, such as RemoteScan (www.remote-scan.com) or TSSCAN (www.terminalworks.com), are recommended. Multi-page scanning is ONLY supported in wide-area-network environments with the use of third-party remote scanning solutions, regardless of operating system. Clients may also utilize various third-party solutions such as Paperport to export images as Multi-Page TIFF and use the import function in the Patient Demographic screen. Contact Compulink’s IT department for any additional details.

Requirements:

	The Host and Remote Locations must connect through an operational VPN
	Host Site must have a Windows 2003 Server Standard or Enterprise Edition Terminal Server. (NOTE: 2003 SBS Server Edition does not have terminal server capabilities.)
	Product Executable (i.e. EYEMD.EXE or EYECARE.EXE) dated 12/16/2005 (for 8.1) and 11/01/2004 (for 8.0) or later
	TWAINWAN.EXE and TWAINGET.EXE File Located in Advantage Product Directory
	Install your peripheral Locally using the installation page

Instructions:

The local workstation must have the same CBS environment variable name and value as the accessed session through Terminal Server or Citrix. The TWAINWAN.EXE software will use the local environment variable to create the correct naming for the data being transferred. CAUTION: The local workstation only needs the CBS variable. Do not add any other Advantage related variables.

The Terminal Server or Citrix environment for each User/Profile must have the environment variable TWAINWAN=Y. (variable name is TWAINWAN, variable value is Y) This variable can be added to the USER or SYSTEM environmental settings unless the server is using the TWAIN function locally. In that case only add this variable to the user variable.

Each local station at the remote sites will launch and leave open, minimized, the TWAINWAN.EXE at the startup. The TWAINWAN.EXE must be running directly from the server's mapped drive on the local station and not thru the session. Example: if X is the shared/mapped drive, then TWAINWAN.EXE would be launched during the Startup of the computer by a shortcut that points to X:\EYECARE\TWAINWAN.EXE. Compulink recommends adding this shortcut to the startup of the local workstation so it will launch automatically.

In the Terminal Server Session, the Device Specific (.DS) file path for the TWAIN device must be entered into workstation setup of the Compulink Advantage product. (example for insurance card reader: C:\Windows\twain_32\EdtCard\EDTCard.ds). All paths are automatically generated and stored in TWAINWAN.INI file located in C:\Windows sub-directory on the remote workstation's local hard drive. CAUTION: This file will be created automatically during the first launch of TWAINWAN.EXE. Should a device driver need to be changed the TWAINWAN.INI file must be deleted and recreated.

***** Do not use a TWAINWAN.EXE older than 7/18/2003 ******

Download TWAINWAN.EXE here Dated 7/18/2003 (Works with version 8.0)

For Version 8.1 or better download and replace the TWAINWAN.EXE and the TWAINGET.EXE and place in the product directory (\EYECARE or \EYEMD, etc.):

Download new TWAINWAN.EXE for 8.1 - Dated 11/01/2005 (Rename to TWAINWAN.EXE)

Download TWAINGET.EXE - (Rename to TWAINGET.EXE) Place in the product directory, i.e. \EYECARE or \EYEMD - This file and two DLLs should be automatically copied to the root of the local "C" drive of the workstation after it is launched the first time. If it does not, please manually place TWAINGET.EXE, CRDE2003.dll and ISP2003.dll in the root of the "C" of the local workstation.

Download TWAINGET with Executables dated 03/03/2006 or newer

Download TWAINWAN DLLs here - In case TWAINWAN or TWAINGET is crashing you may be missing the associated DLLs. Please make sure the following DLLs exist in the product directory without overwriting the existing DLLs.

Install your peripheral Locally using the installation page

Summary:

	Place TWAINWAN.EXE dated 7/18/2003 or newer in the product directory
	Map a drive to the shared product directory on the server at the remote workstation and place a shortcut in startup for TWAINWAN.EXE
	Remote client must have the same CBS ID (environment variable) as the Terminal Server session
	Add TWAINWAN=Y to the user or system variable of the session at the server
	Install your peripheral Locally using the installation page

Troubleshooting:

	Multi-page scanning over the WAN is not supported.
	Users must have WRITE and CHANGE rights to the C:\ and C:\Windows
	Windows Vista and Windows 7 may work if the server operating system is Windows 2003. Users must take ownership of the C drive on Windows 7 and Vista.
	Vista and 7s User Account Control (UAC) can keep the TWAINWAN.INI and the TWAINWGET.EXE from writing to the C:\ and C:\Windows folders.

	If you receive an error message “cannot open file” after the first scan, reduce the size/resolution of the scanned image. Images must be saved as Black/White 1bit or lowest possible resolution for images that need enhancements.
	Do not place the TWAINWAN=Y on the local workstation. This variable is only for the server's session.
	Be sure the TWAINWAN.EXE is launched and minimized at the local station.
	TWAINWAN.EXE shortcut path must be "mapped drive letter:\folder\TWAINWAN.EXE" - example: X:\EYEMD\TWAINWAN.EXE.