Nokia Data Gathering Server

8/14/2019 Nokia Data Gathering Server

1/25

Contents

Welcome to Nokia Data Gathering's documentation! 1

I'm ready tostart collecting data 1

Introduction 1

Solution Overview 1

Getting started 2

Survey List 3

Editor 7

Question Types 9

Skip Logic 11

Results 14

Search and Column Filtering 19User Admin 21
https://nokiadatagathering.net/


2/25


3/25

Welcome to Nokia Data Gathering'sdocumentation!

I'm ready to start collecting data

Mailing List, Source Code, Older Releases and Documentation, Windows PhoneDocumentation (.pdf)

Contents:

Introduction

Nokia Data Gathering is a solution that helps organizations to collect field data using mobilephones instead of paper forms, PDAs or laptops. Since mobile phones can send data frommany remote locations, collected data can be transmitted in near real-time for analysis. Thismakes collection of data much faster, more accurate and more cost effective to gatherespecially in remote locations when dealing with critical issues, such as public health,agricultural stock levels, emergency services and alike. The solution consists of two modules,server and mobile phone, to enable smooth information transfer from the surveyadministrators to the field workforce and vice versa. The process includes the creation ofquestionnaires, their delivery to mobile phones and the subsequent integration and analysisof results. Mobile based data collection offers lots of benefits compared to traditional paperand pen based method as well as compared to data collection with help of a PC:

Speed and efficiency: ability to transmit and process time-critical data quickly. The moreremote the location, the greater the improvement

Data accuracy: removes the need for interpretation of hand-written data and potential

mistyping of information when it is transferred from paper to legacy systems

Reduced operating costs: reduces duplication of work (data entry) and removesunnecessary travel. Further the costs of delayed decisions can be considerable.

Reduced environmental impact: minimizes the frequency and need for heavy loadtransportation and carrying papers in and out - especially at remote locations.

Usability: mobile phones as data collection tools are light-weight small devices with longbattery life. Furthermore many of them provide GPS in-build and easier to use than PCswhile standing/on the move.

Compared to other mobile based data collection tools, Nokia Data Gathering offers highusability (easy to use Java and Windows phone based clients), complete end-to-end system

(including mobile and server modules (with integrated survey editor) allowing organizationsto host their own server and have security in the knowledge that the data collected by themwill remain in-house) and ability to graph and map the results.

Solution Overview

How does it work?

You start by creating a questionnaire on a survey editor. Then you deliver the questionnaireto your fieldworkers over a wireless or mobile network. Your fieldworkers use the Nokia DataGathering mobile app on their phones to enter and store responses to the questionnaire and,most importantly, send their results back to the research station, over the mobile network,for instant analysis.

Welcome to Nokia Data Gathering's documentation!

1
http://docs.nokiadatagathering.net/WindowsPhone.pdfhttp://docs.nokiadatagathering.net/WindowsPhone.pdfhttps://projects.developer.nokia.com/ndghttps://github.com/nokiadatagatheringhttps://mailman-mail5.webfaction.com/listinfo/ndg-discusshttps://nokiadatagathering.net/


4/25

Server: The Server Module is used to create and send surveys to mobile phones, receiveinterview results, administer users, questionnaires and responses, map data usingGPS-based data, graph results and export data. The server can receive interview resultsin near real-time, provided the field personnel are within range of a mobile voice or

mobile data network.Additionally, the server can be connected to a GSM modem to send messages and receiveresponses from the mobile phones of the field personnel.

Mobile Phone Application: The Mobile Phone Module is the only part of the system that isvisible to the field personnel. It is the software that appears on their mobile phone,presented as an easy-to-fill questionnaire.

The process with Nokia Data Gathering begins with survey creation, which enables theproduction of tailored questionnaires. The questionnaires can then delivered to the fieldworkforce wirelessly using a normal mobile telecommunications network. Having receivedthe questionnaire(s) on their mobile phones, the field workforce can then use their phones toenter and store the responses to questions. The system also allows to geo-tag data with GPS

location information, providing an additional layer of information and helping to validatedata. Once the information is collected, the solution enables them to send responses backfor instant analysis, again via a mobile network.

Nokia Data Gathering then is used to create and send surveys to mobile devices via HTTP,receive responses, export data to Excel or .csv, administer users, questionnaires andresponses, graphically represent survey results and map real-time GPS-based data. It canalso be used to send sms messages to users and fieldworkers.

Nokia Data Gathering work flow

Getting started

To get started with Nokia Data Gathering, you need to create an account on our PlaygroundServer. To do this, go to the server and fill in the fields shown in the box on the right handside of the screen. Select a username and password, and enter your first name, last name,email address, phone number and company/organization affiliation in the appropriate boxes.Then click the Create Account button.

Getting started

2
http://nokiadatagathering.net/


5/25

The registration form

After you have filled in the requested information and submitted it, a confirmation email willbe sent to the email address you entered. To complete the registration process, you need toclick on the link provided in the email. After your Nokia Data Gathering Playground accounthas been confirmed, you will be able to return to the server and log in with the usernameand password you selected.

NOTE: If you have problems clicking through to the link send in the email, please copy-pastethe URL into your browser. NOTE: You need to enter your phone number in internationalformat (including the country code).

Survey ListThe Nokia Data Gathering server is used to create and make surveys available to registeredusers and their mobile devices. Responses from the users' mobile devices are sent to theserver over the mobile network, a wireless network or a cable connection. The server is alsoused to export data to CSV and Excel formats, administer users, devices, questionnaires andresponses, map real-time GPS-based data, and review results as selected graphics.

After logging in to the server, you will see the list of surveys that are available to you as auser, as in the figure below:

Survey List

3


6/25

Survey List

Each survey will have a SURVEY NAME, DATE, PUBLISHER and the number of RESULTSthat have been sent back for that particular survey. If there are responses received for aparticular survey, then the number of responses will appear as a clickable a link to theResults page, from which you can view the received responses.

You can filter the surveys by clicking on either Building for surveys that are still in theprocess of being created or built, Available for those that have been made available tousers or All to show all surveys irrespective of state.

Survey Filter to show only surveys currently being built

To return to the default list, which shows all surveys (i.e to turn off the filter) click the redhighlighted text.

To send a survey to a device, you need to make it Available by clicking on Send and thenchoosing a user (this is different from previous versions of Nokia Data Gathering wheresurveys needed to be explicity made Available in the editor) . After a survey is madeAvailable it can no longer be edited. It can however be duplicated and then edited again. Todo this click the duplicate icon on the survey toolbar.

Duplicate a survey

Survey List

4


7/25

The new duplicated survey can be edited and saved as needed until it is sent to a device.Then its Building status will change to Available and no further editing is allowed. Such aprocess is an easy way to implement simple version control for surveys.

Other functions available in the survey toolbar are (in order) Download, Upload, Send,

Edit and Delete.

Clicking Download opens a browser File Save dialog and the raw survey xml can be saved.This is a useful function if for example the survey can only be passed onto a device usingUSB or bluetooth as may be the case if no cellular network is available.

Download a survey

Upload is the same process but in reverse and is only available when Building surveys.When a survey is uploaded by a user it will appear in the servers main admin user surveylist.

Survey List

5


8/25

Survey Upload dialog box

and is a useful function if for example a user has an existing survey created using anotherOpen Rosa compatible survey builder that they wish to use with Nokia Data Gathering.

Clicking Send presents a list of Users and Groups with their corresponding telephonenumbers

Send Survey dialog with User and Group Names and Phone Numbers

select the check box next to the Username and then the Done button to send the survey tothat user. Clicking the select box next to a Group name will show all users in that Group whocan then be selected as before. Clicking the select box next to the Username header selectsall users or offers the option to select all if some are not currently visible in the window

Select All Users

The final button on the survey toolbar is Edit and clicking this on a survey in the Buildingstate shows the Editor which is integrated in Nokia Data Gathering. If rather than editing anexisting survey you would like to create a new one click the plus + icon

Survey List

6


9/25

Survey Creation

Editor

A new or existing survey has a name which can be clicked to edit and any number ofcategories and questions. Actually adding categories and questions is done by dragging fromthe C+ (Drag to add new category) and Q+ (Drag to add new question) buttons.

A new category being dragged into a survey

drop either above or below existing categories and the new category will appear. Click thename to edit

Editor

7


10/25

Click category name to edit

then drag the new question plus + button to add a question. Drop it below a Category

A new question being dragged into a survey

