Dynamic Survey System (DSS) - create your own survey
From Agnitio WIKI
The "Dynamic Survey System" is a framework offered by Agnitio, allowing content creators to create and update surveys for the Agnitio tools, without needing to re-invent the wheel every time. To start using this functionality, please contact your project manager or your contact at the Creative department, to get access to the foundation framework.
Contents |
Using the DSS
The following describes how to generate your own dynamic survey system (DSS) using the Agnitio Manager and your favorite FTP client. Please make sure that you have been granted the right licenses (originator, approver, sales force, iPlanner) and that you have been provided with a copy of the master version.
The DSS is a dynamic system that can be adapted to your needs without any special computer knowledge. By alternating a XML and CSS file you will be able to create your own questions and answers which will be monitored automatically inside the iPlanner. After synchronizing the data will be stored in our Database and can be used immediately for analyzing. In case you run into any problems please contact support@agnitio.com.
Create your copy - duplicate master survey
If you have been provided with a copy of the master survey, follow the next steps to create your own.
1. Open the browser and go to http://agnitiomanager.com
2. Sign in as originator
3. Duplicate the original presentation and give your copy a name Edit-->Duplicate
Edit the Presentation Content
1. Select the presentation to see its details
2. Find information on FTP host, username and password in the presentation details
3. Download presentation files using your favorite FTP client (e.g. http://filezilla-project.org/download.php?type=client)
Edit the XML
1. Locate the XML files (Survey.xml) which can be alternated in order to change the content of your DSS. Please as well refer to the comments inside the XML file. We recommend Notepad (for windows users) and TextEdit (for mac users) in order to make changes.
The XML is divided into pages (<Page>). One page for each question. There can be as many pages/questions as you like. Please not that is it not possible to combine multiple answer types within one question.
<Page>
<Question>There are some 3 radio questions?</Question>
<Input_type>radio</Input_type>
<Answer>This is option A one...</Answer>
<Answer>This is option A two...</Answer>
<Answer>This is option A three...</Answer>
</Page>
The page contains the questions and answers presented in the survey. The XML can be adapted in order to change dynamic content as following.
- Text on intro screen
- Amount of questions
- Question text
- Answer type (checkbox, radio button, slider, input text)
- Text on outro screen
Change the text inside the intro screen
<Intro_text>I am able to change the text here</Intro_text>
Amount of questions - create pages
<Page>
<Question>Put your question here</Question>
<Input_type>radio</Input_type>
<Answer>Write your answer 1 here</Answer>
<Answer>Write your answer 2 here</Answer>
<Answer>Write your answer 3 here</Answer>
</Page>
Change a questions text
<Question>I can change text here</Question>
Select the type of answer. Choose between checkbox, radio button, slider, input text.
<Input_type>radio</Input_type> <Input_type>checkbox</Input_type> <Input_type>text</Input_type> <Input_type>slider</Input_type>
When choosing the input type radio or checkbox you can choose the amount of boxes by defining the amount of answers. Please note that you should avoid using more than 5 answers for radio buttons and checkboxes, since it cannot be handled by the current design.
<Answer>This is option A...</Answer> <Answer>and this is option B...</Answer> <Answer>or simply choose option C</Answer> <Answer>some answer D</Answer> <Answer>and E</Answer>
When choosing the input type text one input field will be displayed. You can define the default input text by inserting it into the Answer tag. Line breaks inside the default text can be archived by using 
<Page>
<Question>There are some text question?</Question>
<Input_type>text</Input_type>
<Answer>This text disappears when the user starts typing</Answer>
</Page>
When choosing the input type slider you can choose the range of the slider from anywhere between 1-->10, or -5-->+5.
<Page>
<Question>There are some slide (1-7) question?</Question>
<Input_type>slider</Input_type>
<slider>
<from>1</from>
<to>7</to>
</slider>
</Page>
Save the XML file by overwriting the existing and upload it using the FTP client, overwrite existing file.
Edit the CSS
1. Locate the CSS file (QuestionnaireUserStyle.css) which can be alternated in order to change the appearance/design of your DSS. We recommend Notepad (for windows users) and TextEdit (for mac users) in order to make changes.
The CSS mainly points to images which can be adapted including the following
- Background image
- Left and right arrow images
- Background of box in which the question appears
- Style of progress bar
- Color of text in progress bar
The background image - including logo disclaimer etc. (1024x768px)
.Page_Background{ background-image:url('../images/Questionnaire/Xarelto_Background.png');}
Left arrow image active
.Aero_left.on{ background-image:url('../images/Questionnaire/Xarelto_arrow_left_on.png')}
Left arrow image
.Aero_left.on{ background-image:url('../images/Questionnaire/Xarelto_arrow_left_off.png')}
Right arrow image active
.Aero_right.on{ background-image:url('../images/Questionnaire/Xarelto_arrow_right_on.png')}
Right arrow image
.Aero_right.off{ background-image:url('../images/Questionnaire/Xarelto_arrow_right_off.png')}
The background of the box in which the questions appear
.Survey_background{ background-image:url('../images/Questionnaire/Xarelto_Gradient.png');}
The background of the progress bar
.Steps_Progress_Background{ background-image:url('../images/Questionnaire/Xarelto_Steps_Progress.png');}
The background of the progress bar when active
.Steps_Background{ background-image:url('../images/Questionnaire/Xarelto_Steps_Background.png');}
The color of the font in progress bar
.Steps_Progress_Counter{ color: #ffffff;}
Save the CSS file by overwriting the existing and upload it using the FTP client, overwrite existing file.
Approve the Survey
1. Open the browser and go to http://agnitiomanager.com
2. Sign in as originator
3. Select the survey
4. Send it for approval
5. Sign out and sign in as approver
6. Select the survey and approve it
Publish the Survey
1. Sign out and sign in as originator again
2. Select the survey
3. Publish it
Verify the Survey on iPad
1. Launch iPlanner
2. Sign in as sales force
3. Download the survey
4. Start a meeting with the survey
5. Synchronize your meeting data
6. Contact support@agnitio.com and provide the following information in order to receive the link for your analyzer report. You can take a look at an example report here: [1])
- Name and manager ID of survey
- Your manager unit
- Your name
Future updates
We are planning to have the survey alteration available inside the Agnitio Manager. This will make the creation of a survey even more user friendly as you will not need use any FTP program. A production plan will be released soon.
