Vol 2 myQA Cockpit User's Guide
Vol 2 myQA Cockpit 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).
www.iba-dosimetry.com
6. Patient Cockpit.............................................................................. 24
6.1. Navigation Panel and Filters for Display............................................................................ 24
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.
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.
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
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.
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.
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.
To see the user manual of the wizard, click the Help button.
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)
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.
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
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.
: "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
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.
: "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.
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.
2 4
2: Machine and protocol of the selected task and tooltip about the operator and test time, e.g.:
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.
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.
Task statistics
Selected task
4b 4a
4c
4d
, , , .
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.
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:
2a-ii
2d
A C
E E
2d
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.
Click Finish.
Click OK.
3 3a
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
, , (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,
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.
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
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.