Difference between revisions of "LBV Forms"

From OpenEMR Project Wiki
 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
'''Layout-Based Visit Forms and what how to make use of this feature.'''
'''Layout-Based Visit Forms and how to make use of this feature.'''


<span style="color:red;">'''(Note that this feature will be available in the 3.2.0 version of OpenEMR that is planned to be released in February of 2010)'''</span>
This OpenEMR EXTRA was created to be used for personal forms. Extra Forms you missed but still want to have and were not found implemented in OpenEMR.'''


----
'''''With a little perseverance and this hand-out we go step by step, through the process of creation.'''''
First create an ADEQUATE DESCRIPTIVE FORM NAME:
Go to Administration => Lists and in "Edit List:" choose=> Layout-Based Visit forms. Create your Form ID (left side of the table) does not accept special characters or spaces. Right side gives you the opportunity to give a real understandable name. Your created name will be shown in "This Encounter" right panel menu view.
'''Quick Guide: How to make use of these Forms'''
Want to include e.a:
How often, How severe, Any bodily harm encountered, Please give short description, What medication used, When is next visit planned,
What provider has your preference, What Pharmacy did provide medication, Skipped some daily advised medications, Reason for skipping the necessary dose, What did observers tell you happened
Put Fields in correct order or leave this for later, you can always change the sort order through Administration => Layouts "put them in right order" => SAVE


This OpenEMR EXTRA was created to be used to make personal forms. Extra Forms you missed but still want to have and were not found implemented in OpenEMR.'''


----
----


'''''So let’s go ahead and start making a New Form'''''
'''Step by step approach: Create the form Epileptic Attacks'''
 
'''Goto:''' Administration => Lists => Create, on first row ID: "Epileptic_Att" (left side of table) give it the name: "Epileptic Attacks" (right side of table) => Save.
 
 
You see the Form was saved as LBFEpileptic_Att in left column and Epileptic Attacks in Layout-Based Visit Forms, via Layouts you find the form back under Epileptic Attacks.
 
 
'''Next goto:''' Administration => Layouts => Edit Layout: Epileptic Attacks and create a group “Epilesia Intake”  and start filling the new Field names with their respective input fields. Give the Label(?) a descriptive name. Let's use “How many attacks”. Add the right options for Label Cols and Data Cols.
 
Save the GROUP NAME and FIRST FIELD by Save Changes just below the GROUP input line. '''NOT the one below add extra fields!'''  




'''First of all decide what do you want to register:'''
----


1….Uhhmmm I don’t know
'''The different options in the rows might be a bit confusing, but with the next information you can make a choice of what to use and where:'''


2. ….. I have no idea, everything is already implemented in other OpenEMR-Forms
(Or go to Demographics page and see how most of the Labels- and Fields- options are used)


3. ….. This is beyond my developing skills


'''Order:''' The sort order in which the field appears within its group.


'''''No, no , no. YOU can do it. With a little perseverance and this manual we go step by step, hand in hand through the process of creation.'''''
'''ID:''' The field's internal identifier, used both in the database and in  
the form.


First make an ADEQUATE FORM NAME: You go to Administration => Lists and in "Edit List:" choose=> Layout-Based Visit forms. Create your Form ID (left side of the table) does not accept special characters or spaces. Right side gives you the opportunity to give a real understandable name. This is the name that will be shown in "This Encounter" right panel menu.  
'''Label:''' The label of the field in the form.


'''UOR:''' Indicates if the field is Unused, Optional or Required.


'''You have this great idea, YOU want a specialist Form for Epileptic attacks'''
'''Data Type:''' The type of field.


Want to include e.a:
'''Size:''' The meaning of this depends on the field type.  For data type 2,
22, 23 and 25 (text fields) it is the field's width ("size") in the
form.  Similarly for type 3 (textarea) it is the "cols" value.  For 21
and 27 (checkboxes, radio buttons) it is the number of sub-columns that
they are arranged into.  For other field types, size is unused.


