The PC Integration API allows you to integrate your browser screens with PC applications. For example, you may have the need to call up your PC-based imaging or document management application to view an invoice, part image, etc., based on a user action in the browser screen. The PC Integration API also allows you to copy data to the PC's clipboard. Genie's STRPCCMD command support also makes use of the PC Integration API.
For obvious security reasons, the browser vendors have made it so that Web-based applications cannot call programs on the PC under normal security settings. This makes it challenging to integrate your browser-based screens with other applications in your environment. The PC Integration API solves this challenge by running the PC commands in either a Java applet (PC Integration Applet) or a separately installed PC program (PC Command Listener).
One of the following alternatives must be configured on the end user PC's before the PC Integration API can be used.
PC Integration Applet
The PC Integration applet runs in the Java Virtual Machine's browser plug-in on the end user's PC. The only current browsers that support the Java plug-in are Internet Explorer and Mozilla FireFox. Chrome and Edge do not support the Java plug-in.
Installing PC Java Plug-in and Verifying Version
As mentioned above, the Sun plug-in is required. The user can verify the version and install it if necessary at this URL:http://www.java.com
Click on the "Do I have Java?" hyperlink to test the version.
This brings up the verification page. If the latest version of Sun Java is installed, a "congratulations" message will appear.
If the latest Sun Java plug-in is not installed, a notification message will display. If this is the case, the user can click the Download Java Now button to get Java. Installation is automated and takes just a few minutes.
PC Command Listener
The PC Command Listener runs on any Windows Vista, 8, 7, or 10 PC.
Installing and Configuring the PC Command Listener on the PC
The PC Command Listener installer can be downloaded here. This is a standard Windows program installer that works in the typical way. The program is installed for all PC users and registers itself to run on Windows startup. The program runs in the System Tray.The tray icon has a context menu that can be used to start/stop the listener and to configure the port number.
PC Command Listener Command-line Installation
The MSI installation package can also be run from a command prompt or script using the Windows 'msiexec' command. When installing using 'msiexec' the configuration data can be passed on the command line using the --CONFIG parameter. The configuration will be written to the PC's program data directory, which is shared by all PC users. For example, to set the listen port to 9999 and disable notification messages:
Configuring the Server for the PC Command Listener
Since the default mode of operation for the PC Integration API is to use the Java applet, the configuration option pui["use pc listener"] and optionally pui["pc listener port"] must be set in order to use the Listener. Options to configure the PC Command Listener are also provided in the Genie Administrator. If specified, these will take precedence.
PC Command Listener on HTTPS (SSL) Servers
To enable a Rich Display session running on HTTPS to send commands to the Listener, the configuration option pui["pc listener mode"] must be set. Genie automatically detects the site is using HTTPS, so that option isn't necessary for Genie.