rapidsms-xforms 0.4.1

rapidsms-xforms

The RapidSMS xforms application provides an interactive web based form builder. Created forms support data being submitted to them via freehand formatted SMS, standard XForm HTTP posts or structured SMS. Applications can choose to use xforms to quickly prototype systems, or even use them as their primary interface, using Django signals to perform more complicated logic on new submissions.

Distinct features

• Interactive Web UI to build Forms

• Flexible constraint architecture to allow for validation of inputs with customized error messaging

• Ability to submit forms either via hand entered SMS’s or via HTTP Posts in XForm format

• Display of submitted forms and editing of values by admin

• Signal architecture to allow you to plug in your own handler for submitted forms

• Integration with ODK Collect, an Android XForms client

The full documentation can be found at:

http://readthedocs.org/docs/rapidsms-xforms/en/latest/

The official source code repository is:

http://www.github.com/nyaruka/rapidsms-xforms

A little video showing this app in use:

http://www.youtube.com/watch?v=PyjEruT5uoU

Built by Nyaruka Ltd under contract of UNICEF:

http://www.nyaruka.com

You may want to check the history for list of changes for each version:

http://github.com/nyaruka/rapidsms-xforms/blob/master/CHANGES.rst

Installation From Cheese Shop

You can install the latest version of the rapidsms-xforms library straight from the cheese shop:

% pip install rapidsms-xforms

You’ll also need to install django-eav from GitHub, which isn’t in PyPi just yet:

% pip install -e git+http://github.com/mvpdev/django-eav.git#egg=django-eav

Installation From Github

You can always get the latest version of rapidsms-xforms from github. Note that the tip of the repo is not guaranteed to be stable. You should use the verison available via pip unless you have a specific reason not to.

You can install the requirements using the pip-requires.txt file:

% pip install -r pip-requires.txt

Configuration

To enable XForms for your project, edit your settings.py to add rapidsms_xforms, eav, django_digest and uni_form:

INSTALLED_APPS = ( "rapidsms",
                     .. other apps ..
                   "eav",
                   "uni_form",
                   "django_digest",
                   "rapidsms_xforms" )

You will probably also want to add XForms as one of the main RapidSMS tabs:

RAPIDSMS_TABS = [
  ('rapidsms.views.dashboard', 'Dashboard'),
      .. other tabs ..
  ('xforms', 'XForms')
]

While you are in settings.py might as well change your LOGIN_URL to match RapidSMS’s:

# set our login url to match RapidSMS's url patterns
LOGIN_URL = "/account/login"

Finally, include the XForms urls in your project’s urls.py:

urlpatterns = patterns('',
   .. other url patterns ..
   ('', include('rapidsms_xforms.urls'))
)

If you are going to use XForms with ODK Collect or another XForms client, you need to specify your host in you settings as well:

XFORMS_HOST = 'www.rapidsms-server.com'

Finally sync your database with:

% python manage.py syncdb

Once you restart RapidSMS a new tab will created letting you create, manage and view forms and their submissions.

survey +age 10 +name emily
survey + age 30   +name monty python
survey +name eric +age 15.4