QPR TaskRecorder: Difference between revisions

From QPR ProcessAnalyzer Wiki
Jump to navigation Jump to search
(Created page with "QPR TaskRecorder is a desktop application, that records actions done by the user. The actions can be for example mouse clicks, key presses, ui elements focusing, button clicks...")
 
No edit summary
Line 7: Line 7:
# Extract the zip package to a suitable location, for example: C:\Program Files\QPR TaskRecorder.
# Extract the zip package to a suitable location, for example: C:\Program Files\QPR TaskRecorder.
# Configure the QPR TaskRecorder
# Configure the QPR TaskRecorder
== Starting QPR TaskRecorder ==
QPR TaskRecorder can be started simply by double-clicking the '''TaskRecorder.exe''' file.
== Using TaskRecorder ==
The main dialog of QPR TaskRecorder contains a table of all currently open applications. You can choose which applications are recorded from the checkboxes. Each application is listed only ones, and when checked, all running instances of the application are recorded. E.g. there may several Word files open at the same time and all are recorded.
When open, QPR TaskRecorder is all the time active and records the selected applications. If there is an error situation, e.g., the CSV file is reserved by another application, the '''Status''' field shows the situation
== Adding Annonations ==
User can add manual annotations during the task recording, to help analyzing the recorded UI events. An annotation is added by writing the annotation text to the '''Annonation''' textbox and clicking the '''Save annotation''' button.


== QPR TaskRecorder configuration ==
== QPR TaskRecorder configuration ==
QPR TaskRecorder has configuration file '''appsettings.json''' containing the following settings:
* '''OutputFile''': The CSV file containing the recorded events.
* '''LogFile''': Log file of QPR TaskRecorder.


== Recorded UI events ==
== Recorded UI events ==
QPR TaskRecorder is able to record the following types of UI events:
QPR TaskRecorder is able to record the following types of UI events:
== Mathematical functions ==
{| class="wikitable"
!'''Column name'''
!'''Description'''
|-
||TimeStamp
||
|-
||UserName
||
|-
||SessionId
||
|-
||EventType
||
|-
||MouseX
||
|-
||MouseY
||
|-
||KeyCode
||
|-
||Key
||
|-
||ModifierKeys
||
|-
||ProcessName
||
|-
||ClassName
||
|-
||ControlType
||
|-
||Name
||
|-
||Value
||
|-
||LabelName
||
|-
||ElementX
||
|-
||ElementY
||
|-
||ElementWidth
||
|-
||ElementHeight
||
|-
||ElementHierarchy
||
|-
||ElapsedTime
||
|}


== Recorded tasks CSV ==
== Recorded tasks CSV ==

Revision as of 20:10, 29 January 2022

QPR TaskRecorder is a desktop application, that records actions done by the user. The actions can be for example mouse clicks, key presses, ui elements focusing, button clicks, selections and text input.

QPR TaskRecorder installation

QPR TaskRecorder is a desktop application for Windows operating systems

  1. Download the QPR TaskRecorder in the downloads section.
  2. Extract the zip package to a suitable location, for example: C:\Program Files\QPR TaskRecorder.
  3. Configure the QPR TaskRecorder

Starting QPR TaskRecorder

QPR TaskRecorder can be started simply by double-clicking the TaskRecorder.exe file.

Using TaskRecorder

The main dialog of QPR TaskRecorder contains a table of all currently open applications. You can choose which applications are recorded from the checkboxes. Each application is listed only ones, and when checked, all running instances of the application are recorded. E.g. there may several Word files open at the same time and all are recorded.

When open, QPR TaskRecorder is all the time active and records the selected applications. If there is an error situation, e.g., the CSV file is reserved by another application, the Status field shows the situation

Adding Annonations

User can add manual annotations during the task recording, to help analyzing the recorded UI events. An annotation is added by writing the annotation text to the Annonation textbox and clicking the Save annotation button.

QPR TaskRecorder configuration

QPR TaskRecorder has configuration file appsettings.json containing the following settings:

  • OutputFile: The CSV file containing the recorded events.
  • LogFile: Log file of QPR TaskRecorder.

Recorded UI events

QPR TaskRecorder is able to record the following types of UI events:

Mathematical functions

Column name Description
TimeStamp
UserName
SessionId
EventType
MouseX
MouseY
KeyCode
Key
ModifierKeys
ProcessName
ClassName
ControlType
Name
Value
LabelName
ElementX
ElementY
ElementWidth
ElementHeight
ElementHierarchy
ElapsedTime

Recorded tasks CSV

The user actions are recorded to a CSV file, that is stored to the user Documents (by default) or a some other location user has specified. The CSV file can be uploaded to QPR ProcessAnalyzer for the analysis like any CSV file.

The CSV file has the following columns: