Difference between revisions of "PTS Comms Client Installation"
Line 183: | Line 183: | ||
<li>Save the amended file, overwriting the existing one. On Windows 7 and newer you may get an access denied error when trying to save the file to its original location; save the amended file to your desktop first and then drag & drop back to the installation folder.</li> | <li>Save the amended file, overwriting the existing one. On Windows 7 and newer you may get an access denied error when trying to save the file to its original location; save the amended file to your desktop first and then drag & drop back to the installation folder.</li> | ||
<li><strong>Reboot the PC</strong> - this is mandatory.</li> | <li><strong>Reboot the PC</strong> - this is mandatory.</li> | ||
</ol> | </ol> | ||
=Configuring barcode scanners for use with PTS= | =Configuring barcode scanners for use with PTS= | ||
Barcode scanners are almost never in the correct mode for use with PTS out-of-the-box. If PTS Comms is installed and running but cannot find your barcode scanner, see the [[Barcode Scanner Configuration]] page for instructions on how to configure your scanner. | Barcode scanners are almost never in the correct mode for use with PTS out-of-the-box. If PTS Comms is installed and running but cannot find your barcode scanner, see the [[Barcode Scanner Configuration]] page for instructions on how to configure your scanner. |
Revision as of 08:26, 26 September 2022
PTS allows for tracking a prescriptions progress through the dispensing process using barcodes and scanners. Barcode scanners are connected to pharmacy PCs either directly or via a base station, and software installed on the PC (known as PTS Comms Client) interprets the barcode data and forwards it to the PTS server software for processing.
How do I know if PTS Comms is already installed and running?
This is not the silly question that it may seem. PTS Comms runs in the background and is automatically minimised to the taskbar notification area of your desktop. This is a deliberate design decision as the application rarely needs to be interacted with, however, it can sometimes lead to confusion around whether the application is running or not, especially as Windows will automatically hide the icon to reduce clutter.
The notification area is the space near the system clock where you can access running applications. If the icon is being hidden you can expose it by clicking on the "^" button. If you do not see the barcode icon here, the application is not running. Try to start the application manually by either rebooting the PC or double clicking the PTS Comms desktop icon. If neither of these options work, IT should be able to verify whether the application is installed, and proceed to install it for you using the information on this page if need be.
Downloading PTS Comms Client
The comms client software needs to be installed on any and all PCs that will be hosting a barcode scanner or base station.
Updating from a previous version
You should uninstall any previous versions of the PTS Comms Software from the PC before downloading and installing your update. This goes for major and minor updates equally.
Download Links
You will need to download the correct version of the PTS Comms Client for your PTS installation.
In PTS 5 you can find the version of PTS you have installed on the main login screen, or by clicking the "TMS Insight (Data Capture) Ltd" link at the top of any page to access the system information screen. In PTS 4, the version number is listed in the footer of the home page.
Find your version number in the list below to download the correct PTS Comms Client installer. x86 versions are available on request.
Note on version numbers
The PTS Comms Client software itself follows its own independent version numbering scheme and as such the application will self-report a version number that has no obvious relationship to the main PTS application version number. Use the table as your guide for choosing the correct Comms installer.
Installing the PTS Comms Client (PTS 5)
There are some settings that require your attention during installation. Skipping these steps will result in the comms software being unable to connect to the scanning service and you will have to start again.
Manual .msi installation
Installation will require admin access on the PC. Double click the .msi file to begin. You will shortly be prompted to review three settings:
- PTS Server Details
Enter the URL to your PTS application here. This is the same familiar URL used to access your main application in your web browser, and takes the format of http://ServerName/PTSWeb/.
This setting is absolutely mandatory - the application won't connect if you skip this step or enter the URL incorrectly. - Username and Password
PTS offers a means to use a barcode scan as a shortcut to certain system facilities, such as opening the booking in screen. If you intend to use these you'll need to ensure a valid username and password is provided with which it can log in to PTS. If the default username & password no longer work, you can change them for working credentials here. This can be completely ignored if you have no intention of using barcode shortcuts. - Non-PTS Barcodes
The software can attempt to detect when a non-PTS code is scanned and forward it on to another open application, such as your dispensing software. This reduces the need for multiple dedicated barcode scanners. This option is enabled by default but can be turned off here if you have any problems.
Silent .msi installation
The installer can be run silently by passing the value of parameters in the command string: e.g.:
msiexec /i "PTSCommsSetup64.msi" /qn PTSURL=http://MYPTSSERVER/PTSWEB/ PTSSENDKEYS=True WEBUSERID=BOOKIN WEBPASSWORD=Track1ng
If you need to install drivers in addition to the Datalogic and Zebra Drivers which are installed by default, then the command line can be modified to add the Newland &/or Voyager drivers (remove NewlandDrivers or VoyagerDrivers from the command line if not required):
msiexec /i "PTSCommsSetup64.msi" /qn PTSURL=http://MYPTSSERVER/PTSWEB/ PTSSENDKEYS=True WEBUSERID=BOOKIN WEBPASSWORD=Track1ng ADDLOCAL="MainExecutables,DatalogicDrivers,NewlandDrivers,VoyagerDrivers"
Typical vs. Complete
On the next page you'll be asked to specify typical, complete or custom setup type. Typical installs Datalogic and Zebra barcode scanner drivers, complete also installs Voyager drivers.
Installing the PTS Comms Client (PTS 4)
- Log on to the PC on which you want to install the software with an account that has local admin rights.
- In Control Panel uninstall any existing versions of the PTS Comms software. Reboot the PC.
- Download and extract the installer to the PC. Download link is below.
- Run setup.exe to begin the installation. Follow the instructions on-screen leaving all the default options as they are. The installer will detect if the .NET framework needs to be installed on the PC and install it if required. The USB COM drivers for Datalogic devices will also be installed as part of the installation process.
- Once the installation is complete navigate to the installation folder (usually C:\Program Files\TMS Insight (Data Capture) Ltd\PTS Communications Client) and locate the PTSComms.exe.config file. If you cannot locate the file in the directory, hit Alt, then click Tools > Folder Options > View and then untick "Hide extensions for known file types".
- Open PTSComms.exe.config in Notepad and locate the section that reads:
<setting name="WebServiceURL" serializeAs="String">
<value>http://CHRIS-SURFACE/PTSWEB/PTSCommsServer.asmx</value>
</setting>
- Amend the value to point to your PTS application. For example if your PTS Server was called 'MyPTSServer' the section should be changed to:
<setting name="WebServiceURL" serializeAs="String">
<value>http://MyPTSServer/PTSWEB/PTSCommsServer.asmx</value>
</setting> - Save the amended file, overwriting the existing one. On Windows 7 and newer you may get an access denied error when trying to save the file to its original location; save the amended file to your desktop first and then drag & drop back to the installation folder.
- Reboot the PC - this is mandatory.
Configuring barcode scanners for use with PTS
Barcode scanners are almost never in the correct mode for use with PTS out-of-the-box. If PTS Comms is installed and running but cannot find your barcode scanner, see the Barcode Scanner Configuration page for instructions on how to configure your scanner.