Troubleshooting ScripTouch for Epic
ScripTouch for Epic is a piece of software designed to allow ScripTouch Signature pads to work with Epic Hyperspace.
Installation
Installation has to be done with your Epic Hyperspace support representative. You will need to install the software on your Epic Hyperspace server. Microsoft .NET 3.5 is required and must be installed separately. For Hyperspace versions prior to 2017 you'll need to know the correct ProgId prior to engaging Epic. Hyperspace 2017 and up no longer require the ProgId to be manually entered.
Download Epic Hyperspace plugin
The ProgIds for ScripTouch for Epic are as follows:
| Hyperspace Version | ProgId |
|---|---|
| 2012 | ScriptelDevice.0 |
| 2014 | ScriptelDevice.1 |
| 2015 | ScriptelDevice.2 |
| 2016 | ScriptelDevice.3 |
| 2017 | ScriptelDevice.3(*) |
| Post-2017 | ScriptelDevice.5(*) |
(*)Typically automatically configured in this version of Epic
Debugging Remote Connections
Typically Hyperspace is run on a server and clients connect to that server to run the Hyperspace application. In cases like this it becomes necessary to forward signature pads to the remote server in order for them to be useful with Epic. There are various ways to accomplish this.
Citrix XenApp/XenDesktop
Citrix XenApp in versions 7.6 and higher as well as XenDesktop 7 and higher natively support USB redirection. Older versions are supported through the use of ScripTouch Remote.
| XenApp Version | Supported | Method |
|---|---|---|
| 7.8 | Yes | Native / ScripTouch Remote |
| 7.7 | Yes | Native / ScripTouch Remote |
| 7.6 | Yes | Native / ScripTouch Remote |
| 7.5 | Yes | ScripTouch Remote |
| 7.1 | Yes | ScripTouch Remote |
| 7.0 | Yes | ScripTouch Remote |
| 6.5 | Yes | ScripTouch Remote |
| 5.x | No | N/A |
| XenDesktop Version | Supported | Method |
|---|---|---|
| 7.8 | Yes | Native / ScripTouch Remote |
| 7.7 | Yes | Native / ScripTouch Remote |
| 7.6 | Yes | Native / ScripTouch Remote |
| 7.5 | Yes | Native / ScripTouch Remote |
| 7.1 | Yes | Native / ScripTouch Remote |
| 7.0 | Yes | Native / ScripTouch Remote |
| 5.x | No | N/A |
In the event you're using ScripTouch Remote you can use the Troubleshooting ScripTouch Remote on Windows guide to troubleshoot remote pad redirection. If you're using native Citrix redirection you can check your setup against the Using Citrix XenApp USB Forwarding guide.
Microsoft Remote Desktop
Microsoft Remote Desktop USB redirection is supported through the use of ScripTouch Remote. You can use the Troubleshooting ScripTouch Remote on Windows guide to troubleshoot issues with Microsoft RDP.
VMware Horizon View
VMware Horizon View natively supports USB redirection. You can use this VMware Guide to set up and troubleshoot Horizon View USB redirection issues.
VMware Horizon View 5.0+ supports USB redirection.
Wyse TCX
Wyse TCX natively supports USB redirection. You can use this Wyse Guide to troubleshoot Wyse TCX USB virtualization.
Creating Debug Logs
The ScripTouch for Epic plugin supports debugging in the event something goes wrong. You can turn on logging by doing the following on your Hyperspace server:
- Open the system Environment Variable editor as outlined in this guide.
- Under 'System variables' click the 'New...' button.
- For 'Variable name' put 'SCRIPTEL_DEBUG' and for 'Variable value' put '1' (case matters).
- Hit 'OK' then hit 'OK'.
- Restart Hyperspace.
Once the environment variable is in place and Hyperspace has been restarted the following files should be created when the Scriptel for Epic plugin is used:
- %TEMP%\scriptel-hyperspace_debug-log.txt
- %TEMP%\scriptel-debug-proscript-<pid>.log
These logs can be sent to Scriptel support to help debug problematic issues.
Create Dump File
In the case of more exotic issues with ScripTouch for Epic it may be necessary to create a dump file to send to Scriptel support. The dump file should be created at the point that the problematic event is occurring if at all possible. This can be done one of two ways described below. Dump files can be rather large, please contact Scriptel Support if you need assistance transmitting the file(s).
Create Dump File with Task Manager
If Hyperspace continues to run while the exceptional condition (freezing, hanging, slowness, etc) is present the easiest way to create a dump file is with Task Manager:
- Start Task Manager by hitting Ctrl - Alt - Delete and clicking "Task Manager".
- Find Epic Hyperspace in the Processes tab, right click and hit "Create Dump File".
- A dialog will appear containing the path to the created dump file, typically it will be in %TEMP%. Make note of the file location and name.
- Hit 'Windows' + R, type '%TEMP%' and hit 'OK'.
- A file browser will appear, find the file you noted earlier in this window and send this file to Scriptel support.
Create Dump File with Registry Settings
If Hyperspace is crashing (the window disappears, or a window appears that indicates Hyperspace has crashed) the easiest way to create a dump file is the following:
- Using the Registry Editor, create a key located at 'HKLM\SOFTWARE\Microsoft\Windows\Windows Error Reporting\LocalDumps'.
- Start Hyperspace and use it until it crashes.
- Hit 'Windows' + R, type '%LOCALAPPDATA%\CrashDumps', and hit 'OK'.
- Collect the dump file for Hyperspace in this location and send it to Scriptel support.
Microsoft documentation describing this feature is available here.
Pad is Disabled After Signing
A new feature added in ScripTouch for Epic 3.2.47 and higher automatically disables the signature pad, to disable the behavior see here.