=== modified file 'src/docbkx/en/dhis2_user_man_datasets_forms.xml'
--- src/docbkx/en/dhis2_user_man_datasets_forms.xml 2013-06-01 12:33:28 +0000
+++ src/docbkx/en/dhis2_user_man_datasets_forms.xml 2013-06-11 21:01:03 +0000
@@ -117,7 +117,9 @@
you to translate the name of a data set to a different language.
- Create or edit a custom data entry form. Refer to for detailed information of how to use this function.
+ Create or
+ edit a custom data entry form. Refer to the section on custom data entry forms for
+ detailed information of how to use this function.
Edit compulsory data elements: This dialog will allow you to add or remove data elements which will be marked as compulsory during data entry.
@@ -245,6 +247,39 @@
You can to intermediary saving by clicking on the Save button, and this will not close the window. It is recommended to save often to ensure you do not loose your work.
When you are done or want to test your form in data entry click on <Save and close>.
+
+ Scripting in custom forms
+ With custom data entry forms it is possible to use Javascript to create dynamic behavior
+ of the form. There are two methods which can be used to hook into events in the data entry
+ module. To have your code invoked when a data entry form has been loaded you can add a
+ Javascript tag in your custom form like this:
+ <script type="text/javascript">
+
+onFormLoad( function() {
+ // Do your javascript stuff here
+} );
+
+</script>
+ To have your code invoked when any data value is successfully saved in the form you can
+ add a Javascript tag like the example below. Note that you can access all properties for the
+ data value being saved through your callback function; the first parameter is the event
+ object while the second argument is the data value object being saved:
+ <script type="text/javascript">
+
+onValueSave( function( event, dataValue ) {
+ var de = dataValue.dataElementId;
+ var co = dataValue.optionComboId;
+ var ou = dataValue.organisationUnitId;
+ var va = dataValue.value;
+
+ // Do stuff like modifying the form based on the data element and value being saved
+} );
+
+</script>
+ The identifiers of the input fields in the data entry form is on the format
+ <dataelementuid>-<optioncombouid> , this can be used to select input fields in your
+ script and perform actions on them.
+
Data set assignment editor
The data set assignment editor is a tool for adding and removing many data sets to organisation units in batch style. Start by selecting an organisation unit from the selection tree. In the area below the tree a grid will be displayed showing all data sets as columns and the child organisation units as rows.