USER GUIDE

Home / Al-Khawarzmi Designer / Build survey

Build survey

How to add a question / control

After adding the first page to your survey, you can start adding questions / controls to your survey, Al-Khawarizmi has different types of questions / controls that can be added easily.

  1. Go to the controls tab and click on one of the question type categories, you want to add from.
Figure 23 : Builder page
  1. Drag and drop the question type into the survey page.
Figure 24 : Builder page

How to edit question / control

to edit question / control, click on question’s edit icon () to open edit screen.

How to duplicate a question

To duplicate a question click on duplicate icon () from Builder page.

INFO
  • Once you duplicated the question you must edit the new one to give the new question a unique code.

How to delete a question

To delete question, click on delete icon () from Builder page.

INFO

If the question is part of a condition in a rule, then you cannot delete it until you delete the related rule.

And if the question part of the actions, then will be excluded automatically with the need to delete the rule.

How to add question to question bank

To add new question to category, do the following:

  1. Click on the icon () in the upper left corner of the Dashboard screen, and then click Question Bank.
  2. Click New Question from upper side of screen.
Figure 25 : New Questions Screen

2. Choose question type.

Figure 26 : Adding New Questions Screen
  1. Fill the Question’s attributes as we filled it in Survey Controls.
  2. Click Save to add the question.
WARNING
  • Category field is mandatory.
  • New tag field: It is used to make it easier to distinguish between questions.
  • Version field is optional.

How to move question within same page

To move question within same page, click on move icon () then by drag and drop move the question to the required place on the same page.

How to move question or control from page to page

To move question or control from page to page, do the following:

  1. Navigate to the page where you desire to move the question/s from it.
  2. Click on more action icon () from the top right of the page as in image below, then click on move questions.
Figure 27 : Move questions
  1. a popup window will appear, choose the destination page from the drop-down list on the top right, then drag and drop the question you need to move in the right box in the place you want
Figure 28 : Move questions
  1. click on Save to save changes.

How to add new page

After filling out the Configuration information of your survey, you will be directed to the Builder page, where you can start adding pages.

  1. Click on more action icon () from the top right of the page as in image below, then click on New Page.
Figure 29 : Adding new page

How to add reorder survey pages

To reorder survey pages, do the following:

  1. Click on more action icon () from the top right of the page as in image below, then click on Sort Pages.
Figure 30 : Sort pages
  1. a popup window will appear, reorder pages by drag and drop move, then click on close.
Figure 31 : Sort pages

How to preview survey

While designing your survey, where ever you are in build screen, logic screen or design screen you can save a preview you survey to check the survey and answer the questions, try the business rules or preview the design and style.

  1. Click Save from the upper screen to save the last changes on the Builder page.
Figure 32 : Save Button
  1. If there is some error in the survey, the following screen will appear.
  2. Click More Details to fix errors.
Figure 33 : Error Message in Your Survey

4. Click Fix then click Close.

Figure 34 : Fixing Survey Error
  1. Click Save.
  2. Click Preview to show the survey.
Figure 35 : Preview Survey Screen
  1. Change the language by clicking () from the upper screen.
  2. Change the way of viewing the survey by clicking () from the right side of the screen.
TIP
  • In the preview survey mode, you can answer questions and move through the pages of your survey the same way your respondents would with a real link.

How to add question from question bank

To add question from question bank in builder page, do the following:

  1. Click on Question Bank.
  2. Choose any list of categories.
  3. Add a question by drag-drop move.
Figure 36 : Question bank
INFO
  • you use the search box to find a specific question by question description or to search for the Tag.
  • when you click on a tag, all related question appears with ability to choose one question or drag and drop the whole list of questions related to this tag

How to add hint to question

From the Builder page, open the edit popup to any control you want to add hint then write the hint.

Figure 37 : Hint

The example below represents a preview screen, to show the hint click on () next to the question.

Figure 38 : Preview screen

A popup screen will appear that represent the hint.

Figure 39 : Preview screen

How to change question default mandatory option

