System administration

This groups all knobs that allow to manage and adapt the behavior of ARIS to the needs of the laboratory and user preferences. They are grouped in two to facilitate their access. The first one is more generic and allows both laboratory supervisor and system administration to access some basic stuff. The second one is only available to the system administrator, since it is considered to require more advance technological skills.

Generic

This groups all the basic administration functionalities. They are available for both the system administration and the laboratory supervisor.

Users

User creation form

When clicking on the edit or New user buttons, a form pops up on the screen. The information necessary to create a user consists of a Username, Name, Middle name, password and the person's Role within the system. This Role will determine the functionalities available to the user. A note, without any effect in the behaviour of the application, can be added to indicate any relevant information to the system administrator.

This same form allows the system administrator to modify the password of any other user. For security reasons, this password must contain some number, some capital letter, some small letter, and at least eight characters.

Since they are used for auditing changes in patients and requests, the users cannot be deleted from the system. However, they can be declared not to be active, which would prevent them from logging in, but still keep track in the database of all their past actions.

Access log

The access log shows the user which user has done an action within the system and exactly when. The timestamp is in the format Year-Month-Day Hour:Minute:Second

Example of access log

There are three actions recorded by the access log, successful log in, wrong user and failed log in. This last action refers to the wrong password being used.

Downloaded fields

ARIS allows the laboratory supervisor to download all the information in the database into a single file in their computer. There are two possible download options, depending on the format of the generated file being plain CSV or compressed and password-protected ZIP. These documents will contain information on the requests, and by extension, on the corresponding patients. Thus, due to patient confidentiality, not all the personal data should be in the downloaded file. The checkboxes in this form allow the laboratory supervisor as well as the system administrator to decide which fields will be downloaded in each one of the formats.

Additionally, the system provides two configuration parameters to customize the structure of the CSV file: csv_delimiter, which defines the character used to separate data fields in the CSV file, and csv_decimal, which specifies the character used to represent decimal values in numerical fields. It is essential to configure these parameters according to the settings used by the system and the spreadsheet software (e.g Excel) to ensure proper data interpretation. Using an incorrect delimiter or decimal separator may result in formatting issues when opening the file.

Technical

This groups all the more advanced administration functionalities. They are available only for the system administration.

Summary of instances

Summary of instances

This tab displays information about the different existing instances in the application. Some examples are: the number of patients, users, requests or genders. This information comes directly from the database and is automatically updated after every modification in the system. It can be useful to investigate potential performance problems in case of extremely large numbers. To facilitate the reading and identification of the different kinds of instances, the information is divided into three sections: Data, Administration and Configuration.

Roles

This tab is displayed and works, in the same way as the State of the request tab in the Configuration functionality. The roles are unchangeable, but their labels (not the corresponding functionality) can be customized.

Each role has different actions allowed within the application, chosen due to the tasks the people are expected to carry out. Thus, there are five roles within the system, which indicate the functionalities that a user can perform, as can be seen in the following table.

Allowed functionalities per role

Functionalities		Patient Manager	Laboratory Technician	Laboratory Technician with Validation	Laboratory Supervisor	System administrator
Patient	Create
	Search
Request	Create
	Change information
	Deliver samples
	Introduce results
	Validate results
	Search historic
Data analysis
Configuration	Generic
	Technical
Administration	Generic
	Technical

Parameters

Parameters determine the behaviour of some functionalities. Thus, they cannot be created or deleted. However, their values can be updated to customize the system. At this point it is important to highlight the on updating them, the data type must be respected. Providing a value of the wrong data type (e.g., a string instead of an integer) can provoke the malfunction of the whole application.

The following table contains the list of existing parameters together with the corresponding data type and a brief description.

System parameters

Name	Data type	Description
attribute_reserved1	String	Label of the first field of free use in the requests (write 'DoNotShow' to hide it)
attribute_reserved2	String	Label of the second field of free use in the requests (write 'DoNotShow' to hide it)
attribute_reserved3	String	Label of the third field of free use in the requests (write 'DoNotShow' to hide it)
backup_frequency	Integer	Minimum amount of hours that need to pass for the system to generate a new copy of the database
backup_history	Integer	Maximum number of copies of the database kept (once reached, the oldest copy in the folder is deleted)
bluetooth_enabler	String	Indicates the availability of automatic tests through Bluetooth connection (accepted values are 'Enabled' and 'Disabled'), which is only used in the IMAGING project
csv_decimal	String	Specifies the character used to represent the decimal point in numerical values in the generated csv file (accepted values are . and ,)
csv_delimiter	String	Specifies the character used to separate fields in the generated csv file (accepted values are ; and ,)
default_language	String	Language set by default on logging in (the same for all users)
filename_background	String	File containing the image displayed in the background
filename_favicon	String	Icon of the system used in the browser tab
filename_sidebarlogo	String	File containing the logo displayed at the bottom of the sidebar
filename_worklistlogo	String	Logo used in the worklist reports
groups_profiles	String	Shows groups and profiles for analytical tests (accepted values are 'Enabled' and 'Disabled')
log_history	Integer	Maximum number of days to keep registries in the access log (those older than this will be automatically deleted)
max_image_volume	Integer	Maximum number of megabytes used to store images (once reached, the oldest ones in the folder are deleted)
name	String	Caption to appear at the top of the screen (in the navigation bar), as well as in the worklist and reports
report_subtitle	String	Subtitle to be used in the worklist and reports
table_default_paging	Integer	This indicates the initial paging of all the tables (accepted values are 5, 10 or 25)
table_min_rows_for_search	Integer	This is the minimum number of rows a table must have to show the corresponding search field
timeout	Integer	Time (in minutes) after which the connection to the backend requires a new log in
version	String	Version of the system
zip_password	String	This is the password that will be used to generate the downloaded zip file

Analytical Requests Information System

Comma Separated Values

Compressed file format

Bluetooth wireless technology