Amct

An angular based multiple choice test framework

This project was generated with Angular CLI version 11.0.3.

Development server

Run ng serve for a dev server. Navigate to http://localhost:4200/. The app will automatically reload if you change any of the source files.

Build

Run ng build to build the project. The build artifacts will be stored in the dist/ directory. Use the --prod flag for a production build.

Configure custom tests

Open assets/config.json and add a custom test config to tests.

Set the relative path to your custom questions configuration file at questions.

The uniqueIdentifier is used as url parameter to easily share the test.

The contributor and contributorUrl fields are optional.

Example:

"tests": [
    {
      "title": "Programmiermethoden und Werkzeuge - Vorübung",
      "questions": "assets/tests/progmeth1.json",
      "numberOfRandomQuestions": 5,
      "uniqueIdentifier": "progmeth1"
    },
    {
      "title": "My custom test",
      "questions": "assets/tests/myQuestionnaire.json",
      "numberOfRandomQuestions": 5,
      "uniqueIdentifier": "customTestId",
      "contributor": "myNickName",
      "contributorUrl": "https://optional-url-to-my-website.com"
    }
]

Configure custom questions

A question must consist of the following elements

• name
• type
• answers
• orientation (only required for the dropList type)

A question can contain the following additional elements

• useDisabled (optional; to use with the dropList type)
• description (optional; shows preformatted text in a html pre element)

Question format

There are already three possible question formats:

Single selection

• use the value radio as type in myQuestionnaire.json
• only one value of all possible answers is allowed to be true

Multiple selection

• use the value checkbox as type in myQuestionnaire.json
• answers can be mixed, all true or all false

Drop lists

• use the value dropList as type in myQuestionnaire.json
• the order of the answers in json corresponds to the order accepted as correct in the test
• the question requires the keyword orientation in the question to be horizontal or vertical
  • with more than two words per answer the vertical orientation is recommended
• in the current version all answers of a default drop list require the value to be true unless the useDisabled option is used
• to start with all answers in a disabled box add "useDisabled": true to the question
  • set value to false for answers which has to be disabled
  • only the order of activated responses (with value = true) is checked!

Question examples

Example of possible question definitions in assets/tests/myQuestionnaire.json:

[
  {
    "name": "What is 1+1?",
    "description": "Example solution method: <script>alert(1+1);</script>?",
    "type": "radio",
    "answers": [
      {
        "text": "0",
        "value": false
      },
      {
        "text": "1",
        "value": false
      },
      {
        "text": "2",
        "value": true
      }
    ]
  },
  {
    "name": "Select all words, starting with a \"d\".",
    "type": "checkbox",
    "answers": [
      {
        "text": "dumb",
        "value": true
      },
      {
        "text": "definitely",
        "value": true
      },
      {
        "text": "teacher",
        "value": false
      }
    ]
  },
  {
    "name": "Sort these entries!",
    "type": "dropList",
    "orientation": "vertical",
    "answers": [
      {
        "text": "First entry",
        "value": true
      },
      {
        "text": "Second entry",
        "value": true
      },
      {
        "text": "Third entry",
        "value": true
      }
    ]
  },
  {
    "name": "Sort these entries and disable the bad ones!",
    "type": "dropList",
    "orientation": "vertical",
    "useDisabled": true,
    "answers": [
      {
        "text": "First entry",
        "value": true
      },
      {
        "text": "Second entry",
        "value": true
      },
      {
        "text": "Thrölfth entry",
        "value": false
      },
      {
        "text": "Third entry",
        "value": true
      }
    ]
  }
]

Online example

Visit https://amct.binsky.org to see a working example