Create/Update exam

Method

Method Description
exam.examCreate Create exam.
exam.examUpdate Update exam.

Request parameters

{
    "exam": {
        "id": {TestId}, /* Only for update operation */
        "title": "{ExamTitle}",
        "category": "{ExamCategory}",
        "code": "{ExamCode}",
        "shuffle_questsion": {ShuffleQuestions},
        "shuffle_answers": {ShuffleAnswers},
        "testing_questions": {TestingQuestions},
        "testing_time": {TestingTime},
        "evaluation_method": {EvaluationMethod},
        "passing_score": {PassingScore},
        "show_description_page": {ShowDescriptionPage},
        "show_standard_introduction": {ShowStandardIntroduction},
        "description": "{Description}"
    }
    "resources": {
        "{ResourcePath}": "{ResourceCnt}",
        ...
    }
}

Response parameters

{
    "exam": {
        "id": {TestId}, 
        ...
    },
    "resources": {
        "{ResourcePath}": "{NewResourcePath}",
        ...
    },
    "completed": {Comleted}
}

If a specific option is completely omitted from the request, it will not be updated, and the previously stored value will be preserved.

Variable Type Appearance Description
{TestId} Integer Mandatory Exam id.
{ExamTitle} String Mandatory Exam title.
{ExamCategory} String Mandatory Exam category. For example "Language" for language related exams or vendor name if it is vendor specific exam.
{ExamCode} String Mandatory Exam code.
{ShuffleQuestions} Boolean Optional When enabled, questions will be shuffled. Enabled by default.
{ShuffleAnswers} Boolean Optional When enabled, question answer options will be shuffled. Enabled by default.
{TestingQuestions} Integer Optional Number of questions, which should appear in online exam simulation. If omitted will be handled automatically. Setting to 0 will re-enable auto-handling. Default value is 60 or will be equal to total available questions (multiple of 5) if it less than 60.
{TestingTime} Integer Optional Time given to complete online exam simulation (in minutes). Default value is 1.5 minute for each question. If omitted will be handled automatically.
{EvaluationMethod} Integer Mandatory Test evaluation method. Following options are available:
  • 1 - Simple: By Percent of Correct Answers. The test is evaluated based on the percentage of correctly answered questions. The user passes if this percentage meets or exceeds the minimum passing value.
  • 2 - Simple: By Gained Points. The test is evaluated based on the total points gained. The user passes if the total points meet or exceed the minimum passing score.
  • 3 - Grades: By Percent of Correct Answers. The test is evaluated based on the percentage of correctly answered questions. Custom grade levels must be defined by setting a percentage range (minimum and maximum) for each grade.
  • 4 - Grades: By Gained Points. The test is evaluated based on the total points gained. Custom grade levels must be defined by setting a points range (minimum and maximum) for each grade.
{PassingScore} Integer Mandatory Applies and mandatory to the following evaluation methods:
  • 1 - Simple: By Percent of Correct Answers. The percentage of correctly answered questions required to pass the test.
  • 2 - Simple: By Gained Points. The total number of points required to pass the test.
{ShowDescriptionPage} Boolean Optional When enabled, a dedicated description page is shown to examinees before the exam starts. Automatically set to false if description is empty. Default: false.
{ShowStandardIntroduction} Boolean Optional When enabled, the standard “Before You Begin” introduction page is shown before the exam starts. Default: true.
{Description} String Optional Exam description content. HTML formatted, may contain media resources like images and audio. Please be aware that only relative URLs are allowed. If omitted from the request, the existing value is preserved and not cleared.
resources Object Optional If you are using media resources like images you need to send the content of each media resource under "resources" node.
{ResourcePath} String Mandatory Path of media resource. Same value as it was used in Description.
Example: "fld/image.jpg" for <img src="fld/image.jpg">.
{ResourceCnt} String Mandatory Base64 encoded content of media resource.
{NewResourcePath} String Mandatory New media resource path.
{Completed} Boolean Mandatory Indicates whether action was successfully completed or not.