0% found this document useful (0 votes)
7 views

Vol 2 myQA Cockpit User's Guide

The myQA Cockpit User's Guide provides essential information on the myQA system, including installation procedures, intended use, and functionalities of the web application. It serves as a viewer for Quality Assurance results and is designed for use by medical physicists and radiooncologists. The guide emphasizes the importance of following safety precautions and proper installation to ensure optimal performance of the myQA system.

Uploaded by

Khang Phan
Copyright
© © All Rights Reserved
Available Formats
Download as PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
7 views

Vol 2 myQA Cockpit User's Guide

The myQA Cockpit User's Guide provides essential information on the myQA system, including installation procedures, intended use, and functionalities of the web application. It serves as a viewer for Quality Assurance results and is designed for use by medical physicists and radiooncologists. The guide emphasizes the importance of following safety precautions and proper installation to ensure optimal performance of the myQA system.

Uploaded by

Khang Phan
Copyright
© © All Rights Reserved
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 31

User’s Guide

Vol. 2

myQA Cockpit
SW Version: 2.12 | Release: 2019-002
Notice
This manual is an integral part of the myQA® system and should always be kept at hand. If the manual
is missing, immediately contact the IBA Dosimetry GmbH for a copy.
Observance of the manual instructions is required for proper performance and correct operation of the
myQA® system. The myQA® system and its accessories must not be used for any other purpose than
what is described in the accompanying documentation (intended use). Violation will result in loss of
warranty.
IBA Dosimetry GmbH does not accept liability for injury to personnel or damage to equipment that may
result from misuse of this equipment, failure to observe the hazard notices contained in this manual, or
failure to observe local health and safety regulations.
Under no circumstances shall IBA Dosimetry GmbH be liable for incidental or coincidental damage
arising from use of the equipment described in this document.
No part of the accompanying documentation may be translated or reproduced without written
permission of IBA Dosimetry, unless reproduction is carried out for the sole purpose of being used by
several people in the same department.
The user must treat the accompanying documentation like any other copyrighted material. If part of the
accompanying documentation is provided in electronic form, these files shall not be modified in any
way. IBA Dosimetry and its suppliers retain title and all ownership rights to the accompanying
documentation (in either electronic or printed form).

IBA Dosimetry GmbH


Bahnhofstrasse 5
DE-90592 Schwarzenbruck
Germany

Phone: +49 9128 607-0


Fax: +49 9128 607-10

www.iba-dosimetry.com

Last update: 2019-10-19


Documentation ID: P-19-002-510-002 01
© 2019 IBA Dosimetry GmbH, Schwarzenbruck

ii | Notice | myQA User's Guide - Vol.2. myQA Cockpit


Table of Contents
1. Introduction ..................................................................................... 1
1.1. Intended Use.............................................................................................................................1
1.2. General Product Description ..................................................................................................1
1.2.1. Basic Functionalities ..............................................................................................................1
1.2.2. Multiple Users ........................................................................................................................2
1.2.3. Units .......................................................................................................................................2
1.2.4. Login ......................................................................................................................................2
1.3. Related Documents .................................................................................................................2
2. Cockpit installation ......................................................................... 3
2.1. Web Browser Requirements ..................................................................................................3
2.2. Installation .................................................................................................................................3
2.2.1. Installation Procedure ............................................................................................................3
2.2.2. Use SQL Server User Authentication if myQA Cockpit is installed on a different Computer 6
2.2.3. HTTPS Setup .........................................................................................................................6
2.3. License Activation ....................................................................................................................7
2.3.1. Activation with IBA License Manager ....................................................................................7
2.3.2. Activation with the myQA Cockpit SW ...................................................................................7
2.4. Browsing the myQA Cockpit ...................................................................................................7
2.5. Page Refresh ............................................................................................................................8
3. Dashboard ....................................................................................... 9
3.1.1. Machines QA Status ........................................................................................................... 10
3.1.2. Tasks Status of the Active Protocol .................................................................................... 11

4. Test Results Page ......................................................................... 12


4.1. Components Displayed in the Test Results Page............................................................ 12
4.2. Task Navigation Panel ......................................................................................................... 13
4.3. Status Statistics of the Selected Task ............................................................................... 14
4.4. Information of Tests .............................................................................................................. 15
4.4.1. Status of a Test Category ................................................................................................... 15
4.4.2. Expanded View of a Category ............................................................................................ 15
4.4.3. Detailed View of a Test ....................................................................................................... 16

