Datasets
Choose only the Brightspace Data Sets your reports and insight widgets need. Each enabled dataset joins ongoing syncs; more data can make the first sync take longer.
Select datasets during setup
Section titled “Select datasets during setup”After you connect Brightspace, Home scans for available datasets. Wait for Select datasets to sync. If the scan finds none, check that the Brightspace service user has Can Access Brightspace Data Sets and that the OAuth 2.0 app has the datasets:bds:read scope. Then select Retry scan.
Required datasets, Users, Course Access, Course Access Log and Organizational Units, are always synced. You cannot turn them off. Recommended includes Role Details, User Enrollments, Organizational Unit Parents, Organizational Unit Ancestors and Organizational Unit Descendants. Other datasets are optional.
Use Minimal for required datasets, Recommended for required plus recommended, or All for everything. You can also use Search datasets… and choose individual rows. Select Continue, check the summary, then start your first sync. If your Evaluation Organization has zero free syncs left and no completed sync, confirming saves the selection without starting a sync. The Your price card appears instead. Follow the price check and purchase steps; after purchase, the first sync loads your selected data.
Match datasets to reports
Section titled “Match datasets to reports”Locked system report rows show Needs followed by the missing dataset names. They link to Manage datasets, or say “Ask an administrator to select these datasets.” when you cannot change datasets. The exact dependencies are:
| System report | Datasets needed |
|---|---|
| LMS Accounts | Course Access, Course Access Log, Users, Organizational Units |
| Enrollment Trends | User Enrollments, Organizational Units |
| Course Activity (Last 30 Days) | Course Access, Organizational Units |
| Final Grade Distribution | Grade Results, Grade Objects, Organizational Units |
| Students with Low Engagement | User Enrollments, Role Details, Organizational Units, Course Access, Content Objects, Content User Progress, Grade Objects, Grade Results, Gradebook Settings, Users |
The LMS Account count also uses Organizational Units, which is always synced.
The Student Engagement Signals template uses the same datasets as Students with Low Engagement. To see columns, expand a dataset in the report builder’s Datasets list. For what works inside a Brightspace course, see Brightspace launch users.
Change your selection
Section titled “Change your selection”Open Data > Datasets after setup. When no sync is running, tick rows or use Select all, Deselect all and Filter datasets…. Select Enable selected or Disable selected. Enabled data joins the next sync; disabling leaves existing data in place without updating it. If a save fails, the choices and reasons remain visible. Fix the issue, then select Retry failed changes. Wait for a running sync to finish before changing datasets.
A dataset can show Missing daily updates when Rowseta cannot yet confirm it holds every daily update for that dataset. Hover over the status to see Rowseta cannot yet confirm this dataset holds every daily update. It repairs this automatically during later syncs. Rowseta repairs it automatically during later syncs, and the message clears once Rowseta confirms it is complete. See Missing daily updates for what to expect.
Scan for new datasets
Section titled “Scan for new datasets”Select Scan Brightspace to discover newly available datasets. The result reports new or newly available datasets. If a scan fails, test the data connection under Integrations > Brightspace, then scan again.
Delete a dataset’s data
Section titled “Delete a dataset’s data”If you can manage datasets, open Data > Datasets, open the dataset’s actions menu and select Delete data. Wait for any running sync to finish first.
The dialog lists every report, saved draft and insight widget in your Organization that uses the data, with its owner and a link when you can open it. Edit or remove these first; they block deletion. Reports that Rowseta could not check also count as using the data. Built-in reports are listed but do not block deletion; they show no data until the next sync.
When nothing blocks deletion, select Delete data to confirm. The dialog says: “This permanently deletes this dataset’s synced data. Reports stop showing it right away, and the stored files are removed within about a day. Sync history is kept.”
Deleting does not switch the dataset off. For an enabled optional dataset, the dialog says: “This dataset is switched on for sync, so the next sync imports it again. To stop that, switch it off on the Datasets page first.” No return warning appears for a switched-off optional dataset. Required datasets, Users, Course Access, Course Access Log and Organizational Units, cannot be switched off and return on the next sync.
Results opened before deletion stop working. Run the report again; export requests from those old results are refused after deletion. To delete everything, see Syncs.