Written by: Sagar Warghade, Senior Product Manager
Insights Report Builder allows you to create and personalize your reports and dashboards using the data available within Brightspace Data Sets (BDS). As the BDS evolves and changes over time, you can take advantage of these enhancements. Any changes to BDS will impact on the Insights Report Builder and you should be aware of those - Impact of Minor & Major Version Changes on Insights Report Builder
With the new BDS Major version 9, updates to the following Brightspace Data Sets will occur:
- Quiz Attempts BDS
- Removed: GracePeriod and ExtendedDeadline
- Renamed: GracePeriodExceededBehaviour to TimeLimitExceededBehaviour
- Addition: IsSynchronous
- Quiz Objects BDS
- Removed: TimeLimitGracePeriod, ShowClock, and TimeLimitExceededBehavior
- Addition: DeductionPercentage and DeductionPercentage
- User Logins BDS
- Removed: OrgId and TimeOff
- Addition: LoginSource
- Enrollments and Withdrawals BDS
- Awards Issued BDS
- Removed: Type, Credits and IsRevoked
- Addition: RevokedDate, RevokedReason, RevokedBy, LastModifiedBy, LastModifiedDate, and Version
- Grade Schemes BDS
- Removed: GradeSchemeRangeId and IsDeleted
- Role Details BDS
- Removed: OrgId, ClassListDisplayRoleCategory, ClassListRoleCategory, ClassListRoleCategoryOrder, and Version
- Addition: LastModifiedDate and DeletedBy
To understand the full details, you can read Motivations Behind The Changes In Data Hub Brightspace Data Set (BDS) Major Version 9
To enable BDS Major version 9 in Data Hub:
1. Ensure the Can Access Brightspace Data Sets permission is granted to administrators at the org level. Admin role also requires Can See/Edit Config Variable Values at the org level.
2. Navigate to Config Variable Browser.
3. Under Tools, click to select BrightspaceDatasets, and then click Version.
4. Ensure the d2l.Tools.BrightspaceDataSets.Version configuration variable is set to version 9.0 or higher. New and changed data sets appear the first time the data set runs after the version update.
What does this mean for my dataflows, reports, and dashboards inside Insights Report Builder?
Since the above Brightspace Data Sets will be going through a major change, you will need to update the dataflows, reports, and dashboards you created that use those Data Sets. In addition, Author users in Insights Report Builder can only create dataflows and edit their dataflows, reports and dashboards. Therefore, they will need to make the right updates to the items they own.
To understand how these Data Sets changes will be impacting you:
1. Navigate to Data in the top menu in Insights Report Builder.
2. Select All DataSets from the left navigation bar
3. Search for each BDS mentioned above (in this case, we searched for Quiz Objects)
4. Select the DataFlow and once inside, navigate to Lineage in the top secondary menu.
The Lineage view provides you with an understanding of all the dataflows, reports, and dashboards you need to update by pointing to the BDS version once it is available
Navigate through the tabs right column to understand the relationship between DataSets, DataFlows, Cards, and Alerts
How do I update my dataflows, reports, and dashboards?
Now that you have understood the impact of the BDS change, you will need to make the right changes to the items that your Author user owns for each of the Data Sets mentioned above.
Once the new BDS major version 9 becomes available, in our example Quiz Objects 9, you will need to make sure everything that is using Quiz Objects 8 is remapped to Quiz Objects 9. Anything mapped to the earlier version will continue to function; however, no new data will be available.
1. To update your DataFlows, edit the impacted DataSet and select ‘Configuration.’ Then change the Input DataSet to the latest version.
2. To update your reports and dashboards, edit the impacted Cards and select the ‘Data’ section of the screen. Then select the new version of the DataSet.
Summary:
BDS Version 9 has been made available in the December 2023/20.23.12 release; the adoption period will end in April 2024/20.24.04 when it becomes the default version in Brightspace Data Hub (BDS) and Insights Report Builder (IRB). After this time, in IRB, we update only the latest BDS Major Version; therefore, we expect you to no longer rely on BDS Version 8 and below. Thus, to ensure the upkeep of the health of our platform and continued data integrity, we will delete BDS version 8 and below in Insights Report Builder in July 2024. In addition, we will also delete corresponding Data Flows, Cards, Reports and Dashboards that use BDS Version 8 and below.
Related blog posts:
Change Management of Brightspace Data Sets within Insights Report Builder
Impact of Minor & Major Version Changes on Insights Report Builder
Motivations behind the changes in Data Hub Brightspace Data Set (BDS) Major Version 9
Analytics Builder – Visualization Infrastructure transition
