To install Portflow on your Blackboard instance, follow the steps below.

Installation

I. Add an LTI Tool Provider

1. Navigate to Admin → LTI Tool Providers (under Integrations)

2. Click Register LTI 1.3/Advantage Tool

   

3. Enter the following Client ID:
   🇪🇺 EU Hosting 
   dbf25a94-5d49-495c-a1c5-e64923cdf3ec
   🇦🇺 AU Hosting 
   90a46a52-fd6b-4fe1-aa31-b5f7f5e18dea

4. Click Submit

5. Set the Status to Approved

6. Copy the Default Deployment ID (send it over to Drieam)

   A full overview of all details to be sent to Drieam can be found below step III.

7. Ensure all User Fields to be Sent are checked:

   1. Role in Course

   2. Name

   3. Emaik Address

8. You can set the Allow mark service access to No

9. Ensure Allow Membership Service Access is set to Yes

   

10. Click Submit

II. Add Role and Service User

1. Navigate to Admin → System Roles (under Users)

2. Click Create Role

   

3. Add a Role name and Role ID, e.g. 'Portflow API Access'

4. Click Submit.

5. Search for the Privilege: Administrator Panel (Users) > Users and enable that privilege.
   All other privileges are not required (and can be removed).

   

6. Navigate to Admin → Users (under Users)

7. Create a new user with the just created role as the Primary System Role

   

8. Click Submit

III. Add API Integration

1. Navigate to Admin → REST API Integrations (under Integrations)

2. Click Create Integration

   

3. Enter the Application ID, same as the Client ID from step I.3 above
   🇪🇺 EU Hosting 
   dbf25a94-5d49-495c-a1c5-e64923cdf3ec
   🇦🇺 AU Hosting 
   90a46a52-fd6b-4fe1-aa31-b5f7f5e18dea

4. Select the created user from step II (with the assigned System role) for the Learn User

5. Set End User Access to Yes

6. Set Authorised To Act As User to No or Service Default (No)

   

IV. Authorise Service User

1. Log in as a System Administrator Blackboard user

2. Go to Portflow → Admin → User permissions → Super Admins

3. Add your newly created service user user as super admin

4. Log in (through login credentials or impersonation) as the service user

5. Go to Portflow → Admin → LMS

6. Click on the button to authorise Portflow to access the Blackboard API through this service user

Information to send to Drieam

Please forward the following information to Drieam, for them to complete the installation:

1. Default Deployment ID (from step I.6)

2. Domain and URL of the Blackboard instance where Portflow is installed.

3. Type of installation (e.g. acceptance/testing/production)

4. Default language and optional secondary language(s) (see below)