5. Trend Analysis Page..................................................................... 17


5.1. Selecting a Test ..................................................................................................................... 17
5.2. Trend Analysis Graphical Display....................................................................................... 19
5.3. Export Trend Analysis as a *.csv File ................................................................................ 20
5.3.1. Export as a *.csv File .......................................................................................................... 20
5.3.2. Open a *.csv File with Excel ............................................................................................... 21

6. Patient Cockpit.............................................................................. 24
6.1. Navigation Panel and Filters for Display............................................................................ 24

myQA User's Guide - Vol.2. myQA Cockpit | Table of Contents | iii


6.2. Statistics of Plan Status of all Patients ............................................................................... 25
6.3. Patient QA Table ................................................................................................................... 25
7. Troubleshooting ............................................................................ 27

iv | Table of Contents | myQA User's Guide - Vol.2. myQA Cockpit


1. Introduction
1.1. Intended Use
The CSP dashboard (also called myQA Cockpit) is a software that retrieves and displays previously
measured or stored QA results from treatment and diagnostics devices as well as patient QA data. It
addresses medical physicists and radiooncologists with a grouped overview of test results, work tasks
and trend analysis on existing data.
The CSP dashboard (thereafter called myQA Cockpit) does not itself control the functions or
parameters of any other medical device, but displays the results of Quality Assurance procedures for
analysis, reporting and printing.
Note: For Non-Intended Use and Intended Users, see Sections 1.2 and 1.3, Vol.1, myQA Platform and
Devices User’s Guide, respectively.

1.2. General Product Description


myQA Cockpit is a web application - a component of the myQA® software package which allows clinical
users to read Machine QA data online. It connects to the myQA database server and is used to display
QA results from Machines, imaging devices, and patient based QA results (plan verification) online.
The web based viewer does not require local installation and can be accessed from anywhere in the
clinic. It can be browsed on different browsers, e.g., desktop or mobile.
myQA Cockpit should be purchased separately. However, according to the Intended Use, myQA
Cockpit is not a stand-alone product. It should be used together with myQA Platform and at least one of
the myQA application modules.

1.2.1. Basic Functionalities


myQA Cockpit displays four pages:
■ Dashboard
This is the start page of the myQA Cockpit. It displays the machines defined in the Equipment
Setup page in the myQA Platform. Only the machines marked for display by checking the Show in
Cockpit box in the myQA Platform - Equipment Setup - Machine Editor dialog are displayed.
■ Test Results
 Displays the latest status of the machine for the active protocol including various levels of
details:
o The machine overall status
o Status of tasks
o Status of tests including the detailed measurement results per test
 Provides the latest QA statistics per task
■ Trend Analysis
Provides a graph of the test results, expected values, and the specified tolerances (warning and fail)
versus the execution dates.
■ Patients
Shows the patients listed in myQA Patients including the projects assigned. By default, the project
with the latest change date is shown per patient. All assigned projects per patient can be viewed by
expansion.

myQA User's Guide - Vol.2. myQA Cockpit | Introduction | 1


1.2.2. Multiple Users
Multiple users can use myQA Cockpit from different computers at the same time. As it is just a viewer,
no conflicts due to multiple data access can occur.

1.2.3. Units
Cockpit uses the units defined in the myQA workspace: myQA Platform > Options > Platform >
Settings > Units. Changing the units in myQA Platform workspace will be reflected on myQA Cockpit
after refreshing the myQA Cockpit website (e.g. by pressing the F5 key on the computer keyboard.).

1.2.4. Login
Users can log in with the myQA user credentials.

1.3. Related Documents


This document is one volume of the myQA User’s Guide. The complete User’s Guide includes:
Vol. 1: myQA Platform and Devices
Vol. 2: myQA Cockpit
Vol. 3: myQA Machines
Vol. 4: myQA FastTrack
Vol. 5: myQA Patients
Vol. 6: myQA Accept
For general safety precautions, technical support, and contact information including complaint report
form, please see Vol. 1, myQA Platform and Devices.

IM PO RT ANT N O T IC E
OBSERVE SAFETY PRECAUTIONS
The safety precautions in Vol. 1, myQA Platform and Devices, are valid for the
complete myQA® system. Ensure to observe the safety precautions described in
the Vol. 1 as well as in this volume.

