User Guide: Difference between revisions

From ARIS
Jump to navigation Jump to search
Alberto (talk | contribs)
No edit summary
Alberto (talk | contribs)
Line 80: Line 80:
| [[ARIS:System administration|System administration]] [[File:System_administration.PNG|25px|right]] || User administration and edition of software parameters.
| [[ARIS:System administration|System administration]] [[File:System_administration.PNG|25px|right]] || User administration and edition of software parameters.
|-
|-
| System information [[File:System_Information.PNG|25px|right]] || Software version and credits.
| System information [[File:System_Information.PNG|25px|right]] || Software license, version and credits.
|}
|}


Most of these functionalities have subsets of actions that can be accessed through the small downward arrow to the right of the name. To change between actions, simply click on the desired functionality and the display will change.
Most of these functionalities have subsets of actions that can be accessed through the small downward arrow to the right of the name. To change between actions, simply click on the desired functionality and the display will change.
==General features==
==General features==
; Arrow
; Arrow

Revision as of 14:48, 3 November 2023

This is a step-by-step user guide on the ARIS system. It contains information on what each functionality does and instructions on how to use them.

Log in page[edit]

The first step to work with ARIS, once the software is properly downloaded and installed (see Installation and Upgrades), the users have to create each an identity (username and password). Entering these both credentials will allow the access to the software and the screen will show now the main page of the system. If the username or password is incorrect, a red information box will pop up above the log in now button.

It is crucial to remember that the system has three different roles with different and complementary functionalities. Consequently, at least three users need to exist, one with each different role System Administrator, Laboratory Technician and Laboratory Supervisor.

Since the interface is through a browser, we have all of its typical features. Among others saving usernames and passwords (some browsers even do it by default). Notice that in this case, this is not a good practice and should be avoided.

Sidebar[edit]

Sidebar found on the left side of the interface

The sidebar contains information about the user's account and is a tool to navigate between the different functionalities of the system.
At the very top of the orange sidebar, the software's name is displayed in a bold white font.

Just below the title, there is a small box that informs the user of the account currently in use, by means of the user's name and role corresponding to this username.
Underneath, there is a list of the different functionalities listed below.

Functionalities of the system
Functionality Description
Patients
Create and edit patients, as well as navigate through the patients list.
Requests
Create and edit requests, as well as different types of search.
Data analysis
Basic statistics on the performance of the laboratory.
Configuration
Options offered by the system in the different dropboxes of the forms.
System administration
User administration and edition of software parameters.
System information
Software license, version and credits.

Most of these functionalities have subsets of actions that can be accessed through the small downward arrow to the right of the name. To change between actions, simply click on the desired functionality and the display will change.

General features[edit]

Arrow
This downward arrow is present when there is a menu with different options to choose from. The user can filter the options by writing down normally in the box. The options displayed can be manipulated through the Configuration functionality.
Asterisk
The red asterisk represents a mandatory field. In other words, if a box contains an asterisk, it must be filled in order to keep doing the desired task. The current action in progress will not conclude until all of the corresponding fields are filled.
Delete
This button is generally found in the Configuration functionality. It allows the user to delete predefined instances of the different concepts, such as the regions or locations available in the creation of patients, for instance. Not instances of every concept are deletable. For example, it is not possible to delete patients, requests or users.
Editing
In general, there is not any icon associated to edition of elements. By simply clinking on the corresponding row, its details are displayed. These are then editable, except in the case of patients, that are read-only until a button to enable modifications is pressed.
The exception to this rule is the details of a test. In this case, this icon corresponds to the possibility of showing and potentially changing the results and notes of the test, as well as more information about the corresponding sample. This happens in the Analytical tests tab reached at either Introduce results, Validate results, as well as the Historical requests.
Search bar
There is a search box at the top of most of the forms that contain tables with lists of elements, like the search patients or create requests tabs. This search box allows the user to filter by different fields like name, phone, health facility ID, creation date or last modification date. To choose one of these, the user must click on the downwards arrow found to the right of search field and pick the desired field (this possibility is not available if the table contains only one column to be searched). Once the field is chosen, the user can type the information corresponding to the search field in the box on the left.
There is a system parameter that establishes the minimum number of elements required for the search box to be shown (i.e., tables with a small number of elements may not require a search functionality).
Locked item
This icon appears attached to elements of a list that cannot be directly selected or deselected. This happens whit groups of tests or profiles. Thus, choosing a group of tests does not allow to remove any of its components, as they are an indivisible set.

Navigation bar[edit]

Language
The language in use is displayed in the top right corner of the page, the user is able to change it depending on their preference by clicking on the text and choosing the language desired. There are currently two options of language for the system; English and Spanish.
Profile
When clicking on this icon, found in the top right corner of the page, two options will show up. The first, is the log-out option, when pressing on this option, the page will change to the log in page, through which the user will be able to change the account they are using. The second icon called change password will produce a pop-up window when clicked, where the user might change their password.
Change password
There are two ways of changing the password associated with the username.
  1. The password can be changed by the user. All they have to do is press on the profile icon, click on change password, and a screen will come up with the title Change password. Next, the user must just fill in the required boxes with their current password, their desired password and, finally, repeat their new password.
  2. Another method to change the password would involve accessing the system administration functionality and going to the users tab. Once in this tab, the user can choose a patient, and click on edit patient. Then, at the bottom of the page, the user is able to find two non-obligatory fields named password and repeat password. These must be filled in order to change the password.
Bluetooth (not visible by default)
By default, this icon is hidden, because most laboratories are not going to use this functionality (only those participating in the IMAGING project).

To make it visible, the value of the corresponding system parameter needs to be modified. For this, a System Administrator needs to log in and go to Parameters. There, s/he needs to set 'bluetooth_enabler' to Enable. This will make the icon visible to all 'Laboratory Technitians'.

When a Laboratory Technitian clicks this icon, the system will enable the Bluetooth connection of the system, and the users will be able to connect their mobile device to ARIS. This capability is used to transfer images from the Mobile App in case of automatic tests. From the moment the icon is orange, all the behavior is managed from the Mobile App (i.e., from ARIS interface, you can only enable or disable the Bluetooth and everything happens in the background). When Bluetooth is active, the icon will turn orange. On clicking again, the feature will be disabled and the icon will be grey.