Configuration/en - Revision history

FuzzyBot: Updating to match new version of source page

2025-05-24T08:30:04Z

Updating to match new version of source page

← Older revision		Revision as of 10:30, 24 May 2025
Line 129:		Line 129:
	Enumerate datatypes can be defined here (integer and real numbers are always available).		Enumerate datatypes can be defined here (integer and real numbers are always available).
	These are simply lists of potential results that can be used in any kind of test.		These are simply lists of potential results that can be used in any kind of test.

			The order of the values later in the dropdown lists will not be alphabetical, but their order of insertion in the value list (this can be useful to fix an order, if there are many values).

	===Reporting order===		===Reporting order===
	[[File:Reportingorder.PNG\|Centre\|500px\|thumb\|Editing the laboratory areas order from the reporting areas tab]]		[[File:Reportingorder.PNG\|Centre\|500px\|thumb\|Editing the laboratory areas order from the reporting areas tab]]
	This tab allows ordering the elements in the PDF ~~work list~~ and in the report of a request.		This tab allows ordering the elements in the PDF worklist and in the report of a request.
	The tests appearing in them will be firstly sorted by laboratory area, then groups of tests, and finally individual tests.		The tests appearing in them will be firstly sorted by laboratory area, then groups of tests, and finally individual tests.
	This is done by choosing one of the three elements, which will lead to another form with a list and two vertical arrows on the left side of the image.		This is done by choosing one of the three elements, which will lead to another form with a list and two vertical arrows on the left side of the image.
	Any number of elements can be simultaneously selected by simply clicking on them.		Any number of elements can be simultaneously selected by simply clicking on them.
	Then, the arrows will allow moving them up or down in the list, and hence in the generated PDF documents.		Then, the arrows will allow moving them up or down in the list, and hence in the generated PDF documents.

FuzzyBot: Updating to match new version of source page

2024-10-14T13:40:04Z

Updating to match new version of source page

← Older revision		Revision as of 15:40, 14 October 2024
Line 132:		Line 132:
	===Reporting order===		===Reporting order===
	[[File:Reportingorder.PNG\|Centre\|500px\|thumb\|Editing the laboratory areas order from the reporting areas tab]]		[[File:Reportingorder.PNG\|Centre\|500px\|thumb\|Editing the laboratory areas order from the reporting areas tab]]
	This tab allows ordering the elements in the PDF ~~worklist~~ and in the report of a request.		This tab allows ordering the elements in the PDF work list and in the report of a request.
	The tests appearing in them will be firstly sorted by laboratory area, then groups of tests, and finally individual tests.		The tests appearing in them will be firstly sorted by laboratory area, then groups of tests, and finally individual tests.
	This is done by choosing one of the three elements, which will lead to another form with a list and two vertical arrows on the left side of the image.		This is done by choosing one of the three elements, which will lead to another form with a list and two vertical arrows on the left side of the image.
	Any number of elements can be simultaneously selected by simply clicking on them.		Any number of elements can be simultaneously selected by simply clicking on them.
	Then, the arrows will allow moving them up or down in the list, and hence in the generated PDF documents.		Then, the arrows will allow moving them up or down in the list, and hence in the generated PDF documents.

FuzzyBot: Updating to match new version of source page

2024-09-27T13:23:37Z

Updating to match new version of source page

FuzzyBot: Updating to match new version of source page

2024-02-01T13:21:12Z

Updating to match new version of source page

← Older revision		Revision as of 15:21, 1 February 2024
Line 1:		Line 1:
	[[Category:Configuration]]		[[Category:Configuration]]
			<languages/>
	The configuration functionality allows the user to manipulate ARIS, adding or changing some of its aspects for a better customization.		The configuration functionality allows the user to manipulate ARIS, adding or changing some of its aspects for a better customization.
	These have been divided into two groups, depending on the knowledge needed to use them.		These have been divided into two groups, depending on the knowledge needed to use them.
