Delivery Executions

This topic lists Data Explorer and API fields associated with a delivery ID’s executions. The entities described in this topic are considered to be the most meaningful when performing a query of a delivery’s data - not all entities returned with a query are listed.

Identification fields

Data Explorer	API	Description
Message ID	`messageId`	The unique identifier for a message or transaction between the client and the API.
Delivery Execution Id	`deliveryExecutionId`	Unique identifier for the delivery execution (the session for a given test taker/delivery combination).
Login	`login`	The test taker’s ID/username (not name).
Delivery Id	`deliveryId`	The delivery ID of the test.
Tenant Id	`tenantId`	The unique identifier for the TAO environment on which the delivery was executed.
Test Taker	`testTaker`	The test taker’s login ID.
	`_id`	The same as the delivery execution ID.

Timestamps

Data Explorer	API	Description
Start Time	`startTime`	The start time of the delivery execution (provided as a unix timestamp).
Finish Time	`endDate`	The end time of the delivery execution (provided as a unix timestamp).
Last_Update_Date	`last_update_date`	The date the delivery was last updated (provided as a unix timestamp).

Session fields

Data Explorer

API

Description

Status

status

The status of the delivery.

Initial: Session created but not yet started.
Interacting: The test taker has started interacting with the delivery (session in progress).
Closed: The session has been fully scored and results submitted and/or the session is being scored by a human grader.

LTI parameters (API)

These parameters may be used as values when specifying LTI parameters in the Display tab of Data Explorer.

Parameter	Description
`lti_version`	Specifies the version of the LTI protocol being used.
`user_name`	The full name or display name of the user launching the delivery.
`roles`	Indicates the user's role (i.e learner).
`custom` (enabled plugins)	Contains custom parameters, such as which plugins are enabled for the session.
`id_token`	A secure token used to authenticate and authorize the LTI launch request.
`platform_issuer`	A URL identifying the platform initiating the LTI launch.
`launch_presentation_locale`	Specifies the preferred language/locale for the user interface.
`resource_link_id`	Unique identifier for the resource being launched.
`given_name`	The user's first name.
`client_id`	Unique identifier for the LTI client.
`launch_presentation_return_url`	URL to return to after the delivery execution is completed.
`lti_message_type`	Describes the type of LTI message being sent (i.e launch request).
`context_id`	Identifier for the course or learning context where the launch occurs.
`family_name`	The user's last name or surname.