The xforms xreports module uses the purcforms FormDesigner purcreports ReportDesigner and FormRunner ReportRunner widgets.
The FormDesigner widget ReportDesigner widget is used for the designing of forms while the FormRunner widget ReportRunner widget is used for form data entry.
The FormDesigner widget ReportDesigner widget is embedded in the xformDesigner.jsp page where it attaches itself at a div with an id of "purcformsdesigner"
The FormRunner widget is embedded in the formEntry.jsp page where it attaches itself at a div with an id of "purcformrunner"
The FormDesigner and FormRunner GWT ReportDesigner and ReportRunner GWT compiled JavaScript files are placed in the resources folder under the formdesigner reportdesigner and formrunner reportrunner folders respectively.
In the xformDesigner.jsp and formEntry.jsp pages, the divs you see are configuration parameters for the FormDesigner and FormRunner widgetsReportRunner widgets. The JavaScript functions are callbacks for the FormDesigner and FormRunner widgetsReportRunner widgets, while the JavaScript variable named "PurcformsText" holds the text used by these widgets for various labels and user messages.
...
When one selects a form on the patient dashboard, the module fetches the xforms definition xreports definition and widget layout data from the database and passes it to the FormRunner widget ReportRunner widget which displays the form to the user for data entry. When the user submits the form, the FormRunner widget ReportRunner widget submits the xforms instance xreports instance data xml (which is identical the one one submitted by Infopath), to the module which passes it through the same form entry queue processing as done for the Infopath forms. The difference here being that the form entry queue API is called immediately instead of waiting for the scheduler as done for Infopath forms.
Resources
- XForms XReports Module
- XForms XReports Module User Guide
- XForms Module Patient Registration
- XForms Module Form XReports Module Report Designer
- XForms Module External Applications Guide
- XForms Module XReports Module Technical Overview
- XReports XForms Module Release Notes
- Download Module
- GitHub project (source code)
- XForms was discussed on a May 9th University call. Watch xforms video
- XForms XReports Newbies FAQs