then click the new question text to edit the question you would like to ask.

Clicking the question text will open out into the Question Types toolbar

The Questions Toolbar

Surveys can be saved either implicitly by going back to the Survey List page

Editor

8


11/25

Back to Survey List

or explicitly by clicking the save icon.

Question Types

Nine question types are currently implemented. All of the questions can be made required or

not by checking the Required check box (as seen for example on the Location question typebelow)

Question Types

1. Descriptive

Descriptive questions are used for text type questions. Click on the text to edit the questionitself. A default and maximum length can be added

2. Exclusive Choice

Exclusive Choice questions are used when there is one unique answer. They can be used toSkip Logic questions based on their responses. Click on the text to edit the question itself.New options can be added by clicking the plus button. Multiple options can be added byuploading a single column excel sheet with one option per line by selecting the import

Question Types

9


12/25

button.

3. Multiple Choice

Multiple Choice questions are used for questions with many possible answers. New optionscan be added by clicking the plus button. Multiple options can be added by uploading asingle column excel sheet with one option per line by selecting the import button

4. Image

Image questions are used when the response should be an image. Click on the text to editthe question itself.

5. Date

Date questions are used for date questions. Click on the text to edit the question itself. Adefault date can be chosen as well as a range specified

Clicking on the calendar symbol allows date to be chosen

6. Decimal

Decimal questions are used when the answer should be a decimal. Click on the text to editthe question itself. A default and a maximum and minimum can be added

Question Types

10


13/25

7. Integer

Integer questions are used when the answer should be a whole number. Click on the text toedit the question itself. A default and maximum length can be added

8. Time

Time questions are used for time type questions. Click on the text to edit the question itself.A default can be added. Use the up/down arrows to scroll hours, minutes and seconds.

9. Location

This will take a GPS reading and attach it to the question

Skip LogicSkip Logic which is also called relevance is a way to make a question be skipped based onthe value of another question.

The best way to explain how this works is through an example which is taken from theXForms Training Materials Suppose we only want to ask the question 'Are you pregnant?' ifthe sex of the patient is female. In the Editor create a survey with an exclusive choicequestion, the 'Are you pregnant' question and another random question which allrespondents can answer. They do not need to be in separate categories but are shown thisway for clarity.

Skip Logic

11
https://bitbucket.org/javarosa/javarosa/wiki/buildxforms


14/25

Skip Logic creation in the survey editor

Hovering next to the available options in the exclusive choice question makes an arrowappear.

This arrow can now be dragged and dropped on the question to be skipped to if this answeroption is selected

Skip Logic

12


15/25

Arrows can be dragged to represent skip logic relationships

The relationship is then visually represented by a change in the arrow color on the exclusivechoice option

Skip Logic realtionship represented by a change in arrow color

Anyone now answering 'Male' to the Sex of the Patient exclusive choice question will now notbe able to answer the question 'Are you pregnant'.

Skip Logic

13

16/25

Males will still be able to see the question but it will be greyed out and they will be unable toanswer it.

Technical Details

In the actual survey XML the binding is added to the question that is conditionally skipped,not the question whose answer decides whether the other question is skipped. This is animportant distinction that can be confusing. For example, here is the bind for the previousexample.

which means bind the question3539 in category8978 to the answer 'Female' of questionquestion9730 in the category5824.

Here is the full commented survey XML for the skip logic example< ? x m l v e r s i o n = ' 1 . 0 ' ? > < h : h t m l x m l n s = " h t t p : / / w w w . w 3 . o r g / 2 0 0 2 / x f o r m s " x m l n s : h = " h t t p : / / w w w . w 3 . o r g / 1 9 9 9 / x h t m l " x m l n s : e v = " h t t p : / / w w w . w 3 . o r g / 2 0 0 1 / x m l - e v e n t s " x m l n s : x s d = " h t t p : / / w w w . w 3 . o r g / 2 0 0 1 / X M L S c h e m a " x m l n s : j r = " h t t p : / / o p e n r o s a . o r g / j a v a r o s a " >< h : h e a d > < h : t i t l e >S k i p L o g i c E x a m p l e < / h : t i t l e > < m o d e l > < ! - - t h e X M L i n s i d e h e r e i s w h a t g e t s f i l l e d o u t a n d s u b m i t t e d w h e n y o u c o m p l e t e t h e f o r m - - > < d a t a i d =" j e j 6 i s a 7 " > < c a t e g o r y 5 8 2 4 > < q u e s t i o n 9 7 3 0 > < / q u e s t i o n 9 7 3 0 > < / c a t e g o r y 5 8 2 4 > < c a t e g o r y 8 9 7 8 > < q u e s t i o n 3 5 3 9 > < / q u e s t i o n 3 5 3 9 > < / c a t e g o r y 8 9 7 8 > < c a t e g o r y 7 2 3 3 > < q u e s t i o n 5 6 9 6 > < / q u e s t i o n 5 6 9 6 > < / c a t e g o r y 7 2 3 3 > < / d a t a > < t r a n s l a t i o nl a n g = " e n g " > < t e x t i d =" / d a t a / c a t e g o r y 5 8 2 4 : l a b e l " > < v a l u e >F i r s t C a t e g o r y < / v a l u e > < / t e x t > < t e x t i d =" / d a t a / c a t e g o r y 5 8 2 4 / q u e s t i o n 9 7 3 0 : l a b e l " > < v a l u e >S e x o f t h e P a t i e n t < / v a l u e > < / t e x t > < t e x t i d =" / d a t a / c a t e g o r y 5 8 2 4 / q u e s t i o n 9 7 3 0 : o p t i o n m a l e " > < v a l u e >M a l e < / v a l u e > < / t e x t > < t e x t i d =" / d a t a / c a t e g o r y 5 8 2 4 / q u e s t i o n 9 7 3 0 : o p t i o n f e m a l e " > < v a l u e >F e m a l e < / v a l u e > < / t e x t > < t e x t i d =" / d a t a / c a t e g o r y 8 9 7 8 : l a b e l " >

< v a l u e >S e c o n d C a t e g o r y < / v a l u e > < / t e x t > < t e x t i d =" / d a t a / c a t e g o r y 8 9 7 8 / q u e s t i o n 3 5 3 9 : l a b e l " > < v a l u e >A r e y o u p r e g n a n t ( j u s t f e m a l e s c a n a n s w e r ) < / v a l u e > < / t e x t > < t e x t i d =" / d a t a / c a t e g o r y 7 2 3 3 : l a b e l " > < v a l u e >T h i r d C a t e g o r y < / v a l u e > < / t e x t > < t e x t i d =" / d a t a / c a t e g o r y 7 2 3 3 / q u e s t i o n 5 6 9 6 : l a b e l " > < v a l u e >M a l e s a n d F e m a l e s c a n a n s w e r t h i s < / v a l u e > < / t e x t > < / t r a n s l a t i o n > < ! - - b i n d s a l l o w u s t o a d d p r o p e r t i e s t o t h e q u e s t i o n s , l i k e d a t a t y p e s , s k i p l o g i c , c o n s t r a i n t s e t c . - - > < b i n d n o d e s e t = " / d a t a / c a t e g o r y 8 9 7 8 / q u e s t i o n 3 5 3 9 " t y p e = " s t r i n g " r e l e v a n t = " / d a t a / c a t e g o r y 5 8 2 4 / q u e s t i o n 9 7 3 0 = ' f e m a l e ' " / > < / m o d e l >< / h : h e a d >< h : b o d y > < ! - - T h i s i s w h e r e w e d e f i n e t h e q u e s t i o n s t h a t t h e u s e r w i l l f i l l o u t - - > < g r o u p > < l a b e lr e f = " j r : i t e x t ( ' / d a t a / c a t e g o r y 5 8 2 4 : l a b e l ' ) " / > < s e l e c t 1r e f = " / d a t a / c a t e g o r y 5 8 2 4 / q u e s t i o n 9 7 3 0 " > < l a b e lr e f = " j r : i t e x t ( ' / d a t a / c a t e g o r y 5 8 2 4 / q u e s t i o n 9 7 3 0 : l a b e l ' ) " / > < l a b e lr e f = " j r : i t e x t ( ' / d a t a / c a t e g o r y 5 8 2 4 / q u e s t i o n 9 7 3 0 : o p t i o n m a l e ' ) " / > < v a l u e >m a l e < / v a l u e > < l a b e lr e f = " j r : i t e x t ( ' / d a t a / c a t e g o r y 5 8 2 4 / q u e s t i o n 9 7 3 0 : o p t i o n f e m a l e ' ) " / > < v a l u e >f e m a l e < / v a l u e > < / s e l e c t 1 >