2 | Introduction | myQA User's Guide - Vol.2. myQA Cockpit


2. Cockpit installation
2.1. Web Browser Requirements
Computers with desktop, tablet or mobile web browsers:
■ Optimally viewed with the minimum width of 768 px.
■ Internet Explorer 11+
■ Chrome 35+ for Windows
■ Firefox 29+
■ Mobile Safari 6.0+
■ Android Browser: Chrome Mobile 35+
■ Microsoft Edge 41+ (Windows 10 systems)

IM PO RT ANT N O T IC E
WEB BROWSERS
Be aware that if other browsers than the recommended ones are used, it could
be possible that some features, e.g. Trend Analysis are not displayed correctly.

2.2. Installation

2.2.1. Installation Procedure


IM PO RT ANT N O T IC E
INSTALLATION
myQA Cockpit should be installed only once on a server that it is accessible by
all myQA Cockpit users. It does not need to be installed on every
computer/mobile device where myQA Cockpit will be accessed.

An IT administrator of a clinic may carry out the myQA Cockpit installation.


Insert the installation disc into the DVD drive of the computer.
Double click Cockpit.exe to start the installation wizard; myQA-Cockpit Setup Wizard opens.

Click Next > and follow the installation instructions.


During the installation process, the myQA Database Wizard will open and display the database
connection status.

myQA User's Guide - Vol.2. myQA Cockpit | Cockpit installation | 3


 If myQA Cockpit and myQA main SW are installed on the same computer, the database
connection will be automatically performed.
 If myQA Cockpit is installed on a different computer, click Import connection file, browse and
open the connection file created when installing myQA main SW, myQA-DB-Connection.ICSI.
o The connection file can be exported from the About myQA dialog of myQA.

o Once the connection file is imported, the database connection will be automatically
established.
 Click Finish.
Continue to follow the installation instructions in myQA-Cockpit Setup Wizard to finish the
installation.

4 | Cockpit installation | myQA User's Guide - Vol.2. myQA Cockpit


Port selection
By default, myQA Cockpit uses Website Port 80, and IBA Service Port 52803. If one of these ports is
blocked by another application, the Cockpit Service Setup dialog will pop up during the installation to
notify the user and suggest a free port.

a b

Example: the default website port, 80, was blocked and the next free port, 81, is set.

If the user does not agree with the proposed port, the user can either
specify ports manually (a) or
click the Rescan button to set the next available port (b)
The selected ports will be saved upon clicking Save and Close and the installation will continue.

Note: If you want to use the start.html in the installation CD to install myQA Cockpit, please use the
Internet Explorer or Edge browser and do not use the Firefox or Chrome browser.
Opening the start.html with a Firefox or Chrome browser to install myQA Cockpit, a pop-up dialog
will ask either to save the *.exe file to a local folder on the computer or cancel the process.
Double-click the saved *.exe file to start the installation, the process is aborted at once. This
issue may be due to that the *.exe file is copied to a new folder while the rest of the installation
files are still in the original location.

myQA User's Guide - Vol.2. myQA Cockpit | Cockpit installation | 5


2.2.2. Use SQL Server User Authentication if myQA Cockpit
is installed on a different Computer
myQA Cockpit uses a Windows Service to connect to the SQL server database. If myQA Cockpit is
configured to use Windows Authentication, the user configured to run the myQA Windows service will
be used to access the databases. By default, this is “NT Authority\System”.
If myQA Cockpit is installed on a different computer than the SQL server, the service user (i.e., “NT
Authority\System” of myQA Cockpit computer) needs to be granted permission on the SQL server
(which has its own separate “NT Authority\System” user), in order for Windows Authentication to work.
This can be done either directly or by assigning the user to a group with permission on the SQL server.
In this scenario, we suggest using a SQL server user to connect to the database instead of using
Windows Authentication.

2.2.3. HTTPS Setup


It is recommended to use HTTPS to increase the website security. To use HTTPS, myQA Cockpit must
be configured with SSL certificates. IBA cannot produce SSL certificates for the clinics. The SSL
certificates can be purchased or self-created by the clinic itself.

Configuration of myQA Cockpit to use HTTPS


