ARIS - User contributions [en]

Requests

2025-05-06T09:28:52Z

Gabriel: Marked this version for translation

[[Category:Requests]]
<languages/>
<translate>

Requests are the most important entities in ARIS, whose main purpose is to manage them.
They are always associated to a given patient, who must have been created before hand.


<div style="float:right; margin: 0px 0px 0px 0px">
<graphviz border='frame' format='svg'>
digraph RequestsDiagram {
node [shape="oval" style=filled fillcolor="orange" fontsize="9pt"];
//edge [minlen=2];
//----- Requests graph
// Nodes
Requests [label="Requests" ];
Create [label="Create", URL="#Create" ];
ChangeInformation [label="Change Information", URL="#Change_information"];
PatientsData [label="Patients' Data", shape="tab", URL="#Create"];
AdditionalInformation [label="Additional Information", shape="tab", URL="#Create"];
BiologicalSamples [label="Biological Samples", shape="tab", URL="#Create" ];
AnalyticalTests [label="Analytical Tests", shape="tab", URL="#Create" ];
DeliverSamples [label="Deliver Samples", URL="#Deliver_samples" ];
IntroduceResults [label="Introduce Results", URL="#Introduce_results" ];
ValidateResults [label="Validate Results", URL="#Validate_results"];
SearchHistoric [label="Search Historic", URL="#Search_historic"];
// Edges
Requests -> Create;
Requests -> ChangeInformation;
Create -> PatientsData;
ChangeInformation -> PatientsData;
PatientsData -> BiologicalSamples [dir=both minlen=2];
BiologicalSamples -> AnalyticalTests [dir=both minlen=2];
AnalyticalTests -> AdditionalInformation [dir=both minlen=2];
Requests -> DeliverSamples;
DeliverSamples -> BiologicalSamples;
Requests -> IntroduceResults;
IntroduceResults -> AnalyticalTests;
Requests -> ValidateResults;
ValidateResults -> AnalyticalTests;
Requests -> SearchHistoric;
{ rank=same; Create ChangeInformation DeliverSamples ValidateResults IntroduceResults SearchHistoric}
{ rank=same; PatientsData AnalyticalTests AdditionalInformation BiologicalSamples }
}
</graphviz>
</div>


__TOC__

==Request Lifespan== 
<div style="float:right; margin: 0px 0px 0px 0px">
<graphviz border='frame' format='svg'>
digraph StatesDiagram {
node [shape=rectangle style=rounded fontsize="9pt"];
edge [fontsize="7pt"];
//----- Main graph
// Nodes
Begin [label="" shape="circle" style=filled fillcolor=black fixedsize=true width=0.2 height=0.2];
Registered [label="Registered"];
Processing [label="Processing"];
WithResults [label="WithResults"];
Validated [label="Validated"];
Cancelled [label="Cancelled"];
End [label="" shape="doublecircle" style=filled fillcolor="black" fixedsize=true width=0.2 height=0.2];
// Edges
Begin -> Registered [constraint=false];
Registered -> Processing [label="Some sample delivered" constraint=false];
Processing -> WithResults [label="All results provided" constraint=false];
WithResults -> Validated [label="All tests validated" constraint=false];
Validated -> End [constraint=false];
Registered -> Cancelled [label="Cancel"];
Processing -> Cancelled [label="Cancel"];
WithResults -> Cancelled [label="Cancel"];
Cancelled -> End [constraint=false];
{ rank=same; Begin Registered Processing WithResults Validated}
{ rank=same; Cancelled End}
}
</graphviz>
</div>


