Skip to main content
Skip table of contents

Custom parameters (grader launch)

The following parameters are used to customize the LTI launch using TAO features.

Key

Value

Default

description

Responses selection parameters

deliveryIds

json-encoded string[]

None

Enter the ID of the delivery for which the responses needs to be scored. 

grader-customparameter-deliveryid.png

testTakerIds

json-encoded string[]

None

Enter the ID(s) of the test-takers for which the responses needs to be scored.

presentationOrder

item , delivery, or title

 

None

Defines the order in which the responses will be presented to the scorer. Depending on the provided values, the sorting criteria will be either:

  • item

    • Item order in the QTI test first

    • Delivery order (as given in the deliveryIds parameter) second

 

  • delivery

    • Delivery order (as given in the deliveryIds parameter) first

    • Item order in the QTI test second

 

  • title

    • Item title order (as defined in Authoring of Test Item title parameter)

    • Delivery order (as given in the deliveryIds parameter) second

      grader-custom-title-presentationorder.png

unscoredFirst

"true" or "false"
true or false

None

Designates that un-scored tasks should come first:

Value can be string (“true”, “false”) or boolean (true or false); both are accepted. Examples:

CODE
“unscoredFirst”: "\"true\""
“unscoredFirst”: "\"false\""
“unscoredFirst”: "true"
“unscoredFirst”: "false"
  • If “true” or true value is used: un-scored tasks are returned first.

  • If “false” or false value is used or this claim is not sent: keep the existing behavior.

Precedence of custom parameters ordering tasks:
When both presentationOrderand unscoredFirst parameters are present, then the unscoredFirstparameters have precedence, meaning that all un-scored tasks are presented first, followed by the scored tasks. The un-scored tasks and the scored tasks are internally sorted by the value provided in the presentationOrderparameter.

Example:

CODE
"https://purl.imsglobal.org/spec/lti/claim/custom": {
  "deliveryIds": [
    "delivery-1111-2222-5555", 
    "delivery-3333-4444-8888",
    "delivery-6666-7777-1000",
    ...
  ],
  "testTakerIds": [
    "tt-1111-2222-3333", 
    "tt-4444-5555-6666",
    "tt-7777-8888-9999",
    ...
  ]
}

Example (json-encoded):

CODE
"https://purl.imsglobal.org/spec/lti/claim/custom": {
  "deliveryIds": "[\"delivery-1111-2222-5555\", \"delivery-3333-4444-8888\", \"delivery-6666-7777-1000\",...]",
  "testTakerIds": "[\"tt-1111-2222-3333\", \"tt-4444-5555-6666\", \"tt-7777-8888-9999\",...]"
}

 

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.