edubase_post_exam_settings
Adjust individual exam settings such as grading, time limits, result visibility, and export options to control test behavior and reporting.
Instructions
Change individual settings of an exam. The columns of the export (every setting from export_stats on) cannot be configured for surveys, only the export_format and the export_sort settings are available for them. The export_attendance setting is read only, the attendance is configured together with its source on the interface.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| exam | Yes | exam identification string | |
| archive | No | allow archiving the users who already have a result, only available for the managers of the exam | |
| grading | No | grading of the exam, the code of a grading preset (see edubase_get_quiz_grading_presets), "none" to disable grading, or "default" to use the setting of the Quiz set, not available for surveys as they are never graded | |
| pausable | No | allow tests to be paused and continued later during the exam period, only available for non-blocking exams and always true for homeworks, cannot be disabled when some tests are currently paused, automatically disabled when nonblocking is disabled | |
| roundtime | No | time limit of a single question in seconds, overriding the setting of the Quiz set, only available for turn based (TURNS mode) Quiz sets. Accepts a number or a numeric string, 0 if there is no time limit, or "default" if the setting of the Quiz set should be used | |
| timelimit | No | time limit of the whole test in seconds, overriding the setting of the Quiz set. Accepts a number or a numeric string, 0 if there is no time limit, or "default" if the setting of the Quiz set should be used | |
| hide_grade | No | hide the grade on the results page, can only be enabled together with hide_points, always enabled with the none type | |
| export_sort | No | ordering of the examinees in the exported results file (default: the same order they are listed in on the users page of the exam, name: by the name of the examinees), default: default | |
| hide_points | No | hide the points during the test and on the results page, always enabled with the none type | |
| nonblocking | No | exam accounts are exclusively assigned to the exam and cannot be assigned to other exams during the exam period, always true for homeworks and surveys, cannot be disabled when the exam already has results or when some tests are currently paused | |
| export_stats | No | export the statistics of every question, not available for surveys (default: false) | |
| freeze_round | No | freeze the current round of the exam, so the Quiz set cannot be replaced and no new round can be started, only available for the managers of the exam | |
| questionless | No | do not show the questions of the Quiz set, the examinees complete the test right away by starting it, only available if not a survey or championship, cannot be changed anymore when the current round already has results, until a new round is started (see edubase_post_exam_round) | |
| results_page | No | redirect the examinees to the results page after the test, can only be disabled with the datetime_blind, manual and none types | |
| view_results | No | when the examinees can see their results (after: right after the test is submitted, until the end of the exam, always: any time during the exam period, the examinees can log back in to see their results, datetime: after the test is submitted, and again from the start of the results viewing period, datetime_blind: only in the results viewing period, the solutions and the details of the evaluation are hidden right after the test, manual: only after the result is published separately, test by test, none: never), not available for surveys (default: after) | |
| export_format | No | format of the exported results file (csv: semicolon separated values, xlsx: Excel 2007+ workbook), default: xlsx | |
| export_gender | No | export the gender of the registered examinees, needs special privileges to enable, not available for surveys (default: false) | |
| export_points | No | export the points scored on every question, not available for surveys (default: false) | |
| export_skills | No | export the skill results of the examinees, only exported when the Quiz set of the exam has skills, not available for surveys (default: true) | |
| export_answers | No | export the answers given by the examinees, not available for surveys (default: false) | |
| export_journey | No | export the journey status of the examinees, only exported when the exam starts a journey (see edubase_get_exam_journey), not available for surveys (default: true) | |
| export_suspicion | No | export the suspicious test taking indicator, never exported when the Suspicion Score is disabled in the settings of the exam, not available for surveys (default: false) | |
| show_in_lasthour | No | only show the results in the last hour of the exam, only available with the after type | |
| grading_threshold | No | threshold of the grading in percentage, between 0 and 100, only available for grading presets with a configurable threshold (of the go-nogo-custom type), can be changed without selecting the grading preset again | |
| view_results_start | No | start of the results viewing period (in YYYY-MM-DD HH:ii:ss format), only available with the datetime and datetime_blind types where it is mandatory, has to be between the start and the end of the exam, no further tests and no new rounds can be started once the period has begun | |
| hide_ingame_results | No | hide the results while the test is taken | |
| export_custom_fields | No | export the user data fields filled in by the examinees (see edubase_get_exam_fields), when the exam starts a journey and export_journey is enabled, the fields requested by the exams along the journey are exported too (fields with the same label share a column, with the value given last), not available for surveys (default: true) | |
| export_finished_only | No | only export the examinees who finished their test, not available for surveys (default: false) | |
| view_results_identifier | No | label of the unique free text custom user data field the examinees can look up their results with, only available with the datetime and datetime_blind types, the field has to be a unique free text (text, email or phone) custom field of the exam (see edubase_get_exam_fields), send "none" (or an empty value) to disable the identifier based results page |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| exam | Yes | ||
| archive | Yes | ||
| grading | No | ||
| pausable | Yes | ||
| roundtime | Yes | ||
| timelimit | Yes | ||
| hide_grade | No | ||
| export_sort | Yes | ||
| hide_points | No | ||
| nonblocking | Yes | ||
| results_url | No | ||
| export_stats | No | ||
| freeze_round | Yes | ||
| questionless | No | ||
| results_page | No | ||
| view_results | No | ||
| export_format | Yes | ||
| export_gender | No | ||
| export_points | No | ||
| export_skills | No | ||
| export_answers | No | ||
| export_journey | No | ||
| export_suspicion | No | ||
| show_in_lasthour | No | ||
| export_attendance | No | ||
| grading_threshold | No | ||
| view_results_start | No | ||
| hide_ingame_results | No | ||
| export_custom_fields | No | ||
| export_finished_only | No | ||
| view_results_identifier | No |