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.
- Go to the controls tab and click on one of the question type categories, you want to add from.

- Drag and drop the question type into the survey 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.

- 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.

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:
- Click on the icon (
) in the upper left corner of the Dashboard screen, and then click Question Bank. - Click New Question from upper side of screen.

2. Choose question type.

- Fill the Question’s attributes as we filled it in Survey Controls.
- Click Save to add the question.
- 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:
- Navigate to the page where you desire to move the question/s from it.
- Click on more action icon (
) from the top right of the page as in image below, then click on move questions.

- 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

- 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.
- Click on more action icon (
) from the top right of the page as in image below, then click on New Page.

How to add reorder survey pages
To reorder survey pages, do the following:
- Click on more action icon (
) from the top right of the page as in image below, then click on Sort Pages.

- a popup window will appear, reorder pages by drag and drop move, then click on close.

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.
- Click Save from the upper screen to save the last changes on the Builder page.

- If there is some error in the survey, the following screen will appear.
- Click More Details to fix errors.

4. Click Fix then click Close.

- Click Save.
- Click Preview to show the survey.

- Change the language by clicking (
) from the upper screen. - Change the way of viewing the survey by clicking (
) from the right side of the screen.
- 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:
- Click on Question Bank.
- Choose any list of categories.
- Add a question by drag-drop move.

- 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.

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

A popup screen will appear that represent the hint.

How to change question default mandatory option
From the Builder page, open the edit popup to any control you want then choose mandatory options.

- 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.

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.

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

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

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

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

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.

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.

How to add questions in a grid
To add questions in a grid, do the following:
- Click on add icon (
) from edit grid page.

- Select the question type, then click Save.

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.

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.

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.

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.


- 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:
- Click on edit icon in any multi answer question.

- Select Random answers checkbox.

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.

How to change question answers code (value)
After open edit page, change the answer value

- 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.

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