< / g r o u p > < g r o u p > < l a b e lr e f = " j r : i t e x t ( ' / d a t a / c a t e g o r y 8 9 7 8 : l a b e l ' ) " / > < l a b e lr e f = " j r : i t e x t ( ' / d a t a / c a t e g o r y 8 9 7 8 / q u e s t i o n 3 5 3 9 : l a b e l ' ) " / > < / g r o u p > < g r o u p > < l a b e lr e f = " j r : i t e x t ( ' / d a t a / c a t e g o r y 7 2 3 3 : l a b e l ' ) " / > < l a b e lr e f = " j r : i t e x t ( ' / d a t a / c a t e g o r y 7 2 3 3 / q u e s t i o n 5 6 9 6 : l a b e l ' ) " / > < / g r o u p >< / h : b o d y >< / h : h t m l >

Results

Clicking on the number of results link on the Survey List page shows the Results List page

Results

14


17/25

with the Result Title, Date Sent, User and Location information displayed. Clicking the selectbox next to the Result Title selects all results

and clicking again deselects all. Results can also be selected individually and then previewedby clicking the preview icon

Results

15


18/25

This preview functionality is also available on the map by clicking on the points of interest

Once the required set are chosen can either be exported (to either Excel or KML) or can berepresented visually. If results in the selected set have images then a dialogue is presentedwhen exporting to Excel

Export results with images

Rather than manually exporting, results can be exported automatically using the schedulebutton. This presents options to select the date from and to and also an email address tosend the export. Any results then collected for that particular survey during those the dateswill be sent as an attachement to the email

Results

16


19/25

Scheduler Options

Selecting the Graph View button shows the Survey Name along with a list of all the questionsin the survey. Exclusive choice type questions have a link to represent the selected results

as a Pie Chart and Integer type questions have a link to represent the selected results as aBar chart.

Graphing Options

Clicking Bar Chart for example will show a bar chart with the total Number of Answers as they axis and the question on the x

Results

17


20/25

How many times do you laugh per day?

along with buttons to save or view the generated image.Clicking Pie Chart will show a piechart with the questions represented as colors with a legend embedded

Are you a talker, thinker or doer

again with the same buttons to save or view the image.

Selecting Map View will display a map with the location of survey responses. Clicking on theicon will show information about the response returned from that location. The map can bepanned and zoomed or displayed in either the default or satellite/terrain. Clicking on thepoints displays a preview of that result

Results

18


21/25

Search and Column Filtering

Search is both contextual and dynamic. This means that different search options arepresented depending on whether you are in the Survey List, User Admin or Results

Searching for Surveys

The above image shows that surveys can be search for using ID, Name or Publisher.Selecting Survey Name from the drop down and 't' in the search box will filter all SurveyNames with 't' as seen below


19


22/25

Contextual Survey Search

The same principle applies when searching Results for Title, User, Date Sent or Location(lat/long)

Search Results by Location

and when searching Users for Name, E-mail or Phone Number. The Survey List, User Adminor Results columns can also be sorted and this is done by clicking to the side of the columnto be filtered. A small black arrow will be displayed to indicate the direction of the sorting. In

the image below we are sorting surveys by the number of Results


20


23/25

User Admin

The User Admin is accessed by clicking the link to the User Admin on the Survey List page.

User Admin Link

which presents all the users and groups which belong to the currently logged in user. BothUsers and Groups are added by dragging the plus button

Drag plus button into Group column

and dropping on the Group column which causes a dialogue to open where the group namecan be added

Drop on Group Column

User Admin

21


24/25

Adding Users functions the same way, dropping the 'plus' button on the Users column

Adding a user

and the dialogue asks for a user name, password and a phone number. It is also possible to

choose the permissions which will be assigned to the user.

Both Users and Groups can be deleted by using the toolbar and it is also possible to sendsms messages to users and to all members of the group

Sending all members of a group an SMS message

Information about a user can be edited by selecting the edit button

User Admin

22


25/25

Editing a users details

which presents options to edit the user details (everything apart from the user name can beedited)

Edit options

User Admin

23

Nokia Data Gathering Server

Documents