Result management

From MedITEX - Wiki

(Difference between revisions)
Jump to: navigation, search
Line 435: Line 435:
 
<tr>
 
<tr>
 
<td style="text-align: left;">[[Image:AdminLetters.png|none|740px|thumb|left|link=http://wiki.meditex-software.com/images/AdminLetters.png| ]]</td>
 
<td style="text-align: left;">[[Image:AdminLetters.png|none|740px|thumb|left|link=http://wiki.meditex-software.com/images/AdminLetters.png| ]]</td>
 +
</tr>
 +
</tbody>
 +
</table>
 +
<p>&nbsp;</p>
 +
<table style="margin-left: auto; margin-right: auto;" border="0">
 +
<tbody>
 +
<tr>
 +
<td>
 +
<p><a href="/index.php?title=Configure_letters">Click here</a> to have nore information about the content in this window.</p>
 +
</td>
 
</tr>
 
</tr>
 
</tbody>
 
</tbody>
Line 445: Line 455:
 
<td><img style="display: block; margin-left: auto; margin-right: auto;" src="/images/AdEdDelRE.png" alt="" width="97" height="30" /></td>
 
<td><img style="display: block; margin-left: auto; margin-right: auto;" src="/images/AdEdDelRE.png" alt="" width="97" height="30" /></td>
 
<td>
 
<td>
−
<p>Other types of documents may be created clicking on the <strong>Plus </strong>button.</p>
+
<p>Other types of documents may be created clicking on <strong>Plus</strong>.</p>
 
<p>Once a type of document is created it will be available in the <strong>New entry</strong> menu present in the <strong>Demographics </strong>section.</p>
 
<p>Once a type of document is created it will be available in the <strong>New entry</strong> menu present in the <strong>Demographics </strong>section.</p>
 
<p>With the button <strong>Edit</strong>, the document type can be edited.</p>
 
<p>With the button <strong>Edit</strong>, the document type can be edited.</p>

Revision as of 13:44, 21 January 2013

<tbody> </tbody>
Result1.png

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

 

Contents

Buttons

Some buttons have special functionalities. Click on it to have more information.

<tbody> </tbody>
<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.

<tbody> </tbody>
Result1.png

 

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.

<tbody> </tbody>
<img src="/images/MathRE.png" alt="" />
  • 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

<tbody> </tbody>
<img src="/images/Statistics.png" alt="" width="60" height="38" /> If the Statistics button is clicked, the following window will be opened:
<tbody> </tbody>

Chart.png

 

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).

<tbody> </tbody>
Explanation of the fields/icons:
Line, 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 icons, the chart will change from a 2D and a 3D layout.
<img src="/images/0,00.png" alt="" />
 Clicking this icon will let you adjust the number of decimal places.
<img src="/images/Epsilon.png" alt="" width="23" height="23" />  <img src="/images/Durchschnitt.png" alt="" width="30" height="26" /> Switch between summary and average representation.
<img src="/images/Colours.png" alt="" width="59" height="25" />
 Here you can choose the background colours of the graph and the form. A third option allows the swapping of 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/X.png" alt="" width="28" height="24" /> Click on this icon to see the distribution of values on the x-axis.
<img src="/images/Y.png" alt="" width="28" height="24" /> Click on this icon to see the distribution of values on the y-axis.
<img src="/images/VXY.png" alt="" /> Click on this icon to see the distribution of values of the y-axis as a function of x-axis categories.
<img src="/images/Ed.png" alt="" /> Click on this icon to edit chart titles.
<img src="/images/ed1.png" alt="" width="24" height="22" /> Click on this icon to edit the font and colour of titles and legends.
<img src="/images/ed2.png" alt="" width="24" height="22" /> Click on this icon to show/hide pattern bar, palette bar and legend. By clicking on this icon, it is also possible to access the data editor. Drag and drop colours and patterns to change the chart.
<img src="/images/ed3.png" alt="" width="24" height="22" /> Click on this icon 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:

  • Print the chart;
  • Send the data or the chart to the clipboard;
  • Export the chart as a *.chf, *.xls or *.csv file;
  • Import a chart from *.chf file;
  • Exchange chart type.

 

Word module

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

<tbody> </tbody>
WM.png

 

Explanation of columns

<tbody> </tbody>
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 just 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>.

<tbody> </tbody>
<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:

<tbody> </tbody>
Letter1.png
1. Write down the standard text.

 

<tbody> </tbody>
Letter2.png
Letter3.png

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.

 

<tbody> </tbody>
Letter4.png
3. Once all placeholders are positioned and deleted at the bottom list, the letter can be saved.

 

<tbody> </tbody>
<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:
Letter5.png

 

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.

<tbody> </tbody>

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:

<tbody> </tbody>
<img src="/images/Letter6.png" alt="" />

 

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>.

 

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.

<tbody> </tbody>
Letter7.png
  • 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.

<tbody> </tbody>
<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.
OpenTemp1.png

 

Administrate letters

<tbody> </tbody>
<img style="display: block; margin-left: auto; margin-right: auto;" src="/images/AdministrateLSettings.png" alt="" width="190" height="31" /> <img style="display: block; margin-left: auto; margin-right: auto;" src="/images/AdministrateLetters.png" alt="" width="109" height="35" />

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:
<tbody> </tbody>
AdminLetters.png

 

<tbody> </tbody>

<a href="/index.php?title=Configure_letters">Click here</a> to have nore information about the content in 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.

<tbody> </tbody>
<img style="display: block; margin-left: auto; margin-right: auto;" src="/images/AdEdDelRE.png" alt="" width="97" height="30" />

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.
<img src="/images/Always.png" alt="" /> Enabling memory query.
The box under Show placeholder / Show SQL-Query is useful for support purposes.
<tbody> </tbody>
<a href="/index.php?title=MedITEX_IVF_manual">Back to the MedITEX IVF menu </a> <a href="#top">Back to top</a>