Professional Documents
Culture Documents
Synchronization
Between Hologic and Third-Party Applications
© 2019 Hologic, Inc. Printed in the USA. This manual was originally written in English.
Hologic, SecurView, MultiView and associated logos are trademarks and/or registered trademarks of Hologic, Inc., and/or its
subsidiaries in the United States and/or other countries. All other trademarks, registered trademarks, and product names are the
property of their respective owners.
This product may be protected by one or more U.S. or foreign patents as identified at www.Hologic.com/patents.
Application Synchronization 4.3 Installation and Service Manual
Table of Contents
Table of Contents
List of Tables
Chapter 1
Introduction
• About This Manual on page 1
• Document Conventions on page 2
• Terms and Definitions on page 3
Warning:
An instruction that, if not followed, can result in a hazardous condition.
Caution
An instruction that, if not followed, can result in damage to the system.
Important
An instruction provided to ensure correct results and optimal performance, or to clarify
limitations of the device.
Note
Information provided to clarify a particular step or procedure.
Chapter 2
Application Synchronization Description
Chapter 2
Note
Application Synchronization supports specific versions and releases of the
applications listed below. For more information, see Supported Applications on
page 51.
For more information regarding the configuration of specific application types, see
Application Types on page 69.
You can move the pointer over the icon to confirm the application is running. The
message will display ‘Hologic Application Synchronization’ with ‘Status: Started’ or
‘Status: Stopped’.
You can also right-click the icon to view the Application Synchronization shortcut menu
as shown in the table below.
Table 2: Application Synchronization Icon Shortcuts
About Displays the AS version and copyright information.
Connected Displays the list of connected applications within the AS
Applications Configuration Interface.
Configure… Displays the AS Configuration Interface main window.
Log Viewer… Displays the AS Log Viewer.
Start Starts Application Synchronization messaging.
Stop Stops Application Synchronization messaging.
Exit Exits Application Synchronization.
Chapter 3
Installing Application Synchronization
Chapter 3
Caution
You must record all configurations for the connected applications before
performing an Application Synchronization upgrade. Connected applications
settings are not migrated to the new install during an upgrade
For each application, refer to the specific application information in this installation
manual, and verify the application configuration information you will need to install this
software. For instance, if you are configuring a Hologic SharedFile Partner, you will need
the following information: Directory, Inbound File Name, Outbound File Name,
Encryption Type, and Encryption Key.
Table 3: Application Configurations for Connected Applications
Application Configuration
Note
Performing a SecurView backup is required only if SecurView DX is one of the
connected applications and Application Synchronization is installed on a
SecurView computer.
Note
Make sure you have recorded all connected application configurations before
uninstalling Application Synchronization. See Recording Application Configurations
on page 15.
If error message boxes are displayed during uninstall of the Application Synchronization
software, please take note of the errors and report them to Hologic Technical Support.
1. Log into Windows as Administrator.
2. On Windows 10, select Start > Settings > System > Apps & features.
3. Select Application Synchronization from the list and select Uninstall. After you
confirm, the InstallShield window appears.
4. Select Remove to remove all installed features. Follow the prompts to remove the
Application Synchronization software.
Note
If a dialog appears that states, ‘XXXXXX is being uninstalled. It is a proxy adapter
and requires the uninstall of a separate package’, select OK. Proxy adapters have
a separate installation package that will need to be uninstalled after completing
the Application Synchronization uninstall. For instructions, see Install/Uninstall
Separate Proxy Application on page 143.
Note
If Philips iSite PACS is one of the connected applications, the Philips iSite plug-in
must be uninstalled. To uninstall Philips iSite plug-in, see section Philips iSite
PACS on page 109.
5. Select Yes, I want to restart my computer now. Select Finish. The system will restart.
Note
If you are installing Application Synchronization on a non-Hologic provided
computer, ensure that at least 1GB of disk space is available on the C: drive before
performing the installation.
Note
Study List Manager(SLM) is automatically installed during the installation of
Application Synchronization. See Configuring Study List Manager (SLM) on page
129 for guidelines on SLM configuration.
Note
If Application Synchronization 4.3 is installed on a non-Hologic Windows 10
computer, it is necessary to set permissions for Windows user accounts other
than Administrator or SCR that may be used to configure or run Application
Synchronization. See Adding Users on a Windows 10 Computer on page 137 for
instructions.
Note
If the InstallShield Wizard does not automatically run, open Windows File
Explorer. Navigate to the disk drive, double-click setup.bat, then follow the
on-screen instructions.
7. In the Installation Components window, select the installation components that are
required for the site. When you are satisfied with the settings, select Next. The Start
Copying Files window appears.
Note
If a connected application with multiple versions available for install is selected, a
‘Select Version’ dialog will appear. Select the correct version to be installed and
select Next. Perform this instruction step for all dialogs of this type that appear
(e.g., Amicas Vision Series, PowerScribe/EWS, RadNet VDI, Dolbey).
Note
If you select Cancel in the Installation Components window to quit the
installation process, you may see an error message: "ABORTING: Failed to install
DLL file." Select OK to close this error message. You can restart the installation
process after waiting for about a minute.
8. In the Start Copying Files window, confirm the components being installed. When
you are satisfied with the settings, select Next.
The Setup Status window appears and installs the software.
Note
If a dialog appears stating ‘XXXX has been selected for installation. It is a proxy
adapter and requires the installation of a separate install package. Please
install the proxy adapter package from ‘C:\AppSyncInstaller\HologicASProxy\
XXXXInstallShield’ after completing this Application Synchronization
installation.’ select OK. Proxy adapters have a separate installation package that
will need to be installed after completing the Application Synchronization
installation. See Install/Uninstall Separate Proxy Application on page 143 for
instructions.
Note
If Philips iSite PACS is one of the connected applications, the Philips iSite plug-in
must be installed. To install Philips iSite plug-in, see section Philips iSite PACS on
page 109.
Note
Hologic.SecurView.AppSync.Synchronizer.exe is added under Allowed
programs and features in the Windows Allow Apps to Communicate through
Windows Firewall window.
Authorized dealers who have access to the Hologic extranet (The WIRE) should complete
this online report:
1. Navigate to https://thewire.hologic.com/installation-form to access the installation
report.
2. Fill out all required fields and select Submit.
Chapter 4
Configuring Application Synchronization
Chapter 4
Note
Application Synchronization messaging must be stopped to make configuration
changes.
Note
The SecurView application uses ports 4700 and 65000-65500, so do not use any of
those values as the listening port for Application Synchronization on a SecurView
Workstation. The default port for the MultiView application is 5102.
4.2.3 Licensing
The Licensing page allows you to obtain the request code and install the license file for
Application Synchronization. You do not need a license if only Hologic products are being
configured (for example, SecurView and/or MultiView).
Note
Application Synchronization can be used with non-Hologic TPAs without a
license for a 7-day trial period. Be sure to obtain a license within 7 days after
installation.
2. In the ‘This Computer’s Fingerprint’ section, select Copy to Clipboard and send the
computer’s fingerprint in an email to 3D@hologic.com. The email should have the
following information:
• Subject line titled App Sync License.
• The site name.
• The serial number on the Hologic License Certificate. The Hologic License Certificate
is provided to the customer at the time of purchase.
3. Access your email, retrieve the license.zip file, and save it to a desired location on the
computer.
4. Unzip the license.zip file and place the license key file on the computer at a desired
location.
5. Select Install License in the Licensing page, navigate to the license key file, and open it.
The license status changes to Any TPA.
3. In the ‘Select a Devices.hlx file’ dialog, navigate to the location of the configuration file to
be imported.
C:\ProgramData\Hologic\AppSync\Configuration
4. Select Open. The Import Configuration page displays the full path of the file to be
imported.
5. Select (Commit Import). A Save Successful message displays.
Note
Application Synchronization automatically creates a backup of the existing
configuration file before the imported file overwrites it.
3. Navigate to a location to save the file and select Save. All connected application
information is exported in the saved configuration file.
Note
The Connected Application Tester can receive request messages from the selected
connected application, however it does not have the ability to send
corresponding response messages.
Note
To access any other page of the Application Synchronization Configuration
Interface, select Stop Tester.
4. You can review the messages that are sent and received by the Connected Application
Tester in the Tester Log.
Note
To assist you in debugging configuration issues, unencrypted user name and
password information are shown in the Tester Log.
To navigate through the pages use the (Next), (Finish), (Previous), and
(Start) buttons, or select a tab to navigate to a specific page.
You can also edit connected applications using these pages.
Table 4: Add/Edit Application Pages
Type Select the application type and assign a unique Alias.
Comm Configure the communication properties of the selected application
type (e.g., serial, TCP/IP, shared file).
XML Mapping For the Hologic SharedFile Partner application type, configure
mapping of XML fields between a TPA XML format and Hologic’s
XML format.
Message Type Configure the Accepted Messages and Sent Messages.
OpenPatient Data Add and/or remove specific leading and/or trailing characters in the
Patient ID or Accession Number field of the OpenPatient message.
OpenPatient Filters Configure five study filtering parameters for the OpenPatient
message, to constrain the study information passed on to the
connected application, whether or not to pass on a Clear message,
and which Match Keys to pass on.
Misc Configure the Response Timeout (in seconds) and Request Delay (in
seconds), if applicable, for the connected application.
Finish Confirm the connected application settings, and complete the
connected application configuration.
4.3.2 Type
The Type page provides a field to enter a new Application Alias. The alias must be unique
(not already used by another connected application). The page also provides a list of
application types from which to select. The page will display a description after you select an
application type from the drop-down list.
Note
The next few examples regarding Add Application will feature the PowerScribe
bi-directional application type.
3. In the Application Alias field, enter the application alias and select (Next) or any of
the tabs.
Note
If the alias in the field is already in use, an error message will appear stating ‘This
name already exists. Please use another one’.
If all the validations are successful, the next or selected page will be displayed.
4.3.3 Comm
The Comm page allows you to configure the application communication properties (e.g.,
serial, TCP/IP, shared file, etc.) based on the application type communication method. The
Comm page content varies per application type. See Application Types on page 69 for the
Comm page definition for each supported application type.
1. In the XML Mapping window, select the ‘Use XML Template’ check box.
2. Enter the TPA XML file format in the text box. There are three ways to do this:
• If a mapping (template) was saved previously for the connected application, it will
be read from Devices.hlx and loaded to the text box automatically, or
• Select Import and navigate to the sample .xml file (Import is the preferred method
for initial loading), or
• Manually type or copy and paste the TPA’s XML file format.
3. Double-click the value within the XML tag. The <Select One> drop-down menu appears.
Important
If you select anywhere outside the value, an error occurs and you must re-import
the XML file.
5. UpdatePatientState Status Values. By default the values used in the mapped Status tag
to indicate an inbound UpdatePatientState message are Complete, Dictated or Finished
(case insensitive matching). If the TPA uses different values in the mapped Status tag to
indicate UpdatePatientState, add to or replace the default values as needed, comma
delimited.
6. Use Status Values to Identify OpenPatient. Select this check box only if the TPA also
uses values in the mapped Status tag to identify OpenPatient messages. Do not select this
check box if the TPA does not include the mapped Status tag in OpenPatient messages.
7. OpenPatient Status Values. If Use Status Values to Identify OpenPatient is checked, add
comma delimited values that the TPA uses in the mapped Status tag to indicate an
inbound OpenPatient message.
8. Ignore Other Status Values. Select this check box if the TPA may send other values in
the mapped Status tag (such as Paused, Aborted, Deleted) that should not be mapped to
UpdatePatientState (or OpenPatient if Use Status Values to Select OpenPatient is
checked).
9. Select Check. The updated XML template is checked for conformity. If there is a problem
with the XML syntax, an error message alerts you to what needs to be addressed.
3. Enter each TPA XML file format in the appropriate text box. There are three ways to do
this:
• If mappings (templates) were saved previously for the connected application, they
will be read from Devices.hlx and loaded to the text boxes automatically, or
• Select Import and navigate to the sample .xml file (Import is the preferred method
for initial loading), or
• Manually type or copy and paste the TPA’s XML file format.
4. Double-click the value within the XML tag. The <Select One> drop-down menu appears.
Important
If you select anywhere outside the value, an error occurs and you must re-import
the XML file.
5. Select a mapping for each value in the Inbound and Outbound templates.
• No Match. Use this option when there is no matching tag in the Hologic XML, and
the TPA does not require a value in XML files that it reads. The value will be
replaced with an empty string.
• Pass Through. Use this option when there is no matching tag in the Hologix XML,
and the TPA requires the tag to be present in XML files that it reads, with the value
included in the template. For outbound UpdatePatientState, the tag that identifies the
message as UpdatePatientState must be mapped as Pass Through.
• Status. Use this option to identify the tag used to indicate an inbound
UpdatePatientState (or OpenPatient) message.
The additional mapping options for the Inbound template are Patient ID, Accession
Number, Study Instance UID, Study ID.
The additional mapping options for the Outbound template are based on the
OpenPatient Fields selected on the Comm page.
6. UpdatePatientState Status Values (Inbound template only). By default the values used
in the mapped Status tag to indicate an inbound UpdatePatientState message are
Complete, Dictated or Finished (case insensitive matching). If the TPA uses different
values in the mapped Status tag to indicate UpdatePatientState, add to or replace the
default values as needed, comma delimited.
7. Use Status Values to Identify OpenPatient (Inbound template only). Select this check
box only if the TPA also uses values in the mapped Status tag to identify OpenPatient
messages. Do not select this check box if the TPA does not include the mapped Status tag
in OpenPatient messages.
8. OpenPatient Status Values (Inbound template only). If Use Status Values to Identify
OpenPatient is checked, add comma delimited values that the TPA uses in the mapped
Status tag to indicate an inbound OpenPatient message.
9. Ignore Other Status Values (Inbound template only). Select this check box if the TPA
may send other values in the mapped Status tag (such as Paused, Aborted, Deleted) that
should not be mapped to UpdatePatientState (or OpenPatient if Use Status Values to
Select OpenPatient is checked).
10. Select Check for the Inbound template, then for the Outbound template. Each updated
XML template is checked for conformity. If there is a problem with the XML syntax, an
error message alerts you to what needs to be addressed.
Note
The next few examples will feature the PowerScribe bi-directional application
type.
The Message Type page contains two groups: Accepted Messages and Sent Messages.
• Accepted Messages. The messages accepted by the application.
• Sent Messages. The messages that the application can send.
Depending on the selected application type, the check boxes available in each group will vary
(see table Partner Interfaces on page 59).
Within the Accepted Messages group, select one of the two OpenPatient message options
that are enabled only when OpenPatient is checked:
• Auto and Manual (default): Application Synchronization will send all received
OpenPatient messages to this connected application, or
• Manual Only: Application Synchronization will send only OpenPatient messages
received from SecurView that were triggered using a manual method to this connected
application.
1. Select (Next) from the previous page or select the Message Type tab. The Message
Type page appears.
2. In the Message Definitions area, verify the messages accepted by or that can be sent by
the selected application type. At least one check box must be checked in order to proceed
to the next or another page. After confirming that the messages used in this instance are
checked, select (Next) or any of the tabs.
Note
When a Hologic product and a non-Hologic TPA are the connected applications,
configure this page as needed for the non-Hologic connected application. This
page is not available for the SecurView application type. However, this page is
available for the MultiView application type, to be used only if SecurView, and
MultiView are the connected applications and there is a difference in Patient ID
or Accession Number values between them.
The OpenPatient Data page contains the settings that allow you to modify the value of the
Patient ID or the Accession Number field in the OpenPatient messages passed to and from
the connected application being configured. Make changes on this page only if the values do
not match. For instance, the values of this connected application may always have the same
specific leading or trailing characters that another connected application does not (e.g.,
B12345 vs. 12345).
Note
If the leading and/or trailing characters differ in value or length from one patient
to another (e.g. sometimes three leading zeros, sometimes four), this
configuration option will not resolve the issue.
1. Select (Next) from the Message Type page or select the OpenPatient Data tab. The
OpenPatient Data page appears.
2. In the Data Field drop-down list, select Accession Number or Patient ID. Enter leading
characters to be removed or added. Enter trailing characters to be removed or added.
3. In the Sample CA Value field, enter a sample value known to the connected application
to check your work. The corresponding value known to the SecurView or MultiView
application should be displayed.
1. Select (Next) from the OpenPatient Data page or select the OpenPatient Filters tab.
The OpenPatient Filters page appears.
2. Review the ‘Configure OpenPatient Study Filter’ default settings and make changes if
necessary. For example, if the connected application expects only one study, uncheck
Accept More Than One Study. To prevent Read or Old studies from being sent to the
connected application, select Accept Only Unread Studies. If only Unread studies are
being sent, in If No Unread Studies Are Available select whether any studies should be
sent if only Read or Old studies are available (None, One Read, All Read).
3. Review the ‘Configure OpenPatient Clear Message’ setting. The default setting should be
sufficient.
4. Review the ‘Configure OpenPatient Match Keys’ settings. The default settings should be
sufficient unless there is a conflict with one of the default match keys.
Note
If more than one connected application is sending OpenPatient messages to this
connected application, before unchecking one of the default match keys, make
sure that all sending applications provide at least one alternate match key that is
still checked.
4.3.8 Misc
If any of the Accepted Messages check boxes are checked on the Message Type page, the
Misc (miscellaneous) tab will be present. The Misc page allows you to configure an
application response timeout and request delay.
If the application being configured cannot respond to a message then the Response Timeout
(Sec) field will be read-only. If the application being configured does respond, enter the
number of seconds to wait for a response before reporting failure. The default is 5 seconds.
The Request Delay (Sec) drop-down list allows you to delay distributing a message received
from the application being configured by up to 10 seconds. The default is Disabled, which
means all messages are sent immediately.
To configure a response timeout and request a delay:
1. Select (Next) from the previous page or select the Misc tab. The Misc page appears.
4.3.9 Finish
The Finish page displays a confirmation prompt to confirm the settings for the connected
application. Confirm the information, and then select (Save). You must be on the Finish
page to save changes and return to the Application List. You may select (Cancel) and
return to the Application List from any page. You can also select (Previous) to edit any of
the previous settings or select any tab.
1. Select a connected application in the Connected Application List and then select
(View Connected Application Summary). A connected application configuration
summary appears.
2. Select (next arrow) to move through the summary. The summary displays the
following information for the connected application: Application Definition,
Communications Definition, Message Definitions, OpenPatient Data, OpenPatient Filters,
and Misc.
To edit a connected application:
1. Select a connected application in the Connected Application List and then select
3. You can search for specific text, filter the log by log level or date range, clear the log
directory, wrap text so that the each complete entry is displayed on multiple lines if it is
longer than one line, or enable tailing so that the Log Viewer page is updated
dynamically as new entries are added.
other than SecurView or MultiView if necessary using the instructions in Installing Application
Synchronization on page 17.
Note
Third-party application versions listed are the earliest versions of software
validated by Hologic, usually the earliest version of the third-party application
that supported the interface.
If you have questions regarding support of a particular third-party application, call Hologic
Technical Support.
Note
Contact Hologic Technical Support to check on a third-party application that is
not shown above.
Chapter 5
Application Types
Chapter 5
Third-party vendors may choose to implement the Hologic Proxy Partner interface. This
interface is a command line driven proxy application provided by Hologic that uses the AS
Adapter. These vendors are referred to as Hologic Proxy Partners.
See TCP/IP Communications Page on page 68 for instructions regarding the Hologic Proxy
Partner Communications page, which is a TCP/IP Communications page.
Any partner that has been validated by Hologic prior to this document’s release will be
listed. Customers may use new partners of this application type as soon as the partner
completes validation with Hologic. The application type default settings support all message
types of the Hologic Proxy Partner interface; however some partners may not choose to
implement all message types. The sent messages configuration may need to be adjusted. See
table Partner Interfaces on page 59 for more information.
The customer is responsible for arranging for a TPA technical representative (or on-site IT
person) to be available during the integration set up with the TPA. This representative must
install and configure the TPA software.
The HologicASProxy intermediary program is required. This program is included on the
Application Synchronization installation disk. This executable must be installed on the same
computer where the TPA software is installed.
For HologicASProxy installation instructions, see Install/Uninstall Separate Proxy Application
on page 143 Use the installer within the HologicASProxyInstallShield folder.
After HologicASProxy is installed, the TPA representative will be able to configure the TPA
to communicate with the HologicASProxy application. The HologicASProxy application
communicates directly with Application Synchronization.
See Configuring and Troubleshooting Proxy Applications on page 145 for instructions on how to
reconfigure and troubleshoot Hologic Proxy Partner applications.
Note
The SecurView application uses ports 4700 and 65000-65500, so those values
should never be used as the listening port for a connected application that is
running on a SecurView Workstation.
Note
The default listening port for the MultiView application is 5102.
Select (Ping IP Address) to test the IP address. A failure will result in a red error
message (Failed to ping the IP (X.X.X.X).) and a success will result in a blue message
(Successfully pinged the IP (X.X.X.X).).
There are a few items to keep in mind when installing Agfa TalkStation as a connected
application:
• Only one instance of Agfa TalkStation can be configured per Application
Synchronization instance.
• Agfa TalkStation Client can be installed on the SecurView workstation or a separate
computer.
• Application Synchronization must be installed on the same computer where the Agfa
TalkStation Client is running.
• The Server Name to enter on the Comm page is the name of the device on which
Agfa TalkStation Server is installed.
• The Agfa technical representative (or on-site IT person) will provide the value to
configure.
• There is no default setting for Server Name on the Comm page.
Note
The Amicas representative must install and configure Amicas Vision Series PACS
client software on a separate computer.
Note
When installing FusionDictate on a SecurView workstation, set the Windows SCR
user with permission to access all files/folders of FusionDictate. (e.g., Program
Files, hidden program data folders).
There are a few items to keep in mind when installing G2 Speech MediSpeech as a connected
application:
• Only one instance of G2 Speech MediSpeech can be configured per Application
Synchronization instance.
• The G2 Speech MediSpeech interface can be installed on the SecurView workstation
or a separate computer.
• Application Synchronization must be installed on the same computer where G2
Speech MediSpeech is running.
# name
com.ge.med.platinum.extend.extend1.name=HologicAppsync
com.ge.med.platinum.extend.extend1.worklist.numberOfUIComponents=
1
com.ge.med.platinum.extend.extend1.worklist.component1.enable=tru
e
Note
The path is dependent on where Application Synchronization is installed. Double
backslash is required in the path.
com.ge.med.platinum.extend.extend1.worklist.component1.command="c
:\\Progra~2\\Hologic\\HologicAppSync\\Synchronizer\\Hologic.Secur
View.AppSync.ConnectedApplications.AppGePacsWcfClient.exe" <PATID>
• When run on the SecurView workstation, the GE Centricity RIS-IC web interface
displays on the SecurView additional monitor using Internet Explorer. If SecurView
is using a newer version of Internet Explorer than is supported by Centricity (e.g.,
IE 11.0), run Internet Explorer in Compatibility View.
• Sending the Login and Logout messages from SecurView to GE Centricity RIS-IC is
mandatory for OpenPatient to work correctly from SecurView to Centricity RIS-IC.
In the Application Synchronization configuration for the GE Centricity RIS-IC
connected application, on the Message Type page make sure Login and Logout in the
Accepted Messages section are checked. On the SecurView make sure each user has
the user preference 'On login and logout' checked in the User Profile tab.
• Sending a Login mesage to Centricity RIS-IC no longer opens the Centricity RIS-IC
main menu. It only sets the user context. Sending a Logout message to Centricity
RIS-IC performs a Logout to release the user context.
Note
A RIS-driven workflow is no longer possible with Centricity RIS-IC 10.7 and
later. Centricity RIS-IC now requires Application Synchronization to initialize
listening for OpenPatient messages (RIS-IC context change events) after each user
has logged into Centricity RIS-IC. Application Synchronization does not have a
way to receive an indication that a user has logged into Centricity RIS-IC.
4. Select (Internet), and then select Custom Level. The Security Settings window
appears.
5. Make the following settings changes:
a. Download signed ActiveX controls: Enable
b. Download unsigned ActiveX controls: Enable
c. Initialize and script ActiveX controls not marked as safe: Enable
d. Use Pop-up Blocker: Disable
8. In the Security tab, select (Local intranet), and then select Custom Level. Repeat
steps 5, 6, and 7.
9. In the Internet Options window, select OK.
10. Log into the SecurView application as a radiologist user.
11. Trigger an open patient event on SecurView by opening a patient that is available in the
GE Centricity RIS-IC database.
• If the user preference to synchronize open patient automatically is enabled, the
configured Centricity RIS-IC Module for the same patient displays on the screen.
• If an Internet Explorer ‘Information Bar’ message appears, select the Do not show
this message again check box, and select OK. A message may appear that states that
your session has timed out. Select OK.
12. Close the Centricity RIS-IC Module.
13. Trigger another open patient event on SecurView by opening another patient that is also
available in the GE Centricity RIS-IC database.
GE Centricity RIS-IC Precision Reporting
It is not possible to launch Precision Reporting via Application Synchronization.
Note
On the Application Messages Page for Imagecast, accepting the Login and Logout
messages will not be selected by default, because Login launches the Imagecast
main menu. The OpenPatient message authenticates the user, so most users do
not need to open the Imagecast main menu. Do not enable acceptance of these
messages, and do not enable the SecurView user preference for automatic
synchronization of login and logout, unless the customer wants to launch the
Imagecast main menu upon SecurView login.
4. Select (Internet), and then select Custom Level. The Security Settings window
appears.
5. Make the following settings changes:
a. Download signed ActiveX controls: Enable
b. Download unsigned ActiveX controls: Enable
c. Initialize and script ActiveX controls not marked as safe: Enable
d. Use Pop-up Blocker: Disable
6. Select OK to close the Security Settings window. A Warning window appears.
7. In the Warning window, select Yes.
8. In the Security tab, select (Local intranet), and then select Custom Level. Repeat
steps 5, 6, and 7.
9. In the Internet Options window, select OK.
10. Log into the SecurView application as a radiologist user.
11. Trigger an open patient event on SecurView by opening a patient that is available in the
GE/IDX Imagecast database.
• If the user preference to synchronize open patient automatically is enabled, the
configured Imagecast Module for the same patient displays on the screen.
• If an Internet Explorer ‘Information Bar’ message appears, select the Do not show
this message again check box, and select OK. A message may appear that states that
your session has timed out. Select OK.
12. Close the Imagecast Module.
13. Trigger another open patient event on SecurView by opening another patient that is also
available in the GE/IDX Imagecast database.
Note
The Comm Port should be set to the port to which the null serial cable is
connected.
The default behavior is to send Accession Number only. If Lanier requires Patient ID only or
both Accession Number and Patient ID, select the appropriate option in the ‘Data String’
field.
The Lanier Serial interface as defined by MedQuist expects the Accession Number and
Patient ID fields to be concatenated with no delimiter when both are sent. The expected
length of each field must be configured in the Lanier device. Therefore, sending both values
in either order can be selected only if each value is of a fixed length for the customer site.
MedQuist DocQvoice Workstation
DocQvoice can be configured by selecting the Lanier Serial application type during
Application Synchronization installation. Follow the instructions for the Lanier Serial
configuration to enable synchronization with DocQvoice.
DocQvoice can be run on the SecurView workstation or a separate computer. A MedQuist
technical representative must install DocQvoice. When DocQvoice is run on the same
computer as Application Synchronization, a serial loop back device must be used, such as a
USB cable that has two Serial ports on it that comes with a small application to install. You
may also need a null modem adapter and a gender changer. Connect the two serial ports
(COM3 and COM4) from the USB Y adapter 1 (COM3) to a Null Modem to a gender changer
to USB Y adapter 2 (COM4). Be sure to set the Comm Port correctly in the Application
Synchronization configuration. Otherwise use the default configuration settings (e.g. Data
String = Accession Num Only).
5.4.21 MagView
There are a few items to keep in mind when installing MagView as a connected application:
• Hologic SharedFile Partner is the preferred application type to use with MagView.
• The MagView application can be installed on the SecurView workstation or a separate
computer.
• MagView uses a TCP/IP interface to communicate with Application Synchronization. See
TCP/IP Communications Page on page 68 for the TCP/IP Communications page
instructions.
• If the MagView Client is deployed through Citrix or another thin client system, the
MagView side of the Synchronization will not function.
• When configuring a MagView application, the application Alias must be ‘MagView’.
• MagView has a maximum of 15 characters for Patient ID and 20 characters for Accession
Number. If a site exceeds this limit, a workaround must be performed by MagView to
create larger Patient ID and Accession number fields. This action requires additional
configuration in the MagView software to create a custom primary field at runtime.
• MagView always has the Patient ID and Accession Number in upper case characters. If
these fields on the Hologic connected application have lower case characters, when
Application Synchronization sends an OpenPatient message it will not correspond on the
Hologic side. The only workaround is to have the site use only upper case characters for
Patient ID and Accession Number.
5.4.22 MammaSoft
The customer is responsible for arranging for a MammaSoft technical representative (or
on-site IT person) to be available during the integration set up with MammaSoft. This
representative must install and configure the MammaSoft Digital Screening software.
There are a few items to keep in mind when installing MammaSoft Digital Screening as a
connected application:
• Only one instance of MammaSoft can be configured per Application Synchronization
instance.
• A ‘MammaSoft Proxy’ intermediary application must be installed on the computer
where the MammaSoft Digital Screening software is installed. This program is on the
Application Synchronization installation disk. For installation instructions, see
Install/Uninstall Separate Proxy Application on page 143. Use the installer within the
MammaSoftInstallShield folder.
• After MammaSoft Proxy is installed, the MammaSoft representative will be able to
configure the MammaSoft Digital Screening application to communicate with the
MammaSoft Proxy application. The MammaSoft Proxy application is what will
communicate directly with Application Synchronization.
• The MammaSoft Proxy application uses a TCP/IP interface to communicate with
Application Synchronization. See TCP/IP Communications Page on page 68 for the
TCP/IP Communications page instructions.
• To reconfigure and troubleshoot proxy applications, see Configuring and
Troubleshooting Proxy Applications on page 145.
• The MammaSoft representative must load Java 1.5 on the computer where
MammaSoft is being installed. This software can be found on the Oracle website.
Note
Perform these steps only for SpeechQ V1.2. These steps are not necessary for
SpeechQ V1.3.
10. If SpeechQ shuts down each time a study is closed or saved in SpeechQ, check the
AlwaysHideByPacs setting in ReportStation.exe.ini.
a. Open and edit the file C:\ProgramFiles\SpeechQ Client\ReportStation.exe.ini
b. Confirm AlwaysHideByPacs=1
Note
ReportStationPath is the path to Reportstation.exe that is configured on install
and may be different. For example:
Note
The IntegrationReportStationPort value may be 5100.
5.4.27 MRS
There are a few items to keep in mind when installing MRS as a connected application:
• The MRS application can be installed on the SecurView workstation or a separate
computer.
• To integrate with Application Synchronization, the site must have at least the
minimum MRS software version 6.6.46, or MRS Aspen Breast.
• MRS uses a TCP/IP interface to communicate with Application Synchronization. See
TCP/IP Communications Page on page 68 for the TCP/IP Communications page
instructions.
• A MRS technical representative must install and configure the MRS client software.
• If the site wishes to install the MRS client software on the SecurView workstation,
then allow the MRS representative to install the client software under the Windows
Customer user.
• After the MRS software is installed and configured, perform the following steps to
ensure that the MRS application starts up under the Windows user "username"
where MRS will be used upon system boot.
To ensure that the MRS application starts up automatically:
1. Open Windows File Explorer and enter the following in the search bar:
C:\Users\<user>\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup\
2. On the desktop, locate and copy the MRS shortcut link.
3. Paste this link into the Startup folder.
• Upon receiving an Open Patient message, MultiView checks the following fields,
using case-sensitive matching: Patient ID, Study Instance UID, and Accession
Number. MultiView can be configured to control which of these fields are used for
matching from Match Keys on the MultiView Application Synchronization
configuration page.
• MultiView to MultiView synchronization is not supported in Application
Synchronization.
To configure MultiView with Application Synchronization:
1. In the MultiView application, navigate to Tools > Options > Application
Synchronization. The Application Synchronization page appears.
2. In the Match Keys section of the Application Synchronization page, select the Match Keys
that you want to configure. The Match Keys are Patient ID, Study Instance UID, and
Accession Number. The selected fields will be used for matching when received in
OpenPatient messages, and will be the fields included in sent OpenPatient messages.
Note
At least one Match Key must be selected.
3. Select the Manual Sync Open Patient check box to enable manual synchronization with
connected applications when opening a patient on MultiView. If this box is checked,
press the Manual Sync button on MultiView to send an Open Patient request to
Application Synchronization.
4. The Manual Sync Open Patient check box is unchecked by default. If Application
Synchronization is configured on MultiView, opening a study from the MultiView Study
List triggers an Open Patient request.
5.4.30 PenRad
The customer is responsible for arranging for a PenRad technical representative (or on-site IT
person) to be available during the integration set up with PenRad. This representative must
install and configure the PenRad client software, either on the SecurView workstation or a
separate computer.
The PenRad application sends and receives messages with Application Synchronization by
placing and reading XML files in a mutually shared directory (folder). PenRad provided the
XML file format to Hologic. PenRad can be configured to support the Hologic SharedFile
Partner XML format. The mutually shared directory must be created manually if it does not
already exist. To test the Application Synchronization configuration for sending messages to
PenRad without PenRad installed, just confirm that XML files are being created in the
configured directory.
Regardless of which PenRad software version the customer has, PenRad must install a
special software patch in order for the PenRad application to be able to send OpenPatient
messages to Application Synchronization.
In order for a Philips iSite PACS Radiology Client to trigger OpenPatient messages to
Application Synchronization, a plug-in must be added to the Philips iSite application and
configured to communicate with Application Synchronization.
Insert the Application Synchronization Installation DVD to the computer where the Philips
iSite PACS Radiology Client is running. Philips iSite plug-in files are located under
AppSyncFullInstallation\AppSyncInstaller\HologicASProxy\PhilipsISitePlugin.
Note
To avoid timeout issues, Nuance recommends a daily restart of any workstation
running PACSBridge. This action may not be necessary as timeout issues are rare.
However, if timeout issues occur, inform the customer that Nuance recommends
a daily reboot of the workstation, and direct them to the Nuance customer help
desk if they have additional questions.
5.4.32.1 PowerScribe
A PowerScribe client will accept messages from only one source (e.g. SecurView or a PACS
workstation, but not both). The customer also must have PACSBridge 4.7 1009 installed on a
server. If the customer has an earlier version of PACSBridge, or does not have PACSBridge,
do not proceed until the correct version is installed.
The PowerScribe application receives messages from Application Synchronization by reading
XML files from a mutually shared directory (folder). Nuance/Dictaphone provided the XML
file format to Hologic. The mutually shared directory must be created manually if it does not
already exist. To test the Application Synchronization configuration without PowerScribe
installed, just confirm the XML files are being created in the configured directory.
5.4.32.2 EWS
The Enterprise Workstation (EWS) can be configured by selecting the PowerScribe or EWS
application type during Application Synchronization installation. The customer must have
PACSBridge 6.5.1.0 installed on a server. If the customer has an earlier version of
PACSBridge, or does not have PACSBridge, do not proceed until the correct version is
installed. The Enterprise Workstation does not have the same flexibility for changing the
Encryption key as the rest of the Nuance product line does. The Encryption key for
Enterprise Workstation should always be set to FFF-Dictaphone. See table PowerScribe or
EWS Communications Page Default Settings on page 112 for additional information on
configuring the PowerScribe or EWS application type.
Note
EWS requires Microsoft Word. It is the Nuance representative’s responsibility to
install all third-party software required for their operation. Ensure that the MS
Toolbar does not start up automatically.
Note
Set the Directory field to C:\RadWhere\.
Note
RadWhere supports only receiving Login, Logout, and OpenPatient messages.
Update the Application Messages page for the PowerScribe bi-directional
connected application accordingly by clearing the OpenPatient check box under
’Sent Messages’.
Note
Mode should not include FieldName.
• If RadNet VDI is running on SecurView, the Cerner RadNet VDI client software
requires write access to the HKLM\Software\Cerner registry key and its sub-keys.
The Cerner technical representative will enable write access to that registry key when
installing the Cerner RadNet VDI client software.
• If Cerner RadNet does not function on Windows 10, additional registry settings may
need to be modified. The Visual Desktop Integration Registry must be set at each
workstation.
For example, log in as Administrator and modify the following portion of the file
C:\Program Files\Cerner\vdiconfigureregistry.exe as follows:
Unidirectional
Accession
________89ABC_EFGHI (8 underscore (_) before the 8)
Resize Ratio: 1.0
5.4.37 SecurView
There are a few items to keep in mind for the SecurView connected application:
• When Application Synchronization is installed on a SecurView workstation, the
InstallShield will configure a SecurView connected application automatically during
installation. SecurView uses a TCP/IP interface to communicate with Application
Synchronization. The default listening port for the SecurView application is 4700. See
TCP/IP Communications Page on page 68.
• When configuring Application Synchronization in the SecurView application via the
Settings tab as the service user, the IP address and port entered should be that of
Application Synchronization and not the actual third-party application. The
Application Synchronization Installation program should configure these settings
correctly and generally they will not need to be changed.
• During the first login to the SecurView application as the service user after a reboot,
if the Configure button on the Settings tab is used to open the Application
Synchronization Configuration Interface, the interface will be hidden behind the
SecurView application. Select OK at the bottom of the SecurView Settings tab to
bring the interface to the forefront.
• If another connected application is capable of sending OpenPatient CLEAR messages
to close the viewer on SecurView, enable the XAppCloseViewersID:CLEAR and
XAppCloseViewersUID:1.2.276.0.28.3.9.99999 settings in lightbox.ini by removing the
# at the beginning of the line (this is enabled by default on SecurView 8.1 and later).
• There are several ways for a SecurView user to initiate a Synchronization message to
a connected application that is capable of receiving the message. For testing, do the
following:
a. Log on to SecurView as a radiologist user, and then select Administration to
open the Patient list.
b. Select a patient and right-click on the patient name.
c. Select Synchronize to send an OpenPatient message to the configured connected
applications via Application Synchronization. If the option is disabled,
Synchronization has not been properly licensed or configured. Sending of Login
and Logout messages must be configured in each user’s preferences.
• Refer to the SecurView DX/RT Workstation User Guide for additional information on all
the different ways a user can synchronize with the connected applications.
• To configure the keypad for SecurView, see Configuring the SecurView Keypad on page
137.
PenRad Configuration:
[Hologic]
Enabled=YES
SerialPortInfo=COM1: baud=4800 parity=N data=8 stop=2 xon=off odsr=off octs=off dtr=off
rts=off idsr=off ReadTimeOut=300
Application Synchronization Configuration:
Use the following application type and communication configuration:
Select the application type: SecurView Serial Partner
Comm Port: (The comm port will need to be set to the port to which the null serial cable is
connected.)
Baud Rate: 4800
Data Bits: 8
Stop Bits: 2
Parity=no
End Marker: #
Only one instance of Selenia AWS can be configured per Application Synchronization
instance.
Hologic Selenia AWS has an interface that sends an OpenPatient message only. This is used
primarily to synchronize the Selenia AWS to the SecurView RT TechMate, or a Selenia AWS
to a SecurView RT workstation that is in the same room as the Selenia AWS. Within
Application Synchronization, there is no IP address or port to configure for the Selenia AWS
application type (i.e. no Communications page).
To configure the Selenia AWS:
1. Log off from the root user. Log into OS as apps.
2. Minimize the Selenia AWS application window.
3. Double-click the Netscape icon.
4. Log in with service name and password.
5. Select DROC.
6. Select Software Configuration.
7. Select /installed/apps.
8. Select Edit Direct Ray Operator console application.
9. Scroll until you locate site configuration and then select Edit Configuration File for
siteconfig.cfg.
a. Change tws sync enabled to true.
b. Set the tws IP address to the SecurView RT TechMate IP address.
c. Set the tws port to 5100.
10. Select Update to save changes.
Important
Synchronization will not occur if the Illuminate InSight application is launched
manually.
If the syngo Workflow ReadExam application is being installed on the same computer where
Application Synchronization is installed, the defaults are acceptable in most cases. Give the
information below to the Siemens syngo Workflow technical representative. If necessary, this
information can be changed to match the syngo Workflow ReadExam settings.
Table 15: syngo Workflow ReadExam Communications Page Default Settings
Field Default Description
Directory C:\NoviusReadExam\ This is the mutually shared directory.
File Name message.xml This is the file that the syngo Workflow
ReadExam client software writes and
Application Synchronization reads.
Chapter 6
Configuring Study List Manager (SLM)
Chapter 6
Note
This section should be performed only on a system that has Application
Synchronization already installed and where SLM is intended to run.
Note
If the host computer is outside the domain, Hologic personnel must work with
the hospital IT team to install their certificates. If SLM Clients on multiple remote
systems need to be configured to communicate with a SLM Server using HTTPS
Anonymous Client, Hologic personnel must work with the hospital IT team to
ensure that certificates are imported to each computer (client and server). Follow
steps 4 to 15 in section Configuring HTTPS Support on page 132.
Note
SLM logs can be found at E:/HologicAppSync/StudyListManager/Logs.
4. Select the corresponding buttons as required to change the port or ports. This will change
the default ports and open Windows Firewall exceptions.
5. Select Computer Account from the Certificates Snap-in window and select Next.
6. Keep the default settings in the Select Computer window. Select Finish and then select
OK.
7. From the Console Root window, select the Certificates (Local Computer) node.
8. Select the Personal node and select Certificates.
9. Double-click the certificate issued to {machinename}.{domain}.
11. Select Thumbprint and copy the values of Thumbprint that display in the bottom of the
screen.
12. Open Notepad on your computer and paste the values of Thumbprint.
13. In Notepad, press [Ctrl] + [H]. Enter one space (by pressing the Space bar one time) in the
Find What field, and select Replace All. This removes spaces between the characters.
14. Press Windows + [R] , then enter CMD in the Run dialog.
Note
If you get the error "The parameter is incorrect" from the Command window,
remove the question mark character ‘?’ that appears after certhash=.
Note
Replace the port number if the default port is not being used.
Note
For SecurView, the server address must match the certificate name, e.g.,
{machinename}.{domain}.
Chapter 7
Service Procedures
Chapter 7
3. Select Application Synchronization from the list and select Change. The
InstallShield window appears.
4. Select Modify and then select Next.
5. In the Installation Components window, select/deselect the installation components
that are to be added or removed. Select Next.
Note
The SecurView or MultiView application is required. SecurView is selected by
default when Application Synchronization is installed on a SecurView
workstation.
Note
Proxy adapters have a separate installation package that will need to be installed
after completing the Application Synchronization installation. For instructions, see
Install/Uninstall Separate Proxy Application on page 143.
Note
Proxy adapters have a separate installation package that will need to be
uninstalled after completing the Application Synchronization installation. For
instructions, see Install/Uninstall Separate Proxy Application on page 143.
9. Select ‘Yes, I want to restart my computer now.’ Select Finish. The system will
restart.
Note
Hologic recommends that the Application Synchronization computer host the
shared drive. When Application Synchronization starts up, it needs the shared
directory to be available to post its File System Watcher. If the shared directory is
on another computer, Application Synchronization’s startup will be delayed until
Windows maps the drive letter. This is a very precarious state that is to be avoided.
Application Synchronization will terminate if Windows fails to map the drive.
4. In the Map Network Drive window, select an unused drive letter in the Drive
drop-down list. In the Folder drop-down list, enter the path of the network share
using the following entries as a guide:
Network Share Path: \\[Computer Name]\[Share Name]
Example: \\DWS01\MySharedFolder
Or, select Browse and select a network computer or server and then a shared folder.
5. Select the Reconnect at sign-in check box, and select Finish. The drive should now
be mapped. The third-party application must be configured with this new drive
letter.
6. Log into Windows as the designated Windows user on the Application
Synchronization computer.
7. Make sure that both computers have proper permissions by copying files manually
into the shared folder.
8. Remove these test files and continue the installation process.
Note
Application Synchronization log files can be 21 MB. Up to 21 files at 1 MB each are
maintained.
1. If SecurView is running, log into the SecurView application as the service user.
2. Select the Exit to Windows tab.
3. Select OK to confirm.
4. Display the Computer window by pressing Windows + [E].
5. Navigate to E:\HologicAppSync\Service.
6. In the Service directory, double-click getlogs.bat. A command window opens.
7. At the prompt to continue, press [C] and [Enter]. Log files and application folders
will be automatically packaged into a ZIP format.
8. When the command window prompts you, press any key to exit the command
window.
9. The created ZIP package can be found in the E:\HologicAppSync\Service folder as
ASlogfiles.zip.
To manually get Application Synchronization logs:
1. Display the Computer window by opening Windows File Explorer.
2. Navigate to the C:\ root directory.
3. Create a new folder and name it AppSyncLogs.
4. Copy the following folders and files to the C:\AppSyncLogs folder.
E:\HologicAppSync\Synchronizer\Logs
E:\SecurView\XAppSettings.xml
E:\SecurView\Log\XAPPINTERFACE.log
E:\HologicASProxy\ (exists only if a proxy application is installed on SecurView
along with Application Synchronization)
Note
If Application Synchronization is installed on a non-SecurView computer, the path
to the log files in \HologicAppSync\Synchronizer\Logs and \HologicASProxy
will be different. Use your best judgment in locating and getting these logs.
5. Copy the Devices.hlx file to the C:\AppSyncLogs folder. You can find this file in the
following directory:
C:\ProgramData\Hologic\AppSync\Configuration\Devices.hlx
6. In Windows Explorer, right-click the C:\AppSyncLogs folder, point to Send To…,
and then select Compressed (zipped) Folder. A file will be created named
AppSyncLogs.zip. This is the file you will need to send for debugging issues.
7. Delete the following folder and zip file once you have sent the logs to the appropriate
person (for example, Hologic Technical Support or Engineering):
C:\AppSyncLogs
C:\AppSyncLogs.zip
Note
If the Proxy application is being installed on a computer other than Application
Synchronization, the .NET Framework 3.5 SP1 must be confirmed and/or installed
manually before continuing. To check this, confirm that the following folder exists:
C:\WINDOWS\Microsoft.NET\Framework\v3.5
Note
The Adapter Name, IP address, and port entered into the Adapter Configuration
Tool in the following step must match the settings configured for the TPA in the
Application Synchronization Configuration Interface.
Note
Use the Application Tester described in Application Tester on page 30 to test
receiving messages from the connected application that is using a Proxy
application.
Note
By default the Hologic Adapter Configuration window for Proxy application
configuration will display a MAC address in the Adapter IP field instead of the IP
address of the Proxy application. You must enter the correct Adapter IP address in
this field and select Save.