Blackboard Logo Dev Docs
search rss_feed menu

Grade Events

Blackboard Learn’s Caliper Analytics stream emits a GradeEvent to cover the following use cases:

GradeEvents are sent in bulk nightly. Here is some of the key data that is associated with these events:

GradeEvent

group.courseNumber - the course batch_uid (i.e. the ID sent in by LIS or Data Integration)

object.assignable - …/gradableItems/id - the primary key for the content ID

action - Graded

actor.id - contains a unique ID of the user (the ID is known to Bb)

generated.normalScore - score provided

extensions - contains a tag called bb:user.externalId with the batch_uid for the user

Sample Payload

Here is a sample of what a workflow might look like:

{
  "sensor": "54b54b42-dd02-42f8-88ed-07bd719bfb7c",
  "sendTime": "2021-01-05T07:55:48.048Z",
  "dataVersion": "http://purl.imsglobal.org/ctx/caliper/v1p1",
  "data": [
    {
      "@context": "http://purl.imsglobal.org/ctx/caliper/v1p1",
      "type": "GradeEvent",
      "id": "54b54b42-dd02-42f8-88ed-07bd719bfb7c",
      "actor": {
        "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/applications/learn",
        "type": "SoftwareApplication"
      },
      "action": "Graded",
      "object": {
        "startedAtTime": "2021-01-04T12:57:55.941Z",
        "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/gradableItems/_12345_1/attempts/_12345_1",
        "type": "Attempt",
        "assignable": {
          "dateToSubmit": "2021-01-04T12:57:55.941Z",
          "maxAttempts": 0,
          "maxSubmits": 0,
          "maxScore": 160,
          "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/gradableItems/_12345_1",
          "type": "Assessment",
          "dateCreated": "2021-01-04T12:57:55.941Z",
          "dateModified": "2021-01-04T12:59:47.248Z",
          "creators": [],
          "learningObjectives": [],
          "keywords": [],
          "items": []
        },
        "assignee": {
          "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/users/0e9625cdef42403c9c8aed38d7cd80b2",
          "type": "Person",
          "extensions": {
            "bb:user.id": "_12345_1",
            "bb:user.externalId": "54b54b42-dd02-42f8-88ed-07bd719bfb7c"
          }
        },
        "count": 1
      },
      "generated": {
        "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/gradableItems/_12345_1/attempts/_12345_1/score",
        "type": "Score",
        "dateCreated": "2021-01-04T12:59:47.248Z",
        "dateModified": "2021-01-04T12:59:47.248Z",
        "extensions": {
          "bb:action.name": "instructor.grade.history.event.attempt.grade",
          "bb:content.id": "_12345_1",
          "bb:provider.domain": "lti.mytool.com"
        },
        "attempt": {
          "startedAtTime": "2021-01-04T12:57:55.941Z",
          "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/gradableItems/_12345_1/attempts/_12345_1",
          "type": "Attempt",
          "assignable": {
            "dateToSubmit": "2021-01-04T12:57:55.941Z",
            "maxAttempts": 0,
            "maxSubmits": 0,
            "maxScore": 160,
            "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/gradableItems/_12345_1",
            "type": "Assessment",
            "dateCreated": "2021-01-04T12:57:55.941Z",
            "dateModified": "2021-01-04T12:59:47.248Z",
            "creators": [],
            "learningObjectives": [],
            "keywords": [],
            "items": []
          },
          "assignee": {
            "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/users/0e9625cdef42403c9c8aed38d7cd80b2",
            "type": "Person",
            "extensions": {
              "bb:user.id": "_12345_1",
              "bb:user.externalId": "54b54b42-dd02-42f8-88ed-07bd719bfb7c"
            }
          },
          "count": 1
        },
        "maxScore": 0,
        "scoreGiven": 39.45205,
        "scoredBy": {
          "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/applications/learn",
          "type": "SoftwareApplication"
        }
      },
      "eventTime": "2021-01-04T12:59:47.248Z",
      "edApp": {
        "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/applications/learn",
        "type": "SoftwareApplication"
      },
      "group": {
        "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/courses/6d0140f42843472da7e3ecd150908fa3",
        "type": "CourseOffering",
        "extensions": {
          "bb:course.id": "_12345_1"
        },
        "members": [],
        "courseNumber": "BIO-101"
      },
      "membership": {
        "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/courses/6d0140f42843472da7e3ecd150908fa3/members/0e9625cdef42403c9c8aed38d7cd80b2",
        "type": "Membership",
        "extensions": {
          "bb:course.id": "_12345_1",
          "bb:course.externalId": "BIO-101",
          "bb:user.id": "_12345_1",
          "bb:user.externalId": "54b54b42-dd02-42f8-88ed-07bd719bfb7c"
        },
        "member": {
          "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/users/0e9625cdef42403c9c8aed38d7cd80b2",
          "type": "Person",
          "extensions": {
            "bb:user.id": "_12345_1",
            "bb:user.externalId": "54b54b42-dd02-42f8-88ed-07bd719bfb7c"
          }
        },
        "organization": {
          "id": "https://caliper-mapping.cloudbb.blackboard.com/v1/sites/54b54b42-dd02-42f8-88ed-07bd719bfb7c/courses/6d0140f42843472da7e3ecd150908fa3",
          "type": "CourseOffering",
          "extensions": {
            "bb:course.id": "_12345_1"
          },
          "members": [],
          "courseNumber": "BIO-101"
        },
        "roles": ["Learner"],
        "status": "Active"
      },
      "extensions": {}
    }
  ]
}