The Roster Exchange API Integration allows Barnes & Noble College to gather course enrollment information to use for billing purposes when content is provisioned in a First Day program.
Set Up the API Roster Exchange
- Navigate to the Admin Panel in Blackboard.
- Under Users, click System Roles > Create Role. Enter the following role properties:
- Role Name: Barnes & Noble College API
- Role ID: BNCAPI
- Click Submit.
- Locate the Barnes & Noble College API role. Hover over the name to view the gray options menu icon. Click the icon and select Privileges.
- In the Manage Privileges menu, add the following privileges—you can search for each individual privilege. Check the box for each privilege and then select Privileges > Permit Privileges. A green check will appear by each privilege when it has been permitted:
- Course/Department (Content Areas) > Edit Materials
- Course/Department Control Panel (Users and Groups) > Users
- Administrator Panel (Users) > Users
- Administrator Panel (Courses) > Courses
- Administrator Panel (Courses) > Courses > Edit > Course Properties
- Administrator Panel (Courses) > Terms
- Return to the Admin Panel.
- Navigate to Users and click Create User.
- Enter the required personal and account information*:
- First Name: BNC
- Last Name: API
- Username: BNCAPI
- Password: (enter a secure password)
- * Leave all other fields blank
- Select the following institution and system roles:
- Institution Roles: Observer
- System Roles: Barnes & Noble College API
- Click Submit to create the user.
- Request an OAuth Application ID from firstname.lastname@example.org.
- Once received, return to the Admin Panel in Blackboard.
- Click on REST API Integrations from the Building Blocks sub-menu.
- Click on Create Integration.
- On the Create Integration page, enter the following in the fields:
- Application ID: enter the application ID provided by Barnes & Noble College
- Learn User: BNCAPI
- Locate a user ID by clicking Browse and searching by username
- End User Access: Yes
- Authorized to Act As User: No
- This option might not appear in your system
- Click Submit.
- You will be returned to the listing of REST API Integrations, and VitalSource will appear among the listed integrations.
- Notify your Implementation contact when the Rest API setup is complete. Once they have confirmed that the setup was successful, please click on the Course Material link in a course (real or test course) in your upcoming term.
- If there are no courses with the Course Material link currently installed for the upcoming term, please add to a course and click.
For Each New Term
Each term sync is initiated with a click on the BNC Course Material link within a course associated to the upcoming term. In order to pull course and roster information for each new term, please be sure to click on the Course Material link in a course in the upcoming term to initiate the new term sync.
Let us know if any staff or test user accounts are commonly enrolled in Blackboard courses (specifically, under the student role), and we will make note to omit them from course roster counts.
Remove the Roster Exchange API Configuration
If you currently have First Day, DO NOT remove this API until your current term courses have fully completed, or students will lose access to their materials.
You must only complete this step if you had a First Day program prior to the upcoming term. Otherwise, continue to the first step, Setting Up API Roster Exchange.
- Return to the Administrator Panel main menu.
- Locate and select REST API Integrations.
- Locate and hover over the Roster Exchange integration.
- Click the gray arrow to reveal the Options Menu.
- Click Delete.