Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
xml [2013/11/14 14:34]
hongsudt
xml [2016/05/13 20:45] (current)
Line 1: Line 1:
-===== XML Editing ===== +data //​campaign//​ can be configured by a //campaign definition//​ which is an XML file describing the structure and properties ​of the data to be collected. A campaign contains a set of //​surveys//,​ each of which is a sequence of messages or prompts ​to be displayed. A //message// (e.g. ''​Please get up and walk for 2 minutes.''​) is a brief communication which does not require user input. A //prompt// solicits a response from the user; either an answer to a question (e.g''​Did you exercise today?''​),​ or some other form of input (e.g. ''​Take a picture of your snack wrapper''​). Our software supports a rich set of prompt types including: 1) single/​multiple choices with the option ​for users to define additional choices; 2) number; 3) free-text; 4) timestamp; 5) multimedia such as pictures, videos or audios; and 6) a //remote activity// that launches a third party application,​ such as a game app to assess attentionEach prompt and message can optionally set a condition based on previous prompt responses that determines whether or not it should be displayed. For instance, a prompt ''​Did you take your medication before, after, or without food?''​ can be set to display if the user responded ''​Yes''​ to the previous prompt ''​Did you take medication X this morning?''​ This capability enables a more interactive and responsive survey answering experience. **For the purpose of the Mobilize project, we will only be using a subset of prompts including single-choice,​ number, free-text, and photo.** 
-future plan of the Mobilize project is to provide ​to students the basic XML editing skills needed in order create their own campaigns ​for use in [[http://ohmage.org|ohmage]]Below are some instructions ​for getting started, and links to more in-depth XML resources (as well as the specific XML schema in use by [[http://ohmage.org|ohmage]].+
  
-==== Getting Started ==== +There are two different ways to create ​campaign 
-You can get started editing with only [[http://en.wikipedia.org/​wiki/​Text_editor|text editor]], but we'd suggest using a few well-known text editors ​that can do XML [[http://​en.wikipedia.org/​wiki/​Syntax_highlighting|syntax highlighting]],​ which will greatly help new users understand ​the flow of XML.+  * Manual campaign creation by creating the campaign XML file and upload to the server. 
 +  * Campaign authoring tool that interactively guide the user through the campaign creation process 
  
-=== Text Editor Suggestions ​=== +==== Manual Campaign Creation ==== 
-  ​* Windows: [[http://notepad-plus-plus.org/|notepad++]] +There are 2 steps required: 
-  Mac OS: [[http://www.barebones.com/products/textwrangler/|Text Wrangler]] +  ​- CreateUsers manually create an XML file using any editor of their choice. The campaign XML file has to be well-formed and conform to [[https://github.com/cens/​ohmageServer/​wiki/​Campaign-Definition|the ohmage campaign definition schema]]. The following ppt file summarizes the campaign properties and how to create a simple campaign with the XML. For a quick and simple creation, we recommend taking an XML example below as a template and modify the content where necessary. ​ 
-  ​* On-line XML editors[[http://​collabedit.com/​]], [[http://brackets.io/]], [[http://​icecoder.net/]]+    * [[http://web.ohmage.org/~hongsudt/slides/CampaignCreation_MZP_PD_2013.pptx|How to create your own campaign (ppt)]]  
 +  - UploadAfter the campaign definition is createdplease login to [[https://lausd.mobilizingcs.org|the Mobilize Web Frontend]], select the campaign tab, then create campaign to upload your campaign
  
-but honestly...this is the best one.  ​it supports ​xml syntax highlightingbut also a collaboration component.  ​no login:+== Campaign XML Examples == 
 +A list of XML templates are provided belowUsers can download any of these files and modify the content where necessaryWe leave some comments at the top to help guide you with the modification 
 +  * [[http://​web.ohmage.org/​mobilize/​resources/​mzp/​ShortSnack.xml|Short Snack Campaign]]: This campaign contains four questions. Each question demonstrates different basic prompt type (i.e.single_choice,​ number, text, and photo). 
 +  * [[http://​web.ohmage.org/​mobilize/​resources/​mzp/​BirdSighting.xml|Bird Sighting Campaign]]: This campaign demonstrates the use of basic prompt types, but contains more questions. ​
  
  
-=== Terms and Grammar === +Note: For more advanced campaign featuresvisit [[https://github.com/ohmage/server/​wiki/​Campaign-Definition#​wiki-examples|this page]] ​for examples
-Additionallysome basic knowledge of XML terms and grammar are suggested. A great resource for these is the [[http://www.w3schools.com/xml/default.asp|W3Schools ​page on XML]].+
  
-==== Creating campaign ​XML ==== +== additional resources related to XML == 
-Campaign definition is described in an XML file. description of this XML schema ​is available at the [[https://github.com/cens/ohmageServer/wiki/Campaign-Definition|campaign definition page]]. +  ​* ​XML terms and grammar: ​great resource for these is the [[http://www.w3schools.com/xml/default.asp|W3Schools page on XML]]. 
-  An ppt file on how to create your own xml (Will be available shortly)+  * Text editors: You can get started editing with only a [[http://​en.wikipedia.org/wiki/Text_editor|text editor]], but we'd suggest using a few well-known text editors that can do XML [[http://​en.wikipedia.org/​wiki/​Syntax_highlighting|syntax highlighting]], which will greatly help new users understand the flow of XMLExamples of these editors are:  
 +    Windows: [[http://​notepad-plus-plus.org/​|notepad++]] 
 +    * Mac OS: [[http://​www.barebones.com/​products/​textwrangler/​|Text Wrangler]] 
 +    * On-line XML editors: [[http://​collabedit.com/​]],​ [[http://​www.xslfiddle.net/​]],​ [[http://​icecoder.net/​]]
  
- 
-=== Campaign XML Examples === 
-If you just wanted to get started creating a campaign fast, we recommend that you take one of the following examples as a template, and modify the content where necessary. We leave some comments at the top to help guide you with the modification. ​ 
-  * [[http://​web.ohmage.org/​mobilize/​mzp/​resources/​BirdSighting.xml|Bird Sighting Campaign]]: This campaign demonstrates the use of basic prompt types. 
-  * [[http://​web.ohmage.org/​mobilize/​mzp/​resources/​ShortSnack.xml|Short Snack Campaign]]: This campaign demonstrates the use of basic prompt types with simple conditions. 
- 
-Note: For more advanced campaign, take a look at [[https://​github.com/​ohmage/​server/​wiki/​Campaign-Definition#​wiki-examples|this sample]] for example. ​ 
- 
-=== Uploading campaign XML === 
-After the campaign definition is created, please login to [[https://​lausd.mobilizingcs.org|the Mobilize Web Frontend]], select the campaign tab, then create campaign to upload your campaign. ​ 
 ==== Campaign Authoring Tool (alpha version) ==== ==== Campaign Authoring Tool (alpha version) ====
-[[http://​lausd.mobilizingcs.org/​campaignAuthoringTool|Campaign Authoring Tool]] provides ​GUI for creating a campaign. ​ +[[http://​lausd.mobilizingcs.org/​campaignAuthoringTool|Campaign Authoring Tool]] provides ​an interactive Graphic User Interface (GUIfor the entire ​campaign ​creation process[[https://​wiki.mobilizingcs.org/​app/​authoring|The campaign authoring wiki page]] provides the how-to and tutorial. Please note that the tool is still under development 
- +
-Note: The tool is still in the alpha version+
  
Print/export