datastoreDeliveries

This topic lists API fields (and their descriptions) associated with a delivery ID. These entities do not include results associated with a delivery ID or any sessions the delivery is assigned to. 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

testQtiId

The Identifier for the test, which can be viewed and changed from the general properties panel in test authoring. 

testQtiTitle

The Title of the test, which can be viewed and changed from the general properties panel in test authoring.

deliveryId

The delivery ID of the test.

toolName

The tool used to create and launch the delivery.

toolVersion

This field displays the authoring tool version which was used to publish the delivery. If the value is set to “tao“, this means the delivery was not published using authoring, but using the test runner publication API.

qtiPackage

This field contains the link to the QTI package stored in the GCP bucket. 

messageId

The unique identifier for a message or transaction between the client and the API. 

Scoring

cutScoreRatio

If a cut score is configured for the test, the percentage of the cut score (a cut-off point for passing the test) achieved by the test taker’s score will display. This percentage is displayed as a decimal value. If no cut score is defined for the test, the value of this field will be null. For more information, see Configuring scoring for tests.

Timestamps

last_update_date

The date the delivery was last updated (provided as a unix timestamp).

publicationTime

This field displays when the test with a given deliveryID was published, provided as a Unix timestamp. 

Parts, Sections, and Items

testParts

This group of fields lists each Part in the delivery’s test individually with details about the Part.

id: The Identifier for the test Part, which can be viewed and changed from the test Part properties panel in test authoring. 

sections

This group of fields lists each Section in the delivery’s test individually with details about the Section.

• id: The Identifier for the test Section, which can be viewed and changed from the test Section properties panel in test authoring. 

• title: The Title for the test Section, which can be viewed and changed from the test Section properties panel in test authoring. 

• items: Each item in the Section is listed with the following information:

  • informational: The value of this field will be true when the item is marked for informational usage in test authoring.

  • id: The Identifier, which can be viewed and modified in the Item’s Properties (in item authoring).

  • title: The title of the item in the Item Properties (in Item authoring).

  • category: This field will display any categories added to the item in test authoring.

items

This section lists each item in the delivery’s test individually with details about the item.

• metadata: The metadata defined for an individual item. This field contains the same information of metadataRaw but with flat structure.

  • label: The label of the item in the Item properties (in the Edit Item form).

  • Metadata properties (propertyLabel), such as subject matter, are listed here with each property name and the value assigned to the given item. 

• fullItemResourceID: Each item’s reference ID URL, which can be found in the item’s general properties in authoring (when selected an item from the Item bank).

• qtiTitle: The title of the item in the Item Properties (in Item authoring).

• authoringPosition: The sequential positioning of the item in the delivery’s test (for the first item, this value will be 1, for the second item this value will be 2, etc).

• maxScore: The maximum score available for the item.

• masteryLevel

• qtiId: The Identifier, which can be viewed and modified in the Item’s Properties (in Item authoring). 

• qtiLabel: The label of the item in the Item properties (in the Edit Item form).

• itemId: The unique identifier of the item within the scope of a single delivery. This field may not always be set.

• itemResourceId: The item’s Identifier, which can be found in the Item Properties (in Item authoring).

• stringType

• assessmentItemId: The Identifier, which can be viewed and modified in the Item’s Properties (in Test authoring). 

• metadateRaw: This field lists the raw, unprocessed set of metadata associated with the delivery’s items. These fields are used to provide additional context to the results of the query.

outcomeDeclarations

Any scoring outcome declarations (such as Category scoring) defined on the test level (in Test authoring) will be listed here. For more information, see Configuring scoring for tests | Outcome-Declarations.