This page needs review and update.
Patient forms are directories containing various XML
files. Each file is a precise function and has a fixed name.
These forms can be sent from one FreeMedForms user to another with a specific module.
Forms updates are transparent to users.
The database will automatically adapt to the loaded FreeMedForms form.
You can define a generic form for all patients and then decorate this form as needed by adding subforms.
The following files are necessary for a valid form:
You can complete your forms with:
description.xml: the description of the form, as separate file
.ui files: QtDesigner created GUIs
drugs.xml for the medication page form
pmhcategories.xml to define which fields are displayed in the page history
[better translation?] all files included in these forms that can either be included in an archive or integrated into subforms
Each file must start with a form header like this one:
<?Xml Version="1.0" encoding="UTF-8"?>
Your XML code must be included in a FreeMedForms tag:
The name you give to forms and items is very important. The database will use these names to store and retrieve records.
If two elements have the same name, the result is unpredictable.
If you change the name of an item between two updates, you must define fieldEquivalence (defined since v0.7.0) to avoid data loss.
We do recommend the use of namespaces using the following rules:
Each form has its own namespace.
For example, the form General Medicine with drugs page has the namespace GP::Basic.
The namespace should generally not be in name conflict with any other form, unless you want to ensure inter-correspondent forms.
The separator between namespaces can be one of the following symbols: :: , : , . (prefer ::)
To improve the performance of scripts, make sure the correct naming respects encapsulation, for example:
Contains the central form that appears in the patient form page of FreeMedForms. It can contain embedded forms.
Each form starts its own branch in the forms tree.
Detailed information about the content is located on a separate page.
Contains the form(s) to insert into the Drugs page. You can insert subforms if necessary.
Contains the information needed to construct entries in the patient history [correct translation?]. Each entry can have: