Location via proxy:   [ UP ]  
[Report a bug]   [Manage cookies]                

Atellica VTLi Immunoassay Analyzer Advanced User Guide DXDCM 09017fe980551832-1725316330754

Download as pdf or txt
Download as pdf or txt
You are on page 1of 53

Advanced User Guide

No part of this user guide or the products it describes may be reproduced by any means or
in any form without prior consent in writing from Siemens Healthcare Diagnostics.
The information in this user guide was correct at the time of printing. However,
Siemens Healthcare Diagnostics continues to improve products and reserves the right to
change specifications, equipment, and maintenance procedures at any time without notice.
If the system is used in a manner differently than specified by
Siemens Healthcare Diagnostics, the protection provided by the equipment may be
impaired. See warning and hazard statements.

Origin DE Siemens Healthcare Diagnostics Siemens Healthineers


Siemens Healthcare Diagnostics Inc. Manufacturing Ltd. Headquarters
511 Benedict Avenue Chapel Lane Siemens Healthcare AG
Tarrytown, NY 10591-5097 USA Swords, Co. Dublin, Ireland
siemens-healthineers.com/poc
Siemensstr. 3
91301 Forchheim
Germany
Phone: +49 9191 18-0
siemens-healthineers.com

© 2020-2024 Siemens Healthcare Diagnostics. All rights reserved.


Atellica is a registered trademark of Siemens Healthcare Diagnostics.
All other trademarks are the property of their respective owners.
11538072 Rev. D, 2024-04
Atellica® VTLi Immunoassay Analyzer

Advanced User Guide


Contents
Chapter 1 Introduction Configuring Wireless connectivity to an
existing network 31
About this User Guide 2
Configuring Wireless connectivity to a
Installing the Service Software 2 new network 31
Starting the Service Software user interface 2 Configuring Service Software connectivity 32
Logging in 2 Configuring middleware software 32
Service software overview 3 Enabling a printer 33
Exploring the user interface 3 Appendix A Specifications and Installation
Common icons and buttons 4
Service Software Specifications 36
Exiting the Service Software 4
Installation Workflow 36
Backing up and restoring 5 Installing the server 36
Backing up the service software 5
Installing the client 37
Restoring the service software 5
Uninstalling Service Software Client/Server 37
Chapter 2 Analyzer Tab Appendix B Error Codes
About the Analyzer Tab 8 Listing of Error Codes 40
Analyzer pane 8
Properties pane 9
Adding a new analyzer 9
Working with groups 10
Creating a new group 10
Using group properties 10
Cartridge protocols and lots 12
Cartridge lots 13
Working with a Single Analyzer 14
Using the analyzer properties menu 15
Cartridge lot details 15

Chapter 3 Inventory Tab


About the Inventory Tab 18
Installing cartridge protocols 18
Cartridge lot information 18
Modifying ranges for quality control lots 19
Installing analyzer software and languages 20
Working with security certificates 20

Chapter 4 Users Tab


About the Users Tab 24
View existing users 24
Adding a new user 24
Change details for an existing user 25
Delete a user 25

Chapter 5 System Settings


About System Settings 28
Changing Analyzer settings 28
Changing Service Software settings 28

Chapter 6 Network Connectivity


About Network Connectivity 30
Configuring a static IP address 30
Configuring with a DHCP server 30
CHAPTER 1
Exploring the
Atellica VTLi Service
Software Client
Chapter 1 - Exploring the Atellica VTLi Service Software Client

About this User Guide


This user guide describes the Atellica VTLi Immunoassay Analyzer advanced configuration
features and explains how to use them. You should carefully read this user guide before
using the device. Make sure to keep this user guide for future reference.
The following conventions are used throughout this guide:

Symbols Description

Indicates additional information about a feature or screen.

Indicates important operations or safety information.

Next > Finish In instructions, indicates a series of commands you use to reach a screen.

Installing the Service Software


The service software server component runs in the background on your IT infrastructure,
and communicates with docked analyzers to retrieve anonymized service-related data and
update each analyzer.
Atellica Analyzer VTLi service software installation is done by a Siemens Healthineers service
engineer. For more information, see Appendix A on page 31.

Starting the Service Software user interface

INSTRUCTIONS
1. On the Windows desktop, double-click .
The service software starts and the login screen appears.
You can also open Start >All Apps >Atellica VTLi Service Software Client.

Starting or closing the service software client does not affect the process of monitoring
analyzers. The service software remains active, even when a user is not logged in. The
analyzer will still connect and transfer data to the service software and to the hospital
information system, even when there are no users logged in.
Logging in
Siemens Healthineers recommends each service software user have a unique user name
and password.

2
Chapter 1 - Exploring the Atellica VTLi Service Software Client

INSTRUCTIONS
1. Type your user name in the User ID field.
2. Type your password in the Password field.
You must wait 5 minutes to login after 5 incorrect password attempts.
3. The Server field shows the last used server location and a list of previously entered
values for the server hostname(:port).
4. Click Log In.
When logging in for the first time during the installation process, the system prompts
you to change your password.
Service software overview
The service software provides for configuring analyzers, monitoring analyzer status,
managing users, and managing supported cartridges and cartridge lots.
The service software client component enables you to group and configure analyzers,
monitor analyzer status, and manage user accounts if no middleware software is available.
The service software also allows you to manage the supported cartridges and cartridge lots.
Exploring the user interface

1 2

1 Configuration tabs:
Analyzer - View status, group and configure settings and workflow, release
or remove cartridge lots from analyzer groups. See Chapter 2, page 7.
Inventory - Install cartridge protocols, manage security certificates, manage
cartridge lots. See Chapter 3, page 17.
Users - Manage user accounts. See Chapter 4, page 21.
2 Status bar icons
3 Workspace - displays the information and messages for the current task you
are performing (for example, analyzer and group settings, reagent cartridge
and QC lots).

3
Chapter 1 - Exploring the Atellica VTLi Service Software Client

Common icons and buttons


Status bar icon displays when new unassigned analyzers are available.
The number in the icon provides information about the number of new
analyzers detected. Click to select the new analyzer.

Status bar icon you click to access system settings and preferences.

Status bar icon displays the current user. Move the mouse pointer over
the icon to see the user information. Click to log out as the current user.

Analyzer is ready for use. No error conditions.

Analyzer can be used but has a warning condition that requires


