← Back to team overview

dhis2-devs team mailing list archive

[Branch ~dhis2-documenters/dhis2/dhis2-docbook-docs] Rev 966: Category option / group set csv import docs

 

------------------------------------------------------------
revno: 966
committer: Lars Helge Øverland <larshelge@xxxxxxxxx>
branch nick: dhis2-docbook-docs
timestamp: Mon 2014-02-17 19:55:32 +0100
message:
  Category option / group set 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	2014-02-15 18:09:40 +0000
+++ src/docbkx/en/dhis2_user_man_import_export.xml	2014-02-17 18:55:32 +0000
@@ -279,7 +279,9 @@
   <section id="importCSVdata">
     <title>Importing CSV data</title>
     <para>DHIS 2 supports import of data in the CSV format. This can be used to import exchange file produced by DHIS 2 itself. It also comes in handy when you want to import data from a third-party system as CSV is widely supported in applications and is easy to produce manually.</para>
-    <para>To import a CSV data exchange file navigate to the <emphasis role="italic">CSV Data Import </emphasis>item in the left-side menu. Upload the exchange file and click <emphasis role="italic">Import</emphasis>.</para>
+    <para>To import a CSV data exchange file navigate to the <emphasis role="italic">CSV Data Import
+      </emphasis>item in the left-side menu. Upload the exchange file and click <emphasis
+        role="italic">Import</emphasis>.</para>
     <para>The following section describes the CSV format used in DHIS 2. The first row is assumed to be a header row and will be ignored during import.</para>
     <para><table>
         <title>CSV format of DHIS 2</title>
@@ -354,8 +356,13 @@
       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>
+    <para>To import CV meta-data go to import-export module and select CSV Meta-Data Import form the
+      left side menu. You must select the object type which your CSV file contains. You can only
+      upload one type of objects at the time. Upload your file and click update.</para>
+    <para>The formats for the currently supported object types for CSV import are listed
+      below.</para>
     <table frame="all">
-      <title>CSV data element format</title>
+      <title>Data Element CSV Format</title>
       <tgroup cols="4">
         <colspec colname="c1" colnum="1" colwidth="1.33*"/>
         <colspec colname="c2" colnum="2" colwidth="1*"/>
@@ -374,19 +381,19 @@
             <entry>Name</entry>
             <entry>Yes</entry>
             <entry/>
-            <entry>Name of data element. Max 230 characters. Unique.</entry>
+            <entry>Name. 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>
+            <entry>Stable identifier. Will be generated by system if not specified.</entry>
           </row>
           <row>
             <entry>Code</entry>
             <entry>No</entry>
             <entry/>
-            <entry>Code for data element.</entry>
+            <entry>Stable code.</entry>
           </row>
           <row>
             <entry>Short name</entry>
@@ -408,22 +415,16 @@
             <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/>
+            <entry>Domain type for data element, can be aggreate or patient.</entry>
           </row>
           <row>
             <entry>Type</entry>
             <entry>No</entry>
             <entry>int</entry>
-            <entry/>
+            <entry>Value type.</entry>
           </row>
           <row>
             <entry>Number type</entry>
@@ -441,7 +442,7 @@
             <entry>Aggregation operator</entry>
             <entry>No</entry>
             <entry>sum</entry>
-            <entry/>
+            <entry>Operator indicating how to aggreate data in the time dimension.</entry>
           </row>
           <row>
             <entry>Url</entry>
@@ -458,6 +459,43 @@
         </tbody>
       </tgroup>
     </table>
+    <table frame="all">
+      <title>Category Option and Category Option Group CSV Format</title>
+      <tgroup cols="4">
+        <colspec colname="c1" colnum="1" colwidth="1.33*"/>
+        <colspec colname="c2" colnum="2" colwidth="1*"/>
+        <colspec colname="c3" colnum="3" colwidth="1.28*"/>
+        <colspec colname="c4" colnum="4" colwidth="5.72*"/>
+        <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. Max 230 characters. Unique.</entry>
+          </row>
+          <row>
+            <entry>UID</entry>
+            <entry>No</entry>
+            <entry>System generated</entry>
+            <entry>Stable identifier. Will be generated by system if not specified.</entry>
+          </row>
+          <row>
+            <entry>Code</entry>
+            <entry>No</entry>
+            <entry/>
+            <entry>Stable code.</entry>
+          </row>
+        </tbody>
+      </tgroup>
+    </table>
   </section>
   <section id="importXMLdata">
     <title>Importing XML data</title>