This article describes how you can import XForms into your Mobenzi project, or export forms you have created in the Mobenzi designer as XForms.

Importing XForms

If you have created forms in other applications but now want to use them in your Mobenzi project, you can easily import these forms if they are in standard XForm format. This feature is available to all plans (including Community plans).

If your form is in XLSFormat, there are many free online tools (see here for an example) available to convert it to XForm format which you can then import into the Mobenzi designer.

Note: There are many ways to implement forms within the XForms standard. Although we attempt to cater for as many variations as possible, we cannot guarantee that all elements of an XForm created by an external system will be imported correctly. It is therefore very important that you review each element of your imported form using the preview functionality to ensure that it looks and is working as expected, and adjust it as necessary.    

To import your form, open the quick-switch menu and select '+ New Form' (1). You can also select the '+ New Form' button from the Dashboard

From the pop-up, select 'Import form' (2)Click 'Browse' (3) and select the .xml file you want to import. 

Click 'Validate' (4) to determine if the form format is valid to be imported into the Mobenzi system. This does not actually import the form, but merely determines whether the form is suitable for import. 

You will receive the following validation feedback:

  • Validation result - Gives feedback on whether your form is valid for import or not. If validation fails you will not be able to import your form. If validation is successful, you can proceed to import the form and the Import Form button will be enabled.
  • Errors - Lists the reasons for validation to fail. If any errors are present, it means the form cannot be imported and the Import Form button will be disabled.
  • Warnings - Lists all unsupported elements of your form that cannot be imported but will not prevent you from importing your form. If warnings are present you will still be able to import the form, but you should specifically check the listed areas after import and rectify/edit as required. It will also list any additional languages the system detected in your XForm for you to confirm.
  • Notices - Gives any other important information, e.g. if no language was detected in your form it will inform you that English was chosen as the default language.

Once your form has been successfully validated, select 'Import Form' (5). The newly imported form will open in the Design tab in Draft status. From here you can preview (recommended), edit, publish and assign your form as usual.

Exporting XForms

You can export your existing Mobenzi forms in order to import them back into another Mobenzi account or to use a mobile app of your choice to capture data. 

To export your form, go to the Design tab (1) and click on the cog icon (2). From the drop-down, select Export XForm (3)Your form will download directly to your computer as an XForm standard xml file.    

Note: You can only export your form as an XForm if you are on a paid plan. Community plans do not have access to this functionality.