During their lifespan, requests go through some different states that determine the functionalities offered for them in the system.
These states are depicted in the diagram, and their labels are modifaiable and configurable at [[Configuration#State_of_the_request|State of the request]].


On creation, the state of the request is ''Registered'', and allows to provide the basic information, as well as associate different tests to it.
After indicating that some of the samples have been delivered, the state changes to ''Processing'' and the data of the request cannot be modified anymore.
Other samples can be delivered later, but at this point, results can be provided for the tests whose sample was already delivered.
Once all non-cancelled tests have a result, the state of the request changes to ''WithResults''.
At this state, results can still be modified, but they are expected to be eventually validated.
A request with all its non-cancelled tests being validated is considered ''Validated''.


At any time, a request, its samples or its tests can be cancelled.
A sample with all its tests cancelled is considered cancelled, and a request with all samples cancelled is considered cancelled, too.


During the lifespan of a request, it is available to all the laboratory technicians, except for the validation, which can only be done by a laboratory supervisor or a specially authorized laboratory technician.

==Create== 
[[File:Selectpatient1.PNG|350px|right|thumb|Create request form]]


This form is divided into tabs. The tab the laboratory technician is on is indicated by the label of the tab turning orange. Above, it can be found the ''Requesting centre'' mandatory field, alongside with the additional ''Requesting unit'' field and the ''Urgent'' checkbox. To create a request, the following steps must be executed:


#Select a patient → The first tab involves searching and selecting a patient. The search grid can be narrowed down with the search field. Once a patient is selected, the main and important information about this patient will be displayed at the bottom of the form in a table. Until the patient has been selected, the laboratory technician cannot save the new request.
#Analytical tests → In this tab, the laboratory technician must choose which tests are requested and required for the patient. Groups and profiles will appear in case the proper [[System administration#Parameters|parameter]] is enabled. More than one element from each list may be chosen, but at least one test must be requested one way or another. Tests selected as part of a group or profile (highlighted in purple) cannot be deselected individually.
#Biological samples → This tab informs the laboratory technician of the type of sample that must be taken, depending on the tests chosen in the previous tab. There are no required fields in this tab, but if the laboratory technician wants to add a comment, there is a comment box for each sample. [[File:Comments.PNG|1000px]]
#Basic information → In this tab, other optional fields are provided like physician, the room or bed of the patient. Additional information like a diagnostic orientation or the pregnancy status can also be indicated.


At any moment, the ''Save values'' button cannot be used if any of the required fields is not filled in.

==Change information== 
[[File:SearchRequest.PNG|350px|right|thumb|Change information form]]


This form is for editing requests whose samples were not yet delivered.
Clicking on any part of the row will bring the laboratory technician to a form similar to the [[#Create|create]] one, with all of its tabs and similar format and behavior.

==Deliver samples== 
Similarly to the previous form, this also displays a list of either ''Registered'' or ''Processing'' requests, for the laboratory technician to choose one of them.
[[File:DeliverSamples1.PNG|350px|right|thumb|Deliver samples form]]
Once a request is chosen, five tabs are shown. The patient's data, potentially analytical tests already done in this request, its list of biological samples, the request data, and tests in previous requests.
Just the biological samples allows some interaction. The other ones are read-only (if enabled at all).


Each of the samples shown contains a field to provide comments, and it can be either checked as delivered or cancelled by click the corresponding red button.
On the delivering of a sample, its origin or incident can be optionally provided.
On cancelling, a pop-up dialogue allows, providing some justification for this.


It is important to notice that the tests associated to the request cannot be changed once the first sample as been delivered.

==Introduce results== 
As in the previous cases, a list of requests is shown.
In this case, this list contains all requests in ''Processing'' state.
Clicking the corresponding button at the bottom, it is possible to download a worklist with all pending tests in these requests, to work on them off-line.


[[File:IntroduceResults1.PNG|350px|right|thumb|Form to Introduce Results]]


Once the laboratory technician has chosen a request, five tabs are shown with the patient's data, its list of analytical tests, its list of biological samples, other request data, and potentially previous tests of the same patient.
Just the analytical tests allows some interaction. The other ones are read-only.
Besides the same search box present in all the tables in the system, there is also the possibility of filtering the tests by group of tests (if any was chosen for this request).
A red button in the top right corner allows cancelling the request.


The table of tests contains the following columns:
#Name → Shows the name and the code of the kind of test. It is coloured red if either the test or its sample was cancelled.
#Result → Allows to introduce the result of the test.
#Generic test note → Shows the informative note associated to the kind of test, if any.
#Result within range → Indicates whether the result of the test is in the expected range of values for the kind of test (green check) or not (red cross).
#Referred → Indicates whether the test is done or expected to be done in another laboratory (green check) or not (red cross).
#Automatic (not visible by default) → Indicates whether the test is done or expected to be done automatically (green check) or not (red cross). Automatic tests are done by means of the [http://dl-prod.essi.upc.edu/IMAGINGwiki/index.php/Microscope:Main Robotized microscope] and the [http://dl-prod.essi.upc.edu/IMAGINGwiki/index.php/MobileApp:Main Mobile App]. Their results should not be typed manually, but uploaded through Bluetooth. This feature is enabled through the corresponding [[System_administration#Parameters|system parameter]]. If enabled, the field is editable here to allow overwriting the automatic results.
#The test has some note → Indicates whether the test has some associated note (green check) or not (red cross).
#Test details → This should show an icon to navigate to further details of the test. However, if the test or its corresponding sample was cancelled, the corresponding message in red will be shown.
#Cancel test → Icon to cancel the test. If the test is cancelled. A red ''cancelled'' label appears.


[[File:TestDetails1.PNG|350px|right|thumb|Test details]]


On the laboratory technician accessing the details of the test, we gain access to visualize many other things (i.e., units of the result, inferior reference measure, superior reference measure, the user who introduced the results, as well as details provided for the corresponding sample on delivering it).
Moreover, this also allows changing if the test is automatic or deferred, indicate some incidence on the sample, or provide some note (notice that the content of this note will be visible to the patient in the report of the request).
It is important to notice that any of the information provided in this form will not be persisted in the disk until back in the list and saved from there.


If the result of the test was provided automatically (which is not enabled by default and only available in the context of the [http://dl-prod.essi.upc.edu/IMAGINGwiki/index.php/Main_Page IMAGING project]), the corresponding image and its associated note will be shown at the bottom of the details of the test.

==Validate results== 
[[File:Validateresults.mp4|left]]
This functionality, available only to the laboratory supervisor or a laboratory technician authorized to validate, uses exactly the same interface as introducing results, but the table shows one more column, ''Validated'', with a checkbox for each test.
These can be checked one by one, or all at once, by choosing a concrete group of tests in the dropbox at the top.
On doing the latter, a button to check all the tests of the group will appear.


Besides doing it in the list, the results can be overwritten and the test validated from the details of the test.
Together with displaying all the information related to the test in read-only mode, the corresponding form also offers the possibility of adding a note to the test, as well as changing whether the test is automatic/referred or not, cancelling the test or the whole request.


It is important to notice that the tests will not be really validated until the bottom right button is pressed to save the changes.

==Search historic== 
[[File:Download.mp4|left]]
This functionality, available to both laboratory technician and supervisor allows to see any request in the history of the laboratory.
They can be filtered out by the state and the date of the request.
By clicking on the corresponding row, all the details of the request can be visualized.


At the bottom left of this form, there are two download buttons.
Clicking any of them will generate and download the corresponding file (i.e., CSV or ZIP).
The checkboxes in the [[System administration#Downloaded fields|Downloaded fields]] tab indicate which fields will be included in each of these files.
Moreover, the ZIP file is password protected.
The password used is indicated by the system parameter ''zip_password'', whose value can be seen and modified from [[System administration#Parameters|Parameters]] tab.


Additionally, the field separator and decimal characters used in the CSV file can also be configured in the same tab.
</translate>

Requests

2025-05-06T09:28:34Z

Gabriel:

[[Category:Requests]]
<languages/>
<translate>

Requests are the most important entities in ARIS, whose main purpose is to manage them.
They are always associated to a given patient, who must have been created before hand.


<div style="float:right; margin: 0px 0px 0px 0px">
<graphviz border='frame' format='svg'>
digraph RequestsDiagram {
node [shape="oval" style=filled fillcolor="orange" fontsize="9pt"];
//edge [minlen=2];
//----- Requests graph
// Nodes
Requests [label="Requests" ];
Create [label="Create", URL="#Create" ];
ChangeInformation [label="Change Information", URL="#Change_information"];
PatientsData [label="Patients' Data", shape="tab", URL="#Create"];
AdditionalInformation [label="Additional Information", shape="tab", URL="#Create"];
BiologicalSamples [label="Biological Samples", shape="tab", URL="#Create" ];
AnalyticalTests [label="Analytical Tests", shape="tab", URL="#Create" ];
DeliverSamples [label="Deliver Samples", URL="#Deliver_samples" ];
IntroduceResults [label="Introduce Results", URL="#Introduce_results" ];
ValidateResults [label="Validate Results", URL="#Validate_results"];
SearchHistoric [label="Search Historic", URL="#Search_historic"];
// Edges
Requests -> Create;
Requests -> ChangeInformation;
Create -> PatientsData;
ChangeInformation -> PatientsData;
PatientsData -> BiologicalSamples [dir=both minlen=2];
BiologicalSamples -> AnalyticalTests [dir=both minlen=2];
AnalyticalTests -> AdditionalInformation [dir=both minlen=2];
Requests -> DeliverSamples;
DeliverSamples -> BiologicalSamples;
Requests -> IntroduceResults;
IntroduceResults -> AnalyticalTests;
Requests -> ValidateResults;
ValidateResults -> AnalyticalTests;
Requests -> SearchHistoric;
{ rank=same; Create ChangeInformation DeliverSamples ValidateResults IntroduceResults SearchHistoric}
{ rank=same; PatientsData AnalyticalTests AdditionalInformation BiologicalSamples }
}
</graphviz>
</div>


__TOC__

==Request Lifespan== 
<div style="float:right; margin: 0px 0px 0px 0px">
<graphviz border='frame' format='svg'>
digraph StatesDiagram {
node [shape=rectangle style=rounded fontsize="9pt"];
edge [fontsize="7pt"];
//----- Main graph
// Nodes
Begin [label="" shape="circle" style=filled fillcolor=black fixedsize=true width=0.2 height=0.2];
Registered [label="Registered"];
Processing [label="Processing"];
WithResults [label="WithResults"];
Validated [label="Validated"];
Cancelled [label="Cancelled"];
End [label="" shape="doublecircle" style=filled fillcolor="black" fixedsize=true width=0.2 height=0.2];
// Edges
Begin -> Registered [constraint=false];
Registered -> Processing [label="Some sample delivered" constraint=false];
Processing -> WithResults [label="All results provided" constraint=false];
WithResults -> Validated [label="All tests validated" constraint=false];
Validated -> End [constraint=false];
Registered -> Cancelled [label="Cancel"];
Processing -> Cancelled [label="Cancel"];
WithResults -> Cancelled [label="Cancel"];
Cancelled -> End [constraint=false];
{ rank=same; Begin Registered Processing WithResults Validated}
{ rank=same; Cancelled End}
}
</graphviz>
</div>


During their lifespan, requests go through some different states that determine the functionalities offered for them in the system.
These states are depicted in the diagram, and their labels are modifaiable and configurable at [[Configuration#State_of_the_request|State of the request]].


On creation, the state of the request is ''Registered'', and allows to provide the basic information, as well as associate different tests to it.
After indicating that some of the samples have been delivered, the state changes to ''Processing'' and the data of the request cannot be modified anymore.
Other samples can be delivered later, but at this point, results can be provided for the tests whose sample was already delivered.
Once all non-cancelled tests have a result, the state of the request changes to ''WithResults''.
At this state, results can still be modified, but they are expected to be eventually validated.
A request with all its non-cancelled tests being validated is considered ''Validated''.


At any time, a request, its samples or its tests can be cancelled.
A sample with all its tests cancelled is considered cancelled, and a request with all samples cancelled is considered cancelled, too.


During the lifespan of a request, it is available to all the laboratory technicians, except for the validation, which can only be done by a laboratory supervisor or a specially authorized laboratory technician.

==Create== 
[[File:Selectpatient1.PNG|350px|right|thumb|Create request form]]


This form is divided into tabs. The tab the laboratory technician is on is indicated by the label of the tab turning orange. Above, it can be found the ''Requesting centre'' mandatory field, alongside with the additional ''Requesting unit'' field and the ''Urgent'' checkbox. To create a request, the following steps must be executed:


#Select a patient → The first tab involves searching and selecting a patient. The search grid can be narrowed down with the search field. Once a patient is selected, the main and important information about this patient will be displayed at the bottom of the form in a table. Until the patient has been selected, the laboratory technician cannot save the new request.
#Analytical tests → In this tab, the laboratory technician must choose which tests are requested and required for the patient. Groups and profiles will appear in case the proper [[System administration#Parameters|parameter]] is enabled. More than one element from each list may be chosen, but at least one test must be requested one way or another. Tests selected as part of a group or profile (highlighted in purple) cannot be deselected individually.
#Biological samples → This tab informs the laboratory technician of the type of sample that must be taken, depending on the tests chosen in the previous tab. There are no required fields in this tab, but if the laboratory technician wants to add a comment, there is a comment box for each sample. [[File:Comments.PNG|1000px]]
#Basic information → In this tab, other optional fields are provided like physician, the room or bed of the patient. Additional information like a diagnostic orientation or the pregnancy status can also be indicated.


At any moment, the ''Save values'' button cannot be used if any of the required fields is not filled in.

==Change information== 
[[File:SearchRequest.PNG|350px|right|thumb|Change information form]]


This form is for editing requests whose samples were not yet delivered.
Clicking on any part of the row will bring the laboratory technician to a form similar to the [[#Create|create]] one, with all of its tabs and similar format and behavior.

==Deliver samples== 
Similarly to the previous form, this also displays a list of either ''Registered'' or ''Processing'' requests, for the laboratory technician to choose one of them.
[[File:DeliverSamples1.PNG|350px|right|thumb|Deliver samples form]]
Once a request is chosen, five tabs are shown. The patient's data, potentially analytical tests already done in this request, its list of biological samples, the request data, and tests in previous requests.
Just the biological samples allows some interaction. The other ones are read-only (if enabled at all).


Each of the samples shown contains a field to provide comments, and it can be either checked as delivered or cancelled by click the corresponding red button.
On the delivering of a sample, its origin or incident can be optionally provided.
On cancelling, a pop-up dialogue allows, providing some justification for this.


It is important to notice that the tests associated to the request cannot be changed once the first sample as been delivered.

==Introduce results== 
As in the previous cases, a list of requests is shown.
In this case, this list contains all requests in ''Processing'' state.
Clicking the corresponding button at the bottom, it is possible to download a worklist with all pending tests in these requests, to work on them off-line.


[[File:IntroduceResults1.PNG|350px|right|thumb|Form to Introduce Results]]


Once the laboratory technician has chosen a request, five tabs are shown with the patient's data, its list of analytical tests, its list of biological samples, other request data, and potentially previous tests of the same patient.
Just the analytical tests allows some interaction. The other ones are read-only.
Besides the same search box present in all the tables in the system, there is also the possibility of filtering the tests by group of tests (if any was chosen for this request).
A red button in the top right corner allows cancelling the request.


The table of tests contains the following columns:
#Name → Shows the name and the code of the kind of test. It is coloured red if either the test or its sample was cancelled.
#Result → Allows to introduce the result of the test.
#Generic test note → Shows the informative note associated to the kind of test, if any.
#Result within range → Indicates whether the result of the test is in the expected range of values for the kind of test (green check) or not (red cross).
#Referred → Indicates whether the test is done or expected to be done in another laboratory (green check) or not (red cross).
#Automatic (not visible by default) → Indicates whether the test is done or expected to be done automatically (green check) or not (red cross). Automatic tests are done by means of the [http://dl-prod.essi.upc.edu/IMAGINGwiki/index.php/Microscope:Main Robotized microscope] and the [http://dl-prod.essi.upc.edu/IMAGINGwiki/index.php/MobileApp:Main Mobile App]. Their results should not be typed manually, but uploaded through Bluetooth. This feature is enabled through the corresponding [[System_administration#Parameters|system parameter]]. If enabled, the field is editable here to allow overwriting the automatic results.
#The test has some note → Indicates whether the test has some associated note (green check) or not (red cross).
#Test details → This should show an icon to navigate to further details of the test. However, if the test or its corresponding sample was cancelled, the corresponding message in red will be shown.
#Cancel test → Icon to cancel the test. If the test is cancelled. A red ''cancelled'' label appears.


[[File:TestDetails1.PNG|350px|right|thumb|Test details]]


On the laboratory technician accessing the details of the test, we gain access to visualize many other things (i.e., units of the result, inferior reference measure, superior reference measure, the user who introduced the results, as well as details provided for the corresponding sample on delivering it).
Moreover, this also allows changing if the test is automatic or deferred, indicate some incidence on the sample, or provide some note (notice that the content of this note will be visible to the patient in the report of the request).
It is important to notice that any of the information provided in this form will not be persisted in the disk until back in the list and saved from there.


If the result of the test was provided automatically (which is not enabled by default and only available in the context of the [http://dl-prod.essi.upc.edu/IMAGINGwiki/index.php/Main_Page IMAGING project]), the corresponding image and its associated note will be shown at the bottom of the details of the test.

==Validate results== 
[[File:Validateresults.mp4|left]]
This functionality, available only to the laboratory supervisor or a laboratory technician authorized to validate, uses exactly the same interface as introducing results, but the table shows one more column, ''Validated'', with a checkbox for each test.
These can be checked one by one, or all at once, by choosing a concrete group of tests in the dropbox at the top.
On doing the latter, a button to check all the tests of the group will appear.


Besides doing it in the list, the results can be overwritten and the test validated from the details of the test.
Together with displaying all the information related to the test in read-only mode, the corresponding form also offers the possibility of adding a note to the test, as well as changing whether the test is automatic/referred or not, cancelling the test or the whole request.


It is important to notice that the tests will not be really validated until the bottom right button is pressed to save the changes.

==Search historic== 
[[File:Download.mp4|left]]
This functionality, available to both laboratory technician and supervisor allows to see any request in the history of the laboratory.
They can be filtered out by the state and the date of the request.
By clicking on the corresponding row, all the details of the request can be visualized.


At the bottom left of this form, there are two download buttons.
Clicking any of them will generate and download the corresponding file (i.e., CSV or ZIP).
The checkboxes in the [[System administration#Downloaded fields|Downloaded fields]] tab indicate which fields will be included in each of these files.
Moreover, the ZIP file is password protected.
The password used is indicated by the system parameter ''zip_password'', whose value can be seen and modified from [[System administration#Parameters|Parameters]] tab.

Additionally, the field separator and decimal characters used in the CSV file can also be configured in the same tab.
</translate>

Requests/es

2025-05-06T08:53:37Z

Gabriel: Created page with "Además, el separador de campo y los caracteres decimales utilizados en el archivo CSV también se pueden configurar en la misma pestaña."

[[Category:Requests]]
<languages/>
La gestión de las solicitudes es el proceso más importante que realiza ARIS, siendo éste el objetivo principal de la aplicación.
Las solicitudes siempre están asociadas a un paciente determinado, que debe haber sido creado previamente.

<div style="float:right; margin: 0px 0px 0px 0px">
<graphviz border='frame' format='svg'>
digraph RequestsDiagram {
node [shape="oval" style=filled fillcolor="orange" fontsize="9pt"];
//edge [minlen=2];
//----- Requests graph
// Nodes
Requests [label="Solicitudes" ];
Create [label="Creación de Solicitud", URL="#Creación_de_Solicitud"];
ChangeInformation [label="Cambiar Información", URL="#Cambiar_información"];
PatientsData [label="Datos del Paciente", shape="tab", URL="#Creación_de_Solicitud"];
AdditionalInformation [label="Información Adicional", shape="tab", URL="#Creación_de_Solicitud"];
BiologicalSamples [label="Muestras Biológicas", shape="tab", URL="#Creación_de_Solicitud"];
AnalyticalTests [label="Tests Analíticos", shape="tab", URL="#Creación_de_Solicitud"];
DeliverSamples [label="Entrega de Muestras", URL="#Entrega_de_muestras" ];
IntroduceResults [label="Introducción de los Resultados", URL="#Introducción_de_los_resultados" ];
ValidateResults [label="Validar Resultados", URL="#Validar_resultados"];
SearchHistoric [label="Buscar en el Histórico", URL="#Buscar_en_el_histórico"];
// Edges
Requests -> Create;
Requests -> ChangeInformation;
Create -> PatientsData;
ChangeInformation -> PatientsData;
PatientsData -> BiologicalSamples [dir=both minlen=2];
BiologicalSamples -> AnalyticalTests [dir=both minlen=2];
AnalyticalTests -> AdditionalInformation [dir=both minlen=2];
Requests -> DeliverSamples
DeliverSamples -> BiologicalSamples;
Requests -> IntroduceResults;
IntroduceResults -> AnalyticalTests;
Requests -> ValidateResults;
ValidateResults -> AnalyticalTests;
Requests -> SearchHistoric;
{ rank=same; Create ChangeInformation DeliverSamples ValidateResults IntroduceResults SearchHistoric}
{ rank=same; PatientsData AnalyticalTests AdditionalInformation BiologicalSamples}
}
</graphviz>
</div>

__TOC__

==Ciclo de vida de la Solicitud ==
<div style="float:right; margin: 0px 0px 0px 0px">
<graphviz border='frame' format='svg'>
digraph StatesDiagram {
node [shape=rectangle style=rounded fontsize="9pt"];
edge [fontsize="7pt"];
//----- Main graph
// Nodes
Begin [label="" shape="circle" style=filled fillcolor=black fixedsize=true width=0.2 height=0.2];
Registered [label="Registrada"];
Processing [label="Procesando"];
WithResults [label="Con Resultados"];
Validated [label="Validada"];
Cancelled [label="Cancelada"];
End [label="" shape="doublecircle" style=filled fillcolor="black" fixedsize=true width=0.2 height=0.2];
// Edges
Begin -> Registered [constraint=false];
Registered -> Processing [label="Alguna muestra entregada" constraint=false];
Processing -> WithResults [label="Todos los resultados disponibles" constraint=false];
WithResults -> Validated [label="Todos los tests validados" constraint=false];
Validated -> End [constraint=false];
Registered -> Cancelled [label="Cancelar"];
Processing -> Cancelled [label="Cancelar"];
WithResults -> Cancelled [label="Cancelar"];
Cancelled -> End [constraint=false];
{ rank=same; Begin Registered Processing WithResults Validated}
{ rank=same; Cancelled End}
}
</graphviz>
</div>

Durante su vida útil, las solicitudes pasan por diferentes estados que determinan las funcionalidades que se les ofrecen en el sistema.
Estos estados se muestran en el diagrama y sus etiquetas se pueden modificar y configurar en [[Configuration/es#Estado_de_la_solicitud|Estado de la Solicitud]].

Al crear una nueva solicitud, el estado en el que aparece es ''Registrada'', y permite proporcionar la información básica, así como asociarle diferentes test.
Después de marcar que algunas de las muestras han sido entregadas, el estado cambia a ''Procesando'' y los datos de la solicitud ya no se pueden modificar.
Se pueden entregar otras muestras más adelante, pero en este punto ya se pueden proporcionar los resultados de los test cuya muestra ya se entregó.
Una vez que todos los test no cancelados tengan un resultado, el estado de la solicitud cambia a ''Con Resultados''.
En este estado, los resultados aún se pueden modificar, mientras se espera que eventualmente se validen.
Una solicitud con todos sus test no cancelados y validados se considera ''Validada''.

En cualquier momento se podrá cancelar una solicitud, sus muestras o sus test.
Una muestra con todas sus pruebas canceladas se considera cancelada y una solicitud con todas sus muestras canceladas también se considera cancelada.

Durante la vida útil de una solicitud, ésta está a disposición de los técnicos de laboratorio, excepto para realizar la validación, que sólo puede ser realizada por un supervisor de laboratorio o un técnico de laboratorio especialmente autorizado para ello.

==Creación de Solicitud==
[[File:Selectpatient1.PNG|350px|right|thumb|Formulario de creación de solicitud]]

Este formulario se divide en pestañas. La pestaña en la que se encuentra el técnico de laboratorio se indica mediante la etiqueta de la pestaña que se pone en color naranja. Encima se encuentra el campo obligatorio “Centro solicitante”, junto con el campo adicional “Unidad solicitante” y la casilla de verificación “Urgente”. Para crear una solicitud se deben realizar los siguientes pasos:

#Seleccionar un paciente → La primera pestaña permite buscar y seleccionar un paciente. La tabla de búsqueda se puede acotar con el campo de búsqueda. Una vez seleccionado un paciente, la información principal más importante sobre este paciente se mostrará en la parte inferior del formulario en una tabla estática. Hasta que no se haya seleccionado el paciente, el técnico de laboratorio no puede guardar la nueva solicitud.
#Pruebas analíticas → En esta pestaña, el técnico de laboratorio debe elegir qué pruebas se solicitan y requieren para el paciente. Los grupos y perfiles aparecerán en caso de que se habilite el [[System administration/es#Parameters#Parámetros|parámetro]] adecuado. Se puede elegir más de un elemento de cada lista, pero al menos un test debe solicitarse de una forma u otra. Los tests seleccionados como parte de un grupo o perfil (resaltados en violeta) no se pueden deseleccionar individualmente.
#Muestras biológicas → Esta pestaña informa al técnico de laboratorio del tipo de muestra que debe tomar, dependiendo de las pruebas elegidas en la pestaña anterior. No hay campos obligatorios en esta pestaña, pero si el técnico de laboratorio desea agregar un comentario, hay un cuadro de comentarios para cada muestra. [[File:Comments.PNG|1000px]]
#Información básica → En esta pestaña, se proporcionan otros campos opcionales como el médico, la habitación o la cama del paciente. También se puede indicar información adicional como una orientación diagnóstica o el estado de embarazo.

En todo momento, no se podrá utilizar el botón “Guardar valores” si alguno de los campos obligatorios no está rellenado.

==Cambiar información==
[[File:SearchRequest.PNG|350px|right|thumb|Formulario de cambio de información]]

Este formulario es para editar solicitudes cuyas muestras aún no se han entregado.
Al hacer clic en cualquier parte de la fila, el técnico de laboratorio accederá a un formulario similar al de [[#Creación_de_Solicitud|Creación de Solicitud]], con todas sus pestañas y formato y comportamiento similar.

==Entrega de muestras==
Al igual que el formulario anterior, este también muestra una lista de solicitudes ''Registradas'' o ''Procesando'', para que el técnico de laboratorio elija una de ellas.
[[File:DeliverSamples1.PNG|350px|right|thumb|Formulario de entrega de muestras]]
Una vez elegida una solicitud, se muestran cinco pestañas: Los datos del paciente, las posibles pruebas analíticas ya realizadas en esta solicitud, su lista de muestras biológicas, los datos de la solicitud y las pruebas de solicitudes anteriores.
Solo las muestras biológicas permiten cierta interacción. Las demás son de solo lectura (si están habilitadas).

Cada una de las muestras mostradas contiene un campo para proporcionar comentarios, y se puede marcar como entregada o cancelar haciendo clic en el botón rojo correspondiente.
A la entrega de una muestra se podrá indicar opcionalmente su origen o alguna incidencia detectada en la misma.
Al cancelar, un cuadro de diálogo emergente permite proporcionar alguna justificación para hacerlo.

Es importante tener en cuenta que los test asociados a la solicitud no se pueden cambiar una vez entregada la primera muestra.

==Introducción de los resultados==
Como en los casos anteriores, se muestra una lista de solicitudes.
En esta lista todas las solicitudes se encuentran en estado ''Procesando''.
Al hacer clic en el botón correspondiente en la parte inferior, es posible descargar una lista de trabajo con todas las pruebas pendientes en estas solicitudes, para trabajar en ellas fuera de línea.

[[File:IntroduceResults1.PNG|350px|right|thumb|Formulario de introducción de resultados]]

Una vez que el técnico de laboratorio elige una solicitud, se muestran cinco pestañas con los datos del paciente, su lista de tests analíticos, su listado de muestras biológicas, y potencialmente los test previos del mismo paciente.
Las primeras tres pestañas y la última son sólo de lectura.
Sólo las pruebas analíticas permiten cierta interacción. El resto de pestañas son de solo lectura.
Además de la misma casilla de búsqueda presente en todas las tablas del sistema, también existe la posibilidad de filtrar los test por grupo de test (si se eligió algún grupo para esta solicitud).
Un botón rojo en la esquina superior derecha permite cancelar la solicitud.

La tabla de test contiene las siguientes columnas.
#Nombre → Muestra el nombre y el código del tipo de test. Se colorea de rojo si se canceló el test o su muestra.
#Resultado → Permite introducir el resultado del test.
#Generic test note → Muestra la nota informativa asociada al tipo de test, si la hubiera.
#Resultado dentro de rango → Indica si el resultado de la prueba está en el rango de valores esperado para el tipo de prueba (check verde) o no (cruz roja).
#Referido → Indica si la prueba se realiza o se espera que se realice en otro laboratorio (check verde) o no (cruz roja).
#Automático (no visible por defecto) → Indica si la prueba se realiza o se espera que se realice automáticamente (check verde) o no (cruz roja). Las pruebas automáticas se realizan mediante el [http://dl-prod.essi.upc.edu/IMAGINGwiki/index.php/Microscope:Main Microscopio robotizado] y el [http://dl-prod.essi.upc.edu/IMAGINGwiki/index.php/MobileApp:Main Aplicación móbil]. Sus resultados no deben escribirse manualmente, sino cargarse a través de Bluetooth. Esta característica se habilita a través del correspondiente [[System_administration/es#Parámetros|parámetro del sistema]]. Si está habilitado, el campo se puede editar aquí para permitir sobrescribir los resultados automáticos.
#La prueba tiene alguna nota→ Indica si la prueba tiene alguna nota asociada (check verde) o no (cruz roja). Las pruebas cuyos resultados se generaron automáticamente siempre tendrán una nota asociada.
#Detalles del test → Esto debería mostrar un icono para navegar a más detalles del test. Sin embargo, si el test o su correspondiente muestra fue cancelada, se mostrará el mensaje correspondiente en rojo.
#Cancelar prueba→ Icono para cancelar la prueba. Si se cancela la prueba, aparece una etiqueta roja que dice "Cancelado".

[[File:TestDetails1.PNG|350px|right|thumb|Detalles del test]]

Al acceder el técnico de laboratorio a los detalles del test, se pueden visualizar muchas otras cosas (como unidades del resultado, medida de referencia inferior, medida de referencia superior, el usuario que introdujo los resultados, así como los detalles proporcionados para la correspondiente muestra al entregarla).
Además, esto también permite cambiar si el test es automático o diferido, indicar alguna incidencia en la muestra, o añadir alguna nota (nótese que el contenido de esta nota será visible para el paciente en el reporte de la petición).
Es importante tener en cuenta que la información proporcionada en este formulario no se conservará en el disco hasta que vuelva a la lista y se guarde desde allí.

Si el resultado del test se proporcionó automáticamente (no está habilitado de forma predeterminada y solo está disponible en el contexto del [http://dl-prod.essi.upc.edu/IMAGINGwiki/index.php/Main_Page Proyecto IMAGING]), la imagen correspondiente y su nota asociada se mostrarán en la parte inferior del detalle del test.

==Validar resultados==
[[File:Validateresults.mp4|left]]
Esta funcionalidad, disponible sólo para el supervisor del laboratorio o un tècnico especialmente autorizado para ello, utiliza exactamente la misma interfaz que la introducción de resultados, pero la tabla muestra una columna más, ''Validado'', con una casilla de verificación para cada test.
Estos se pueden verificar uno por uno o todos a la vez eligiendo un grupo concreto de test en el cuadro desplegable en la parte superior.
Al hacer esto último aparecerá un botón para consultar todos los test del grupo.

Además de poder sobrescribir y validar los resultados en la lista, también se puede hacer desde los detalles del test.
Junto a mostrar toda la información relacionada con el test en modo de solo lectura, el formulario correspondiente también ofrece la posibilidad de añadir una nota al test, así como cambiar si el test es automático o referido, cancelar el test o la solicitud completa.

Es importante tener en cuenta que los test no quedarán realmente validados hasta que se presione el botón inferior derecho para guardar los cambios.

==Buscar en el histórico==
[[File:Download.mp4|left]]
Esta funcionalidad, disponible tanto para el técnico de laboratorio como para el supervisor, permite ver cualquier solicitud en el historial del laboratorio.
Se pueden filtrar por estado y por fecha de la solicitud.
Al hacer clic en la fila correspondiente se podrán visualizar todos los detalles de la solicitud.

En la parte inferior izquierda de este formulario, hay dos botones de descarga.
Al hacer clic en cualquiera de ellos, se generará y descargará el archivo correspondiente (es decir, CSV o ZIP).
Las casillas de verificación en la pestaña [[System_administration/es#Campos_descargados|Campos Descargados]] indican qué campos se incluirán en cada uno de estos archivos.
Además, el archivo ZIP está protegido con contraseña.
La contraseña utilizada viene indicada por el parámetro del sistema ''zip_password'', cuyo valor se puede ver y modificar desde la pestaña [[System_administration/es#Parámetros|Parámetros]].

Además, el separador de campo y los caracteres decimales utilizados en el archivo CSV también se pueden configurar en la misma pestaña.

Translations:Requests/31/es

2025-05-06T08:51:39Z

Gabriel: Created page with "Además, el separador de campo y los caracteres decimales utilizados en el archivo CSV también se pueden configurar en la misma pestaña."

Además, el separador de campo y los caracteres decimales utilizados en el archivo CSV también se pueden configurar en la misma pestaña.

Requests

2025-05-05T12:16:24Z

Gabriel: Marked this version for translation

[[Category:Requests]]
<languages/>
<translate>

Requests are the most important entities in ARIS, whose main purpose is to manage them.
They are always associated to a given patient, who must have been created before hand.


<div style="float:right; margin: 0px 0px 0px 0px">
<graphviz border='frame' format='svg'>
digraph RequestsDiagram {
node [shape="oval" style=filled fillcolor="orange" fontsize="9pt"];
//edge [minlen=2];
//----- Requests graph
// Nodes
Requests [label="Requests" ];
Create [label="Create", URL="#Create" ];
ChangeInformation [label="Change Information", URL="#Change_information"];
PatientsData [label="Patients' Data", shape="tab", URL="#Create"];
AdditionalInformation [label="Additional Information", shape="tab", URL="#Create"];
BiologicalSamples [label="Biological Samples", shape="tab", URL="#Create" ];
AnalyticalTests [label="Analytical Tests", shape="tab", URL="#Create" ];
DeliverSamples [label="Deliver Samples", URL="#Deliver_samples" ];
IntroduceResults [label="Introduce Results", URL="#Introduce_results" ];
ValidateResults [label="Validate Results", URL="#Validate_results"];
SearchHistoric [label="Search Historic", URL="#Search_historic"];
// Edges
Requests -> Create;
Requests -> ChangeInformation;
Create -> PatientsData;
ChangeInformation -> PatientsData;
PatientsData -> BiologicalSamples [dir=both minlen=2];
BiologicalSamples -> AnalyticalTests [dir=both minlen=2];
AnalyticalTests -> AdditionalInformation [dir=both minlen=2];
Requests -> DeliverSamples;
DeliverSamples -> BiologicalSamples;
Requests -> IntroduceResults;
IntroduceResults -> AnalyticalTests;
Requests -> ValidateResults;
ValidateResults -> AnalyticalTests;
Requests -> SearchHistoric;
{ rank=same; Create ChangeInformation DeliverSamples ValidateResults IntroduceResults SearchHistoric}
{ rank=same; PatientsData AnalyticalTests AdditionalInformation BiologicalSamples }
}
</graphviz>
</div>


__TOC__

==Request Lifespan== 
<div style="float:right; margin: 0px 0px 0px 0px">
<graphviz border='frame' format='svg'>
digraph StatesDiagram {
node [shape=rectangle style=rounded fontsize="9pt"];
edge [fontsize="7pt"];
//----- Main graph
// Nodes
Begin [label="" shape="circle" style=filled fillcolor=black fixedsize=true width=0.2 height=0.2];
Registered [label="Registered"];
Processing [label="Processing"];
WithResults [label="WithResults"];
Validated [label="Validated"];
Cancelled [label="Cancelled"];
End [label="" shape="doublecircle" style=filled fillcolor="black" fixedsize=true width=0.2 height=0.2];
// Edges
Begin -> Registered [constraint=false];
Registered -> Processing [label="Some sample delivered" constraint=false];
Processing -> WithResults [label="All results provided" constraint=false];
WithResults -> Validated [label="All tests validated" constraint=false];
Validated -> End [constraint=false];
Registered -> Cancelled [label="Cancel"];
Processing -> Cancelled [label="Cancel"];
WithResults -> Cancelled [label="Cancel"];
Cancelled -> End [constraint=false];
{ rank=same; Begin Registered Processing WithResults Validated}
{ rank=same; Cancelled End}
}
</graphviz>
</div>


During their lifespan, requests go through some different states that determine the functionalities offered for them in the system.
These states are depicted in the diagram, and their labels are modifaiable and configurable at [[Configuration#State_of_the_request|State of the request]].


On creation, the state of the request is ''Registered'', and allows to provide the basic information, as well as associate different tests to it.
After indicating that some of the samples have been delivered, the state changes to ''Processing'' and the data of the request cannot be modified anymore.
Other samples can be delivered later, but at this point, results can be provided for the tests whose sample was already delivered.
Once all non-cancelled tests have a result, the state of the request changes to ''WithResults''.
At this state, results can still be modified, but they are expected to be eventually validated.
A request with all its non-cancelled tests being validated is considered ''Validated''.


At any time, a request, its samples or its tests can be cancelled.
A sample with all its tests cancelled is considered cancelled, and a request with all samples cancelled is considered cancelled, too.


During the lifespan of a request, it is available to all the laboratory technicians, except for the validation, which can only be done by a laboratory supervisor or a specially authorized laboratory technician.

==Create== 
[[File:Selectpatient1.PNG|350px|right|thumb|Create request form]]


This form is divided into tabs. The tab the laboratory technician is on is indicated by the label of the tab turning orange. Above, it can be found the ''Requesting centre'' mandatory field, alongside with the additional ''Requesting unit'' field and the ''Urgent'' checkbox. To create a request, the following steps must be executed:


#Select a patient → The first tab involves searching and selecting a patient. The search grid can be narrowed down with the search field. Once a patient is selected, the main and important information about this patient will be displayed at the bottom of the form in a table. Until the patient has been selected, the laboratory technician cannot save the new request.
#Analytical tests → In this tab, the laboratory technician must choose which tests are requested and required for the patient. Groups and profiles will appear in case the proper [[System administration#Parameters|parameter]] is enabled. More than one element from each list may be chosen, but at least one test must be requested one way or another. Tests selected as part of a group or profile (highlighted in purple) cannot be deselected individually.
#Biological samples → This tab informs the laboratory technician of the type of sample that must be taken, depending on the tests chosen in the previous tab. There are no required fields in this tab, but if the laboratory technician wants to add a comment, there is a comment box for each sample. [[File:Comments.PNG|1000px]]
#Basic information → In this tab, other optional fields are provided like physician, the room or bed of the patient. Additional information like a diagnostic orientation or the pregnancy status can also be indicated.


At any moment, the ''Save values'' button cannot be used if any of the required fields is not filled in.

==Change information== 
[[File:SearchRequest.PNG|350px|right|thumb|Change information form]]


This form is for editing requests whose samples were not yet delivered.
Clicking on any part of the row will bring the laboratory technician to a form similar to the [[#Create|create]] one, with all of its tabs and similar format and behavior.

==Deliver samples== 
Similarly to the previous form, this also displays a list of either ''Registered'' or ''Processing'' requests, for the laboratory technician to choose one of them.
[[File:DeliverSamples1.PNG|350px|right|thumb|Deliver samples form]]
Once a request is chosen, five tabs are shown. The patient's data, potentially analytical tests already done in this request, its list of biological samples, the request data, and tests in previous requests.
Just the biological samples allows some interaction. The other ones are read-only (if enabled at all).


Each of the samples shown contains a field to provide comments, and it can be either checked as delivered or cancelled by click the corresponding red button.
On the delivering of a sample, its origin or incident can be optionally provided.
On cancelling, a pop-up dialogue allows, providing some justification for this.


It is important to notice that the tests associated to the request cannot be changed once the first sample as been delivered.

==Introduce results== 
As in the previous cases, a list of requests is shown.
In this case, this list contains all requests in ''Processing'' state.
Clicking the corresponding button at the bottom, it is possible to download a worklist with all pending tests in these requests, to work on them off-line.


[[File:IntroduceResults1.PNG|350px|right|thumb|Form to Introduce Results]]


Once the laboratory technician has chosen a request, five tabs are shown with the patient's data, its list of analytical tests, its list of biological samples, other request data, and potentially previous tests of the same patient.
Just the analytical tests allows some interaction. The other ones are read-only.
Besides the same search box present in all the tables in the system, there is also the possibility of filtering the tests by group of tests (if any was chosen for this request).
A red button in the top right corner allows cancelling the request.


The table of tests contains the following columns:
#Name → Shows the name and the code of the kind of test. It is coloured red if either the test or its sample was cancelled.
#Result → Allows to introduce the result of the test.
#Generic test note → Shows the informative note associated to the kind of test, if any.
#Result within range → Indicates whether the result of the test is in the expected range of values for the kind of test (green check) or not (red cross).
#Referred → Indicates whether the test is done or expected to be done in another laboratory (green check) or not (red cross).
#Automatic (not visible by default) → Indicates whether the test is done or expected to be done automatically (green check) or not (red cross). Automatic tests are done by means of the [http://dl-prod.essi.upc.edu/IMAGINGwiki/index.php/Microscope:Main Robotized microscope] and the [http://dl-prod.essi.upc.edu/IMAGINGwiki/index.php/MobileApp:Main Mobile App]. Their results should not be typed manually, but uploaded through Bluetooth. This feature is enabled through the corresponding [[System_administration#Parameters|system parameter]]. If enabled, the field is editable here to allow overwriting the automatic results.
#The test has some note → Indicates whether the test has some associated note (green check) or not (red cross).
#Test details → This should show an icon to navigate to further details of the test. However, if the test or its corresponding sample was cancelled, the corresponding message in red will be shown.
#Cancel test → Icon to cancel the test. If the test is cancelled. A red ''cancelled'' label appears.


[[File:TestDetails1.PNG|350px|right|thumb|Test details]]


On the laboratory technician accessing the details of the test, we gain access to visualize many other things (i.e., units of the result, inferior reference measure, superior reference measure, the user who introduced the results, as well as details provided for the corresponding sample on delivering it).
Moreover, this also allows changing if the test is automatic or deferred, indicate some incidence on the sample, or provide some note (notice that the content of this note will be visible to the patient in the report of the request).
It is important to notice that any of the information provided in this form will not be persisted in the disk until back in the list and saved from there.


If the result of the test was provided automatically (which is not enabled by default and only available in the context of the [http://dl-prod.essi.upc.edu/IMAGINGwiki/index.php/Main_Page IMAGING project]), the corresponding image and its associated note will be shown at the bottom of the details of the test.

==Validate results== 
[[File:Validateresults.mp4|left]]
This functionality, available only to the laboratory supervisor or a laboratory technician authorized to validate, uses exactly the same interface as introducing results, but the table shows one more column, ''Validated'', with a checkbox for each test.
These can be checked one by one, or all at once, by choosing a concrete group of tests in the dropbox at the top.
On doing the latter, a button to check all the tests of the group will appear.


Besides doing it in the list, the results can be overwritten and the test validated from the details of the test.
Together with displaying all the information related to the test in read-only mode, the corresponding form also offers the possibility of adding a note to the test, as well as changing whether the test is automatic/referred or not, cancelling the test or the whole request.


It is important to notice that the tests will not be really validated until the bottom right button is pressed to save the changes.

==Search historic== 
[[File:Download.mp4|left]]
This functionality, available to both laboratory technician and supervisor allows to see any request in the history of the laboratory.
They can be filtered out by the state and the date of the request.
By clicking on the corresponding row, all the details of the request can be visualized.


At the bottom left of this form, there are two download buttons.
Clicking any of them will generate and download the corresponding file (i.e., CSV or ZIP).
The checkboxes in the [[System administration#Downloaded fields|Downloaded fields]] tab indicate which fields will be included in each of these files.
Moreover, the ZIP file is password protected.
The password used is indicated by the system parameter ''zip_password'', whose value can be seen and modified from [[System administration#Parameters|Parameters]] tab.


Additionally, the field separator and decimal characters used in the CSV file can also be configured in the same tab.
</translate>