Result management

Revision as of 15:36, 17 July 2013

After a query has been executed the Result window will open.

Buttons

Buttons with a blue dotted frame have special functionalities. Click on it to have more information.

<a href="/index.php?title=MedITEX_IVF_main_page"><img style="display: block; margin-left: auto; margin-right: auto; border: 2px dotted blue;" src="/images/HomeRE.png" alt="" width="70" height="35" /></a>	Click this button to go back to MedITEX main page.
<img style="display: block; margin-left: auto; margin-right: auto;" src="/images/RefreshResult.png" alt="" width="85" height="35" />	If the value related to one or more of the query field has been changed, the result can be updated by clicking this button without executing the query again.
<img style="display: block; margin-left: auto; margin-right: auto;" src="/images/UtilizeAs.png" alt="" width="75" height="35" />	With this button, a query can be set as working list in the list section or as standard letter in one of the sections of MedITEX IVF.
<img style="display: block; margin-left: auto; margin-right: auto;" src="/images/PrintRE.png" alt="" width="86" height="35" />	With this button, you may print the result table or a letter, depending on which tab (Query result, Word module or Rich text module) is active.
<img style="display: block; margin-left: auto; margin-right: auto;" src="/images/ExportRE.png" alt="" />	By clicking this button, a result table may be exported in different file formats (Excel, CSV, HTML, TXT, PDF and XML).
<a href="/index.php?title=Result_management#Administrate_letters"><img style="display: block; margin-left: auto; margin-right: auto; border: 2px dotted blue;" src="/images/AdministrateLetters.png" alt="" width="109" height="35" /></a>	By clicking on this button, the window Configuration will pop up.
<a href="/index.php?title=Result_management#Statistical_analysis"><img style="display: block; margin-left: auto; margin-right: auto; border: 2px dotted blue;" src="/images/Statistics.png" alt="" width="60" height="38" /></a>	This button can be used to produce a chart.
<img src="/images/Sum.png" alt="" />	The sum of the values of a column is shown by clicking this button.
<img src="/images/Average.png" alt="" width="58" height="35" />	The average value of a column is shown by clicking this button.
<img src="/images/MinRE.png" alt="" width="32" height="35" />	The minimum value of a column is shown by clicking this button.
<img src="/images/MaxRE.png" alt="" width="36" height="35" />	The maximum value of a column is shown by clicking this button.

Query results

If the Query result tab is selected, all the selected data fields are shown in individual columns. Each row of the table represents a record.

Filter, group or sort the list of results

The list of results may be filtered, grouped and sorted by clicking the column headers as explained <a href="/index.php?title=Welcome_to_MedITEX_IVF#Managing_Lists">here</a>. The filtering corresponds to a logical restriction of the data set displayed in the list of results (e.g. only the pregnant patients of all, etc.).

Statistical analysis

The results of the query can be used to carry out statistical analysis.

There are essentially two ways to produce such analysis:

Mathematical functions

You can apply basic mathematical functions such as sum, average, minimum and maximum to a column or generate a chart.

If <img src="/images/Sum.png" alt="" /> is clicked, the sum of the values in the column where the selected cell is (number 8, circled in red) will be displayed at the bottom of the column.

If <img src="/images/Average.png" alt="" width="58" height="35" /> is clicked, the average value in the column where the selected cell is, will be displayed at the bottom of the column.

If <img src="/images/MinRE.png" alt="" width="32" height="35" /> or <img src="/images/MaxRE.png" alt="" width="36" height="35" /> is clicked, the minimum value (in our example 0) or the maximum value (in our example 9) will be displayed at the bottom of the column.

Generating a chart

If the Statistics button is clicked, the following window will be opened:

For the x-axis of your statistics you can use all columns of the list of results.

For the y-axis you can only use columns whose associated field from the data base contains numerical values only (integers, floating-point numbers).

These are only descriptive statistics: histograms, plots and their individual parts.

The interpretation of the y-axis values exclusively depends on the scale measurement of the data used (the data is, however, displayed in such a way as if the values were all interval-scaled).