Line 62:		Line 63:
	[[File:Genericconfiguration.PNG\|right\|600px\|thumb\|Editing the labels used for the states]]		[[File:Genericconfiguration.PNG\|right\|600px\|thumb\|Editing the labels used for the states]]
	This form controls the values of all non-free text fields (i.e., those that appear when clicking on an [[User Guide#General features\|arrow]]) within the system. Through each tab, the user is able to create, edit and delete the values of one of these fields.		This form controls the values of all non-free text fields (i.e., those that appear when clicking on an [[User Guide#General features\|arrow]]) within the system. Through each tab, the user is able to create, edit and delete the values of one of these fields.
	If the laboratory is not interested in one of the values, but the user does not wish to delete the information from the system, it can be simply disabled, so it will not be shown in the corresponding drop-down menu. This is done by unticking the ''Active'' checkbox. </br> [[File:Activecheckbox.PNG\|75px\|Activated checkbox]] ⇔ [[File:Deactivatedcheckbox.PNG\|75px\|Deactivated checkbox]] </br>		If the laboratory is not interested in one of the values, but the user does not wish to delete the information from the system, it can be simply disabled, so it will not be shown in the corresponding drop-down menu. This is done by unticking the ''Active'' checkbox.
			This is a very important feature, since deleting some configuration value will produce a cascade effect that will delete all other configuration records pointing to the deleted one (e.g., deleting a region will delete all its locations).
			Patients or requests will not be deleted, but the corresponding information will not be displayed anymore (e.g., after deleting a region, this information in the patient will become empty).</br>
			[[File:Activecheckbox.PNG\|75px\|Activated checkbox]] ⇔ [[File:Deactivatedcheckbox.PNG\|75px\|Deactivated checkbox]] </br>
	List of tabs:		List of tabs:
	*Regions (initially empty)		*Regions (initially empty)

FuzzyBot: Updating to match new version of source page

2024-01-23T08:46:35Z

Updating to match new version of source page

New page

[[Category:Configuration]]
The configuration functionality allows the user to manipulate ARIS, adding or changing some of its aspects for a better customization.
These have been divided into two groups, depending on the knowledge needed to use them.
The first group is absolutely generic and both laboratory supervisor and system administrator should be able to provide the required information.
However, for the second group, more specific biomedical knowledge will be needed, and consequently only the laboratory supervisor is allowed to do it.

<div style="float:right; margin: 0px 0px 0px 0px">
<graphviz border='frame' format='svg'>
digraph ConfigurationDiagram {
nodesep=0.05;
node [shape=oval style=filled fillcolor=orange fontsize="9pt" margin="0.01, 0.01"];
Configuration [label="Configuration"];
ConfGeneric [label="Generic", URL="#Generic_configuration"];
ConfTechnical [label="Technical", URL="#Technical_configuration"];
Configuration -> ConfGeneric;
Configuration -> ConfTechnical;
Regions [label="Regions", shape=tab, URL="#Generic_configuration"];
Locations [label="Locations", shape=tab, URL="#Generic_configuration"];
Units [label="Units", shape=tab, URL="#Generic_configuration"];
HealthFacilities [label="Health, Facilities" shape=tab, URL="#Generic_configuration"];
Physicians [label="Physicians", shape=tab, URL="#Generic_configuration"];
Gender [label="Gender", shape=tab, URL="#Generic_configuration"];
IdentificationCards [label="Identification Cards", shape=tab, URL="#Generic_configuration"];
StateOfTheRequest [label="State of the Request", shape=tab URL="#State_of_the_request"];
ConfGeneric -> Regions;
ConfGeneric -> Locations;
ConfGeneric -> Units;
ConfGeneric -> HealthFacilities;
ConfGeneric -> Physicians;
ConfGeneric -> Gender;
ConfGeneric -> IdentificationCards;
ConfGeneric -> StateOfTheRequest;
LaboratoryAreas [label="Laboratory Areas", shape=tab, URL="#Technical_configuration"];
AnalyticalTests [label="Analytical Tests", shape=tab URL="#Analytical_tests"];
AnalyticalTestsGroups [label="Analytical Tests Groups", shape=tab URL="#Analytical_tests_groups"];
AnalyticalProfiles [label="Analytical Profiles", shape=tab URL="#Analytical_profiles"];
KindsOfSamples [label="Kinds of Samples", shape=tab, URL="#Technical_configuration"];
SampleIncidents [label="Sample Incidents", shape=tab, URL="#Technical_configuration"];
SampleOrigins [label="Sample Origins", shape=tab, URL="#Technical_configuration"];
PregnancyPhases [label="Pregnancy Phases", shape=tab, URL="#Technical_configuration"];
DataTypes [label="Datatypes", shape=tab, URL="#Datatypes"];
ReportingOrder [label="Reporting Order", shape=tab, URL="#Reporting_order"];
ConfTechnical -> LaboratoryAreas;
ConfTechnical -> AnalyticalTests;
ConfTechnical -> AnalyticalTestsGroups;
ConfTechnical -> AnalyticalProfiles;
ConfTechnical -> KindsOfSamples;
ConfTechnical -> SampleIncidents;
ConfTechnical -> SampleOrigins;
ConfTechnical -> PregnancyPhases;
ConfTechnical -> DataTypes;
ConfTechnical -> ReportingOrder;
{ rank=same; Regions Units Physicians IdentificationCards LaboratoryAreas AnalyticalTestsGroups KindsOfSamples SampleOrigins DataTypes}
{ rank=same; ConfGeneric ConfTechnical}
{ rank=sink; Locations HealthFacilities Gender StateOfTheRequest AnalyticalTests AnalyticalProfiles SampleIncidents PregnancyPhases ReportingOrder}}
</graphviz>
</div>

__TOC__

==Generic configuration==
[[File:Genericconfiguration.PNG|right|600px|thumb|Editing the labels used for the states]]
This form controls the values of all non-free text fields (i.e., those that appear when clicking on an [[User Guide#General features|arrow]]) within the system. Through each tab, the user is able to create, edit and delete the values of one of these fields.
If the laboratory is not interested in one of the values, but the user does not wish to delete the information from the system, it can be simply disabled, so it will not be shown in the corresponding drop-down menu. This is done by unticking the ''Active'' checkbox. </br> [[File:Activecheckbox.PNG|75px|Activated checkbox]] ⇔ [[File:Deactivatedcheckbox.PNG|75px|Deactivated checkbox]] </br>
List of tabs:
*Regions (initially empty)
*Locations (initially empty)
*Units
*Health Facilities (initially empty)
*Physicians (initially empty)
*Gender
*Identification cards
*State of the request

Some of them also include hierarchical information. Thus, physicians point to health facilities, health facilities point to locations and these to regions. This information is used in the forms to show the right available values depending on the parent choice in the hierarchy.

===State of the request===
From the ''state of the request'' tab, only the ''label'' field can be edited. Notice that this indicates the different phases a request goes through in the application during its lifecycle, and not only a passive value to be stored.

==Technical configuration==
The ''Laboratory areas'', ''Kinds of sample'', ''Sample incidents'', ''Sample origins'' and ''Pregnancy phases'' tabs, have exactly the same effect as the ones under the [[#Generic configuration|generic configuration]] (i.e., they simply provide the available values in drop boxes).
However, the following tabs have further effects in the behaviour of the forms.

===Analytical tests===
[[File:Analyticalprofile.PNG|right|thumb|700px| Editing analytical profiles]]
This is without doubt the most crucial concept in the configuration, since it defines the available kinds of tests in the laboratory.
They are identified by a name, but also contain a code that will always be shown next to the name.
To facilitate the management of the laboratory, kinds of tests are assigned to a laboratory area, which will be used both in the generation of reports for the patients, as well as in the analysis of data regarding the performance of the laboratory itself.

Each kind of test is then related to a kind of sample.
Only after that kind of sample is provided by the patient, the corresponding test will be allowed to have an associated result.

Each test must have a [[#Datatypes|datatype]], which indicates the kind of result it will accept, this being either numerical (integer or real) or enumerate.
For numerical test results, units of the test can be indicated for informative purposes, together with upper and lower bounds of the result can be defined.
These will be automatically checked.
Only results within the declared boundaries will get a green tick next to them.
Those outside the boundaries will be detected and automatically marked with a red cross.
Validating the value will rely anyway on the laboratory supervisor.
However, a note can be provided here to indicate exceptions to the boundaries or any information that is considered relevant to either the technician or the supervisor.

Finally, there are two specific boolean fields:
* Referred → Indicates that an action or test is performed in another hospital. The option marked in the configuration only determines the default of this field for each test. It does not impede the laboratory supervisor from choosing differently in the [[Requests|Requests]] forms.
* Automatic → Enables the kind of test to be partially automated. The result of the test is not manually obtained by a person, but by an AI. If this option is disabled in the configuration, the laboratory supervisor will not be able to mark it otherwise in the [[Requests|Requests]] forms. However, if it is enabled, the laboratory supervisor will be able to choose if she desires for the test to be done automatically or not in the [[Requests|Requests]] forms.

===Analytical tests groups===
In this tab, groups of tests can be formed for a quicker selection when choosing which tests to perform on a patient. When creating or editing a new group, a ''Group Of Tests Information'' form must be filled in or modified. In this form, the group must be given a name and the laboratory supervisor must choose the tests included in the group from the box provided. In the left-hand side list, the groups are in alphabetical order and if the laboratory supervisor wishes for a quicker option, there is a search bar on top of the box to write down and filter the tests.
Simply clicking on the name of a test adds it to the group, hence appearing in the right-hand side list.

The analytical tests groups are also used to sort the tests in the generated report of a request.

===Analytical profiles===
In this tab, profiles of tests can be formed for a quicker selection when choosing which groups of tests or individual tests to perform on a patient.
When creating or editing a new profile, an ''Analytical Profile Information'' form must be filled in or modified.
In this form, the profile must be given a name and the laboratory supervisor must choose the tests and the groups included in the profile from the lists provided.
The groups and tests are in alphabetical order and if the laboratory supervisor wishes for a quicker option, there is a search bar on top of the box to write down and filter the tests and groups.

Choosing a group selects in the corresponding list all the tests belonging to it.
Then, these cannot be individually removed from the profile, but only by removing the group.
Moreover, a test added later to the group will automatically appear as part of any profile containing that group, which is indicated by a lock icon next to the test name.

Analytical profiles do not have any effect in the report generated for a request.

===Datatypes===

Enumerate datatypes can be defined here (integer and real numbers are always available).
These are simply lists of potential results that can be used in any kind of test.

===Reporting order===
[[File:Reportingorder.PNG|Centre|500px|thumb|Editing the laboratory areas order from the reporting areas tab]]
This tab allows ordering the elements in the PDF worklist and in the report of a request.
The tests appearing in them will be firstly sorted by laboratory area, then groups of tests, and finally individual tests.
This is done by choosing one of the three elements, which will lead to another form with a list and two vertical arrows on the left side of the image.
Any number of elements can be simultaneously selected by simply clicking on them.
Then, the arrows will allow to move them up or down in the list, and hence in the generated PDF documents.

← Older revision		Revision as of 15:23, 27 September 2024
Line 65:		Line 65:
	If the laboratory is not interested in one of the values, but the user does not wish to delete the information from the system, it can be simply disabled, so it will not be shown in the corresponding drop-down menu. This is done by unticking the ''Active'' checkbox.		If the laboratory is not interested in one of the values, but the user does not wish to delete the information from the system, it can be simply disabled, so it will not be shown in the corresponding drop-down menu. This is done by unticking the ''Active'' checkbox.
	This is a very important feature, since deleting some configuration value will produce a cascade effect that will delete all other configuration records pointing to the deleted one (e.g., deleting a region will delete all its locations).		This is a very important feature, since deleting some configuration value will produce a cascade effect that will delete all other configuration records pointing to the deleted one (e.g., deleting a region will delete all its locations).
	Patients or requests will not be deleted, but the corresponding information will not be displayed ~~anymore~~ (e.g., after deleting a region, this information in the patient will become empty).</br>		Patients or requests will not be deleted, but the corresponding information will not be displayed any more (e.g., after deleting a region, this information in the patient will become empty).</br>
	[[File:Activecheckbox.PNG\|75px\|Activated checkbox]] ⇔ [[File:Deactivatedcheckbox.PNG\|75px\|Deactivated checkbox]] </br>		[[File:Activecheckbox.PNG\|75px\|Activated checkbox]] ⇔ [[File:Deactivatedcheckbox.PNG\|75px\|Deactivated checkbox]] </br>
	List of tabs:		List of tabs:
Line 90:		Line 90:
	This is without doubt the most crucial concept in the configuration, since it defines the available kinds of tests in the laboratory.		This is without doubt the most crucial concept in the configuration, since it defines the available kinds of tests in the laboratory.
	They are identified by a name, but also contain a code that will always be shown next to the name.		They are identified by a name, but also contain a code that will always be shown next to the name.
	To facilitate the management of the laboratory, kinds of tests are assigned to a laboratory area, which will be used both in the generation of reports for the patients, ~~as well as~~ in the analysis of data regarding the performance of the laboratory itself.		To facilitate the management of the laboratory, kinds of tests are assigned to a laboratory area, which will be used both in the generation of reports for the patients, and in the analysis of data regarding the performance of the laboratory itself.

	Each kind of test is then related to a kind of sample.		Each kind of test is then related to a kind of sample.
Line 105:		Line 105:
	Finally, there are two specific boolean fields:		Finally, there are two specific boolean fields:
	* Referred → Indicates that an action or test is performed in another hospital. The option marked in the configuration only determines the default of this field for each test. It does not impede the laboratory supervisor from choosing differently in the [[Requests\|Requests]] forms.		* Referred → Indicates that an action or test is performed in another hospital. The option marked in the configuration only determines the default of this field for each test. It does not impede the laboratory supervisor from choosing differently in the [[Requests\|Requests]] forms.
	* Automatic → Enables the kind of test to be partially automated. The result of the test is not manually obtained by a person, but by an AI. If this option is disabled in the configuration, the laboratory supervisor will not be able to mark it otherwise in the [[Requests\|Requests]] forms. However, if it is enabled, the laboratory supervisor will be able to choose if ~~she desires~~ for the test to be done automatically or not in the [[Requests\|Requests]] forms.		* Automatic → Enables the kind of test to be partially automated. The result of the test is not manually obtained by a person, but by an AI. If this option is disabled in the configuration, the laboratory supervisor will not be able to mark it otherwise in the [[Requests\|Requests]] forms. However, if it is enabled, the laboratory supervisor will be able to choose if they desire for the test to be done automatically or not in the [[Requests\|Requests]] forms.

	===Analytical tests groups===		===Analytical tests groups===
Line 136:		Line 136:
	This is done by choosing one of the three elements, which will lead to another form with a list and two vertical arrows on the left side of the image.		This is done by choosing one of the three elements, which will lead to another form with a list and two vertical arrows on the left side of the image.
	Any number of elements can be simultaneously selected by simply clicking on them.		Any number of elements can be simultaneously selected by simply clicking on them.
	Then, the arrows will allow ~~to move~~ them up or down in the list, and hence in the generated PDF documents.		Then, the arrows will allow moving them up or down in the list, and hence in the generated PDF documents.