Hosting requirements
The Brightspace Data Platform uses Amazon Web Services™ (AWS) for data storage. Data is hosted in the same region as your LMS.
Permissions
|
Note: Analytics Builder is only intended for non-learner personas, and as such there is a maximum of 20,000 readers. Ensure that only users who need access have the Can Use Analytics Builder permission to keep your viewership below this limit. |
| Permission |
Permission level |
Allows users to |
Users will see |
|---|
| Insights > See Insights Portal Tool |
Organization |
Access the Insights Portal page |
All Dashboards in Analytics Builder
|
| Insights > Can Use Analytics Builder |
Organization |
Launch Analytics Builder
Have reports shared with them
|
Insights Report Builder
Creates user as a viewer
|
| Insights > Can Manage Analytics Builder |
Organization |
Manage authors
Activate Analytics Builder
|
Analytics Builder
|
|
Note: Analytics Builder automatically creates groups based on roles that have the Insights > Can Use Analytics Builder permission. For more information, refer to Share dashboards with role-based groups |
Analytics Builder roles
Author
Any user with an organization level role with the Can Use Analytics Builder permission can become an Author by being set up by an administrator with the Can Manage Analytics Builder permission. These authors do not need to have the same role.
Authors can:
- Export Dashboards to CSV, Excel, and PDF
- Share Analyses, Dashboards, and Datasets
- Create and update all datasets
- Create and update all Super-Fast Parallel In-memory Calculation Engine (SPICE) datasets
- Create and update email reports
- Subscribe to email reports
- Create or update threshold alerts
Authors cannot:
- View SPICE capacity
- Add and run anomaly detection
- Create and update all data sources
- Create or rename shared folders
To add an author
- In Insights Portal and click Manage Authors.
Figure: Click Manage Authors to add or change authors.
- Click New Authors.
Figure: Click New Author to select one of the two author roles for your implementation.
- Search for the user and org level role to whom you want to assign an author license.
Figure: Search for users by first name, last name, username, email, or org defined ID.
- Click Assign Authors.
Reader
By default, each organization can have up to 20, 000 readers.
Readers can:
- Export Dashboards to CSV, Excel, or PDF
- Create or update threshold alerts
Readers cannot:
- Share Analyses, Dashboards, and Datasets
- Create or update all datasets
- Create and update all Super-Fast Parallel In-memory Calculation Engine (SPICE) datasets
- Create or update email reports
- Subscribe to email reports
- View SPICE capacity
- Add or run anomaly detection
- Create or update all data sources
- Create or rename shared folders
You can share Analytics Builder resources with a group in addition to individual users. This improves the scale at which you and other report authors can distribute information from Analytics Builder. To share resources with other individuals and groups,
grant the Insights > Can Use Analytics Builder (Org) permission to existing Brightspace roles. Analytics Builder automatically creates groups based on roles that have the Can Use Analytics Builder permission using the format: BrightspaceRoleName-RoleID. For example: ProgramAdministrator-103.
|
Note: Only alpha-numeric characters in Latin-based languages are supported. Special characters and whitespace are automatically removed from the group names. |
If a user's role changes, that user is automatically moved to the Analytics Builder group that corresponds to their new role. If a role is deleted, the corresponding Analytics Builder group is also deleted. Updates to group membership in Brightspace are expected to appear in Analytics Builder within a day.
|
Note: If a user's role changes in Brightspace, they might also remain a member of the previous group until the next day. At that time, the user is removed from the previous group membership and added to the group appropriate to their new role, as expected. |
To share resources and dashboards with groups, authors can use the same workflow as they have previously used for individual users and can designate the group as one of the following designations:
- Viewer: all members of the group can view, export, and print the shared resource
- Co-owner: all members of the group can view, export, print, share, and delete the shared resource
|
Note: If a reader belongs to a group with which an asset is shared as co-owner, the reader continues to be limited by the permissions of being a reader.
|
To share a resource, report, or dataset with a group
- From your org navbar or from the Course Admin menu, click Insights Portal.
- Click the Analytics Builder tab.
- Click Dashboards and select the resource you want to share.
- In the Permissions tab, click Add Users and Groups.
- Search for the user or group with whom you want to share the resource.
- In the Permissions column, indicate if you want to designate the group as either Viewer or Co-owner.
Figure: Indicate if you want invited users and groups to have Viewer or Co-owner privileges.
Video: Sharing and collaborating with Analytics Builder
Using Row-level and Column-level security with Analytics Builder
To create datasets that are useful and relevant to report consumers, it is possible to limit rows and columns available to specific users. This is not mandatory but can assist in distributing and protecting specific data points in your reports.
- Row-level security enables you to grant permissions so that instructors can see only the courses they instruct. An administrator or department head may share a dashboard to multiple instructors. Each instructor can view the same dashboard, but the content each can see is limited to their specific courses; they cannot see content from courses they do not teach.
- Column-level security enables you to secure columns within the dataset that should not be widely viewed. For example, in the interests of protecting Personally Identifiable Information (PII) or preserving the anonymization of assignment submissions, an instructor may be limited in seeing last names or user IDs of the learners in their classes.
To set row- or column-level security:
- On the Analytics Builder home page, select a dataset.
- On the Dataset properties dialog, click Summary.
- Under About, click Set up
Figure: Click one of the Set up links in the Summary tab in the Dataset properties.
Video: Row- and column-level security in Analytics Builder