Brightspace Data Streams (July 2023)

Announcement Events

«  ActivityExemptionEvent   ·  [   home  ·   community   |   search  ·   index   ·  next   ·  previous   ]   ·  Announcement Event  »

Announcement Item EventsΒΆ

Announcement item events are posted when a user performs any action pertaining to announcement itemss. The actor is the user who performs the action, and the object is the announcement involved. The event object has the following form:

{
        "id": "<EventUUID>",
        "timestamp": "<UTCDateTimeString>",
        "actor": {
                "account": {
                        "homePage": "https://<TenantUUID>.lms.d2l.com/",
                        "name": "urn:uuid:<UserUUID>"
                }
        },
        "verb": {
                "id": "https://api.brightspace.com/xapi/verbs/<AnnouncementVerbString>"
        },
        "object": {
                "objectType": "Activity",
                "id": "urn:uuid:<AnnouncementUUID>",
                "definition": {
                        "type": "https://api.brightspace.com/xapi/activities/tools/announcement/item"
                }
        },
        "context": {
                "contextActivities": {
                        "category": [
                                {
                                        "id": "https://api.brightspace.com/xapi/profiles/brightspace-activity-v1p0.jsonld"
                                }
                        ]
                },
                "registration": "<OrgUnitUUID>",
                "extensions": {
                        "https://api.brightspace.com/xapi/extension_keys/context/actor": {
                                "userId": "<BrightspaceUserIdNumber>",
                                "imsRoleIds": [ <IMSRoles> ],
                                "impersonatingUserId": "<BrightspaceImpersonatingUserIdNumber>",
                                "roleId": "BrightspaceRoleIdNumber>"
                        },
                        "https://api.brightspace.com/xapi/extension_keys/context/object": {
                                "id": "<BrightspaceAnnouncementIdNumber>"
                        },
                        "https://api.brightspace.com/xapi/extension_keys/context/context": {
                                "tenantId": "<TenantUUID>",
                                "originalEventId": "<InternalEventUUID>",
                                "orgUnitType": "<BrightspaceOrgUnitTypeString>",
                                "orgUnitId": "<BrightspaceOrgUnitIdNumber>"
                        }
                }
        }
}

Notes:

<AnnouncementVerbString>

may be one of

created
deleted
released
updated
restored
<AnnouncementFolderUUID>

a unique identifier for the announcement. This UUID is created by an algorithm whose input is the TenantID, OrgUnitID, and announcement ID number. This UUID will be used whenever this announcement is referenced by any BDS event.

<OrgUnitUUID>

a unique identifier for the OrgUnit.

impersonatingUserID

only present if the user is being impersonated by a different user. If this field is present, then the Actor information refers to the person being impersonated, not the impersonator.

originalEventId

only provided for use by D2L personnel if needed for troubleshooting.

See Fundamental xAPI Concepts for information on other fields.

«  ActivityExemptionEvent   ·  [   home  ·   community   |   search  ·   index   ·  next   ·  previous   ]   ·  Announcement Event  »