Professional Documents
Culture Documents
FilmArray 2.0
FilmArray 2.0
0 LIS Interface
FilmArray 2.0 LIS Interface Overview
TECHNICAL
The FilmArray 2.0 system is capable of interfacing with a laboratory information
system (LIS). FilmArray test results can be electronically transferred from a ::: NOTE
FilmArray 2.0 system to an LIS (unidirectional communication). There are two
components of the FilmArray 2.0 LIS interface: the FilmArray Link software
developed by BioFire Diagnostics and the driver software developed by the LIS
or middleware vendor. To set up the interface, FilmArray customers will need to
obtain the FilmArray Link software and the appropriate driver from their LIS or
middleware provider.
The FilmArray Link software consists of the FilmArray Link Software v2.0 and
panel-specific FilmArray Link electronic report modules. The FilmArray Link
Software v2.0 is a plug-in to the FilmArray Software v2.0. The software retrieves
test result data from a configured FilmArray database, sends the data to the
corresponding electronic report module (where the data is formatted into an XML
file, also referred to as an electronic report), and then sends the electronic report
to BCI Link. The FilmArray Software v2.0 must be installed on a FilmArray 2.0
computer in order for the FilmArray Link Software v2.0 to be installed and used.
LIS and middleware vendors will need to provide drivers that are compatible with
the FilmArray 2.0 system. Each driver must be able to collect, read, and parse
XML files, as well as to reformat the parsed data into a form that can be read by
the LIS. Documentation is available from BioFire Diagnostics to aid LIS and
middleware vendors during driver development and can be requested through
the company’s website.
Note that the FilmArray Link Software v2.0 transmits the electronic reports using
one of two data transfer methods: File Transfer Protocol (FTP) or shared folder
protocol. Drivers developed by LIS and middleware vendors to provide an
interface with the FilmArray 2.0 system will support one of these data transfer
methods. Determine which method is supported by the driver to be used and
complete the appropriate instructions below to set up the interface.
TECHNICAL NOTE
BioFire Diagnostics, LLC
1|Page www.BioFireDX.com
FLM2-PRT-0246 -01
FilmArray 2.0 LIS Interface Setup Instructions (FTP)
The following instructions describe how to set up the FilmArray 2.0 LIS interface
if the LIS or middleware driver to be used supports the FTP data transfer method.
TECHNICAL
Refer to the FilmArray 2.0 LIS Interface Setup (Shared Folder Protocol) section if
the driver supports the shared folder protocol method of data transfer.
2. Set up the FilmArray 2.0 system in the lab in the location to be used for
clinical testing if not already completed. Ensure the system is near a
network port.
The following steps are performed by the customer (lab and IT personnel) with
assistance from a BioFire Diagnostics Field Application Specialist and a
Customer Support Representative if desired.
1. Install the FilmArray Link Software v2.0 and the panel-specific electronic
report modules.
a. Launch the FilmArray Software v2.0 from the shortcut on the desktop
if it is not open. Minimize the FilmArray Software v2.0 window.
TECHNICAL NOTE
BioFire Diagnostics, LLC
2|Page www.BioFireDX.com
FLM2-PRT-0246 -01
b. Double click the BCI Link icon on the desktop. BCI Link will launch
and request administrative login credentials. The administrative login
is “LabAdmin” and the default password is “Lab_Admin”.
TECHNICAL
Note that BioFire Diagnostics recommends that local IT personnel
change the default password for the Windows user account named
::: NOTE
“LabAdmin”. Do not delete or modify the groups associated with the
LabAdmin user account.
TECHNICAL NOTE
BioFire Diagnostics, LLC
3|Page www.BioFireDX.com
FLM2-PRT-0246 -01
c. From the BCI Link user interface, click the BCI Link parameter
settings button.
TECHNICAL
::: NOTE
d. Select the FTP configuration tab and click the Add… button.
TECHNICAL NOTE
BioFire Diagnostics, LLC
4|Page www.BioFireDX.com
FLM2-PRT-0246 -01
e. Create an FTP account by completing the following fields in the FTP
Account Manager window. Note that the field entries shown in the
screenshot are for illustrative purposes and the customer needs to
determine the account name and login information. Also note that
TECHNICAL
spaces and special characters cannot be used in any of these fields.
•
::: NOTE
Account name
• Login
• Password
• Password confirmation
f. Select the Active account checkbox and change the value in the
Uploading period (sec) field from zero to 3600.
g. Click OK.
TECHNICAL NOTE
BioFire Diagnostics, LLC
5|Page www.BioFireDX.com
FLM2-PRT-0246 -01
h. Verify that the account is Active and click the Save configuration
button. Note that the recommended port number is 21 (default port
number).
TECHNICAL
::: NOTE
TECHNICAL NOTE
BioFire Diagnostics, LLC
6|Page www.BioFireDX.com
FLM2-PRT-0246 -01
j. Click the play button associated with the FTP icon. Note that the
double headed arrow will not turn green until the driver connects to
the FTP server.
TECHNICAL
::: NOTE
TECHNICAL NOTE
BioFire Diagnostics, LLC
7|Page www.BioFireDX.com
FLM2-PRT-0246 -01
k. Click the play button in the lower, right-hand portion of the screen. A
FilmArray icon and a green double headed arrow are displayed,
indicating that communication has been established.
TECHNICAL
Note that if the FilmArray icon does not appear after the play
button has been pressed, start the FilmArray Software v2.0 from
::: NOTE
the shortcut on the desktop and press the play button in BCI
Link again.
The following steps are performed by the customer (lab personnel and LIS
specialist) with assistance from the LIS or middleware vendor, and a BioFire
Diagnostics Field Application Specialist and a Customer Support Representative
if desired.
2. Configure the driver using the login and password for the FTP account
created in step 2.e. of the Install and Configure FilmArray Link Software
section (page 5).
3. Map the FilmArray test results from the XML files to the LIS. The panel-
specific electronic report module technical notes provide information to
help with the mapping process. BioFire Diagnostics can provide test files
that can be sent through the interface to verify the mapping without
running pouches and chemistry, if desired.
5. Install the driver in the production area of the LIS. TECHNICAL NOTE
BioFire Diagnostics, LLC
8|Page www.BioFireDX.com
FLM2-PRT-0246 -01
FilmArray 2.0 LIS Interface Setup (Shared Folder Protocol)
The following instructions describe how to set up the FilmArray 2.0 LIS interface
if the LIS or middleware driver to be used supports the shared folder protocol
TECHNICAL
data transfer method. Refer to the FilmArray 2.0 LIS Interface Setup (FTP)
section if the driver supports the FTP data transfer method.
2. Set up the FilmArray 2.0 system in the lab in the location to be used for
clinical testing if not already completed. Ensure the system is near a
network port.
5. Add the computer to the domain. Note that the local FilmArray user
account must be used to operate the FilmArray 2.0 system. Once the
computer has been added to the domain, the user name "./FilmArray" will
need to be used to log in to the computer (rather than the user name
"FilmArray").
6. Map the computer to the network drive on which the shared folder is
located. The username and password for the account that has read and
write access to the shared location on the network will be required to
complete the mapping.
The following steps are performed by the customer (lab and IT personnel) with
assistance from a BioFire Diagnostics Field Application Specialist and a
Customer Support Representative if desired.
1. Install the FilmArray Link Software v2.0 and the panel-specific electronic
report modules.
TECHNICAL NOTE
BioFire Diagnostics, LLC
9|Page www.BioFireDX.com
FLM2-PRT-0246 -01
2. Complete the following steps to give BCI Link access to the shared folder
on the network.
a. From the Start menu on the computer, search for the Services
program.
TECHNICAL
::: NOTE
TECHNICAL NOTE
BioFire Diagnostics, LLC
10 | P a g e www.BioFireDX.com
FLM2-PRT-0246 -01
b. Right click on Services and select the Run as administrator option.
The program will request administrative credentials. The
administrative login is “LabAdmin” and the default password is
“Lab_Admin”.
TECHNICAL NOTE
BioFire Diagnostics, LLC
11 | P a g e www.BioFireDX.com
FLM2-PRT-0246 -01
c. Select bciNetServer from the list of services and click Stop in the
upper left-hand corner of the window.
TECHNICAL
::: NOTE
TECHNICAL NOTE
BioFire Diagnostics, LLC
12 | P a g e www.BioFireDX.com
FLM2-PRT-0246 -01
TECHNICAL
::: NOTE
e. Select the radio button for This account:. Enter the domain name,
username, and password corresponding to the credentials used to
access the shared folder on the network. Note that the figure below
is for illustrative purposes.
TECHNICAL NOTE
BioFire Diagnostics, LLC
13 | P a g e www.BioFireDX.com
FLM2-PRT-0246 -01
g. Click Start in the upper left-hand corner of the Services window.
TECHNICAL
::: NOTE
3. Complete the following steps to configure BCI Link for use with the
shared folder protocol.
b. Double click the BCI Link icon on the desktop. BCI Link will launch
and request administrative login credentials. The administrative login
is “LabAdmin” and the default password is “Lab_Admin”.
TECHNICAL NOTE
BioFire Diagnostics, LLC
14 | P a g e www.BioFireDX.com
FLM2-PRT-0246 -01
TECHNICAL
::: NOTE
c. Enter login and password and click OK. The user will be presented
with the BCI Link user interface.
TECHNICAL NOTE
BioFire Diagnostics, LLC
15 | P a g e www.BioFireDX.com
FLM2-PRT-0246 -01
d. Click the BCI Link parameter settings button.
TECHNICAL
::: NOTE
e. From the BCI Link parameter settings, click on the Shared folder
configuration tab.
TECHNICAL NOTE
BioFire Diagnostics, LLC
16 | P a g e www.BioFireDX.com
FLM2-PRT-0246 -01
g. Manually enter the following path in the Request folder field:
C:\ProgramData\BioFireDx\FilmArrayLink\Requests
h. Manually enter the complete network path for the shared folder in the
TECHNICAL
Result folder field.
::: NOTE
Do not use the drive letter when entering the path (e.g., do not enter
G:\...\Results).
Note that the examples of the result folder paths above are for
illustrative purposes and the customer needs to determine the folder
path.
i. Change the value in the Maximum file age (in s) in result folder (no
checks if 0) field from 7200 to 3600.
TECHNICAL NOTE
BioFire Diagnostics, LLC
17 | P a g e www.BioFireDX.com
FLM2-PRT-0246 -01
TECHNICAL
::: NOTE
k. Click the Monitoring button. Note that the result folder path shown in
the screenshot below is for illustrative purposes and the customer
needs to determine the folder path.
TECHNICAL NOTE
BioFire Diagnostics, LLC
18 | P a g e www.BioFireDX.com
FLM2-PRT-0246 -01
l. To start the shared folder service, click the play button next to the
SharedFolder icon (identified in the screenshot below). The double
headed arrow changes from gray to green.
TECHNICAL
::: NOTE
The following steps are performed by the customer (lab personnel and LIS
specialist) with assistance from the LIS or middleware vendor and BioFire
Diagnostics Field Application Specialist and a Customer Support Representative
if desired.
TECHNICAL
1. Install the driver in the test area of the LIS.
::: NOTE
2. Configure the LIS and driver to retrieve and process the XML files from
the shared folder.
3. Map the FilmArray test results from the XML files to the LIS. The panel-
specific electronic report module technical notes provide information to
help with the mapping process. BioFire Diagnostics can provide test files
that can be sent through the interface to verify the mapping without
running pouches and chemistry, if desired.
TECHNICAL NOTE
BioFire Diagnostics, LLC
20 | P a g e www.BioFireDX.com
FLM2-PRT-0246 -01
Troubleshooting
The following sections describe troubleshooting of the FilmArray Link Software
v2.0 and the BCI Link software.
TECHNICAL
::: NOTE
FilmArray Link Software v2.0 Troubleshooting
The user may encounter run processing issues with the FilmArray Link Software
v2.0 where electronic reports are not sent to the LIS. These could be due to the
automated run processing settings or they could be the result of errors in the
software.
If electronic reports are not automatically being sent to the LIS, verify that the
automated run processing status is Active and the button says “Stop” (see the
screenshot below). Refer to the FilmArray Link Software v2.0 technical note for
instructions regarding how to enable and disable automated run processing. If
automated run problems persist, refer to the Run Processing Errors section
below.
A run transfer error may occur if the FilmArray Link software fails to deliver an
electronic report to the LIS. Messages associated with run transfer errors are
displayed in the Event Viewer section of the FilmArray Link tab. The time
associated with each run transfer error event, the event type (Error), and the
event details are shown in the Event Viewer.
The run transfer error messages and possible solutions for resolving the errors
are described in the table below. Note that local IT personnel and LIS specialists
can assist with troubleshooting the FilmArray Link Software v2.0.
TECHNICAL NOTE
BioFire Diagnostics, LLC
21 | P a g e www.BioFireDX.com
FLM2-PRT-0246 -01
Run Transfer Error Message Possible Solution
An error occurred during run Ensure the power and Ethernet cables are
transfer for the pouch x and securely connected to the FilmArray 2.0
sample y. Error sending computer and wall outlets.
message to BCI.
Restart the FilmArray 2.0 computer and TECHNICAL
::: NOTE
verify that the bciNetServer service has
started. Start the service if it has not been
started. Refer to the Verify and Change
bciNetServer Service Status section below.
TECHNICAL NOTE
BioFire Diagnostics, LLC
22 | P a g e www.BioFireDX.com
FLM2-PRT-0246 -01
Run Transfer Error Message Possible Solution
An error occurred during run Ensure the power and Ethernet cables are
transfer for the pouch x and securely connected to the FilmArray 2.0
sample y. Pouch result was computer and wall outlets.
not valid.
Ensure that the pouch result is Pass and TECHNICAL
::: NOTE
the run status is Completed for the desired
run. Note that the FilmArray Link Software
v2.0 will not send runs which have a pouch
result of Fail and a run status of anything
other than Completed.
1. Search for the Services program from the Start menu on the
computer.
If the bciNetServer service needs to be started, close the Services program and
complete the following steps.
1. Search for the Services program from the Start menu on the
computer.
3. Select bciNetServer from the list of services and click Start in the
upper left-hand corner of the Services window.
TECHNICAL NOTE
BioFire Diagnostics, LLC
23 | P a g e www.BioFireDX.com
FLM2-PRT-0246 -01
BCI Link Troubleshooting
The user may encounter changes in the BCI Link connection status with the LIS.
Changes to the BCI Link status are documented as events in the Event Viewer
TECHNICAL
section of the FilmArray Link tab. The time associated with each BCI Link status
change event, the event type (BCI), and the message details are displayed in the
Event Viewer. The current BCI Link status is displayed in the Communication
Management section of the FilmArray Link tab. Refer to the two screenshots
below where the Communication Management section displays BCI Link
::: NOTE
statuses of Ok and Warning.
The status of BCI Link may be Ok, Warning, Error, or Not Connected. The status
of BCI Link should be Ok for the FilmArray Link Software v2.0 to function as
intended. The following table provides a description of each of the BCI Link
statuses.
TECHNICAL NOTE
BioFire Diagnostics, LLC
24 | P a g e www.BioFireDX.com
FLM2-PRT-0246 -01
The table below provides instructions for resolving any issues related to the
status of BCI Link and for returning the BCI Link status to Ok. Note that local IT
personnel and LIS specialists can assist with troubleshooting BCI Link.
TECHNICAL NOTE
BioFire Diagnostics, LLC
25 | P a g e www.BioFireDX.com
FLM2-PRT-0246 -01
BCI Link Status Possible Solution
TECHNICAL NOTE
BioFire Diagnostics, LLC
26 | P a g e www.BioFireDX.com
FLM2-PRT-0246 -01
BCI Link Status Possible Solution
TECHNICAL NOTE
BioFire Diagnostics, LLC
27 | P a g e www.BioFireDX.com
FLM2-PRT-0246 -01
BCI Link Status Possible Solution
TECHNICAL NOTE
BioFire Diagnostics, LLC
28 | P a g e www.BioFireDX.com
FLM2-PRT-0246 -01
Verify Result Folder Path
1. Launch BCI Link from the shortcut on the desktop and enter
administrative credentials. The administrative login is "LabAdmin"
and the default password is "Lab_Admin". TECHNICAL
Note that BioFire Diagnostics recommends that local IT personnel ::: NOTE
change the default password for the Windows user account named
"LabAdmin". Do not delete or modify the groups associated with the
LabAdmin user account.
3. From the BCI Link parameter settings, click on the Shared folder
configuration tab.
4. Verify that the path entered in the Result folder field matches the
path expected by the LIS. Contact local IT department to obtain the
expected file path.
Note: To ensure the path is accessible from the FilmArray 2.0 computer, copy the
path from the Results folder field into the Windows Explorer address bar. An
error message will be displayed if the path is incorrect or unavailable.
1. Launch BCI Link from the shortcut on the desktop and enter
administrative credentials. The administrative login is "LabAdmin"
and the default password is "Lab_Admin".
3. From the BCI Link parameter settings, click on the FTP configuration
tab.
a. Highlight the account in the FTP configuration tab and click the
Properties… button.
TECHNICAL NOTE
BioFire Diagnostics, LLC
29 | P a g e www.BioFireDX.com
FLM2-PRT-0246 -01
BCI Link Message Acknowledgement
1. Launch BCI Link from the shortcut on the desktop and enter
administrative credentials. The administrative login is "LabAdmin"
and the default password is "Lab_Admin". TECHNICAL
Note that BioFire Diagnostics recommends that local IT personnel ::: NOTE
change the default password for the Windows user account named
"LabAdmin". Do not delete or modify the groups associated with the
LabAdmin user account.
TECHNICAL NOTE
BioFire Diagnostics, LLC
30 | P a g e www.BioFireDX.com
FLM2-PRT-0246 -01
3. Select message to be acknowledged and click the acknowledge
button (refer to the screenshot below).
Note that all messages must be acknowledged before the status of BCI Link will
change to Ok. When the status has returned to Ok, a green box is displayed in
the alarm button (refer to the screenshot below).
TECHNICAL
::: NOTE
3
3
TECHNICAL
customer support available. If you have any questions or concerns,
please contact BioFire Diagnostics Customer Support at 801-736-
::: NOTE
6354, option 5 or by email at support@biofiredx.com
TECHNICAL NOTE
BioFire Diagnostics, LLC
32 | P a g e www.BioFireDX.com
FLM2-PRT-0246 -01