dhis2-devs team mailing list archive

[noreply@xxxxxxxxxxxxx]

------------------------------------------------------------
revno: 964
committer: Lars Helge Øverland <larshelge@xxxxxxxxx>
branch nick: dhis2-docbook-docs
timestamp: Sat 2014-02-15 19:09:40 +0100
message:
  Data elements CSV import docs
modified:
  src/docbkx/en/dhis2_user_man_import_export.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_import_export.xml'
--- src/docbkx/en/dhis2_user_man_import_export.xml	2013-12-23 09:16:02 +0000
+++ src/docbkx/en/dhis2_user_man_import_export.xml	2014-02-15 18:09:40 +0000
@@ -288,7 +288,7 @@
             <row>
               <entry>Column</entry>
               <entry>Required</entry>
-              <entry>Notes</entry>
+              <entry>Description</entry>
             </row>
             <row>
               <entry>Data element</entry>
@@ -346,6 +346,119 @@
 &quot;DUSpd8Jq3M7&quot;,&quot;201202&quot;,&quot;gP6hn503KUX&quot;,&quot;V6L425pT3A0&quot;,&quot;10&quot;,&quot;bombali&quot;,&quot;2010-04-17&quot;,,&quot;false&quot;
 &quot;DUSpd8Jq3M7&quot;,&quot;201202&quot;,&quot;OjTS752GbZE&quot;,&quot;V6L425pT3A0&quot;,&quot;9&quot;,&quot;bombali&quot;,&quot;2010-04-06&quot;,,&quot;false&quot;</screen>
   </section>
+  <section>
+    <title>Importing CSV data elements</title>
+    <para>DHIS 2 supports import of meta-data in the CSV format. Currently data elements are
+      supported. You can import data elements from <emphasis role="italic">CSV Meta-data
+        Import</emphasis> in the import-export module. Columns which are not required can be omitted
+      in the CSV file, but the order will be affected. If you would like to specify columns which
+      appear late in the order but not specify columns which appear early in the order you can
+      include empty columns ("") for them.</para>
+    <table frame="all">
+      <title>CSV data element format</title>
+      <tgroup cols="4">
+        <colspec colname="c1" colnum="1" colwidth="1.33*"/>
+        <colspec colname="c2" colnum="2" colwidth="1*"/>
+        <colspec colname="newCol3" colnum="3" colwidth="1.33*"/>
+        <colspec colname="c3" colnum="4" colwidth="5.84*"/>
+        <thead>
+          <row>
+            <entry>Column</entry>
+            <entry>Required</entry>
+            <entry>Default value</entry>
+            <entry>Description</entry>
+          </row>
+        </thead>
+        <tbody>
+          <row>
+            <entry>Name</entry>
+            <entry>Yes</entry>
+            <entry/>
+            <entry>Name of data element. Max 230 characters. Unique.</entry>
+          </row>
+          <row>
+            <entry>UID</entry>
+            <entry>No</entry>
+            <entry>System generated</entry>
+            <entry>UID for data element. Will be generated by system if not specified.</entry>
+          </row>
+          <row>
+            <entry>Code</entry>
+            <entry>No</entry>
+            <entry/>
+            <entry>Code for data element.</entry>
+          </row>
+          <row>
+            <entry>Short name</entry>
+            <entry>No</entry>
+            <entry>50 first char of name</entry>
+            <entry>Will fall back to first 50 characters of name if unspecified. Max 50 characters.
+              Unique.</entry>
+          </row>
+          <row>
+            <entry>Description</entry>
+            <entry>No</entry>
+            <entry/>
+            <entry>Free text description of data element.</entry>
+          </row>
+          <row>
+            <entry>Form name</entry>
+            <entry>No</entry>
+            <entry/>
+            <entry>Max 230 characters.</entry>
+          </row>
+          <row>
+            <entry>Active</entry>
+            <entry>No</entry>
+            <entry>false</entry>
+            <entry/>
+          </row>
+          <row>
+            <entry>Domain type</entry>
+            <entry>No</entry>
+            <entry>aggregate</entry>
+            <entry/>
+          </row>
+          <row>
+            <entry>Type</entry>
+            <entry>No</entry>
+            <entry>int</entry>
+            <entry/>
+          </row>
+          <row>
+            <entry>Number type</entry>
+            <entry>No</entry>
+            <entry>number</entry>
+            <entry>Only relevant if type is int.</entry>
+          </row>
+          <row>
+            <entry>Text type</entry>
+            <entry>No</entry>
+            <entry>text</entry>
+            <entry>Only relevant if type is string.</entry>
+          </row>
+          <row>
+            <entry>Aggregation operator</entry>
+            <entry>No</entry>
+            <entry>sum</entry>
+            <entry/>
+          </row>
+          <row>
+            <entry>Url</entry>
+            <entry>No</entry>
+            <entry/>
+            <entry>URL to data element resource.</entry>
+          </row>
+          <row>
+            <entry>Zero is significant</entry>
+            <entry>No</entry>
+            <entry>false</entry>
+            <entry>Indicates whether zero values will be stored for this data element.</entry>
+          </row>
+        </tbody>
+      </tgroup>
+    </table>
+  </section>
   <section id="importXMLdata">
     <title>Importing XML data</title>
     <para>DHIS 2 supports import of data in XML format. The format is called DXF (DHIS Exchange