myQA Cockpit uses nginx as a web application server. Once the certificates are ready, nginx must to be
configured with these certificates. Please consult the documentation of nginx for instructions.
The nginx configuration file can be found in the following path:
C:\Program Files (x86)\IBA Dosimetry\myQA-Cockpit\WebSite\conf

The IBAWebserverWrapper windows service must be restarted after the configuration is finished.

To set the SSL certificates properly, myQA Cockpit should be hosted under a static IP or a domain
name. This IP address or domain name should be specified in the certificates. If the website address
specified in the certificates and the address to access myQA Cockpit are not matching; users may get
untrusted connection messages in browser.
Depending on your certificate status (e.g. when it is self-signed), users may still get an untrusted
connection error message in the browser.
In both cases, users can ignore the warning messages and proceed.

6 | Cockpit installation | myQA User's Guide - Vol.2. myQA Cockpit


2.3. License Activation
When the myQA Platform is installed and activated, myQA Cockpit is automatically activated.
If myQA Cockpit is installed on a computer where the myQA Platform is not installed, license activation
is required. It is recommended to activate the license by use of the IBA License Manager.

2.3.1. Activation with IBA License Manager


When myQA Cockpit is installed, the IBA License Manager is automatically installed.
Click Start > All Programs >IBA Dosimetry > IBA License Manager to open the IBA License
Manager wizard.
Click the Activation button, and follow the instructions in the wizard. You will need to provide the
product key in order to activate Cockpit.

To see the user manual of the wizard, click the Help button.

2.3.2. Activation with the myQA Cockpit SW


Click Start > All Programs > IBA Dosimetry > myQA-Cockpit > myQA to open the “About myQA”
window.
Follow the instructions in Chapter 10, Vol.1, myQA Platform and Devices, to activate the license

2.4. Browsing the myQA Cockpit


IM PO RT ANT N O T IC E
ACCESSING MYQA COCKPIT
myQA Cockpit can be accessed via URL. Use the computer name of the server
or the IP address of the server where myQA Cockpit is installed to log in to
myQA Cockpit.

myQA User's Guide - Vol.2. myQA Cockpit | Cockpit installation | 7


Use the same password and username as for the myQA SW to login.

Note: only if myQA Cockpit is installed on the same computer as the web browser the address
“localhost” can be used to access myQA Cockpit.
If myQA Cockpit cannot be opened, see Chapter 7 for troubleshooting
By default, the start page, Dashboard, will open after logging into myQA Cockpit. myQA Cockpit
contains 4 pages that can be switched in the title area on the top by clicking the corresponding name:
■ Dashboard (see Chapter 3)
■ Test Results (see Chapter 4)
■ Trend Analysis (see Chapter 5)
■ Patients (see Chapter 6)

2.5. Page Refresh


The data in myQA Cockpit is refreshed by pressing the F5 key in the keyboard, switching to a different
page, or re-opening the website. The last data update time is displayed under the IBA logo in the upper
right corner.
Any data change in the myQA workspace is only shown in the myQA Cockpit site after a refresh is
made.

W AR NI NG
REFRESH THE WEB PAGE
The myQA Cockpit web page should be refreshed frequently to display the
current actual data to myQA workspace.

When myQA Cockpit is refreshed or re-opened, the latest selections or defined filters in navigation
panel will persist.

8 | Cockpit installation | myQA User's Guide - Vol.2. myQA Cockpit


3. Dashboard
By default, the myQA Cockpit start page, Dashboard, opens after logging in to myQA Cockpit.

IM PO RT ANT N O T IC E
STATUS DISPLAY
Only status from the latest executed tasks are displayed when the due date of
the executed task was today.

2 4

myQA Cockpit – Dashboard

The Dashboard page displays monitored machines, in tiles. Only machines, which have been marked
for display by checking Show in myQA Cockpit in the myQA Platform - Equipment Setup - Machine
Editor dialog, are included.

Machine Editor – Show in myQA Cockpit is selected

myQA User's Guide - Vol.2. myQA Cockpit | Dashboard | 9


By default, all available machines are selected for display.
They can be filtered by location via the navigation panel on the left. When the Location filter is not used
(all locations are selected), it is displayed in gray color ( ). When a filter is used (at least one location
is un-selected), it changes its color to orange ( ).
The Location filter further uses a green icon ( ), if a location is selected and a gray icon ( ) if a
location is de-selected.
The Location filter is restored when reloading the page or switching to a different page and returning to
the Dashboard page.
For each machine, the following items are displayed per tile:
1. Machine name and the latest status
2. Location of the machine including clinic, department, and treatment room
3. Task names of the active protocol and their latest status. The task name also serves as a link to
test results for this task to the Test Results view.
4. Icon which visualizes the machine type (see myQA Platform - Equipment Setup)