How often, How severe, Any bodily harm encountered, Please give short description, What medication used, When is next visit planned,
'''List:''' The ID of the associated list, if applicable.
What provider has your preference, What Pharmacy did provide medication, Skipped some daily advised medications, Reason for skipping the necessary dose, Will you stick to the advised dose in future Y/N, Please explain, Was this encounter billed, What did observers tell you happened (Please choose from options)


'''Label Cols:''' The number of table columns in the form dedicated to the
field's label.  Usually this is 1, but might be 0 to indicate that the
label (if any) is to appear in the previous column.  Note the labels and
data are currently arranged into a total of 4 columns.


Now take some time to put you fields in the right order or leave this for later. You can always change the sort order later through Administration => Layouts "put them in right order" => Save
'''Data Cols:''' Similar to Label Cols, but for the field's input area.
Usually 1 or 3, sometimes 0.


'''Default Value:''' A value that may be assigned when the field is left
empty.


'''Now let’s create the Form Epileptic attacks'''
'''Description:''' This is assigned to the field's "title" attribute in the
form.


Administration => Lists => Create, on first row ID: "Epileptic_Ins" (left side of table) give it the name: "Epileptic Interventions" (right side of table) => Save. You see the Form was saved as LBFEpileptic_Ins in left column and Epileptic Interventions in Layout-Based Visit Forms, via Layouts you find the form back under Epileptic Interventions.


Now go to Administration => Layouts => Edit Layout: Epileptic Interventions and create a group “Epilesia Intake”  and start filling the new Field names with their respective input fields. Give the Label(?) a descriptive name. Let's use “How many attacks”. Add the right options for Label Cols and Data Cols.
----


Save the GROUP NAME and FIRST FIELD by Save Changes just below the GROUP input line. '''NOT the one below add extra fields!'''




Line 50: Line 88:




After you made all fields Save the Changes below once more with the button SAVE CHANGES.
After you made all fields SAVE the Changes below all Fields once more with the button SAVE CHANGES.


Go to your Client and during an encounter, new or old one, choose the "Epileptic Interventions" Form and start filling particulars as stipulated in your New created Layout-Based Visit Form.
Go to your Client and during an encounter, new or old one, choose the "Epileptic Interventions" Form and start filling particulars as stipulated in your New created Layout-Based Visit Form.
Line 60: Line 98:
Make the necessary fields with the input options and save every field after creation. Just on the line under added field. Than save the form and next time you open Epileptic Interventions Form you have the option to click additional info on the Epileptic Information Form.
Make the necessary fields with the input options and save every field after creation. Just on the line under added field. Than save the form and next time you open Epileptic Interventions Form you have the option to click additional info on the Epileptic Information Form.


Hope this little information helps you to get started with "Layout-Based Visit Forms" and get your information arranged in a way you always wanted to gather your information.  
This information helps to get started with "Layout-Based Visit Forms" and get your information arranged in a way you always wanted to gather your information. It's not fool proof, but with trial and error you can make use of your own forms.  


The Results of the gathered information can be found back in patient/client => Visits => List.
The results of your input in these Forms can be found back in patient/client => Visits => List.




