This is the basic information you need to create a simple form using the the Html _ Form _ Entry _ Module.[edit]
Getting Started
The htmlform tag
Your entire form must be wrapped in an htmlform tag<htmlform>
tag
| Code Block | ||||
|---|---|---|---|---|
| ||||
<htmlform> ...stuff goes here... |
...
</htmlform> |
...
|
Required elements
A form is required to ask for the datetime, location, and provider, and it must have a submit button. For a complete reference on these tags see Tag Reference Page<htmlform>
| Code Block | ||||
|---|---|---|---|---|
| ||||
<htmlform> Date: <encounterDate default="today"/> <br/> |
...
Location: <encounterLocation/> <br/> |
...
Provider: <encounterProvider role="Provider"/> <br/> |
...
...stuff goes here... |
...
<submit/> |
...
</htmlform> |
...
|
Section Tag
The <section> tag lets you break your form, and corresponding form schema, into sections. For a complete reference on this tag see Tag Reference Page
| Code Block | ||||
|---|---|---|---|---|
| ||||
<section headerLabel="section1"> |
...
... |
...
</section> |
...
<section headerLabel="section2"> |
...
... |
...
</section> |
[edit]
Obs Tag
The form wouldn't be much without being able to enter observations. For a complete reference on this tag see Tag Reference Page
| Code Block | ||||
|---|---|---|---|---|
| ||||
<obs conceptId="5089" labelText="Weight" /> |
...
<obs conceptId="5090" labelText="Height" /> |
[edit]
Velocity expressions
The lookup tag allows you to evaluate velocity expressions. For a complete reference on these tags see Tag Reference Page
| Code Block | ||||
|---|---|---|---|---|
| ||||
<lookup expression="patient.personName"/> to display the patient's name |
...
<lookup expression="patient.gender"/> to display the patient's gender |
...
<lookup expression="patient.age"/> to display the patient's age |
...
<lookup expression="patient.getPatientIdentifier(5)"/> to display the patient's identifier of the type with id=5 |
...
<lookup complexExpression="#foreach( $addr in $patient.addresses ) $\!addr.cityVillage <br/> #end"/> to display the city/village of each of the patient's addresses |
...
|
Putting it all together
A very basic form to enter height and weight observations could look like:<htmlform>
<section
| Code Block | ||||
|---|---|---|---|---|
| ||||
<htmlform> <section headerLabel="1. Encounter Details"> |
...
Date: <encounterDate default="today"/> <br/> |
...
Location: <encounterLocation/> <br/> |
...
Physician: <encounterProvider role="Provider"/> <br/> |
...
<br/> |
...
</section> |
...
<section headerLabel="2. Demographic Info"> |
...
<span>Nom du patient: <lookup expression="patient.personName"/></span> |
...
<span>No. Dossier: <lookup complexExpression="#foreach( $patId in $patientIdentifiers.get("PIH ID") ) $\!patId #end"/></span><br/> |
...
<span>Sexe: <lookup expression="patient.gender" codePrefix="gender_"/></span> |
...
<span>(a) Date de naissance: <lookup expression="patient.birthdate"/></span> |
...
<span>(b) Age: <lookup expression="patient.age"/></span> |
...
</section> |
...
<section headerLabel="3. Vital Signs"> |
...
<obs conceptId="5089" labelText="Weight" /> (kg) |
...
<obs conceptId="5090" labelText="Height" /> (cm) |
...
</section> |
...
<br/><br/> |
...
<submit/> |
...
</htmlform> |
[edit]
Additional Information
See HTML_Form_Entry_Module_HTML_Reference for complete documentation on the tags listed above, additional information on the <obs> tag and the related <obsGroup>, and details on more advanced features like macros, repeating templates, and enrolling patients in programs.
[edit]See the /wiki/spaces/RES/pages/26262844 page for more explanations and examples. Ellen Ball presented /wiki/spaces/RES/pages/26312479. The other training courses include sections on forms as well.
Tips for making new forms
...