Merge pull request #1072 from david-roper/add-csv-doc-example

Add csv doc example

Author: joshunrau

docs/en/3-guides/3.3-how-to-upload-data.md

@@ -68,3 +68,37 @@ Open Data Capture allows you to visualize numeric measures over time in a single
       Whenever data is optional within a form it can be left empty and still be properly submitted. Any optional data column in the csv template will have an "(optional)" tag attached to its sample data entry, which means any entry in the column can be left blank. This is usually done in that case of when one column value depends on another. For example, a sessionFailed column would be followed by an optional reasonForFailure column.
 
 </Steps>
+
+### Sample CSV Data
+
+This section will present how to properly fill in a template csv from the upload feature. Say we download the following csv template that looks like this below:
+
+| subjectID | date       | stringQuestion | setQuestion     | optionalQuestion | recordArrayQuestion                                  |
+| :-------- | :--------- | :------------- | :-------------- | :--------------- | :--------------------------------------------------- |
+| string    | yyyy-mm-dd | yes/no         | SET(A/B/C, ...) | A/B (optional)   | RECORD_ARRAY(testString: A/B/C, testNumber: number;) |
+|           |            |                |                 |                  |                                                      |
+
+<br>
+
+Starting with the first column we have **subjectID**, which is a string value containing the identification of the subject taking part in the instrument. This field is required.
+
+The second column contains the date of which in instrument was done by the subject, which follows _yyyy-mm-dd_ format. This field is to be filled for each row.
+
+The third column is a string entry consisting of two possible options (yes/no).
+
+The fourth column is a field which takes in a set of entries, where the options are A, B or C. The set can have all these option within it, however it does not accept duplicates. So an entry such as `SET(A,A,C)` would fail, but the entry `SET(A,B,C)` would be valid.
+
+The fifth column is an optional string field with the possible options of A or B. This field can hold either A, B, or can remain empty.
+
+Finally, the sixth column is a record array field. This record array object can have the fields testString and testNumber entered within it. These internal field values are entered by including the fieldname and its corresponding value separated by a **":"**. In addition, a record array can also have multiple entries for each internal field within it as long as the new entry is separated by a **";"**. With that in mind, valid entries for this column would be `RECORD_ARRAY(testString: A, testNumber: 1;)` or <br>
+`RECORD_ARRAY(testString: A, testNumber: 1; testString: 1, testNumber: 2;)`, etc.
+
+<br>
+
+A valid CSV file that follows this template can be seen below:
+
+| subjectID | date       | stringQuestion | setQuestion  | optionalQuestion | recordArrayQuestion                                                         |
+| :-------- | :--------- | :------------- | :----------- | :--------------- | :-------------------------------------------------------------------------- |
+| testID123 | 2025-01-07 | yes            | SET(A, B, C) | B                | RECORD_ARRAY(testString: A, testNumber: 2; testString: B, testNumber: 3;)   |
+| testID111 | 2025-01-06 | no             | SET(C, B)    | A                | RECORD_ARRAY(testString: B, testNumber: 22; testString: A, testNumber: 1;)  |
+| testID111 | 2025-01-03 | no             | SET(A, C)    |                  | RECORD_ARRAY(testString: B, testNumber: 12; testString: B, testNumber: 13;) |