3.1.1. Machines QA Status


The machines can be sorted by status (Status↕) or alphabetically (A-Z↕). By default, the machines are
listed in order of "worst status first": Failed, Warning", Skipped and Passed. If multiple machines have
the same status, they are ordered alphabetically.
A symbol on the left side of the machine name indicates the overall status of this machine. It is
calculated based on the status of all last executed tasks of the machine and the following rules:

: "Passed" - if all task are passed

: "Failed" - if there is at least one failed task and not any overdue tasks

: "Warning" - if there is at least one warning and not any failed/overdue tasks

: "Skipped" - if there is at least one skipped and not any passed/warning/failed/overdue tasks

: "Overdue" - if there is at least one overdue task

: "Undefined" - if there is no skipped/passed/warning/failed/overdue task or no tasks under the


machine at all

W AR NI NG
MACHINE QA STATUS
Be aware of how the machine status is aggregated from the status of the Tasks.
Wrong interpretation leads to miss-understanding of the machine status.

10 | Dashboard | myQA User's Guide - Vol.2. myQA Cockpit


3.1.2. Tasks Status of the Active Protocol
Only tasks of the active protocol are displayed. By default, the tasks are listed in order of "worst status
first": failed, warning", skipped and passed. If multiple tasks have the same status, they are ordered
alphabetically.
By clicking a task, it will switch to the Test Results view and display the test results for this task.
The status of tasks are taken from myQA Machines directly. There is no further calculation in myQA
Cockpit.
The status symbols used for the task status (See Section 3.4.3, Vol.3: myQA Machine User’s Guide, for
detailed description):

: "Passed"

: "Failed"

: "Warning"

: "Skipped"

: "Overdue"

: "Undefined"
Note: if a task is overdue or undefined, myQA Cockpit will not show any results but a message
reminding the user to execute the task.

myQA User's Guide - Vol.2. myQA Cockpit | Dashboard | 11


4. Test Results Page
The Test Results page is opened by clicking the Test Results tab in the title area or clicking a task link
on the Dashboard page.

IM PO RT ANT N O T IC E
DISPLAY IN THE TEST RESULT PAGE
Only test results from the latest executed task of an active protocol are displayed
when the due date of the executed task was today.

4.1. Components Displayed in the Test Results Page


The Test Results page displays the tests of the selected task of a machine in the navigation (1):

2 4

myQA Cockpit - Test Results Page (example)


1: Task navigation for selecting a task to be displayed (see Section 4.2)

2: Machine and protocol of the selected task and tooltip about the operator and test time, e.g.:

3: QA test information display

4: Status statistics of the selected task (see Section 4.3)

12 | Test Results Page | myQA User's Guide - Vol.2. myQA Cockpit


4.2. Task Navigation Panel
The Test Results page shows the test results of the task selected in the navigation panel.
The navigation panel provides four filters, which adhere to a selection hierarchy from top to bottom as
how they are listed the navigation panel:

Task Navigation panel

The behavior of the Location filter is the same as in the Dashboard page (Chapter 3). For other filters,
when a filter is not defined (no items are selected), it is in gray color ( ). When a filter is defined, it
changes to orange color ( ).
Select Machine filter
It lists all machines that belong to the locations included by the Location filter. No more than one
machine can be selected simultaneously.
Select Task filter
It lists all tasks of the active protocol of the machine selected in the Select Machine filter.
The tests of the selected task will be displayed in the content area in category groups.
Approver filter
Enter an approver name or parts of it in the text box to filter by the approver name. If the Approver filter
is defined without defining the Select Tasks filter, you may need to define the Select Tasks filter
afterwards since one approver can approve more than one task.
Filters can be expanded or collapsed. The expanded Select Machine and Select Task filters show the
available machines or tasks and their status. See Section 3.1.1 (for machines) and Section 3.1.2 (for
tasks) for the description of the status symbols.

Expanded filter examples: Select Machine, or Select Tasks

