Configuration – Sapelli

A Sapelli Project can only have one Configuration element, which resides as an immediate child of the Project element itself. The Configuration element holds settings general to the Project. Currently only the Logging preference is supported. It serves as a container for these more-specific settings and thus does not have any attributes of its own.

The Configuration element is included immediately after the Project element, before the declaration of any Forms:

<SapelliCollectorProject id="101" name="ProjectName" version="1.2" defaultLanguage="en-GB">
  <Configuration>
    ... (configuration elements go here)
  </Configuration>
  ... (Forms go here)
</SapelliCollectorProject>

... (configuration elements go here)

</Configuration>

... (Forms go here)

</SapelliCollectorProject>

The example above codes for a Project called “ProjectName”, version 1.2 with ID “101” and a default language of British English.

Logging

Logging provides the analytics or usage statistics of where a user has clicked throughout the project. The Logging Configuration element allows the Project designer to enable or disable logging during the process of data collection. If logging is enabled, log files will be stored in the appropriate folder according to the Collector folder structure and will also be mirrored to Android’s Logcat output if appropriate. N.B. By default logging is enabled within a project.

<SapelliCollectorProject id="101" name="ProjectName" version="1.2" defaultLanguage="en-GB">
  <Configuration>
    <Logging enabled="false" />
    ... (Other settings go here)
  </Configuration>
  ... (Form elements go here)
</SapelliCollectorProject>

... (Other settings go here)

</Configuration>

... (Form elements go here)

</SapelliCollectorProject>

The code above has disabled logging for the Sapelli Project called “ProjectName”, version 1.2 with ID “101” and a default language of British English.