Explanation of the fields/icons:
Curve, Bars... Pareto	These are different layouts that can be chosen for the chart.
<img style="display: block; margin-left: auto; margin-right: auto;" src="/images/2D3D.png" alt="" width="59" height="28" />	By clicking on these buttons, the chart will have a 2D/3D layout.
<img src="/images/0,00.png" alt="" />	This button sets the decimal places.
<img src="/images/BE.png" alt="" width="43" height="27" />	Displays basis unit or unit.
<img src="/images/Colours.png" alt="" width="59" height="25" />	Changes background colours of the graph and of the form. A third option allows the swapping the colours between the graph and the form.
<img style="display: block; margin-left: auto; margin-right: auto;" src="/images/Legend.png" alt="" width="57" height="25" />	Click on this button to show/hide the legend.
<img style="display: block; margin-left: auto; margin-right: auto;" src="/images/Toolbar.png" alt="" width="59" height="27" />	Click on this button to show/hide the toolbar.
<img style="display: block; margin-left: auto; margin-right: auto;" src="/images/PlusChart.png" alt="" width="54" height="29" />	Creates a new chart. It will be opened at the right side of the window. Close it with the red X button.
Parameter	Changes the Parameters shown in the chart.
Time period	Sets a period.
<img src="/images/Ed.png" alt="" />	Click on this button to edit the chart title.
<img src="/images/ed1.png" alt="" width="24" height="22" />	Click on this button to edit the font and colour of titles and legend.
<img src="/images/ed2.png" alt="" width="24" height="22" />	Click on this icon to hide/show pattern bar, palette bar and legend. By clicking on this button it is also possible to access to the data editor.
<img src="/images/ed3.png" alt="" width="24" height="22" />	Click on this button to modify the view options.
<img style="display: block; margin-left: auto; margin-right: auto;" src="/images/Graph.png" alt="" width="85" height="26" />	By clicking this button the user can: choose to print the chart; send the data or the chart to the clipboard; export the chart as .chf, .xls or .csv file; import the chart from .chf files; exchange chart type.

If your system does not give support to the necessary library, a much simpler version of this tool will be presented.

It is also possible to switch between modes clicking on the button Graph and choosing Exchange chart type.

Word module

By selecting the word module tab a simple list will be shown.

Explanation of columns

Placeholder	This column displays the placeholders present in the query. Each placeholder has been generated by the selection of one field during the query building. A placeholder can be duplicated just double clicking on it. If the same field is needed more than once in the letter, just duplicate the placeholder. The new placeholder will be filled with the same value of the parent placeholder.
Utilize	Here the user can choose if the value related to a placeholder will be shown in the letter. To change the status from Yes to No just double-click on the corresponding cell.
Bookmark	This column displays the names of the bookmarks present in the Word file related to the query. To edit the name of the bookmark just double-click it.
Value	This column displays the results related to a given placeholder for the selected record.
<img style="display: block; margin-left: auto; margin-right: auto;" src="/images/REButtons.png" alt="" />	With these buttons, it is possible to swap back and forth from one record to another, changing the values of the results accordingly.
<img src="/images/AdPlace.png" alt="" />	Using additional placeholders: In addition to the placeholders selected while building the query, new placeholders can be used. The additional placeholders allow the user to add to the letter: ultrasound and embryo images, user signatures, date and time specifications. To add a placeholder press this button. When a placeholder is selected it will appear in the list along with its bookmark and it can be used in the letter just like other placeholders.

Creating a letter

When the query is saved for the first time, a Word file is created in the folder WOMOD. This folder is in File_Storage\Templates. The complete path can be seen in the <a href="/index.php?title=MedITEX_IVF_Settings#General">settings</a>.

<img style="display: block; margin-left: auto; margin-right: auto;" src="/images/CreateCust.png" alt="" />	When this button is clicked the standard WOMOD template opens. The template will contains all the bookmarks listed in the Bookmarks column with the related placeholder.
If a model of the letter is available as a MS Word document, it is possible to save such model as a template before building the query. The template must be saved in the WOMOD folder and shall have the same name that the query will have.

To create a letter:

1. Write down the standard text.


2. Cut and paste placeholders in the appropriate position. Once a placeholder is allocated, it can be deleted from the list at the bottom of the page.

3. Once all placeholders are positioned and deleted at the bottom list, the letter can be saved.

<img src="/images/ed4.png" alt="" width="147" height="102" />	Saved letters may be edited by clicking Edit template.
<img src="/images/ed5.png" alt="" />	To view and print the letter related to the selected record, press Generate letter. A letter with all filled placeholders will open:

Using letters as standard templates

Once a letter is created, you may want to set it as a standard template.

What matters here is the combination of the group elements for your query.

If your query contains a reference to:

A therapy

A OI-IUI

A medical history

A lab results

A semen analysis

A patient's data

A referring doctors

you can use the document as a cycle letter;
you can use the document as an insemination letter;
you can use the document as a medical history letter;
you can use the document as a lab letter;
you can use the document as a semen analysis letter;
you can use the document as a administration letter;
you can use the document as a letter for referring doctors.

Press the black arrow on the right of the button Utilize as, select Letter templates and assign the document to one of the available entries.

For our example, only two options will be available:

In the main window of MedITEX IVF you can now click the menu-item Letters and see (depending on the currently opened input mask) exactly those queries whose letter templates you have linked (assume we have chosen for our query Cycle letter, the letter will be available in the cycle input mask).

A click on the desired entry in the menu leads to the execution of the query for the current patient or the current therapy only.

A Word document is then generated from the associated letter template. The word document will automatically be copied in the file storage folder related to the patient and the document entry in the patient demographics mask will also be generated. The type of the document generated in the demographics will be the one assigned as described <a href="/index.php?title=Result_management#Administrate_letters">here</a>.

Printing letters

In order to print the created letters from MedITEX IVF, you must be in the appropriate window. For example, if you wish to print a Medical history letter, you must first select the desired patient, then click on Medical history and finally, generate the letter from the top menu Letter.