If a status of a task was overwritten in myQA Machines, an info icon appears. Hovering over it will
display the original status.
The defined filters will be restored when reloading the page or switching to a different page and coming
back to the Test Results page. After the session is closed the filters will be reset.

myQA User's Guide - Vol.2. myQA Cockpit | Test Results Page | 13


4.3. Status Statistics of the Selected Task
For each task in a protocol for a specific machine, the percentages of the number of tests passed,
failed, skipped or had a warning over the total number of tests in the task are displayed on the top right
for the last execution:

Task statistics

Selected task

Percentage of skipped, passed, warning, failed tests.

14 | Test Results Page | myQA User's Guide - Vol.2. myQA Cockpit


4.4. Information of Tests

4.4.1. Status of a Test Category


The categories of tests are always displayed (4a). The overall status of a category are also indicated by
a symbol on the left side of the category name (4b). It is calculated based on the status of the last
executed tests in this category and the rules (see below for a description of the status symbols):

4b 4a

4c

4d

: "Passed" – if there is at least one test passed and no warning/failed tests

: "Failed" – if there is at least one failed test

: "Warning" – if there is at least one test warning and no failed tests

: "Skipped" – if there is at least one test skipped and no passed/warning/failed tests

4.4.2. Expanded View of a Category


The tests of a category can be expanded / collapsed by clicking the row of the category (4c). The test
category of a test is defined in myQA Machines whenever a new protocol is created.
By default, if there is at least one failed test in a task, the test(s) are expanded when selecting this task
in the navigation panel, otherwise the tests are collapsed.
When a test category is expanded, the tests are shown with test name (Test Name), operator
(Executed by), finishing date and reference date (Finishing / Reference Date), and test results
(Status). The Finishing Date is the time when the task was finished. The Reference Date is set in the
myQA Machines > Test Run page and refers to the actual date of the measurement.
A test result, directly taken from the myQA Machines, has one of the following statuses, which is shown
in the Status column:

, , , .

myQA User's Guide - Vol.2. myQA Cockpit | Test Results Page | 15


4d

Displaying a Test Note


If a test note is entered during the test run in the myQA Machines workspace, the Test Note Icon
will appear next to the executor in the expanded view. The tooltip will display the note when hovering
the cursor over the icon.

4.4.3. Detailed View of a Test


The detail information of a test can be viewed by clicking on the row of a test (4e):

4d

4e

Beside the status of a test, the expected/reference and actual values, warning and fail limits are
displayed.
For the imaging plugin tests (i.e., CBCT, EPID, MLC and VMAT QA Plugins), the detailed view includes
General Information, Tolerances and Result sections. See a combined test of CBCT QA below:

Once the test is expanded, it can be collapsed by clicking the row of the test again.

16 | Test Results Page | myQA User's Guide - Vol.2. myQA Cockpit


5. Trend Analysis Page
The Trend Analysis page plots a graph of the test results and the specified tolerances versus the
execution dates. Therefore, it displays the pattern or trends of the executed tests within the selected
time period.
To open the Trend Analysis page, click the Trend Analysis button on the top (2b).

5.1. Selecting a Test


To display the plot(s) of a test result,
Select its machine and the task in the task navigation (1) (see detailed information about this panel
in Section 4.2). Only one task of a device can be selected at the same time.
A test included in this task can then be selected in the upper part of the main area (2a) for the trend
analysis.

 A task may contain many tests. They may be displayed in several pages. It might be necessary
to move forward and back through the pages (2a-i) to find the desired test.

2a-i

 To facilitate a test selection, the test name can be filtered by a full-text search based on the
name (2c). For example, enter “output” in the filter, the test names containing “output” (not
case-sensitive) are displayed:

myQA User's Guide - Vol.2. myQA Cockpit | Trend Analysis Page | 17


 For the selected test, the results used for analysis can be shown for different ranges of dates
(2a-ii):
o Last 7 Days - loads the data of the last 4 weeks (A), but displays the last 7 days as initial
selection (B). See an example below.
o Last 4 Weeks - loads 6 months of data, displays last 4 weeks initially
o Last 6 Months - loads 1 year of data, displays last 6 months initially
o Last 12 Months - loads all data, displays last year initially
o All - loads all data, shows all data initially

2a-ii

2d

A C

Change the selected dates


The selected area can be changed by placing the cursor inside the navigator (C), pressing the left
mouse, and dragging the navigator to a desired position. In the navigator area, once the left mouse is
pressed, the range of the selected dates are shown (D). The information is updated upon the change of
the dates.

