{"type":"doc","content":[{"type":"paragraph","content":[{"text":"Implementer shortcuts: ","type":"text"},{"text":"Getting Started","type":"text","marks":[{"type":"link","attrs":{"href":"https://openmrs.atlassian.net/wiki/spaces/docs/pages/25477699"}}]},{"text":" | ","type":"text"},{"text":"HTML Reference","type":"text","marks":[{"type":"link","attrs":{"href":"https://openmrs.atlassian.net/wiki/display/docs/HTML+Form+Entry+Module+Reference"}}]},{"text":" | ","type":"text"},{"text":"Javascript Reference","type":"text","marks":[{"type":"link","attrs":{"href":"https://openmrs.atlassian.net/wiki/spaces/docs/pages/25475282"}}]},{"text":" | ","type":"text"},{"text":"Release Notes","type":"text","marks":[{"type":"link","attrs":{"href":"https://openmrs.atlassian.net/wiki/spaces/docs/pages/25472313"}}]}]},{"type":"paragraph","content":[{"text":"Developer shortcuts: ","type":"text"},{"text":"Technical Overview","type":"text","marks":[{"type":"link","attrs":{"href":"https://openmrs.atlassian.net/wiki/spaces/docs/pages/25469511"}}]},{"text":" | ","type":"text"},{"text":"Collaborating on Html Form Entry Using Git","type":"text","marks":[{"type":"link","attrs":{"href":"https://openmrs.atlassian.net/wiki/spaces/Archives/pages/25521003"}}]}]},{"type":"paragraph","content":[{"text":"Other examples: ","type":"text"},{"text":"How to Embed HTML Form (generated by HTML Form Entry module) in a custom module","type":"text","marks":[{"type":"link","attrs":{"href":"https://openmrs.atlassian.net/wiki/spaces/Archives/pages/25521109"}}]}]},{"type":"paragraph","content":[{"text":"Related modules: ","type":"text"},{"text":"HTML Form Entry UI Module","type":"text","marks":[{"type":"link","attrs":{"href":"https://openmrs.atlassian.net/wiki/spaces/docs/pages/25473688"}}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Overview","type":"text"}]},{"type":"paragraph","content":[{"text":"The HTML Form Entry allows anyone with basic HTML programming skills and a knowledge of the OpenMRS system to create forms. It is an alternative to the Infopath FormEntry module in many (but not all) cases.","type":"text"}]},{"type":"paragraph","content":[{"text":"The key point about writing forms with this module is that you only have to write HTML (with some special tags for things in the OpenMRS model) and the module will automatically \"just know\" what to do when the user clicks the submit button.","type":"text"}]},{"type":"paragraph","content":[{"text":"Currently a form submission creates one encounter for one patient.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Requirements","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Versions in the 3.x line support OpenMRS 1.9+ and are maintenance only","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Versions from 4.x support OpenMRS 2.1+ and are the mainline for new development and longer-term support","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Comparison with Infopath FormEntry module","type":"text"}]},{"type":"paragraph","content":[{"text":"Advantages:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Forms are entered in-the-webapp. No need for installed software on the client.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"You can review a form after entering it and have it look \"just like you entered it\"","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Form submission immediately creates data (i.e. no waiting for queues to be processed.)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Disadvantages:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"No WYSIWYG editor (though one is in the works)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Support for scripted behavior is limited (and requires Javascript programming)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Want to help improve this module? Contact ","type":"text"},{"type":"mention","attrs":{"id":"712020:bb3e16ab-189e-4c78-a9ef-ccea9a604fee","text":"@Mark Goodrich"}},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Download","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Download the Htmlformentry module","type":"text","marks":[{"type":"link","attrs":{"href":"https://addons.openmrs.org/#/show/org.openmrs.module.htmlformentry"}}]}]}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Source code:","type":"text"},{"type":"hardBreak"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"View/download source code for htmlformentry","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/OpenMRS/openmrs-module-htmlformentry"}}]},{"text":" from github","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Instructions","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Download the module from the repository and install it.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to \"Manage HTML Forms\" under the ","type":"text"},{"text":"administration page","type":"text","marks":[{"type":"link","attrs":{"href":"https://demo.openmrs.org/openmrs/admin/index.htm"}}]},{"text":". (Make sure you are looking at the \"HTML Form Entry\" section, not the \"Forms\" section!)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create a new form there (click \"New HTML Form\").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Fill out the necessary information; including the Name, Description, Version, and select the Encounter Type from the list. (When an HTML form is submitted, it will create this type of encounter.)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Save the form. Then it will open the page for editing the HTML Form.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Customize the HTML form to your specifications. Recent versions of the HTML Form Entry Module include a basic form that can be customized. For additional documentation on the HTML tags that are available, see the ","type":"text"},{"text":"HTML Reference","type":"text","marks":[{"type":"link","attrs":{"href":"http://archive.openmrs.org/wiki/HTML_Form_Entry_Module_HTML_Reference"}}]},{"text":".","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Screenshots","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Creating new HTML Form","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"width":458,"id":"d7afc8f0-d996-42a5-b986-57393da94391","collection":"contentId-25475242","type":"file","height":261}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Adding a new or editing a form","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"width":750,"id":"2e517a4a-2130-4125-ad4a-08072b8c1a6e","collection":"contentId-25475242","type":"file","height":614}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Filling out a form","type":"text"}]},{"type":"paragraph","content":[{"text":"Note that if you put in an illegal value (per the constraints in the concept dictionary) it is immediately flagged.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"width":1039,"id":"7a694b4f-94ad-4aff-9dd6-919f3ec954e1","collection":"contentId-25475242","type":"file","height":515}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Viewing a form","type":"text"}]},{"type":"paragraph","content":[{"text":"This looks pretty close to the initial entry.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"width":1041,"id":"5102ce75-52fa-48ef-88a7-3577d071f11c","collection":"contentId-25475242","type":"file","height":400}}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Example HTML","type":"text"}]},{"type":"paragraph","content":[{"text":"Here's the code behind the screenshots","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n\n lightgrey=#e0e0e0\n lightblue=#e0e0ff\n\n...\n\n \n \n \n \n

\n \n \n \n \n \n \n \n

3. Anamnese

\n\t\t Symptomes:
\n
\n \n

\n\n Conditions socioeconomiques:\n

\n
\n
\n
\n \n

\n
\n
\n \n

\n\n\t\t
\n Examen Clinique:
\n\t\t\n\t\t\n\t\t

\n\t\t\t C
\n\t\t\t/min
\n\t\t\tkg
\n\t\t\tkg/m2
\n\t\t

\n\t\t\t/min
\n\t\t\t\n\t\t\t
\n\t\t\tcm\n\t\t

\n \n \n \n \n \n\t\t\n \n \n \n \n \n \n \n \n \n \n

4. Anamnese systematique et depistage TBC:

\n\t\t\t\n\t\t\t\t\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\t\t\t\t\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\t\t\t

\n\t\t\t\t\t\tToux:\n\t\t\t\t\t\t\n\t\t\t\t\t\t\n\t\t\t\t\t	\n\t\t\t\t\t\tduree:\n\t\t\t\t\t\tsemaines\n\t\t\t\t\t\tmois\n\t\t\t\t\t



Sueurs nocturnes	\n\t\t\t\t\t\t\n\t\t\t\t\t\t\n\t\t\t\t\t\t\n\t\t\t\t\t
Fievre	\n\t\t\t\t\t\t\n\t\t\t\t\t\t\n\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t \n\t\t\t\t\t\t\tduree:\n\t\t\t\t\t\t\tjours\n\t\t\t\t\t\t\tsemaines\n\t\t\t\t\t\t\tmois\n\t\t\t\t\t\t\n\t\t\t\t\t
Perte de poids	\n\t\t\t\t\t\t\n\t\t\t\t\t\t\n\t\t\t\t\t\t\n\t\t\t\t\t
Contact TBC+:

\n\t\t

\n\t\tResultat du depistage TBC \n\t\t

\n\t

5. La sante sexuelle

\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n

Sexuellement actif:
Dernieres regles
Planification familiale
Methode	\n\t\t\t\n\t\t\t \n\t\t\t\n\t\t\t \n\t\t\t\n\t\t\t\n\t\t
Enceinte	\n\t\t\t\n\t\t\t\n\t\t
Symptomes d'IST

\n...\n\n","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Global Properties","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"htmlformentry.dateFormat","type":"text","marks":[{"type":"em"}]},{"text":": (added in HFE 1.9) lets you specify a date format (as defined in ","type":"text"},{"text":"Java's SimpleDateFormat","type":"text","marks":[{"type":"link","attrs":{"href":"http://docs.oracle.com/javase/6/docs/api/java/text/SimpleDateFormat.html"}}]},{"text":") that will be used to display all dates in HTML Forms. This will hold for entering new forms, and viewing/editing existing ones. (For example set the global property to \"dd-MMM-yyyy\" for an unambiguous date format like 31-Jan-2012.)","type":"text"},{"type":"hardBreak"},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"htmlformentry.showDateFormat","type":"text","marks":[{"type":"em"}]},{"text":": (added in HFE 1.9) set to true if you want static text for the date format to be displayed, else set to false. This text is displayed next to the date widgets as something like (dd/mm/yyyy)","type":"text"},{"type":"hardBreak"},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"htmlformentry.timeFormat","type":"text","marks":[{"type":"em"}]},{"text":": (added in HFE 2.6) lets you specify a time format (as defined in ","type":"text"},{"text":"Java's SimpleDateFormat","type":"text","marks":[{"type":"link","attrs":{"href":"http://docs.oracle.com/javase/6/docs/api/java/text/SimpleDateFormat.html"}}]},{"text":") that will be used to display all times in HTML Forms. Default is 24-hour time (e.g. ","type":"text"},{"text":"18:41","type":"text","marks":[{"type":"em"}]},{"text":"). Setting this global property to \"h:mm a\" would change this to ","type":"text"},{"text":"6:41 PM","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Required Privileges","type":"text"}]},{"type":"paragraph","content":[{"text":"The following privileges may be necessary for various activities. It may be necessary to create them manually, and add them to your user's role.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[<=1.4] \"Patient Dashboard - View Html Forms Section\" <-- Required to view the HTML Forms tab on the patient dashboard","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[>=1.5] \"Form Entry\" <-- Required to enter forms generally","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"Add Encounters\" <-- Required to submit a form","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Upcoming features","type":"text"}]},{"type":"paragraph","content":[{"text":"To request more features, ask for them on developers@openmrs.org or create them as tickets in ","type":"text"},{"text":"our JIRA site","type":"text","marks":[{"type":"link","attrs":{"href":"http://tickets.openmrs.org/browse/HTML"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Flowsheets","type":"text"}]},{"type":"paragraph","content":[{"text":"Want to build an interface out of nothing but htmlforms? The HtmlFormFlowsheet module provides an easy way of combining html forms into a simple patient-dashboard-type configurable interface. Or, you can embed flowsheet tables directly into your existing htmlforms. This module is particularly useful if you are trying to model patient-based flowsheet type data (such as an MDRTB CAT-IV treatment card, or a chronic care flowsheet). See: ","type":"text"},{"text":"the htmlformflowsheet module wiki.","type":"text","marks":[{"type":"link","attrs":{"href":"http://openmrs.atlassian.net/wiki/display/docs/HtmlFormFlowsheet+Module"}}]}]},{"type":"extension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"children","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"bfdeecac-b769-43af-8e06-a8b386adb423"},"schemaVersion":{"value":"2"},"title":"Child pages (Children Display)"}}}},{"type":"paragraph","content":[{"type":"hardBreak"}]}],"version":1}

Browser not supported