Difference between revisions of "SurveyCTO Coding Practices"

Jump to: navigation, search
Line 1: Line 1:
This article discuss solutions to specific but common issues in the programming language used in SurveyCTO. If you want a general introduction to how to structure your approach to programming a CAPI questionnaire or how to use best practices settings that reduce the risk of errors, then see the topic of [[Questionnaire Programming]].
+
This article discuss solutions to common issues in the SurveyCTO programming language. For a general introduction to how to structure your approach to CAPI programming or best practices settings, see the [[Questionnaire Programming]] topic.
  
 
== Read First ==
 
== Read First ==
* All coding examples linked to in this section are stored in Google Drive. You can copy that code to an Excel file, but Survey CTO also allows you to pull this code using the URL of the Google Sheet directly from your own server.
+
All coding examples linked to in this section are stored in Google Drive. SurveyCTO also allows you to pull this code directly to your server, using the URL of the Google Sheet (alternatively, you can copy the code to Excel).
  
 
==Groups==
 
==Groups==
Use a lot of groups but do not over use them. This means that you should always ask yourself if anything you do can be done more simplistically with a group. Although, only include a group if they fulfill one of the purposes below:
+
Use a lot of groups but do not over use them. In general, groups are used to fulfill one of the purposes below:
  
 
*Apply a [[Relevance Condition to Multiple Fields|relevance condition to multiple fields]].
 
*Apply a [[Relevance Condition to Multiple Fields|relevance condition to multiple fields]].

Revision as of 15:16, 13 February 2017

This article discuss solutions to common issues in the SurveyCTO programming language. For a general introduction to how to structure your approach to CAPI programming or best practices settings, see the Questionnaire Programming topic.

Read First

All coding examples linked to in this section are stored in Google Drive. SurveyCTO also allows you to pull this code directly to your server, using the URL of the Google Sheet (alternatively, you can copy the code to Excel).

Groups

Use a lot of groups but do not over use them. In general, groups are used to fulfill one of the purposes below:

Repeat Groups

Repeat groups are a group that is repeated 1 or multiple times. This means that most properties that apply to a regular group, also applies to a repeat group.

Choice Lists

Choice lists are the answer options an enumerator can choose from in a select one or select multiple question. They are listed in the choices in the SurveyCTO questionnaire. While the programming language ODK that SurveyCTO builds on has very few restrictions on how you can code your options, there are choice list best practices that matters for data quality when using the data from these question in for example Excel.

The choice lists can also be dynamically populated by answers already given by the respondents.

Choice Filters

Preloading

Additional Resources

  • list here other articles related to this topic, with a brief description and link