dhis2-devs team mailing list archive

[noreply@xxxxxxxxxxxxx]

------------------------------------------------------------
revno: 718
committer: Lars Helge Øverland <larshelge@xxxxxxxxx>
branch nick: dhis2-docbook-docs
timestamp: Sat 2013-03-30 12:44:10 +0100
message:
  Update on validation rules
modified:
  src/docbkx/en/dhis2_user_man_creating_data_quality.xml


--
lp:~dhis2-documenters/dhis2/dhis2-docbook-docs
https://code.launchpad.net/~dhis2-documenters/dhis2/dhis2-docbook-docs

Your team DHIS 2 developers is subscribed to branch lp:~dhis2-documenters/dhis2/dhis2-docbook-docs.
To unsubscribe from this branch go to https://code.launchpad.net/~dhis2-documenters/dhis2/dhis2-docbook-docs/+edit-subscription

=== modified file 'src/docbkx/en/dhis2_user_man_creating_data_quality.xml'
--- src/docbkx/en/dhis2_user_man_creating_data_quality.xml	2011-02-02 13:14:10 +0000
+++ src/docbkx/en/dhis2_user_man_creating_data_quality.xml	2013-03-30 11:44:10 +0000
@@ -76,7 +76,29 @@
   <section id="validationRule">
     <title>Validation Rule</title>
     <para>This module provides management of validation rules. A validation rule is based on an expression which defines a relationship between a number of data elements. The expression has a left side and a right side and an operator  which defines whether the former must be less than, equal to or greater than the latter. The expression forms a condition which should assert that certain logical criterias are met. For instance, a validation rule could  assert that the total number of vaccines given to infants is less than or equal to the total number of infants.</para>
-    <para>To add a validation rule, click the add new button. First, provide a descriptive <emphasis role="italic">name</emphasis> for the validation rule. The  name must be unique among the validation rules. Second, provide a description for the validation rule. Third, select an operator. The  operator options are <emphasis role="italic">equal</emphasis>, <emphasis role="italic">not equal</emphasis>, <emphasis role="italic">greater than</emphasis>, <emphasis role="italic">greater than or equal</emphasis>, <emphasis role="italic">less than</emphasis>, <emphasis role="italic">less than or equal to</emphasis>. Then define the left side and right side of the validation rule expression. First, provde a description for the expression. Second, build the expression with the expression builder. The expression is mathematical and contain data elements as well as integers and mathematical operators. Data elements can be included by double-clicking  one in  the available data elements list to the righ. Alternatively one can  select a data element and click the insert button. Mathematical operators can be included by clicking the corresponding button under the expression builder area. Save the expression by clicking <emphasis role="italic">save</emphasis>, then save the validation rule by clicking <emphasis role="italic">save</emphasis>.</para>
+    <para>To add a validation rule, click the add new button. First, provide a descriptive <emphasis
+        role="italic">name</emphasis> for the validation rule. The name must be unique among the
+      validation rules. Second, provide a description for the validation rule. Third, select an
+      operator. The operator options are <emphasis role="italic">equal</emphasis>, <emphasis
+        role="italic">not equal</emphasis>, <emphasis role="italic">greater than</emphasis>,
+        <emphasis role="italic">greater than or equal</emphasis>, <emphasis role="italic">less
+        than</emphasis>, <emphasis role="italic">less than or equal to</emphasis> and <emphasis
+        role="italic">compulsory pair</emphasis>. Then define the left side and right side of the
+      validation rule expression. First, provde a description for the expression. Second, build the
+      expression with the expression builder. The expression is mathematical and contain data
+      elements as well as integers and mathematical operators. Data elements can be included by
+      double-clicking one in the available data elements list to the righ. Alternatively one can
+      select a data element and click the insert button. Mathematical operators can be included by
+      clicking the corresponding button under the expression builder area. Save the expression by
+      clicking <emphasis role="italic">save</emphasis>, then save the validation rule by clicking
+        <emphasis role="italic">save</emphasis>.</para>
+    <para>When defining the expression you can control whether the validation rule should be ignored
+      or throw a violation when one or more data elements in the expression have no registered data
+      values through the <emphasis role="italic">skip for missing values</emphasis> setting.</para>
+    <para>The compulsory pair operator allows you to require that data values must be entered for a
+      form for all of the data elements in the expression, or none at all. In other words, you can
+      require that if one field in a form is filled, then one or more other fields must also be
+      filled.</para>
     <para>To edit a validation rule, click the <emphasis role="italic">edit</emphasis>icon next to the relevant validation rule in the list. Then follow the same producedures as  above.</para>
     <para>To delete a validation rule, click the <emphasis role="italic">delete</emphasis>icon next to the relevant validation rule in the list.</para>
     <para>To view validation rule details, click the <emphasis role="italic">view details</emphasis>icon next to the relevant validation rule in the list.</para>