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

TABLE OF CONTENTS

• Installation
  • I. Install the App
  • II. Create an OAuth app
  • III. Add Portflow to the nav bar
• Overview of information to send to Drieam
  • Default language
• Recommended adjustments
  • A. Adjust assignment end date settings
  • B. Adjust email access
  • C. OpenBadges Support

Installation

I. Install the App

1. Go to Admin Tools > Manage extensibility > Apps

2. Find and open Portflow

3. Click Install

4. Review the data access and click Allow and Install

5. Under Make tool available to, add the Organization and All descendants (even if just available to 1 department) and click
   

6. Click Continue

7. Copy all registration details and send them over to Drieam.
   See the full list of required details at the below step III.

8. Click Done.

9. Enable the Deployment: toggle Disabled to Enabled.

II. Create an OAuth app

This OAuth app is used to get assignment submissions on behalf of the learner to import into their portfolio as evidence.

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 III.

III. 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

Overview of 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 tool) 

1. Registration details (step I)
   • Client ID
   • Deployment 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. OAuth app details (step II) 
   • Client ID
   • Client Secret
3. Nav bar Quicklink URL
   This is the URL you see when Portflow has been opened from the navigation menu.
4. Default language and optionally secondary language(s) — see below.

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 Brightspace 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 chosen languages also determine the languages you can set rubric scale level names in.

The default language cannot be changed.

Recommended adjustments

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

A. Adjust assignment end date settings

This will make sure students are able to 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