N.B: Don’t forget to make Back-Up ’s, '''YES MAKE BACK-UP’S !!!''' , since what you created is not going to be saved for future new versions in OpenEMR. This self made materials most probably will be lost during reinstall processes. Make use of the Linux, Web and Windows based Back-Up possibilities as offered by OpenEMR.
<span style="color:red;">'''N.B: Don’t forget to make Back-Up ’s, '''YES MAKE BACK-UP’S !!!''' , since what you created is not going to be saved for future new versions in OpenEMR. All self made materials will be lost during reinstall of any official OpenEMR version from scratch. Make use of the Linux, Web and Windows based Back-Up possibilities as offered in OpenEMR. (Administration => Backup => CONTINUE)</span>

Revision as of 06:54, 17 February 2010

Layout-Based Visit Forms and how to make use of this feature.

This OpenEMR EXTRA was created to be used for personal forms. Extra Forms you missed but still want to have and were not found implemented in OpenEMR.


With a little perseverance and this hand-out we go step by step, through the process of creation.

First create an ADEQUATE DESCRIPTIVE FORM NAME:

Go to Administration => Lists and in "Edit List:" choose=> Layout-Based Visit forms. Create your Form ID (left side of the table) does not accept special characters or spaces. Right side gives you the opportunity to give a real understandable name. Your created name will be shown in "This Encounter" right panel menu view.


Quick Guide: How to make use of these Forms

Want to include e.a:

How often, How severe, Any bodily harm encountered, Please give short description, What medication used, When is next visit planned, What provider has your preference, What Pharmacy did provide medication, Skipped some daily advised medications, Reason for skipping the necessary dose, What did observers tell you happened


Put Fields in correct order or leave this for later, you can always change the sort order through Administration => Layouts "put them in right order" => SAVE



Step by step approach: Create the form Epileptic Attacks

Goto: Administration => Lists => Create, on first row ID: "Epileptic_Att" (left side of table) give it the name: "Epileptic Attacks" (right side of table) => Save.


You see the Form was saved as LBFEpileptic_Att in left column and Epileptic Attacks in Layout-Based Visit Forms, via Layouts you find the form back under Epileptic Attacks.


Next goto: Administration => Layouts => Edit Layout: Epileptic Attacks and create a group “Epilesia Intake” and start filling the new Field names with their respective input fields. Give the Label(?) a descriptive name. Let's use “How many attacks”. Add the right options for Label Cols and Data Cols.

Save the GROUP NAME and FIRST FIELD by Save Changes just below the GROUP input line. NOT the one below add extra fields!



The different options in the rows might be a bit confusing, but with the next information you can make a choice of what to use and where:

(Or go to Demographics page and see how most of the Labels- and Fields- options are used)


Order: The sort order in which the field appears within its group.

ID: The field's internal identifier, used both in the database and in the form.

Label: The label of the field in the form.

UOR: Indicates if the field is Unused, Optional or Required.

Data Type: The type of field.

Size: The meaning of this depends on the field type. For data type 2, 22, 23 and 25 (text fields) it is the field's width ("size") in the form. Similarly for type 3 (textarea) it is the "cols" value. For 21 and 27 (checkboxes, radio buttons) it is the number of sub-columns that they are arranged into. For other field types, size is unused.

List: The ID of the associated list, if applicable.

Label Cols: The number of table columns in the form dedicated to the field's label. Usually this is 1, but might be 0 to indicate that the label (if any) is to appear in the previous column. Note the labels and data are currently arranged into a total of 4 columns.

Data Cols: Similar to Label Cols, but for the field's input area. Usually 1 or 3, sometimes 0.

Default Value: A value that may be assigned when the field is left empty.

Description: This is assigned to the field's "title" attribute in the form.




Continue to ADD relevant Fields. Every ID(?) should be unique for this FORM. Make the Fields appear in order of your choice with the field ORDER.

Save every field just below the row of field particulars.


After you made all fields SAVE the Changes below all Fields once more with the button SAVE CHANGES.

Go to your Client and during an encounter, new or old one, choose the "Epileptic Interventions" Form and start filling particulars as stipulated in your New created Layout-Based Visit Form.

Or you can add another or second GROUP, so in case the patient comes back from a referred situation or you just want to add other particulars not needed in first encounter, this new group should have some extra information input that is only needed when the first part of the form gives rise to extra information input. Remember to give every field in the same FORM a different ID(?) any New Group in the same FORM must also have different ID(?) for every row of information.

The Third group should be created if the first group and Second group give rise to even more information specifics for this kind of client.

Make the necessary fields with the input options and save every field after creation. Just on the line under added field. Than save the form and next time you open Epileptic Interventions Form you have the option to click additional info on the Epileptic Information Form.

This information helps to get started with "Layout-Based Visit Forms" and get your information arranged in a way you always wanted to gather your information. It's not fool proof, but with trial and error you can make use of your own forms.

The results of your input in these Forms can be found back in patient/client => Visits => List.


N.B: Don’t forget to make Back-Up ’s, YES MAKE BACK-UP’S !!! , since what you created is not going to be saved for future new versions in OpenEMR. All self made materials will be lost during reinstall of any official OpenEMR version from scratch. Make use of the Linux, Web and Windows based Back-Up possibilities as offered in OpenEMR. (Administration => Backup => CONTINUE)