For this installation, Administrator or Super Administrator permissions in Brightspace at the Organization level are required.

This manual describes the installation, the information that is required by Drieam to complete the installation, and the strongly recommended adjustments to Brightspace for an optimal experience of Portflow.

Installation

I. Register the Tool

1. Go to Admin Tools → Manage extensibility → LTI Advantage 

2. Click Register Tool

3. Select Standard

4. Fill out the fields:

   1. Name: Portflow

   2. Description: e.g. The student-owned portfolio solution by Drieam

   3. Domain: 
      🇪🇺 EU Hosting 
      https://app.portflow.app
      🇦🇺 AU Hosting 
      https://au.portflow.app

   4. Redirect URLs: 
      🇪🇺 EU Hosting 
      https://app.portflow.app/lti/launches
      🇦🇺 AU Hosting 
      https://au.portflow.app/lti/launches

   5. OpenID Connect Login URL:
      🇪🇺 EU Hosting 
      https://app.portflow.app/lti/open_id
      🇦🇺 AU Hosting 
      https://au.portflow.app/lti/open_id

   6. Keyset URL:
      🇪🇺 EU Hosting  
      https://app.portflow.app/lti/keypairs
      🇦🇺 AU Hosting 
      https://au.portflow.app/lti/keypairs

   7. Extensions: 

      1. Assignment and Grade Services

      2. Deep Linking

      3. Names and Role Provisioning Services

   8. Roles: 

      1. Send Institution Role

   9. Substitution Parameters:

5. Click register

6. Copy all Registration details and send them over to Drieam.
   See the full list of required details at the below step V.

II. Register the Deployment

1. Go to Admin Tools → External Learning Tools → LTI Advantage

2. Click New Deployment

3. Select the tool Portflow (tool name), the rest should be filled out automatically

4. Under security settings, check:

   1. Org Unit Information

   2. User information (and all descendants)

   3. Link information (and all descendants)

   4. Classlist including users not known to this deployment

5. Under Make tool available to, add the Organization and All descendants 

   (even if it will be just available to 1 department)

6. Click Create Deployment

7. Communicate the Deployment Id with Drieam.

   See the full list of required details at the below step V

III. Create an OAuth App

1. Go to Admin Tools → Manage Extensibility → OAuth 2.0

2. Click Register an app

3. Fill out the fields

   1. Application name: Portflow

   2. Redirect URI:
      🇪🇺 EU Hosting 
      https://app.portflow.app/lti/oauth2/callback
      🇦🇺 AU Hosting 
      https://au.portflow.app/lti/oauth2/callback

   3. Scope: core:*:*

4. Accept the terms 

5. Click Register

6. Communicate the Client ID and Client Secret with Drieam
   See the full list of required details below step V.

IV. Create Links

We’ll create 2 links to integrate Portflow in Brightspace, a launching link and an insert stuff link to submit Portflow snapshots in assignments.

1. Go to Admin Tools → External Learning Tools → LTI Advantage

2. Open Portflow

3. Click View Links at the bottom of the page

4. Click New Link

5. Fill out the fields:

   1. Name: Portflow Launch

   2. URL:
      🇪🇺 EU Hosting 
      https://app.portflow.app/lti/launches
      🇦🇺 AU Hosting 
      https://au.portflow.app/lti/launches

   3. Description: Launch Portflow in Brightspace

6. Select Type: Basic Launch

7. Click Save and Close

8. Click New Link

9. Fill out the fields

   1. Name: Portflow

   2. URL:
      🇪🇺 EU Hosting 
      https://app.portflow.app/lti/launches
      🇦🇺 AU Hosting 
      https://au.portflow.app/lti/launches

   3. Description: Insert a Portflow snapshot

10. Select Type: Deep Linking Insert Stuff

11. Click Save and Close

V. Add Portflow to the nav bar

Make Portflow available to your users. As Portflow is a course-overarching app, we encourage adding Portflow to all used nav bars, including the homepage navbar.

1. Go to Admin Tools → Navigation & Themes → Custom Links

2. Click Create Link

3. Name: Portflow
   Or any other name. It is also possible to add emoji, or symbols like ⎈.

4. URL: Insert Quicklink → External Learning Tools → Portflow Launch

5. Copy the generated URL (e.g. /d2l/common/dialogs/quickLink/quickLink.d2l?ou={orgUnitId}&type=lti&rcode=XXXX&srcou=6606&launchFramed=1&framedName=Portflow) and communicate it with Drieam.

6. Behaviour: Same Window

7. Description: Access your portfolio

8. Icon: e.g., the icon available at Drieam

9. Availability: select Share with child org units

10. Click Save

11. Go to Navbars

12. Open the desired Navbar and add the link via Add Links → select Portflow.

13. Click Save and Close

Information to Send to Drieam

Please send the following information from the steps above to support@drieam.com. We recommend using a secure transfer service (e.g. SURF FileSender, 1Password or other secure tool).

1. Registration details (step I)

   • Client ID

   • Brightspace Keyset URL

   • Brightspace OAuth2 Access Token URL

   • OpenID Connect Authentication URL

   • Brightspace OAuth2 Audience

   • Issuer

   • Instance URL: the ("vanity") URL users will access Brightspace from

2. Deployment ID (step II)

3. OAuth app details (step III) 

   • Client ID

   • Client Secret

4. Nav bar Quicklink URL (step V)
   This is the URL you see when Portflow has been opened from the navigation menu.

5. Default language and optionally secondary language(s) — see below.

Recommended Adjustments to Brightspace

Adust these settings in Brightspace for an optimal experience with Portflow.

A. Adjust assignment end date settings

This will make sure students can import their submissions into Portflow after the deadline has passed.

1. Navigate to Config Variable Browser → Tools → Dropbox → EndDateDefaultType

2. At Override values, choose visible with submission restricted for the Org unit which will use Portflow.  

   If you choose 'visible with access restricted' or 'hidden', students are not able to import their submitted assignments into Portflow once the deadline has passed.

3. Click Save

B. Adjust email access

This will make it possible to send email notifications to users that have not yet launched Portflow, e.g. when distributing Portflow templates.

1. Navigate to Config Variable Browser → Tools → Classlist → DisplayEmail

2. At Override values, choose On for the Org unit (e.g. 6606) which will use Portflow.

3. Click Save

C. OpenBadges Support

Brightspace includes support for OpenBadges compatible badges, but this is not enabled by default. For Portflow to be able to embed badges issued in Brightspace, a configuration needs to be changed in Brightspace. Follow these steps to enable this feature in Brightspace.

1. Navigate to Config Variable Browser → Tools → Awards → DigitalCredentialSharingEnabled

2. Set the Org Value to On

3. Click Save