====== Surveys list ======

In the Surveys list you can create your surveys. The other sections of the Surveys window belong to a survey in the Surveys list and refresh when another item is selected in this list.

The Surveys list has the following fields:

^Field           ^Description ^
|**Code**       |Text field by which the survey is identified by the system. It has to be unique for each survey except for placement test type surveys.\\ In case of placement tests surveys: surveys for the different course subject can have the same code. During the placement process the student is able to select the course subject and the appropriate survey will be presented to the student.| 
|**Title**     |[[en:intro:glossary#multilingual_names|Multilingual title]] of the survey. Click on this field and edit its translations in the [[:en:staff:settings:surveys:translations_window|Translations window]].|
|**Type**     |Surveys can have the following types:\\ __Course requirements__ is used to add standardized extra information to a course, which can appear in a [[en:staff:courses:survey|Survey window]] of the [[en:staff:courses:start|Courses tab]].\\ __Customer data__ is used to add standardized extra information to a customer, which can be edited in the [[en:staff:customers:settings#survey_window|Survey window]] of the [[en:staff:customers:start|Customers tab]]\\ __Feedback request__ is used to get feedback from students on a course. The feedback can be requested in an email using the {{:thumb_up.png?nolink}} //Feedback request// button in the header of the [[en:staff:courses:students|Students window]] in the [[en:staff:courses:start|Courses tab]] or by defining and publishing a URL (see [[#set_survey_link|Set survey link]]).\\ __Lesson observation__ is used to assess teachers by filling out a survey about the findings.\\ __Placement test__ is used to assess students' knowledge level. Define and publish a URL to make this survey available to them (see [[#set_survey_link|Set survey link]]).|

Use the {{:add.png?nolink}} {{:edit.png?nolink}} {{:remove.png?nolink}} {{:save.png?nolink}}  {{:refresh.png?nolink}} buttons on the toolbar at the bottom of the list to [[en:intro:ui#list_editing|edit the data in the list]].

The {{:view.png?nolink}} in the toolbar can be used to preview the selected survey.

Use the {{:link.png?nolink}} //Link// button to create a URL to make the survey available to the public. Clicking on this URL starts the survey for the user and collects its data. This feature is currently used for surveys with a type of //Feedback request// or //Placement test//. The filled in responses are collected in the Feedback and Applications branches of the [[en:staff:inbox|Inbox tab]].

===== Survey properties =====

The //Survey parameters// section is only displayed for //Placement test// surveys (and not for the other types).

The Properties section has the following fields:

^Field^Description^
|**Course type**       |Course type of the placement test|
|**Course subject**       |Course subject of the placement test|
|**Max. level**       |The student's level if all answers are filled in with maximum score|

The placement test is automatically evaluated and the reached level is automatically assigned to the test. The reached level can be calculated in 2 ways: a) either the //Max. level// parameter is defined (see above) or the //Scores list// is filled in (this overrides the //Max. level// setting). If the //Max. level// property is used then the levels are evenly assigned between the initial and the //Max. level// according to the score (the score difference between adjacent levels is the same). Using the Scores list the score for each level can be set individually.

^Field^Description^
|**Start score**       |Inclusive start score for the level|
|**End score**       |Exclusive end score for the level (should be the same as the start score of the next level)|
|**Level**       |Level reached if score is more or equal to the //Start score// and less than the //End score//.|
===== Set survey link =====

In the //Set survey link window// you can set parameters for //placement test// and //feedback request// type surveys that you want to display to the public. By setting these parameters additional information will be displayed and requested before and after the survey pages from students. The generated URL can be published to the students by placing the link on your web site or by sending this link to the students by email.

The window consists of the Saved links window and the Parameters section.

==== Saved links list ====

In the //Saved links window// use the {{:add.png?nolink}} {{:remove.png?nolink}} and {{:refresh.png?nolink}} buttons to create a name for the set parameters. The saved parameter set can be updated by selecting an item in the list and then clicking on the {{:save.png?nolink}} //Save link// button.

==== Link parameters ====

Links have the following parameters:

^ Field   ^ Description    ^       
|**Default user interface**   | __Language:__ Select the default language of the survey. The student will be able to change this setting while filling in the survey.\\ __Inline / popup:__ Choose inline if the survey should expand the whole space available in the browser window. Choose Popup to display the survey in a popup window in the browser.\\ __Formal speach:__ Check if formal speech is to be used in the survey.| 
| **Displayed student fields**   | Select the student fields that should be displayed to the student in the beginning of the survey and for which input is required.|
| **Displayed student application fields**   | Select the application fields that should be displayed to the student in the beginning of the survey:\\ __Availability:__ Week calendar where the student can select the days and times he/she wants to study.\\ __Comments:__ comments field\\ __Company:__ name of the company that sponsors the study. This field can also have a predefined value, see //Default company// below. \\ __Course type:__ Students can choose from the default course types the type they want to attend. \\ __Intensity:__ Preferred course intensities chosen from [[en:staff:settings:intensities|the predefined course intensities]]. \\ __Lessons:__ Preferred course length chosen from [[en:staff:settings:lesson_counts|the predefined course lesson counts]].\\ __Location:__ Selectable locations chosen from [[en:staff:settings:locations|the predefined locations]]\\ __Start date:__ Date range for the preferred course start.\\ __Type:__ Preferred cost center of the course chosen from [[en:staff:settings:cost_centers|the predefined cost centers]].\\ __Subject:__ Course subject that belongs to the selected course type.|
| **Visible sections**   | Choose which of the following sections should be displayed during student application:\\ __Written test:__ If checked a page asking the student whether he/she wants to fill in the survey is displayed followed by the survey's pages with the questions. If it is not checked then the survey can be simply used to collect the student's personal data.\\ __Spokent test:__ If checked a page is displayed after the written test with available dates and times for spoken placement tests. The available times are defined by teachers who can perform placement tests in their calendar as //Available time// The selected time will be scheduled in the teacher's calendar.\\ __Course selection:__ A list of courses the applicant select from that match the knowledge level of the the written test's result and the criterion selected below. |
| **Selectable course status**   | //Course state// filter for the courses that are displayed when the //Course selection section// is displayed.|
| **Selectable course types**   | Only the selected //Course type// and //Course subject// values will be displayed for these //Displayed student application fields//.|
| **Selectable cost centers**   | Only the selected //Cost center// values will be displayed for the Type field (see //Displayed student application fields//).|
| **Selectable locations**   | Only the selected //Location// values will be displayed for the //Location field// (see //Displayed student application fields//).|
| **Default company**   | Enter the student's company name here. This will be displayed in the survey (if this student application field is displayed) and the incoming application, so you can easily identify the applications belonging to the same company upon receipt.|
| **Notification email**   |Select the [[:en:staff:settings:templates:start|email template]] from the drop-down menu that the student should receive when he reaches the last page of the application.|
| **Customer policy to approve**   | Select the customer policy students need to approve before filling in the survey. You can choose from the Policy web addresses that is filled in for the customers in the their Customer data window. Note: selecting this option is useful if you send this survey to only the customer whose policy you select here.| 
|**School**   | Select here the [[:en:staff:settings:schools|school]] to which the filled in survey should belong to.|
| **Link**   | This window contains the URL of the survey. The set parameters are encoded in the URL thus when the parameters are changed the URL is automatically updated. When done, copy (or save) and use this link to reference the survey.|