attention.

Analyzer has an error condition and cannot be used until resolved.

Finding Service Software information


Click the Siemens Healthineers logo in the status bar to display the About screen to view
the software release number, software release date, and other information.

Logging out
INSTRUCTIONS

1. Click .
2. Click Log out.
An automatic log out feature ends the current user session after a default time of
inactivity. You can set the default inactivity time in system settings.

Exiting the Service Software


Click the Close button in the upper right corner of the screen.
Exiting the service software closes the user interface. The service software remains
active, even when a user is not logged in. The analyzer can still connect and transfer
data to the service software and to the hospital information system when a user is not
logged in.

4
Chapter 1 - Exploring the Atellica VTLi Service Software Client

Backing up and restoring the service software

Backing up the service software


INSTRUCTIONS

1. Stop the Atellica VTLi Immunoassay Analyzer service.


2. Copy the SERVER.DB and server-settings.xml files in location %ProgramData%\Atellica
VTLi Immunoassay Service Software Server to your backup location (preferably
identifying date, time, and version of the software in use when the backup was made.
3. Start the service.

Restoring the service software


INSTRUCTIONS

1. Stop the Atellica VTLi Immunoassay Analyzer service. service.


2. Copy the SERVER.DB and server-settings.xml from your backup location to:
%ProgramData%\Atellica VTLi Immunoassay Service Software Server\.
3. Start the service.

5
Chapter 1 - Exploring the Atellica VTLi Service Software Client

6
CHAPTER 2
Using the
Analyzer Tab
Chapter 2 - Using the Analyzer Tab

About the Analyzer Tab


Use the Analyzer tab to manage settings for individual analyzers or a group of analyzers. All
analyzers in a group share the same configuration. Adding an analyzer to a group configures
the analyzer according to group settings and removes any existing settings.

The Analyzers tab has two main sections:


‒ Analyzer pane
‒ Properties pane

Analyzer pane
The Analyzer pane displays all analyzers and groups currently managed by the application. It
also shows the status of each analyzer.

The assigned analyzer name is shown above each analyzer icon. The last synchronization
date or Connected (if the analyzer is online and network connected) is shown below the
analyzer icon.
An information message displays when no analyzers or groups are available.

Viewing analyzer status


Analyzers are shown as icons in the Analyzer pane. The icon’s color and symbol indicates the
current status of each analyzer.

8
Chapter 2 - Using the Analyzer Tab

Analyzer is working normally; no special conditions.

Analyzer can be used, but requires attention. A yellow exclamation mark


symbol also appears in the analyzer icon on the Analyzer pane.
Typically, this occurs when synchronization is pending and the system is
waiting for the analyzer to be docked.

Analyzer cannot be used at all. A red X symbol also appears in the analyzer
icon on the Analyzer pane.
Typically, this occurs when the analyzer is locked for testing by the
Administrator, when a QC has failed, assigned security certificate expires, or
when a QC is overdue.

Properties pane
The Properties pane provides additional information on the analyzer or group selected in
the Analyzer pane.

The content of the Properties pane changes depending on whether you select an analyzer
or a group. Clicking on the right side of the pane allows you to access either analyzer or
group settings, depending on the selection.
When you select (highlight) an analyzer that is not part of a group, you can only view
basic properties in the properties pane.

Adding a new analyzer


When a new analyzer is detected on the network and there is at least one existing group,
the analyzer appears in the Analyzer pane. The “new analyzer detected” icon appears in the
status bar.

9
Chapter 2 - Using the Analyzer Tab

Working with groups


You can create groups of analyzers for ease of identifying and managing settings. For
example, Emergency Room, Cardiology, and so on. All analyzers in a group are configured
automatically.
Groups are ordered alphabetically by the group name, and the order cannot be rearranged.
Within each group, the analyzers are also ordered alphabetically by the analyzer ID.
If the strip length extends beyond the available space on the screen, a scroll bar appears at
the bottom of the Analyzer pane.
You can also use the keyboard left and right arrow keys to move through groups and
analyzers.

Creating a new group


INSTRUCTIONS

1. Click in the top-right corner of the screen to create a new group.

The Create new group dialog appears.


2. Enter the name of the new group.
3. Select the language and software properties for the group.
4. Click Create.
You can use the Create a copy of this group option to quickly create a new group.

Using group properties


If a group is highlighted, the Properties pane displays the following information:

‒ Group settings (such as Analyzer login, User ID and Patient ID entry, Sound, etc.)
‒ Cartridge protocols and applicable QC lots for the group
Using the Group properties menu
You can define settings for a group by using the Group settings menu.
You can also right-click on a group to open the properties menu.

10
Chapter 2 - Using the Analyzer Tab

Renaming an existing group


INSTRUCTIONS

1. Select the group you want to rename in the Analyzer pane.


2. Click > Rename group.
3. Enter the new group name.
4. Click OK to save the new group name.
Editing group settings
INSTRUCTIONS

1. Select the group you want to change in the Analyzer pane.


2. Click > Edit group settings.
3. In the Edit settings dialog box, modify the settings as necessary:
‒ Analyzer login: Select the level of user authentication required.
‒ User ID entry: Select the method for entering the user ID.
‒ Patient ID entry: Select the method for entering the patient ID.
‒ Sound: Enable or disable analyzer sound.
‒ Date format: Select the format in which the analyzers display dates.
‒ Time format: Select the format in which the analyzers display time.
‒ Memory full handling: Configure when the analyzer application overwrites existing
measurement data.
‒ POC administrator: Enter contact information for the analyzer administrator. Data in
this field is not anonymized and is part of the logfile(s) as entered in this dialog.
‒ Automatic logout: Set the period of inactivity allowed before the current user is
logged out.
4. Click OK to confirm the changes.
Changing group settings triggers synchronization for all analyzers in the selected group.
Copying group settings
Use this feature to copy settings from an existing group to a new group.

INSTRUCTIONS

1. Select the group you want to copy in the Analyzer pane.


2. Click > Create a copy of this group.
The Create group copy dialog displays.
3. Enter a name for the new group.
The default name is the original group name with an incremented number.
4. Click the check-boxes for cartridge protocols and lots (cartridge and QC) linked to the
original group.
5. Click Create to create the group.
The new group is added to the Analyzers pane.
Updating analyzer language and software
Use this option to upgrade and downgrade the analyzer software.

11
Chapter 2 - Using the Analyzer Tab

INSTRUCTIONS

1. Select the group you want to update or downgrade in the Analyzer pane.
2. Click > Update analyzer language and software.
3. Select the installed language and software version.
You might not be able to select all software versions, depending on the current version
of the analyzers already present in the group.
4. Be sure to confirm that all analyzers in the group are updated.
5. Click OK to start the update.
Do not press the sleep button during a software update.

Reset the analyzer if the connection to the software service is lost after a software
update.
Deleting a group
INSTRUCTIONS

1. Select the group you want to delete in the Analyzer pane.


2. Click > Delete group.
3. Click Yes to confirm the selection.
The group and associated analyzers disappear from the Analyzer pane.
Deleted analyzers do not need to be undocked and docked to become visible again in
the Analyzer pane.

Cartridge protocols and lots


The Cartridge protocols and lots area shows the available cartridges for all analyzers within
the selected group.

When no cartridge protocols are assigned to a group, an information message displays.

Adding a cartridge protocol to a group


INSTRUCTIONS

1. Select a group in the Analyzer pane.


2. Click on the right side of the Properties pane.
3. Select a cartridge protocol from the drop-down list.
4. Click Add to add the cartridge protocol to the group.
Only cartridge protocols that have been registered on the Inventory tab and can be
added to a group. See Inventory tab on page 17.
Adding a cartridge protocol to a group triggers synchronization for all analyzers in the
selected group.

12
Chapter 2 - Using the Analyzer Tab

Cartridge lots
The cartridge lots are color coded for quick visual status. Green means lot is ready to use.
Yellow means lot is about to expire. Red means lot is expired.
Lots can be removed by clicking the minus (-) symbol behind the lot number.
Only available when manage cartridge lots is on in the service software options.
To ensure a cartridge or QC lot is correctly added to a group again after removing it
using the minus (-) symbol, do one of the following:
‒ Add the lot to the group by clicking the plus (+) icon on the Analyzer tab.
‒ Remove the lot from the Inventory tab before adding it again by using the lot on the
analyzer.
Removing a cartridge protocol from a group
Removing a cartridge protocol from an analyzer group means that the assay can no longer
be performed on any of the analyzers in that group.

INSTRUCTIONS

1. Select a group in the Analyzer pane.


2. Click on the top-right side of the cartridge protocol you want to remove.
3. Select Remove cartridge protocol from group.
4. Click Yes to the confirmation message.
The cartridge is removed from the group.
Removing a cartridge protocol from a group triggers synchronization for all analyzers in
the selected group.
Changing Quality Control (QC) Workflow settings
The system supports regular testing of Quality Control (QC) samples. QC samples can
be used to monitor reliability of a system and provide ongoing feedback that results are
sufficiently reliable. The QC workflow can also be disabled if needed.
With the QC workflow enabled, the system mandates regular QC testing and guides users
through the process, including QC due warning messages. If a QC test is not successfuly
done within the configured time, the analyzer is locked from testing with the relevant
cartridge lot(s).
QC samples also provide a stable source for use in releasing new cartridge lots. The system
supports the release of new cartridge and QC lots by testing a QC sample. This process is
fully guided. Failing to register new cartridge lots or QC lots (can be configured separately)
means that the lot cannot be used for patient testing.

INSTRUCTIONS

1. Select a group in the Analyzer pane.


2. Click on the top-right side of the selected cartridge protocol.
3. Select QC and Workflow settings.
4. In the Workflow settings dialog, modify the following as necessary:
‒ Unknown cartridge lots: Select whether unknown cartridge lots can be used or
whether they must be registered first.
‒ QC guidance: Select whether QC is enabled or disabled.
‒ Unknown QC lots: Select whether unknown QC lots can be used. Only available when
QC guidance is enabled.
‒ QC interval: Select the interval between subsequent QC tests. Only available when QC
guidance is enabled.

13
Chapter 2 - Using the Analyzer Tab

‒ QC interval due warning: Select when the system will notify the user before the next
QC test is due. Only available when QC guidance is enabled.
5. Click OK to confirm changes.
Changing workflow settings triggers synchronization for all analyzers in the selected
group.
Adding a cartridge lot to a cartridge protocol within a group
To make cartridge lots available on analyzers, the lot must be first added to the cartridge
protocol on the Inventory tab (see Inventory tab on page 17).
After that, the cartridge lot can be made available to the analyzers in the selected group by
adding it as described in this section.
Adding a cartridge lot to a cartridge protocol within the group makes the protocol
available on all analyzers in the group.
Expired cartridge lots are removed from the drop-down list.

INSTRUCTIONS

1. Select a group in the Analyzer pane.


2. Click the Add lot button on the selected cartridge protocol.
3. Select the cartridge lot from the drop-down list.
4. Click Add.
The cartridge lot is added to the cartridge protocol.
The drop-down list only shows cartridge lots that have been registered on the
Inventory tab.

Removing a cartridge lot from a cartridge protocol within a group


INSTRUCTIONS

1. Select a group.
2. Click the minus (-) symbol on the cartridge lot that should be removed from the
cartridge protocol.
3. Click Yes to remove the cartridge protocol from the group.
Removing a cartridge protocol from the group removes the cartridge file from all
analyzers in the group.
Working with a Single Analyzer
If a single analyzer is selected, the Properties overview displays the following analyzer
information:
‒ Analyzer settings for the selected analyzer.
‒ Cartridge protocols and lot information for the selected analyzer.
Moving an analyzer to a group configures the analyzer to the settings for that group.
When the analyzer is selected, the analyzer properties are displayed and more detailed
cartridge lot information is shown (for example, lot status).
If you remove an analyzer from the docking station while it is synchronizing with a
group, the analyzer may not fully synchronize with all configured group settings. This is
not visible on the analyzer itself, but the analyzer is displayed with the warning status
(orange) in the service software until it is docked again and successfully completes the
pending synchronization.

14
Chapter 2 - Using the Analyzer Tab

Using the analyzer properties menu

You can also right-click on an analyzer to open the menu.

Cartridge lot details


Lot availability is color-coded.
‒ Green lots are available for testing.
‒ Orange lots have QC tests scheduled but can still be used.
‒ Red lots can not be used for testing because, for example, QC is overdue or the lot has
expired.
If a single analyzer is highlighted, you can not add or remove lots. This action can only
be performed at the group level.
Renaming an analyzer
INSTRUCTIONS

1. Select the analyzer you want to rename.


2. Click > Rename analyzer.
3. Enter the new analyzer name.
4. Press OK to save your changes.
Deleting an analyzer
INSTRUCTIONS

1. Select the analyzer you want to delete.


2. Click > Delete analyzer.
3. Click Yes to delete the analyzer.
The analyzer can also be deleted from the group by dragging its icon outside the group.
Locking an analyzer
If for whatever reason you wish to prevent users from using a particular analyzer it can be
locked remotely.
The analyzer must be connected to the service software for locking.

INSTRUCTIONS

1. Select the analyzer you want to lock.


2. Click > Lock analyzer.
The analyzer lock status is shown in the analyzer Properties overview.
When the analyzer is locked, the analyzer Properties overview displays “Locked by
admin” and the analyzer icon in the Analyzer overview changes to error status (red).

15
Chapter 2 - Using the Analyzer Tab

Unlocking an analyzer
The analyzer must be connected to the service software for unlocking.

INSTRUCTIONS

1. Select the analyzer you want to unlock.


2. Click > Unlock analyzer.
The analyzer unlock status is shown in the analyzer Properties overview.
Resetting an analyzer to factory defaults
You can restore an analyzer to the factory default settings. When you do this:
‒ All data stored on the analyzer is deleted.
‒ The analyzer is removed from its assigned group and communication with the service
software is lost.

INSTRUCTIONS

1. Select the analyzer you want to reset.


2. Click > Reset analyzer to factory defaults.
3. Click the checkbox in the confirmation dialog box.
4. Click Yes to reset the analyzer to the factory defaults.
Change the communication settings on the analyzer to restore communication with the
service software.
Preparing analyzer for service
A best practice is clearing patient data from an analyzer before sending it out for
servicing.

You can not undo changes from clearing patient data from an analyzer. All patient data
is removed from the system.

INSTRUCTIONS

1. Select the analyzer you want to send out for service.


2. Click > Prepare analyzer for service.
3. Click Acknowledge and procede checkbox.
4. Click Ok.
The analyzer can no longer be used for testing.
After clearing patient data, the analyzer is removed from its assigned group and
communication with the service software is lost.

16
CHAPTER 3
Using the
Inventory Tab
Chapter 3 - Using the Inventory Tab

About the Inventory Tab


Use the Inventory tab to manage cartridge protocols, lots, quality control kits, security
certificates, analyzer languages and software.

Whenever a new or upgraded cartridge protocol is available, it must be loaded on the


Inventory tab before it can be downloaded to an analyzer group or multiple analyzer
groups. Similarly, cartridge lots must first be loaded via the Inventory tab.
Installing cartridge protocols
The Inventory tab contains an overview of the installed cartridge protocols and lots. New
cartridge protocols can be installed and new lots can be registered in this area as well as old
protocols and lots removed.

INSTRUCTIONS
1. Under Cartridge lots, click .
2. In the dialog box, select one or more cartridge protocol files to import.
The file is validated and added to the Cartridge protocols and lots area on the
Inventory tab.

Cartridge lot information


In this area, a list of installed cartridge lots is displayed for each cartridge protocol.

18
Chapter 3 - Using the Inventory Tab

Registering a new cartridge lot


INSTRUCTIONS
1. Click the Register new lot button.
2. Enter the lot ID to be added.
Removing/uninstalling a cartridge protocol or lot
Catridge lots remain on the analyzer until they are removed. Removing cartridge lots
that are no longer in use helps keep a clear working environment on the analyzer. This is
especially important when the QC regime is enabled. Lots no longer in use appear in red
because the analyzer recognizes that QC testing is overdue.

INSTRUCTIONS
1. Click next to the name of the cartridge protocol.
A warning message displays if the cartridge protocol is still in use by at least one
analyzer.
2. Click the minus (-) button next to remove a lot.
3. Confirm you want to remove the item.
You cannot remove a lot if the lot is still assigned to a cartridge protocol within a group.
Go to the Analyzers tab to remove the lot from the assigned group.

Modifying ranges for quality control lots


When a cartridge protocol is selected, the quality control (QC) kits that are linked to that
cartridge protocol become visible. Each QC kit, which is a combination of a QC product and
level, contains a separate list of QC lots. A QC lot can then be modified, so that for each
analyte linked to the current cartridge protocol, the range can be modified.
For more on QC testing workflow, see the Atellica VTLi Immunoassay Analyzer User
Guide.

INSTRUCTIONS
1. Select a cartridge protocol.
2. Click the browse button (...) next to a QC lot and select Set QC Range.
3. Modify the QC range for one or more analytes listed on the left.
In the Set QC Range window, the upper and lower limits can be adjusted.
‒ If the upper limit is left empty, it is set to infinity.
‒ When the lower limit is left empty, it is set to 0.
‒ When both values are left empty or when the Use default values button is clicked,
default values are used.
‒ Default values are retrieved from the analyzer after synchronization.
If no limits are entered, an analyzer will not begin a QC text for that lot.

19
Chapter 3 - Using the Inventory Tab

Registering a new QC lot


You can also add QC lots using the analyzer. For more information, see the Atellica VTLi
Immunoassay Analyzer User Guide.

INSTRUCTIONS
1. Click the Register lot button.
2. Enter the QC lot ID in the text field.
3. Set the QC ranges for each analyte. Follow the Instructions for Use of the QC sample to
obtain the QC acceptance limits for each lot and level.
Removing a QC lot
QC lots remain on the analyzer until they are removed (similar to cartridge lots)
INSTRUCTIONS
1. Click the browse button (...) next to the QC lot and select Remove this lot.
2. Confirm you want to remove the lot.
It is not possible to remove a QC lot if the lot is still assigned to a QC kit within a group.
Use the Analyzers tab to remove the QC lot from the assigned QC kit.

Installing analyzer software and languages


The Inventory tab contains an overview of the installed analyzer software and language
packages. New software and language packages can be registered here.
INSTRUCTIONS
1. Under Analyzer software and languages, click to add one or more inventory
packages.
2. Select analyzer software or language packages.
3. Click Open to install the selected packages.
If you see the message “Failed analyzer software upgrade”, try the upgrade again. If
problem persists, please contact your local service representative.
Removing an inventory package
1. Click the minus (-) button next to an item to remove the selected package.
2. Click Yes to confirm removal of the inventory package.
Working with security certificates
The Inventory tab contains an overview of the installed root security certificates and allows
you to manage them.
Installation of root security certificates is required to enable encryption if your
middleware uses a certificate authority (CA). If your system uses self-signed certificates,
use the encryption feature as described in Chapter 6, page 30.
You can tell the expiration status of a security certificate by its color (gray = valid, yellow =
nearing expiration, red = expired).

20
Chapter 3 - Using the Inventory Tab

Adding a security certificate


Analyzers using embedded software version V2.X do not support security certificates encryption.

INSTRUCTIONS
1. Under Certificates, click + to add a new security certificate.
2. Select the appropriate security certificate file.
Supported types are: crt, pem, cer, der, pfx, p12, p7b, p7s.

3. Click Open to install the selected security certificate.


4. Enter the security certificate password (pfx, p12 certificates only) and click OK.

Removing a security certificate


You can’t remove a security certificate assigned to a group.

INSTRUCTIONS
1. On a Certificate, click - to remove.
2. Click OK on the confirmation dialog.

21
Chapter 3 - Using the Inventory Tab

22
CHAPTER 4
Using the Users Tab
Chapter 4 - Using the Users Tab

About the Users Tab


You can use the Users tab to create and maintain a list of operators for the analyzer. You
can:
‒ View existing user details
‒ Change details for a user
‒ Create a new user
‒ Delete a user

Only Administrator users can access the User tab options.

View existing users


To view the current list of users, click the User tab. Current users are listed alphabetically.
Click a column header to sort the display by that column.

Adding a new user


INSTRUCTIONS
1. Click the User tab.
2. Click Create New User button.
3. Enter the following details in the Create New User dialog box:
‒ User name: The name of the operator.
‒ User ID: The alphanumeric identifier for the operator.
‒ Role: Click User or Administrator to assign that role to the operator.
‒ Password: The login password for the operator. Password rules are:
• Minimum password length is 12 characters
• Password must contain 3 of the following 4 types of characters: uppercase letters,
lowercase letters, numbers, and symbols (limited set of symbols allowed)
• No part of the password should contain the Operator ID
‒ Account: Click the Enabled checkbox to activate the user.
‒ Active from/until: Choose the start and end dates for operator ID.
4. Do one of the following:
‒ Click Create user to accept your changes.
‒ Click Cancel to close the dialog box without making changes.

24
Chapter 4 - Using the Users Tab

Change details for an existing user


Follow the instructions below to view and change information about an existing user.

INSTRUCTIONS
1. Click the User tab.
2. Click the user name in the list you want to change.
3. Click the Edit User button.
The User Details dialog box displays.
4. Change the information as necessary.
5. Do one of the following:
‒ Click OK to accept your changes.
‒ Click Cancel to close the dialog box without making changes.

Delete a user
Follow the instructions below to delete a user.

INSTRUCTIONS
1. Click the User tab.
2. Click the user name in the list you want to delete.
3. Click Delete User button.
4. Do one of the following:
‒ Click OK to accept your changes.
‒ Click Cancel to close the dialog box without making changes.

25
Chapter 4 - Using the Users Tab

26
Chapter 5
System Settings
Chapter 5 - System Settings

About System Settings


Use the System Settings options to control the service software.
If the Windows time zone of the computer running the Service Software server is
changed, restart the Atellica VTLi Service Software Server (using Windows Services) to
ensure the Service Software application uses the new time zone information.

Changing Analyzer settings


The options in this area deal with synchronizing information in the service software with the
analyzers.

INSTRUCTIONS
1. Click in the top bar to open the System settings dialog box.
2. Under Analyzer, select one or more of the following:
‒ Sync date and time: This option controls the date, time, and time zone. The default is
Off.
Sync date and time should be Off when using middleware.

‒ Sync users: This option controls synchronizing users. The default is On.
‒ Manage lots: Synchronizes lot information. When On, registered lots on a single
analyzer are also synchronized with all analyzers in the same group. QC measurements
do not have to be performed on one analyzer only.
Sync users and Manage lots should be Off when using middleware.

‒ Warn if not connected for: Set the time frame when a warning message displays if an
analyzer is not docked.
3. Do one of the following:
‒ Click OK to accept your changes.
‒ Click Cancel to close the dialog box without making changes.

Changing Service Software settings


INSTRUCTIONS
1. Click in the top bar to open the System settings dialog box.
2. Under Service Software, select one or more of the following:
‒ Automatic logout after: Select the inactivity timeout period to automatically log out a
user.
‒ Certificate expiry due warning: Select the time frame for a warning that a security
certificate is about to expire.
‒ SRS Server IP: Enter the IP address of the SRS server.
‒ SRS File Transfer: Select if data should be uploaded to SRS.
3. Do one of the following:
‒ Click OK to accept your changes.
‒ Click Cancel to close the dialog box without making changes.

28
Chapter 6
Network
Connectivity
Chapter 6 - Network Connectivity

About Network Connectivity


You must have information from your network administrator about whether the IP address
used for the analyzer is a static address or assigned dynamically by a Dynamic Host
Configuration Protocol (DHCP) server.
‒ In case of a static address you must have the IP address of the subnet mask and default
gateway for the network you plan to use for connections.
‒ You must have an IP address assigned for the analyzer that falls within the IP address
range allowed by the network. The IP address must be unique.
‒ You must have the IP address of the service software. See Appendix A, page 32 for
installation information.
‒ You must have Administrator rights to configure the analyzer and service software.
You must configure analyzer connectivity on the analyzer before you can transfer data to
and from the service software. The service software must be connected to the network you
want the analyzer connected to.
You should work with your IT department to ensure proper network configuration
settings for procedures in this chapter.
Configuring the Atellica VTLi Immunoassay Analyzer with a static IP address

INSTRUCTIONS
1. If required, log in to the analyzer.
2. On the Home screen, tap > Connectivity Settings> Analyzer LAN Settings.
3. Tap Change.
4. Read the warning message and tap OK.
5. To enter the static IP address details, perform the following steps:
‒ Select Static.
‒ Tap Next.
‒ Enter the IP address, using the displayed numeric pad, and then tap Next.
‒ Enter the Subnet mask, using the displayed numeric pad, and then tap Next.
‒ Enter the default gateway, using the displayed numeric pad, and then tap Next.
6. Do one of the following:
‒ Tap OK to restart the analyzer and apply the changes.
‒ Tap Cancel to discard the changes.
You can now proceed to the configuration procedure for the service software to complete
the configuration.
Configuring the Atellica VTLi Immunoassay Analyzer with a DHCP server
Follow this procedure on the analyzer if your network uses a Dynamic Host Configuration
Protocol (DHCP) server.

INSTRUCTIONS
1. If required, log in to the analyzer.
2. On the Home screen, tap > Connectivity Settings> Analyzer LAN Settings.
3. Tap Change.
4. Read the warning message and tap OK.
5. Select DHCP.

30
Chapter 6 - Network Connectivity

6. Tap Next.
7. Do one of the following:
‒ Tap OK to restart the analyzer and apply the changes.
8. Tap Cancel to discard the changes.
Configuring Wireless connectivity to an existing network
INSTRUCTIONS
1. If required, log in to the analyzer.
2. On the Home screen, tap > Connectivity Settings> Analyzer WLAN Settings.
3. Tap Change.
4. Read the warning message and tap OK.
5. Select On and tap Next.
6. Tap the Wifi network name you want to use and then tap Next.
7. Enter the password and tap Next.
8. Do one of the following:
‒ To keep the existing IP address, tap No. Tap Yes on the confirmation screen and then
tap Next to return to the Connectivity Settings sreen.
‒ To change the IP address, tap Yes then tap Next. Continue with step 9.
9. On the Address Type screen, tap DHCP or Static, and then tap Next.
10. For DHCP:
‒ Tap OK to restart the analyzer or Cancel to discard the changes and return to the
Address Type screen.
11. For Static:
‒ Enter the IP address and tap Next.
‒ Enter the Subnet Mask and tap Next.
‒ Enter the Defaulty gateway and tap Next.
‒ Tap OK to restart the analyzer or Cancel to discard the changes and return to the
Address Type screen.
Configuring Wireless connectivity to a new network
INSTRUCTIONS
1. If required, log in to the analyzer.
2. On the Home screen, tap > Connectivity Settings> Analyzer WLAN Settings.
3. Tap Change.
4. Read the warning message and tap OK.
5. Select On and tap Next.
6. Tap + Add network and then tap Next.
7. On the Add Network SSID screen, enter the Wifi network name and then tap Next.
8. Tap the security type and then tap Next.
9. Enter the password and tap Next.
10. Follow steps 8-11 in the Configuring Wireless connectivity to an existing network
section on this page.

31
Chapter 6 - Network Connectivity

Configuring Service Software connectivity


You perform the following steps on the analyzer to establish a connection between the Atellica VTLi
Immunoassay Analyzer and service software.

INSTRUCTIONS
1. If required, log in to the system.
2. On the Home screen, tap > Connectivity Settings> Service Software Settings.
3. Tap Change.
4. Read the warning message and tap OK.
5. Select Enabled and tap Next.
6. Enter the service software server IP address and tap Next.
7. Tap Next to confirm the connection IP port.
8. Tap Next to confirm the watchdog IP port.
9. Tap OK to confirm the command IP port.
10. Do one of the following:
‒ Tap Yes to apply the changes.
‒ Tap Cancel to discard the changes.
In most cases, the settings in steps 7–9 should remain unmodified. These settings should only
be modified in special configurations (when the ports are not available).When changing these
settings on the analyzer, make sure that they are also correctly configured in service software or
communication between the analyzer and service software will not be possible.
Configuring middleware software connectivity
For software version 3.1, it is possible to encrypt POCT1-A communication with TLS (transport layer
security) certificates. To enable encryption, configure your middleware software to work with either
a self-signed certificate, or with a certificate authority (in combination with a root certificate).
Follow the steps below to establish a secure connection between the Atellica VTLi Immunoassay
Analyzer and POCT1-A middleware software.
If your middleware package uses self-signed certificates, you can enable encryption using the
steps below. If your middleware uses a certificate authority, you first need to install the root
certificate on the analyzers via the Inventory tab. See Chapter 3, page 20.

INSTRUCTIONS
1. If required, log in to the analyzer.
2. On the Home screen, tap > Connectivity Settings> Middleware Settings.
3. Tap Change.
4. Read the warning message and tap OK.
5. On the Communications screen, select Enabled and tap Next.
6. On the Encryption screen, read the warning, select Enabled if applicable and tap Next.
7. Enter the middleware server IP address and tap Next.
8. Tap OK to confirm the modified connectivity settings.
9. Do one of the following:
‒ Tap Yes to apply the changes.
‒ Tap Cancel to discard the changes.

32
Chapter 6 - Network Connectivity

Enabling a printer
You must enable printing if you purchased an optional thermal printer before it can be used to print.

INSTRUCTIONS
1. If required, log in to the analyzer.
2. On the Home screen, tap > Connectivity >Settings> Printer Settings.
3. Tap Change.
4. Read the waring message and tap OK.
5. On the Result Printing screen, tap Enabled.

33
Chapter 6 - Network Connectivity

34
APPENDIX A
Specifications
and Installation
Appendix A - Specifications and Installation

Service Software Specifications

Specifications

Operating system Microsoft Windows 10, or Windows Server 2019


RAM 8GB minimum
Free disk space 100GB minimum
Drive USB
Network connection LAN or Wifi
Monitor Color monitor with 1280x960 resolution minimum
Processor 2.6 GHz, 64-bit (x64) minimum
Accessories Mouse and keyboard

Installation Workflow
Initial Atellica Analyzer VTLi service software installation is done by a Siemens
Healthineers service engineer. The information provided here is for reference only and
should only be changed after consulting with both your IT and Siemens Healthineers
technical representatives.

Use a fixed IP address for the Atellica VTLi Service Software.

Installing the server


1. Double click ssw-service-3.1.1032.0.msi and follow the on-screen steps.
‒ By default the software is installed in
C:\Program Files (x86)\Siemens Healthcare Diagnostics\Atellica VTLi Service Software
Server
Generate new certificate with additional SANs (Optional)
The client can reach the server by its hostname (and localhost when client is installed on
the same host). During installation a certificate is being generated bound to this hostname.
When this machine should be reached through an alternative name, a new certificate is
needed. This certificate is being extended with one or more SAN(s) (Subject Alternative
Names).

INSTRUCTIONS
The following steps describe the process of adding one or more SANs.
1. Open a command prompt with administrator privileges in the following directory:
C:\Program Files (x86)\Siemens Healthcare Diagnostics\Atellica VTLi Service Software
Server
2. Enter the command:
certgen -d <alternativename> <alternativename>
where alternativename can be any name (i.e. a FQDN) through which this host can be
reached. Multiple alternative names are allowed.
As a result a new certificate is generated, registered and exported into the
‘%PROGRAMDATA%\Siemens Healthcare Diagnostics\Atellica VTLi Service Software
Client\Certificates’ folder.
3. Copy the exported certificate to the ‘%PROGRAMDATA%\Siemens Healthcare Diagnostics\
Atellica VTLi Service Software Server\redist’ folder for ease of distribution along with the
client installer.

36
Appendix A - Specifications and Installation

Deploy client certificates manually (Optional)


You might to do this in the following situations:
‒ Exported certificate needs to be deployed to an already installed client.
‒ IT department has a deployment strategy for deploying trusted certificates.
The certificate must be deployed in following certificate stores on the client:
‒ Local Computer\Personal\Certificates
‒ Local Computer\Trusted Root Certification Authorities\Certificates

Installing the client


During installation of the server, a special folder (‘‘%PROGRAMDATA%\Atellica\VTLi Service
Software Server\redist’) is created. All files needed for client installation are placed in this
folder.
When the client installer needs to be moved, be sure to move the ServiceURL.txt and *.cer
files along with it. If these files are available the following actions take place during client
installation:
‒ ServiceURL.txt: When the client is installed (and no client settings have remained from
a previous installation) the service URL is being set correctly. This will prefill the correct
‘Server’ field upon client startup.
‒ *.cer. All available certificates will be registered into the necessary certificate stores on
the client. Normally a single certificate should exist.

INSTRUCTIONS
1. Double click ssw-client-3.1.1032.0.msi, located within the redist directory (created
during Server install) and follow the on-screen steps.
‒ By default the software is installed in
‘C:\Program Files (x86)\Siemens Healthcare Diagnostics\Atellica VTLi Service Software
Server

Uninstalling the Service Software Client/Server


INSTRUCTIONS
1. Go to the Control Panel> Programs and Features.
2. Select the Atellica VTLi Service Software Client entry and click the Uninstall button.
3. Go to the Control Panel> Programs and Features.
4. Select the Atellica VTLi Service Software Server entry and click the Uninstall button.

37
Appendix A - Specifications and Installation

38
APPENDIX B
Error Codes
Appendix B - Error Codes

Listing of Error Codes

Patient Test Results


Error Number Description

150 Unexpected failure during test. Test failed.


350 Cartridge protocol invalid.
450 Analyzer cover not closed in time.
455 Sample was not added to cartridge within required time.
451 Temperature controller error.
452 Sample detector error.
453 Cartridge reader error.
454 Cartridge not recognized.
550 Unexpected failure during test. Test failed.
551 Analyzer cover opened during test. Test aborted.
552 Unexpected failure during test. Test failed.
553 Unexpected failure during test. Test failed.
554 Cartridge moved during sample addition or closing of cartridge lid.
555 Cartridge moved during closing of cartridge lid.
556 Cartridge moved during test. Test aborted.
557 Cartridge removed during test. Test aborted.
558 Insufficient sample or a blockage in cartridge.
559 No result available (data processing failed).
560 No result available (temperature (°C) out of range).
561 - 562 Detection error.
563 Cartridge hardware error.
564 Power button error.
565 Cover detector error.
566 Docking station connection error.
567 Battery or charging hardware error.
568 Cartridge error.
569 Cartridge moved during test. Test aborted.
570 Too much movement or analyzer not horizontal. Test failed.
571 Tilt sensor error.
572 QC result is out of range.
573 Test performance deviation detected. Test failed.
576 Detection error.
577 Test performance deviation detected. Test failed.

40
Appendix B - Error Codes

Patient Test Results


Error Number Description

578 Display hardware error.


579 - 581 Cartridge error.
650 Result calculation failed. Test failed.
651 - 662 Invalid result due to signal deviation.
950 Analyzer stopped working.
951 Service access failure.

General Errors
Error Number Description

1000 - 1018 Analyzer problem.


1200 Analyzer problem.
1202 Cartridge not removed or inserted too early.
1203 Analyzer not horizontal during self-test.
1400 - 1401 System update failed.
1402 Update failure due to too low battery level. Charge the battery and
retry the update.
1403 Data Migration Failure
1600 Battery level too low for test. Dock the analyzer to charge the battery
to about at least 15% and retry.
1601 The cartridge information for the cartridge/lot is corrupt. If the
problem persists, the analyzer needs servicing. Contact your
administrator or technical support representative.
1602 Firmware update required to read cartridge.
1603 Cartridge could not be read. Retry with another cartridge. If the
problem persists, contact your administrator or technical support
representative.
1604 Expired cartridge used.
1605 Cartridge already used.
1606 Cartridge could not be read by analyzer. Ensure the cartridge
protocol for the test indicated on the cartridge pouch is installed on
the analyzer.
1607 Incorrect cartridge type tested.
1608 Cartridge protocol failed to load.
1609 Sample added too early.

41
Appendix B - Error Codes

General Errors
Error Number Description

1610 Cartridge detection error. Possible causes are cartridge handling


(touching transparent part, incorrect cartridge insertion), or the
analyzer needs to be cleaned. If the problem persists, contact the
your administrator or technical support representative.
1611 User removed cartridge during test
1612 Battery not charged in time.
1613 Cartridge failure.
1614 Initial cartridge insertion not correct.
1615 Cartridge lot not released for testing.
1616 Failed QC locked analyzer.
1617 QC not tested in time.
1618 Incorrect cartridge lot tested.
1619 Cartridge or QC lot is already registered.
1620 Cartridge lot already exists for another test. If the problem persists,
contact your administrator or technical support representative.
1800 Sample not added in time.
1801 Sample added too early.
1802 Analyzer cover not closed in time.
1803 RFId incorrectly programmed.
1804 - 1805 Sample added too early.
2000 Analyzer cover opened during test.
2001 - 2002 Cartridge failure or handling error.
2003 Cartridge moved during measurement.
2004 Cartridge failure or handling error.
2005 Non filling cartridge/ Not enough sample.
2006 - 2007 Analyzer problem.
2008 Temperature out of range.
2009 Cartridge failure or handling error.
2010 Cartridge moved during measurement.
2011 Analyzer tilted out of range during test.
2012 Analyzer problem.
2015 Analyzer problem.
2016 - 2017 Cartridge error.
2200 Result is invalid.
2700 Analyzer not docked when requested.

42
Appendix B - Error Codes

General Errors
Error Number Description

2701 Hiding the only remaining cartridge lot is not allowed. Active a new
lot first.
4001 - 4002 Incompatible barcode scanned
4051 No users have been send by SSW or MW.
4052 Invalid access code.
4053 Account not activated in SSW or MW.
4054 Expiration data in SSW or MW past.
4055 Training overdue in MW.
4056 Wrong password used.
4057 Wrong user permission.
4103 - 4104 Incompatible barcode scanned.
4105 - 4106 Incorrect QC sample.
4107 - 4108 System failure.
4109 Expired QC sample.
4110 Unknown QC lot .
4111 Incompatible barcode scanned.
4112 - 4114 Incorrect QC sample.
4115 Wrong QC barcode scanned. Scan the barcode from the QC vial.
4116 QC acceptance limits were not entered in Service Software or
Middleware.
4117 The scanned barcode does not match the scanned barcode from the
QC vial.
4118 Wrong barcode scanned. QC vial was scanned. Locate the
barcode containing the QC acceptance limits; see the QC package
insert.
9000 Fatal system problem.
9001 - 9003 System failure.
9004 Analyzer problem.
9005 Anonimise function used in SSW. Ananlyzer needs service.
9006 System failure.

43
Appendix B - Error Codes

Communication Errors
Error Number Description

1201 Memory storage full - memory can be freed by uploading results to


Middleware or modifying the data overwriting setting in the Service
Software.
2400 Memory low. Upload results to Middleware to free up space, or
change memory settings in Service Software.
2600 Network error. Failed to communicate with Middleware.
2650 Network error. Failed to communicate with Service Software.
2699 Communications error.
4150 - 4153 HHA configuration changes in network settings.
4154 - 4157 HHA SSW configuration changes in settings.
4158 Analyzer Settings: Change WiFi Connection
4159 WiFi Settings: Invalid Ssid
4160 WiFi Settings: Invalid Security Type
4161 WiFi Settings: Invalid Encryption Type
4162 WiFi Settings: Invalid Password

44
Index
Factory defaults, 16

G
Groups
deleting, 12
A
properties, 10
About screen, 2, 4
working with, 10
Adding
cartridge protocol to a group, 12, 14 H
new user, 22 How to
Analyzer pane, 8 add cartridge protocol, 12
Analyzer properties menu, 15 add lot to a protocol in group, 14
Analyzer renaming, 15 add new user, 22
Analyzer status add new wireless network, 29
viewing, 8 backup and restore, 5
Analyzer tab, 8 change analyzer settings, 26
change QC workflow, 13
B
change service software settings, 26
Backup and restore, 5
change user details, 23
C configure DHCP server for analyzer, 28
Cartridge lot information, 18 configure middleware connectivity, 30
Cartridge lots, 12 configure service software connectivity,
Cartridge protocols 30

installing, 18 configure static IP address for analyzer, 28

Changing analyzer settings, 26 copy group settings, 11

Changing user details, 23 create a new analyzer group, 10

Client certificates, 33 delete a group, 12

Color coding delete a user, 23

cartridge lots, 12, 15 edit group settings, 11

Common icons and buttons, 4 exit software, 4

Creating install cartridge protocols, 18

new analyzer group, 10 install software and languages, 20


lock an analyzer, 15
D log in, 2
Deleting log out, 4
a user, 23 modify ranges for QC lots, 19
DHCP server, 28 register a new cartridge lot, 20
Display resolution, 32 remane existing group, 11
remove a cartridge lot or protocol, 19
F

45
remove a QC lot, 20 Q
remove cartridge from group, 13 QC workflow settings, 13
remove lot from protocol group, 14
remove patient data, 16
R
Registering a new cartridge lot, 20
rename an analyzer, 15
Removing a QC lot, 20
reset to factory defaults, 16
Reset to factory defaults, 16
unlock an analyzer, 16
update language and software, 11 S
use existing wireless network, 29 SANs, 32
Service software
I
configure connectivity, 30
Installing
Single analyzer, 14
analyzer software and languages, 20
Specifications, 32
service software, 32
Static IP address, 28
Inventory tab, 18
Steps to
L add cartridge protocol, 12
Locking an analyzer, 15 add lot to a protocol in group, 14
login screen, 2 add new user, 22
add new wireless network, 29
M
backup and restore, 5
Memory required, 32
change analyzer settings, 26
Middleware settings, 30
change QC workflow, 13
Modifying QC lot ranges, 19
change service software settings, 26
Monitor resolution, 32
change user details, 23
N configure DHCP server for analyzer, 28
Network connectivity, 28 configure middleware connectivity, 30
configure service software connectivity,
O 30
Operating system, 32 configure static IP address for analyzer, 28
Overview copy group settings, 11
service software, 3 create a new analyzer group, 10
delete a group, 12
P
delete a user, 23
Password rules, 22
edit group settings, 11
Patient data
exit software, 4
removing, 16
install cartridge protocols, 18
POCT-1A, 30
install software and languages, 20
Properties pane, 9
lock an analyzer, 15

46
log in, 2 adding a new network, 29
log out, 4 existing network, 29
modify ranges for QC lots, 19
register a new cartridge lot, 20
remane existing group, 11
remove a cartridge lot or protocol, 19
remove a QC lot, 20
remove cartridge from group, 13
remove lot from protocol group, 14
remove patient data, 16
rename an analyzer, 15
reset to factory defaults, 16
unlock an analyzer, 16
update language and software, 11
use existing wireless network, 29
System settings, 26

T
Tabs
Analyzer, 8
Inventory, 18
Users, 22
Technical specifications, 32

U
Uninstalling
service software, 33
Unlocking an analyzer, 16
Updating
language and software, 11
User interface, 3
Users tab, 22

V
Viewing
analyzer status, 8
existing users, 22

W
Wireless connectivity

47

You might also like