Pages Menu
Categories Menu

Posted by on Apr 10, 2015 in Information Management, Mobile Technologies, What's new | 0 comments

An elegy for the LINKS Codebook

An elegy for the LINKS Codebook

It is now almost two years ago when Nafundi announced the release of the free code source book called Task Force LINKS Codebook on their blog. ( ). The tool is extracting questions, answer choices and their coding values out of xml forms coded for use in ODK. At the time, I read the blog post with interest, downloaded the tool, tested it, found it to be working well and then forgot about it again. Well, not immediately, I did use it on the survey we were supporting at the time and whilst the partners did have a look and also thought it was useful, nothing further happened. They did not actively use it and also we did not. I remember sharing my experience with colleagues but also they did not see any further use case at the time.

Last week, I remembered that the tool existed; I was slated for remote support for a SENS nutrition survey; the survey manager being a well-seasoned SENS and MDC specialist, apart from assistance with coding or rather localizing the global questionnaire, it was apparent he would not need further assistance. However he asked me on Skype: “When we did the same survey two years ago, I don’t know exactly which options we used, do you still have the old forms and can you get the questions and answer options out for me?”

links1Now, two years ago, we had not been using xls forms. The calculations we needed had not been supported back then in xls syntax. Now we mostly use xls forms, and of course there it is easy to extract the questions as opposed to extort it of the xml. But even so, getting a quick overview on the questions, their answers choices and how those are coded is also not so straight forward for the novice or non-technical ODK user when looking at the xls form in Excel having to consult several tabs. So I remembered the Code book and decided to use it.

You will need to have Java installed and Runtime set:

For Windows 7:
Start “Control Panel”
Click “Default Programs”
Click “Associate a file type or protocol with a specific program”
Double click .jar.
Browse C:\Program Files\Java\jre7\bin\javaw.exe.
Click the button Open.
Click the button OK

It is then extremely simple: you just double-click on the jar file click on “1. Select form”; and do just exactly as you are bid; i.e. select your xml in the upcoming browser window, then click on “2. Make Codebook”. It will create a codebook in pdf format for every language included in your xml. The pdf is automatically created in the directory where your xml is stored.

The pdf contains three columns: Variable name, Question text and Saved Value, the latter listing the choices and their respective coding values.


One gains immediately a quick overview on the questions and controls used presented in a reader-friendly fashion and which can be easily shared for consultation or refining a questionnaire based on a similar thematic.

I was amazed myself again how fast and effective this tool works.

The survey coordinator as well. I’d like to quote him here: “Thank you so much and surely this will be helpful to me!” (Tiras Nkala, UNHCR survey coordinator)

Post a Reply

Your email address will not be published. Required fields are marked *

🚚 📦 We're moving!

[French below]

The content of the CartoBlog was transferred to the Information Management Resource Portal in May 2021:

Please note that the CartoBlog will be decommissioned in early 2022. From now on, we warmly encourage you to consult the tutorials, benchmarking studies and other resources directly onto the new portal.

Thank you!

🚚 📦 On déménage !

Le contenu du CartoBlog a été transféré sur l’IM Resource Portal en mai 2021 :

Veuillez noter que le CartoBlog sera désactivé au début de l’année 2022. Nous vous invitons, dès à présent, à prendre l’habitude de consulter les tutoriels, benchmarkings et autres ressources directement sur le nouveau portail.

Merci !