Change the range of the selected dates


Place the cursor on one of the boundaries (E) of the navigator (the cursor will become double arrows),
press down the left mouse button, and drag it to the desired date.

E E

18 | Trend Analysis Page | myQA User's Guide - Vol.2. myQA Cockpit


5.2. Trend Analysis Graphical Display
Tests with numerical results
After a test is selected (see the previous section), the trend analysis of this test is plotted as a line chart
in the lower part of the main display area of the Trend Analysis tab page (2d).
■ The vertical axis represents the test values and the horizontal axis represents the dates when the test
was performed.
■ The blue dashed lines : connect the expected values.
■ The green solid line : connects the actual measured data points.
■ The red dashed lines : top/bottom - connect the upper/lower failed limit.
■ The orange dashed lines : top/bottom - connect the upper/lower warning limit.

2d

Tests with Pass/Warning/Fail results


For the Pass/Warning/Fail tests, trends are displayed for all executed tests with the following result
indicators:

: Pass; : Warning; : Fail

Tooltip for a data point


The coordinates of a data point (test result and test date, 1, see next page) can be viewed by hovering
the mouse cursor over the data point that represents this test. If a test note is entered during the test
run in the myQA Machines workspace, the note will be also displayed (2). If the test was executed with
myQA version 2.10 or earlier, the tooltip will also inform that it was generated with an old version of the
plugin (3).

myQA User's Guide - Vol.2. myQA Cockpit | Trend Analysis Page | 19


1
2
3
1

5.3. Export Trend Analysis as a *.csv File

5.3.1. Export as a *.csv File


When a test with trending data is selected, the Export as CSV button appears on the upper
right-side of the graphical display. With this button, the displayed Trend Analysis can be exported as a
CSV format file.
Click the Export as CSV button.
Click the Save expanding icon and choose Save as. Select the desired location and then save the
file. By default, the filename is [test name]_YYYY-MM-DD.csv, e.g., 1.01 Electron output
constancy_2018-06-20.csv.

20 | Trend Analysis Page | myQA User's Guide - Vol.2. myQA Cockpit


5.3.2. Open a *.csv File with Excel
The saved *.csv file is stored as plain text file and it is automatically linked to Excel when Microsoft
Excel is installed on the computer. It can be opened with Excel by double-click the filename. However,
only a German formatted PC will display the columns correctly, for an English formatted PCs, for
example, it is possible that all text is displayed in one column. See an example:

In this case, please follow the procedure below to separate the columns.
Note: When importing the exported CSV file, please use the Convert Text to Columns Wizard to set
";" as the delimiter if this is not your default Windows delimiter.
Select all cells of the column with text. Click the tab and then Text to Columns in the Data ribbon.
The Convert Text to Columns Wizard opens. Select Delimited in the Original dada type box in
Step 1.

Select Semicolon in the Delimiters box in Step 2.

myQA User's Guide - Vol.2. myQA Cockpit | Trend Analysis Page | 21


In Step 3, select the first column, and then in the Date box choose YMD.

Click Finish.

About the date format


For the date, it is stored in the ANSI format: YYYY-MM-DD. When the csv file is opened with Excel, it
recognizes this field as a date and transforms it into the local format, e.g., dd.mm.yyyy in this case it is
the German date format, e.g.,

22 | Trend Analysis Page | myQA User's Guide - Vol.2. myQA Cockpit


Procedure for displaying a different date format,
Select the column and then right-click this column; select Format Cell in the context menu.
In the Format Cells dialog, select Date, a country under Local (location), and a format under Type.

Click OK.

About decimal separator and thousands separator


If the decimal separator and thousands separator
need to be changed:
Select the affected columns.
Click the Advance button.
Select the desired characters in the Decimal
separator and Thousands separator boxes.
Click OK.

myQA User's Guide - Vol.2. myQA Cockpit | Trend Analysis Page | 23


6. Patient Cockpit
The Patients view provides a complete status overview of treatment plan verifications performed in the
myQA Patients workspace.
The Patients QA page contains a navigation panel (1) and a patient QA table (2) that shows
information about all patients with assigned treatment plans. In addition, the system shows an overall
statistics of all patient related plans (3).
The Patients QA view is accessed by clicking the Patients button on the top navigation area (3a).

