如何创建基本的OpenMRS HTMLFormEntry表单

Question

HTMLFormEntry是一种非常有效的保存表单的方法。您将创建XML，模块将在按submit时将输入转换为数据库记录。

我们如何呈现一个表单，例如在path/to/form.xml

我们是否必须在它自己的页面中呈现它，或者我们可以将它加载到页面中？

Answer 1

1.从xml创建一个新的表单对象

选项1：利用public void HtmlFormEntry.HtmlForm.setXmlData(String xmlData)

import org.openmrs.module.htmlformentry.HtmlForm;

...

HtmlForm form = new HtmlForm();
form.setXmlData(xml);

选项2XML:如果您的尚未加载，请使用public static HtmlForm HtmlFormEntryUI.HtmlFormUtil.getHtmlFormFromUiResource()、reference

• 注意：relativeWebResourcePath是模块的/omod/src/main/webapp/resources目录的相对路径。
• 参数为ResourceFactory resourceFactory, FormService formService, HtmlFormEntryService htmlFormEntryService, String providerAndPath

import org.openmrs.api.FormService;
import org.openmrs.module.htmlformentry.HtmlFormEntryService;
import org.openmrs.module.htmlformentry.HtmlForm;
import org.openmrs.module.htmlformentryui.HtmlFormUtil;

...

String htmlFormPath = thisModuleName+":"+relativeWebResourcePath;
ResourceFactory resourceFactory = ResourceFactory.getInstance();
FormService formService = Context.getFormService();
HtmlFormEntryService htmlFormEntryService = Context.getService(HtmlFormEntryService.class);
HtmlForm form = HtmlFormUtil.getHtmlFormFromUiResource(resourceFactory, formService, htmlFormEntryService, htmlFormPath);

2.使用FormEntrySession生成超文本标记语言并处理表单输入、提交等

• reference
• better reference

import org.openmrs.module.htmlformentry.FormEntrySession;

...

FormEntrySession fes = new FormEntrySession(patient, form, request.session)
String html = fes.getHtmlToDisplay()

3.使用生成的html

FormEntrySession对象生成的html应该包含提交表单所需的所有逻辑。