<a href="/index.php?title=How_to_print_letters%3F">Click here</a> to read more about printing letters.

Rich text module

The Rich text module tool allows the easy creation of letters and documents. A document is composed of three units: header, text area and footer.

The header, for example, you can add a logo, individual text and the date.
In the text area you can add individual text which ideally contains placeholders (text contained between two %%; eg %Persons.First name%) of the result table. As you can see in the print preview, these placeholders will be replaced by the values of the result table. Placeholders can be duplicated selecting them from the drop box Placeholders and clicking on <img src="/images/RichB.png" alt="" />. Moreover, additional placeholders can be used.
The footer may contain a greeting, address or a name.

Standard formatting (font size, text alignment, color etc.) can be applied in all three areas.

Header and footer can be saved and imported later for other documents.

<img src="/images/OpenTemp.png" alt="" width="143" height="21" />	To import header and footer from another document, select the document to import from and press Open template.

Administrate letters

<img style="display: block; margin-left: auto; margin-right: auto;" src="/images/AdministrateLSettings.png" alt="" width="190" height="31" />	<a href="/index.php?title=Result_management#Administrate_letters"><img style="display: block; margin-left: auto; margin-right: auto;" src="/images/AdministrateLetters.png" alt="" width="109" height="35" /></a>
You can find this button in the <a href="/index.php?title=MedITEX_IVF_Settings#Report_editor">settings</a>.	You can find this button in the result management of the <a href="/index.php?title=Result_management#Buttons">report editor</a>.
If one of these buttons are clicked the following window opens:

<a href="/index.php?title=Configure_letters">Click here</a> to have more information about the content of this window.

The list on the left shows the letters which have been set to be available in one of the MedITEX sections. If the user selects the type of document in the Document type drop menu, the letter will be saved in the demographic section among the documents of the same type.

Other types of documents may be created clicking on Plus.

Once a type of document is created it will be available in the New entry menu present in the Demographics section.

With the button Edit, the document type can be edited.

A letter can be removed from the MedITEX section it was assigned to by selecting it and clicking on Delete.

Enabling memory query.

The box under Show placeholder / Show SQL-Query is useful for support purposes.

<a href="/index.php?title=MedITEX_IVF_manual">Back to the MedITEX IVF menu </a>

<a href="/index.php?title=Configure_letters"><img src="/images/help.png" border="1" alt="" width="48" height="48" align="BOTTOM" /> </a><a href="/index.php?title=Configure_letters">Click here</a> to have more information about the content of this window.

@@ Line 261: / Line 261: @@
 <p><strong>Using additional placeholders</strong>:</p>
 <p>In addition to the placeholders selected while <strong>building the query</strong>, new placeholders can be used. The <strong>additional placeholders</strong> allow the user to <strong>add to the letter: ultrasound </strong>and <strong>embryo images</strong>, <strong>user signatures</strong>, <strong>date </strong>and <strong>time specifications</strong>.</p>
-<p>To <strong>add a placeholder</strong> just press this button. When a <strong>placeholder </strong>is <strong>selected </strong>it will appear in the list along with its <strong>bookmark </strong>and it can be used in the letter just like other placeholders.</p>
+<p>To <strong>add a placeholder</strong> press this button. When a <strong>placeholder </strong>is <strong>selected </strong>it will appear in the list along with its <strong>bookmark </strong>and it can be used in the letter just like other placeholders.</p>
 </td>
 </tr>
@@ Line 400: / Line 400: @@
 <p>A click on the desired entry in the menu leads to the execution of the query for the <strong>current patient</strong> or the <strong>current therapy </strong>only.</p>
 <p>A <strong>Word</strong> document is then generated from the  associated letter template. The word document will automatically be  copied in the file storage folder related to the patient and the  document entry in the patient demographics mask will also be generated.  The type of the document generated in the demographics will be the one  assigned as described <a href="/index.php?title=Result_management#Administrate_letters">here</a>.</p>
+<p>&nbsp;</p>
+<h3>Printing letters</h3>
+<p>In order to print the created letters from <strong>MedITEX IVF</strong>, you must be in the appropriate window. For example, if you wish to print a <strong>Medical history</strong> letter, you must first select the desired patient, then click on <strong>Medical history</strong> and finally, generate the letter from the top menu <strong>Letter</strong>.</p>
+<p>&nbsp;</p>
+<table style="margin-left: auto; margin-right: auto;" border="0">
+<tbody>
+<tr>
+<td><a href="/index.php?title=How_to_print_letters%3F"><img style="display: block; margin-left: auto; margin-right: auto;" src="/images/plus48.png" alt="" width="48" height="48" /></a></td>
+<td><a href="/index.php?title=How_to_print_letters%3F">Click here</a> to read more about printing letters.</td>
+</tr>
+</tbody>
+</table>
+<p>&nbsp;</p>
 <p>&nbsp;</p>
 <h2>Rich text module</h2>