3 3a

6.1. Navigation Panel and Filters for Display


Initially, all patients of clinics assigned to the user are displayed (see Section 5.3.1.1, Vol. 1, myQA
Platform and Devices). myQA Cockpit will persist any filters set on the patients list, i.e., on subsequent
page views the last used filter will be set again.
The Navigation (1) panel contains the filters for selective display. Click the filter title area to show or
hide the filter contents.
Filters of Locations, Approval Status, Case, and Type: all corresponding items available for the
specific user are listed. Click once on the item to select or de-select this item.
The Approval Date filter: enter the range of the dates for display.
Filters of Patients, Approver: free-text filters. By entering the complete or partial name / ID of a patient
(for Patient filter) or name of the approver (for Approver filter), only the patients whose name / ID
(when using Patient filter) or approver’s name containing the entered text will be displayed.
When a filter is not defined, it is in gray color ( ). When a filter is defined, it changes to orange color (
). Clicking will set all defined filters to un-defined, i.e. all patients are displayed.

24 | Patient Cockpit | myQA User's Guide - Vol.2. myQA Cockpit


6.2. Statistics of Plan Status of all Patients

The clinic sites selected to be displayed are shown on the left of the top bar. However, on the right-
side, the overall status is shown for all patient related projects.
The status is shown as percentages:
 gray - projects with no approval state
 green - percentage for projects with Approved status
 yellow - percentage for projects with Needs R. (Revision) status
 red - percentage for projects with Declined status

6.3. Patient QA Table

Listed items in the Patient QA table


The patient QA table has the following list columns that show the data from the latest updated project of
a patient:
 Patient ID (patient’s identification number)
 Family, First Name (patient’s family name first name)
 Case (project study case)
 Type (verification type and measurement device)
 Appr. Date (approval date)
 Approver (approver’s name)
 Appr. Status (status symbol with status text).
The Status of the newest project is shown with a colored symbol containing the status text:

, , (Needs Revision),
 Appr. Notes (note symbol appears if a comment was entered in the Approval dialog in the
Verification Compare page of myQA Patients).

The note is shown on "mouse-over". On mobile devices, the note is shown on tapping.
The table displays 15 patients per page. If there are more than 15 patients, click the page navigation,

, to navigate to different pages.

myQA User's Guide - Vol.2. myQA Cockpit | Patient Cockpit | 25


Sorting the Display Order
By left-clicking a column name area, the Sorted-up or Sorted-down icon for this column appears, e.g.:

Once the Sorted-up or Sorted-down icon appears, the display order of this column can be sorted
reversely by left-clicking the column name area. The rest of the columns are sorted accordingly.

Patient’s project overview


By clicking the row of a patient, all projects of this patient will be displayed. Once the patient is
expanded, it can be collapsed by clicking the row of the patient again.

Compared to the patient QA table, five more columns are shown in the patient’s all project view:
■ Imported
■ Measured The steps in the Workflow Status indicator in the myQA Patients workspace. The
■ Verified green checkmark indicates that this step was set as finished.
■ Finalized
■ Due Date - project due date

26 | Patient Cockpit | myQA User's Guide - Vol.2. myQA Cockpit


7. Troubleshooting
Normally, IBACockpitApi and IBAWebserverWrapper windows services should be automatically
started after installation of myQA Cockpit and the computer is restarted. If myQA Cockpit cannot be
opened, check the Service of the computer:
Enter service in the Start menu and then click Service in the list. The Service window opens.
Check the status of IBACockpitApi and IBAWebserverWrapper. If they are not started, right-click
on the row of IBACockpitApi or IBAWebserverWrapper and select Restart, respectively.

If the IBAWebserverWrapper cannot be restarted, it may be due to the port used by myQA Cockpit
being assigned to another application. Re-assign a port in the nginx.conf file (in the folder: C:\Program
Files (x86)\IBA Dosimetry\myQA-Cockpit\WebSite\conf):
■ In case HTTP is used:

server {
listen 80;

■ In case HTTPS is used:

server {
listen 443 default ssl;

Replace the port number (text in red color) to a new port number which which is not used by another
application.
Enter service in the Start menu and then click Service in the list.
Right-click on the row of IBAWebserverWrapper and select Restart.

myQA User's Guide - Vol.2. myQA Cockpit | Troubleshooting | 27

You might also like