From the Builder page, open the edit popup to any control you want then choose mandatory options.

Figure 38 : Mandatory options
INFO
  • Mandatory options:
    • Not Required: The answer of the field does not affect the work of the submit nor the transition between pages.
    • Required: The field’s answer affects the work of submit and the transition between pages.
    • Required for completion: It affects the work of the submit but does not affect the navigation between pages.

How to change merge / unmerge cell in matrix

After adding custom matrix to your survey, Alkhawarizmi provides ability to merge / unmerge cells.

Firstly, select the cells that will merge / unmerge, then click on merge cells or unmerge cells.

How to add / delete rows and columns in matrix

After adding the matrix to the builder page, then open the edit matrix screen, click on the green icon to add or the red one to delete.

Figure 39 : Edit matrix popup

How to add labels in matrix cells

After adding the matrix to the builder page, then open the edit matrix screen, click on the edit icon () on the cell that you want to add a label on it.

Figure 40 : Edit matrix popup

Choose the type of the cell (text or question), then add Arabic and English description.

Figure 41 : Edit matrix popup

How to other options in matrix key column

To make the last cell in matrix column editable, click on check box other field

Figure 42 : Edit matrix popup

How to check matrix validity

To check matrix validity, click on Show Invalid Cells from Edit Matrix screen.

Figure 43 : Check matrix validity

A pop up screen will appear that shows valid and invalid cells in matrix.

Figure 44 : Check matrix validity

How to restrict add / delete row option in grid

From edit grid screen, click on Hide Add Button checkbox or Hide Delete Button checkbox then click on Save.

Figure 45 : Hide add / delete button in grid

How to add questions in matrix

From edit matrix screen, click on edit icon () on the cell you want to add question to it.

choose Question as type of the cell, then select question type.

Figure 46 : Adding questions in matrix

How to add questions in a grid

To add questions in a grid, do the following:

  1. Click on add icon () from edit grid page.
Figure 47 : Adding questions in grid
  1. Select the question type, then click Save.
Figure 48 : Adding questions in grid

How to add default value for a question

We can add default value for the question as check box, check box list, drop down list, and radio.

To add default value, open edit page then click on Default Answer check box, and choose the default answer.

Figure 49 : Adding default value for a question

How to change answers sequence in a question

Alkhawarizmi provides ability to change the answers sequence in questions such as Radio and checkbox list question, this process is done by click on () then drag and drop answer to required place.

Or by changing the sequence number beside each answer and the sequence and visual order will automatically change by the new values.

Figure 50 : changing answers sequence in a question

How to upload answers from excel to a question

Open edit page, then click on Upload Excel File, then choose the excel file that contains the answers.

Figure 51 : uploading answers from excel to a question
INFO

We have a pre-defined template contains all necessary fields and you need to download it and fill your answer in it then upload it again.

How to add bulk answers to a question

Open edit page, then click on Bulk Answers, then write the answers.

Figure 52 ; Adding bulk answers
Figure 53 : Adding bulk answers
INFO
  • Every line represents an answer so when you click enter to the new line then it means you added a new answer

How to add randomize answers feature

Random answers: each time the survey is opened, the option’s order will appear differently.

to add randomize answer feature on a multi answer question, do the following:

  1. Click on edit icon in any multi answer question.
Figure 54 : Adding randomize answer
  1. Select Random answers checkbox.
Figure 55 : Adding randomize answer

How to add other option with free text box

We can add other option with free text box in questions as check box, radio, and drop down list.

After open edit page, click on Other Field check box.

Figure 56 : Adding other option with free text box

How to change question answers code (value)

After open edit page, change the answer value

Figure 57 : Changing question answers code
INFO
  • The value of each answer represents the answer saved on the database tables of the survey, and not allowed to duplicate any value.

How to edit survey for a specific collection mode

From Modes page, click on () icon then click on Edit.

Figure 58 : Editing survey for a specific collection mode

Builder, Logic and Design will display a DDL with Collection mode to edit each one individually.

Figure 59 : Editing survey for a specific collection mode