Portflow installation on Blackboard

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

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)
7. Ensure all User Fields to be Sent are checked
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 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. Share the user sign in details with Drieam (you SHOULD NOT change the password or delete the user after Drieam has processed the account to authorise access. Changing the password or removing the user will revoke Drieams API access.)
9. 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
   dbf25a94-5d49-495c-a1c5-e64923cdf3ec
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. Default language

The default language for Portflow has to be set by Drieam. This is the language that will be shown to users who have their Blackboard account set to any language other than the list of supported languages. Let Drieam know what your primary (default) language and secondary language(s) should be. The default language cannot be changed.

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. [Optional, see note in step II] Sign-in details (username, password, clean Blackboard sign-in url) of the newly created user with the designated privileges.

Note: users will not be able to search for/find System administrators when sharing their portfolio. This is a limitation set by the Blackboard API.