{"type":"doc","content":[{"type":"extension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"_parentId":{"value":"25477743"}},"macroMetadata":{"schemaVersion":{"value":"1"},"title":"Table of Contents"}}}},{"type":"heading","attrs":{"level":1},"content":[{"text":"Introduction","type":"text"}]},{"type":"paragraph","content":[{"text":"The 'htmlformflowsheet' module is an OpenMRS module that allows you to generically model a paper flowsheet. The basis for the design of this module was originally the WHO Cat-IV treatment card for multi-drug resistant tuberculosis, which contains baseline information (filled out once), and then flowsheet-type information that is appended to the paper form over time (for items such as monthly regimen adherence, monthly smear and culture results, and regimen changes).","type":"text"}]},{"type":"paragraph","content":[{"text":"htmlformflowsheet custom tag for flowsheets","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"This module provides basic functionality for embedding small htmlforms inside of larger htmlforms, where the small htmlforms each represent one row in a patient chart. This functionality is provided by the 'htmlformflowsheet' custom htmlform tag (see ","type":"text"},{"text":"htmlformflowsheet: custom tag for htmlformentry","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"linkType":"self","anchorName":"htmlformflowsheet: custom tag for htmlformentry"},"href":"#HtmlFormFlowsheetModule-htmlformflowsheet:customtagforhtmlformentry"}}]},{"text":" section).","type":"text"}]},{"type":"paragraph","content":[{"text":"tabbed interface for flowsheets","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Additionally, the module allows you to specify any number of tabs in a tab-based layout, each containing a distinct html form. You can then designate whether or not the html form should be used once (as in baseline demographics), or as a flowsheet (where a new row will be added for every month, as in monthly adherence, for example). Forms that are one-time forms (like baseline demographics and medical history forms) can be as complex as is necessary, and working with these is almost identical to dealing with a stand-alone htmlform externally -- it just all happens within a tab.","type":"text"}]},{"type":"paragraph","content":[{"text":"Htmlforms that are meant to be flowsheets should represent exactly one row in a table on the paper form. A 'flowsheet' type tab will display the longitudinal history of the entry of this form, and allow you to append new entries, and edit/delete existing entries. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Any form entry of either type can be viewed and edited later, and this has been optimized for performance such that only that tab will be reloaded after a new entry or edit is made.","type":"text"}]},{"type":"paragraph","content":[{"text":"(Note: this module was previously called the 'mdrtbpatientchartwidgets' module. The previous 'mdrtbpatientchartwidgets' module will receive no further development. All further development will happen here.)","type":"text"}]},{"type":"paragraph","content":[{"text":"Status","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"1.2.2:","type":"text","marks":[{"type":"strong"}]},{"text":" This version adds the role-based-homepage portlet. I hope that this will be a fairly short-lived version, because i want to add a configuration data model, and give the option of including portlets in tabs. I will continue to support this feature, but the setup is going to change. Here's how it currently works:","type":"text"}]},{"type":"paragraph","content":[{"text":"Using the \"URL-based Interface\" syntax describe below, you first need to configure the ","type":"text"},{"text":"setting","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Settings Descriptions"},"href":"https://openmrs.atlassian.net/wiki/spaces/Archives/pages/25464642"}}]},{"text":" named ","type":"text"},{"text":"htmlformflowsheet.programConfigurationMap","type":"text","marks":[{"type":"strong"}]},{"text":" which maps program Ids to configuration strings. Here's an example value:","type":"text"}]},{"type":"paragraph","content":[{"text":"This maps two programs to configurations, programs 5 and 6.","type":"text"}]},{"type":"paragraph","content":[{"text":"{5:\"configuration=S:DEMOGRAPHICS:22:LAST|S:ASTHMA%20INTAKE:38:LAST|F:VISITS:18|F:RENDEZ-VOUS:21|F:MEDICATIONS:26|F:HOSPITALIZATION:17|F:DIAGNOSTICS:20|F:NON%20MEDICAL:23|F:OTHER%20INTERVENTIONS:24|F:SOCIAL%20ASSISTANCE:19&title=ASTHMA%20PROGRAM&showAllEncsWithEncType=true\", 6:\"configuration=S:DEMOGRAPHICS:33:LAST|S:DIABETES%20INTAKE:37:LAST|F:VISITS:27|F:RENDEZ-VOUS:28|F:INSULIN:31|F:MEDICATIONS:34|F:HOSPITALIZATION:36|F:DIAGNOSTICS:35|F:SOCIAL%20ASSISTANCE:30|F:NON%20MEDICAL:29&title=DIABETES%20PROGRAM&showAllEncsWithEncType=true\"}","type":"text"}]},{"type":"paragraph","content":[{"text":"Next, in your role-based homepage for a given role, you just need to include a new portlet that is included in htmlformflowsheet. Here's an example role-based homepage:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n\n\n

Non Communicable Disease (NCD) Homepage

\n\n\n\n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"Notice that the portlet tag includes program Ids 5 and 6, which correspond to the global property described above. For the create patient widget created by the portlet, you must also specify an htmlform that creates a patient, which in this example is form Id 16. Here's a sample htmlform for creating a patient that was created by Berchmas, at PIH/IMB Rwanda:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n\t\n headerColor =#009d8e\n\t\tfontOnHeaderColor = white\n\t\n\n\t\n\t

Create Patient (version 0.1)

\n
\n\n

Name\n\n

\n
\n

Id Number(s) \n \n

\n
\n\n

Demographics\nGender: \n

\n
\nHealth Center: \n\n
\n
\n \n

\n\n\n","type":"text"}]},{"type":"paragraph","content":[{"text":"1.2:","type":"text","marks":[{"type":"strong"}]},{"text":" I have recently updated the version of htmlformflowsheet in the module repository to version 1.2. This version was tested against openmrs1.6.4.x and htmlformentry version 1.7.4. I have not tested against openmrs1.7 or higher, although i'd be grateful for someone to try this and let me know how it goes. Additionally, we only use the htmlformflowsheet tag in production, so i have less of an incentive to keep up with the tabbed interface side of the module (although i tested this when adding version 1.2 to the repository). If someone wants to help me push this functionality forward, that would be a great help. Version 1.2 also includes full support for the htmlformentry drugOrder tag. Using htmlformflowsheet + htmlforms with the drugOrder tag allows you to create a regimen management UI within an htmlform that won't duplicate drug orders. For a better explanation of how the drugOrder tag, see the ","type":"text"},{"text":"HtmlForms Reference wiki page","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"spaceKey":"docs","isRenamedTitle":true,"linkType":"page","contentTitle":"HTML Form Entry Module HTML Reference","anchorName":""},"href":"https://openmrs.atlassian.net/wiki/pages/createpage.action?spaceKey=docs&title=HTML%20Form%20Entry%20Module%20HTML%20Reference"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"TODO: regimen management screenshot","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"htmlformflowsheet: custom tag for htmlformentry","type":"text"}]},{"type":"paragraph","content":[{"text":"The HtmlFormFlowsheet Module now allows you to embed its flowsheet widget into an html form. This means that you can embed multiple htmlforms inside of other htmlforms as flowsheets. Another way to think of this functionality is that the 'flowsheet' view in this module can be embedded in a parent htmlform as a widget.","type":"text"}]},{"type":"paragraph","content":[{"text":"To do this, all you have to do is upload HtmlFormFlowsheet version 1.1 (or higher), and then in your htmlform xml, you can now use the tag:","type":"text"}]},{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"In this example, formId corresponds to Form 39, not html_form_id = 39. 'formId' is the only attribute that this tag takes. Here, form #39 will be rendered as a flowsheet in the parent htmlform. As long as the htmlformflowsheet module is installed on your system, the htmlformflowsheet tag will always be a valid tag within htmlforms.","type":"text"}]},{"type":"table","attrs":{"__autoSize":true},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Example of HTML form with three embedded flowsheets","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Screenshot","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"codeBlock","content":[{"text":"...\n

\n\t\n

\n...\n","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"mediaSingle","attrs":{"layout":"align-start","width":1071,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":128368,"__fileMimeType":"image/jpeg","width":1071,"id":"029ab13b-92ac-4d9c-95f0-7c7231296dce","collection":"contentId-25477743","type":"file","__fileName":"flowsheet_screenshot2.jpg","height":462}}]}]}]}]},{"type":"paragraph","content":[{"text":"By default, the \"Add another\" button in the flowsheet table will appear at the top of the table, with default text. You can set the location of this to be the bottom of the table, using the global property value:","type":"text"}]},{"type":"paragraph","content":[{"text":"htmlformflowsheet.addAnotherButtonPosition","type":"text","marks":[{"type":"strong"}]},{"text":": bottom","type":"text"}]},{"type":"paragraph","content":[{"text":"You can customize the label for this button within the htmlformflowsheet tag, as described below.","type":"text"}]},{"type":"paragraph","content":[{"text":"Also by default, the flowsheet table will list encounters in chronological order, most recent at the top, oldest at the bottom. You can reverse this order by configuring the global property:","type":"text"}]},{"type":"paragraph","content":[{"text":"htmlformflowsheet.encountersChronology","type":"text","marks":[{"type":"strong"}]},{"text":": asc","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Shared Encounter","type":"text"}]},{"type":"paragraph","content":[{"text":"The HtmlFormFlowsheet Module can now be used to have its htmlformflowsheet widgets either create a new encounter per flowsheet when a new new row is added (available in 1.1), OR, you can choose an existing encounter of the same encounter type to append Obs to. This allows you to use multiple flowsheet widgets to 'build' a month's rendez-vous encounter.","type":"text"}]},{"type":"paragraph","content":[{"text":"For this to work, all you need to do is add the attribute sharedEncounter=\"true\" to the htmlformflowsheet tag, like this:","type":"text"}]},{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"When the sharedEncounter attribute is set to true, users will be prompted to choose from a list of existing encounters. The Obs will be then appended to the chosen encounter.","type":"text"}]},{"type":"paragraph","content":[{"text":"The only additional piece of setup that you need for this to work is that you need to make sure that all of the htmlforms that are going to be used in your patient chart to represent a row in an htmlformflowsheet widget are of the *","type":"text"},{"text":"same encounter type","type":"text","marks":[{"type":"strong"}]},{"text":"*. And, you need htmlformentry module version 1.6.6 or greater.","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"inline-media-image","parameters":{"width":"","id":"07ff58a8-3f9d-4496-a130-65b7a3df81c5","collection":"contentId-25477743","height":""}}},{"text":" ","type":"text"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"inline-media-image","parameters":{"width":"","id":"2d5ffdcd-f429-4f98-9096-96dd6e1c5d29","collection":"contentId-25477743","height":""}}}]},{"type":"paragraph","content":[{"text":"Version 1.1.7","type":"text","marks":[{"type":"strong"}]},{"text":": ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"you may enter a form ","type":"text"},{"text":"uuid","type":"text","marks":[{"type":"strong"}]},{"text":" instead of the formId number as the argument value for the 'formId' attribute.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"to change the value of the 'Add New' button, you may use the attribute addAnotherButtonLabel, so for example, this is a valid use of the tag: ","type":"text"},{"text":"","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"there's a new global property called htmlformflowsheet.PatientChartFormIds that allows you to put links to patient charts in a patient header An example value for this global property is ","type":"text"},{"text":"39:2|3|4,43:2,44 . ","type":"text","marks":[{"type":"strong"}]},{"text":" What this means is that the link to the patient chart with formId 39 should only be visible for patients who have enrolled in programs 2,3,4. Likewise, the link to the patient chart with formId 43 should only be visible for patient in program 2. Finally, the link for formId 44 is visible for all patients.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"if you would like to resize the pop-up window when editing or creating flowsheet rows, you may use the attribute windowHeight. So, for example, this is a valid use of the tag ","type":"text"},{"text":"","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"paragraph","content":[{"text":"Version 1.1.9","type":"text","marks":[{"type":"strong"},{"type":"textColor","attrs":{"color":"#333333"}}]},{"text":": ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"with the attribute ","type":"text"},{"text":"showHtmlForm=\"true\"","type":"text","marks":[{"type":"strong"}]},{"text":", you can instruct the htmlformflowsheet tag renderer to render the specified htmlform in the format described by the htmlform itself, rather than the htmlformflowsheet rendering of the htmlform contents.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"with the attribute ","type":"text"},{"text":"readOnly=\"true\"","type":"text","marks":[{"type":"strong"}]},{"text":", you can instruct the htmlformflowsheet tag renderer to render the form as usual, but to not give any options to manipulate the rows in the table.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Attributes","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"formID","type":"text","marks":[{"type":"strong"}]},{"text":": Form ID of the flowsheet. Note this is NOT the html_form_id.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"REQUIRED","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Example: ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Value: Form ID integer, or in 1.1.7 and beyond it could be the form's uuid.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Default: None","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"addAnotherButtonLabel","type":"text","marks":[{"type":"strong"}]},{"text":": Edit the text on the \"Add New\" button.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"OPTIONAL/REQUIRED","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Example: ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Value: String","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Default: \"Add New\"","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"readOnly","type":"text","marks":[{"type":"strong"}]},{"text":" Instruct the htmlformflowsheet tag renderer to render the form as usual, but to not give any options to manipulate the rows in the table.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"OPTIONAL in module version 1.1.9","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Example: ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Value: true or false","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Default: false","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"sharedEncounter","type":"text","marks":[{"type":"strong"}]},{"text":": When set to true, Obs entered on the flowsheet will be appended to an existing encounter of the same encounter type.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"OPTIONAL","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Example: ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Value: true or false","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Default: false","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"showHtmlForm","type":"text","marks":[{"type":"strong"}]},{"text":": Instruct the htmlformflowsheet tag renderer to render the specified htmlform in the format described by the htmlform itself, rather than the htmlformflowsheet rendering of the htmlform contents","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"OPTIONAL in module version 1.1.9","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Example: ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Value: true or false","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Default: false","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"windowHeight","type":"text","marks":[{"type":"strong"}]},{"text":": Adjust the size of the pop-up window.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"OPTIONAL","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Example: ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Value: Integer","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Default: ?????","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"conceptsToShow","type":"text","marks":[{"type":"strong"}]},{"text":": Customizes the order of columns (and which columns) to display in the flowsheet table","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"OPTIONAL","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Example: ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Value: comma-separated string of conceptIds or concept uuids","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Default: if this is not supplied, then all concepts from the form are shown on the table in a system-generated order","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Tabs: Building a ","type":"text"},{"text":"tabbed interface","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff0000"}}]},{"text":" out of htmlforms","type":"text"}]},{"type":"paragraph","content":[{"text":"If you only want a single tab-based interface, there are two global properties that allow you to configure your tab layout:","type":"text"}]},{"type":"paragraph","content":[{"text":"htmlformflowsheet.configuration","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"This global property essentially does the entire layout of the tabs. Here is an example property value:","type":"text"}]},{"type":"paragraph","content":[{"text":" S:Demographics:15:LAST|F:Smear:21|F:Culture:22|F:Labs:20|F:Adherence:23|F:Adverse Effects:17|F:Steering Committee:19|F:Comments:18","type":"text"}]},{"type":"paragraph","content":[{"text":"These are pipe-delimited entries of the form:","type":"text"}]},{"type":"paragraph","content":[{"text":" <<","type":"text"},{"text":"Type","type":"text","marks":[{"type":"em"}]},{"text":">>:<<","type":"text"},{"text":"Title:FormID","type":"text","marks":[{"type":"em"}]},{"text":">>:<<","type":"text"},{"text":"FIRST or LAST","type":"text","marks":[{"type":"em"}]},{"text":">>, where","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Type can be 'F' for flowsheet, and 'S' for single","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Title (any text value),","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Form Id should be the base formID in your database (not the htmlform ID),","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"(optional) the strings 'FIRST' or 'LAST' only apply to Single forms (type 'S'), and determine which form to show, if there are multiple entries of this form for a patient.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"htmlformflowsheet.links","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"This global property allows you to place external links above the rendered tab interface. These are also pipe-delimited and take the form:","type":"text"}]},{"type":"paragraph","content":[{"text":" Title:URL","type":"text"}]},{"type":"paragraph","content":[{"text":"for example, here is a valid sample value: Bacteriologies:/module/mdrtb/mdrtbPatientOverview.form?view=BAC|DSTs:/module/mdrtb/mdrtbPatientOverview.form?view=DST|Regimens:/module/mdrtb/mdrtbPatientOverview.form?view=REG|Treatment Outcomes:/module/mdrtb/mdrtbPatientOverview.form?view=STATUS","type":"text"}]},{"type":"paragraph","content":[{"text":"Once you have configured these global properties, you can see the results by navigating to:","type":"text"}]},{"type":"paragraph","content":[{"text":" module/htmlformflowsheet/patientWidgetChart.list?patientId=33","type":"text"}]},{"type":"paragraph","content":[{"text":"NOTE","type":"text","marks":[{"type":"strong"},{"type":"textColor","attrs":{"color":"#ff0000"}}]},{"text":": After changing either of these global properties, you will need to stop and start the module in order for your new values to take effect.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"URL-driven HtmlForm-based Interfaces","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"If you would like for your application to have multiple flowsheet layouts, this can be done by adding the URL parameters '","type":"text"},{"text":"configuration","type":"text","marks":[{"type":"strong"}]},{"text":"', '","type":"text"},{"text":"links","type":"text","marks":[{"type":"strong"}]},{"text":"', and '","type":"text"},{"text":"fullPage","type":"text","marks":[{"type":"strong"}]},{"text":"' to the module's URL.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Configuration","type":"text"}]},{"type":"paragraph","content":[{"text":"This global property essentially does the entire layout of the tabs.","type":"text"}]},{"type":"paragraph","content":[{"text":"These are pipe-delimited entries of the format:","type":"text"}]},{"type":"paragraph","content":[{"text":" <<","type":"text"},{"text":"Type","type":"text","marks":[{"type":"em"}]},{"text":">>:<<","type":"text"},{"text":"Title:FormID","type":"text","marks":[{"type":"em"}]},{"text":">>:<<","type":"text"},{"text":"FIRST or LAST","type":"text","marks":[{"type":"em"}]},{"text":">>, where","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Type can be 'F' for flowsheet, and 'S' for single","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Title (any text value),","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Form Id should be the base formID in your database (not the htmlform ID),","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"(optional) the strings 'FIRST' or 'LAST' only apply to Single forms (type 'S'), and determine which form to show, if there are multiple entries of this form for a patient.","type":"text"}]}]}]},{"type":"table","attrs":{"__autoSize":true},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Example","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"codeBlock","content":[{"text":"https://servername/openmrs/module/htmlformflowsheet/patientWidgetChart.list?patientId=16366&configuration=S:Demographics:207:LAST|F:Prophylaxis:164|F:Allergies:154|F:OI:165|S:Vaccines:179:LAST|F:Visits:153&fullpage=false","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"mediaSingle","attrs":{"layout":"align-start","width":1280,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":222781,"__fileMimeType":"image/jpeg","width":1280,"id":"a15ba4f1-f775-4586-8c9d-e95e2d46d678","collection":"contentId-25477743","type":"file","__fileName":"configuration.jpg","height":536}}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Links","type":"text"}]},{"type":"paragraph","content":[{"text":"This optional parameter allows you to place external links above the rendered tab interface. These are also pipe-delimited and take the form:","type":"text"}]},{"type":"paragraph","content":[{"text":" Title:URL","type":"text"}]},{"type":"table","attrs":{"__autoSize":true},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Examples","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"codeBlock","content":[{"text":"https://concepts.pih-emr.org/openmrs/module/htmlformflowsheet/patientWidgetChart.list?patientId=16366&configuration=S:Demographics:207:LAST|F:Prophylaxis:164&links=DashboardIsHere:/patientDashboard.form?patientId=16366","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":" ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"codeBlock","content":[{"text":"https://concepts.pih-emr.org/openmrs/module/htmlformflowsheet/patientWidgetChart.list?patientId=16366&configuration=S:Demographics:207:LAST|F:Prophylaxis:164&links=Bacteriologies:/module/mdrtb/mdrtbPatientOverview.form?view=BAC|DSTs:/module/mdrtb/mdrtbPatientOverview.form?view=DST|Regimens:/module/mdrtb/mdrtbPatientOverview.form?view=REG|Treatment%20Outcomes:/module/mdrtb/mdrtbPatientOverview.form?view=STATUS","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":" ","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"fullPage","type":"text"}]},{"type":"paragraph","content":[{"text":"This optional parameter allows you to specify whether or not you want to include the OpenMRS header and footer. The only two allowed values are \"true\" and \"false\". If you specify fullPage=true, you get the default 'everything' view of the configured tabs. Or when omitted from the URL the full page including header and footer are displayed. If you specify fullPage=false, you don't get the header, patient header, or footer, making the tabs suitable for insertion into a ui framework (tested against the ui.springmvc module). Note, fullPage is case sensitive in respect to both the parameter name and parameter value.","type":"text"}]},{"type":"table","attrs":{"__autoSize":true},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"fullPage=true or fullPage parameter is omitted","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Header and Footer are displayed","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"mediaSingle","attrs":{"layout":"align-start","width":1280,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":208081,"__fileMimeType":"image/jpeg","width":1280,"id":"4860b077-05ca-4570-b483-0e1fb9023da5","collection":"contentId-25477743","type":"file","__fileName":"fullPageTrue.jpg","height":513}}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"fullPage=false","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Header and footer are hidden","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"mediaSingle","attrs":{"layout":"align-start","width":1280,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":152421,"__fileMimeType":"image/jpeg","width":1280,"id":"dd5c99f3-4550-4f2d-921f-d2d6b09751ae","collection":"contentId-25477743","type":"file","__fileName":"fullPageFalse.jpg","height":406}}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"title","type":"text"}]},{"type":"paragraph","content":[{"text":"Htmlformflowsheeet version 1.2.1 additionally adds the parameter '","type":"text"},{"text":"title","type":"text","marks":[{"type":"strong"}]},{"text":"' which puts the title argument above the flowsheet tabs. For example you could add &title=ASTHMA%20PROGRAM to add ASTHMA PROGRAM to the top of the tabbed interface. Other parameters that work across all tabs are '","type":"text"},{"text":"showHtmlForm","type":"text","marks":[{"type":"strong"}]},{"text":"', which will change the flowsheet renderer to use htmlformentry native rendering if set to true rather than htmlformflowsheet default rendering, and '","type":"text"},{"text":"showAllEncsWithEncType'","type":"text","marks":[{"type":"strong"}]},{"text":", which will allow you to append the data entered in a flowsheet to already existing encounters.","type":"text"}]},{"type":"paragraph","content":[{"text":"For example, if you navigate to the following, you get the default tab view for patient #33.","type":"text"}]},{"type":"paragraph","content":[{"text":" module/htmlformflowsheet/patientWidgetChart.list?patientId=33","type":"text"}]},{"type":"paragraph","content":[{"text":"If you navigate to the following, you get a tab view with only the culture and lab forms, and a link to mdrtb treatment outcomes.","type":"text"}]},{"type":"paragraph","content":[{"text":" module/htmlformflowsheet/patientWidgetChart.list?patientId=33&configuration=F:Culture:22|F:Labs:20&links=Treatment Outcomes:/module/mdrtb/mdrtbPatientOverview.form?view=STATUS","type":"text"}]},{"type":"paragraph","content":[{"text":"Note: on single htmlforms, when displayed, i would recommend getting rid of the default 'print' and 'delete' links that render by default in htmlformentry. To do this, add the following javascript to your htmlform:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Examples","type":"text"}]},{"type":"paragraph","content":[{"text":"Here is one-time form in the tab structure: ","type":"text"},{"text":"http://archive.openmrs.org/wiki/Image:Single.JPG","type":"text","marks":[{"type":"link","attrs":{"href":"http://archive.openmrs.org/wiki/Image:Single.JPG"}}]}]},{"type":"paragraph","content":[{"text":"This is a flowsheet-type form in the tab structure: ","type":"text"},{"text":"http://archive.openmrs.org/wiki/Image:Flowsheet.JPG","type":"text","marks":[{"type":"link","attrs":{"href":"http://archive.openmrs.org/wiki/Image:Flowsheet.JPG"}}]}]},{"type":"paragraph","content":[{"text":"keywords: flowsheet, patient chart, htmlformentry, formflowsheet, treatment card, tabs","type":"text"}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Unreleased Version (1.3.0 Snapshot) with working tabbed Interface","type":"text"}]},{"type":"paragraph","content":[{"text":"The most updated HTML Form Flowsheet module version with working tabbed interface is the Github 21 Febrary 2013 master branch snapshot.","type":"text"}]},{"type":"paragraph","content":[{"text":"This has been tested with:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"OpenMRS 1.8.4","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"HTML Form Entry 1.10.0","type":"text"}]}]}]}],"version":1}