Adding a Domain (Blackboard Administrators Only):

As the LMS Administrator, an SWEAP IT or SWEAP Program Administrator will provide you with the Blackboard LTI 1.3 Client ID and these instructions. Follow these steps to create a new LTI Tool in Blackboard Classic or Ultra. (We provide Ultra instructions and screen captures when they differ from Classic.)

If you require the deprecated older versions of the documentation, it is available here:Integrating SWEAP With Blackboard (LTI 1.1)

  1. As the LMS Administrator, log in to Blackboard Classic and select the System Admin tab in the top navigation. (In Blackboard Ultra, select Admin from the left navigation.)

 

  1. On the Systems Admin screen, find Integrations, and then select LTI Tool Providers.

  1. On the LTI Tool Providers screen, select Register LTI 1.3/Advantage Tool

  1. Enter the Client ID provided by the SWEAP or your local institution’s SWEAP Program administrator, and select Submit.

    • The default production Client ID is 1480f1f4-3467-4491-aa18-6163e77648ee
    • The default development Client ID is c526e611-74e4-41c1-a83b-08583616ac9a

      showing client id

  2. On the Modify LTI 1.3 Tool screen, in the Tool Status section, notice that the fields for Default Deployment ID, Initiate Login URL, Tool Redirect URLs, JWKS URL, and Domain are auto-populated.

    Record the default deployment id.

    showing default deployment id highlight

  3. The subsequent fields for user fields are at the discretion of the institution, we recommend sending name and email for full usability of the site.
    Access to membership and acknowledgement is also not needed.
    Be sure to include roles. If your institution wishes to deidentify the data, then do not check name and email checkboxes.
    Be sure to allow postback for grades. When a learner completes an assessment, SWEAP will send a 100% to Blackboard. SWEAP always sends 100%, We do not send the raw student achievement score to Blackboard, see guide here: SWEAP is not an Exit or Entrance Exam.
    The program determines the value of the SWEAP instrument completion towards the student grade.

    Same institutional policies as before with SSL as the default options.

Confirming/Adding Placements:

Go To Administrator Panel, LTI Providers, Locate SWEAP Assessments PROD then manage placements you should be able to see a link for course content tool and a deep linking placement. These should be automatically populated. If for any reason you need to create a new placement, the required URL is https://sweapinstruments.org/lti/lti

Adding Connection To SWEAP

This step must be completed to enable the connectivity to SWEAP before adding an assignment.

  1. After getting the Client and Developer ID, you can now authorize the connection from the SWEAP side. Log into SWEAP and then go to The LTI 1.3 Settings Page . To gain access you can follow the instructions here: Adding Access To SWEAP
  2. Click Add New Integration, and fill out the data like so: You may also email the deployment id to phil@sweapinstruments.org
  3. Note if your institution uses ULTRA, the URLS are:
    1. Platform ID : https://blackboard.com
    2. Client ID:
      1. PROD: 1480f1f4-3467-4491-aa18-6163e77648ee
      2. TEST: c526e611-74e4-41c1-a83b-08583616ac9a
    3. Auth Request URL: https://developer.blackboard.com/api/v1/gateway/oidcauth
    4. Access Token URL: https://developer.blackboard.com/api/v1/gateway/oauth2/jwttoken
    5. Public Keyset (JWKS) URL: 
      1. PROD: https://developer.blackboard.com/api/v1/management/applications/1480f1f4-3467-4491-aa18-6163e77648ee/jwks.json
      2. TEST: https://developer.blackboard.com/api/v1/management/applications/c526e611-74e4-41c1-a83b-08583616ac9a/jwks.json
    6. Select Enabled – Use This Integration
  4. You’re now complete. Save the integration.

Adding An Assignment

You can then add SWEAP Instruments as an assignment, and then when it’s added, click on the added assignment, a screen will appear to allow you to select the correct assessment.  After you view the assessment the first time, a screen will pop up that will allow for you to select what instrument you want to administer.

As an administrator/course builder/instructor will need to pick an assessment type and press submit.

If this step is not complete, then the activity will not open for your learners.

  1. Click Add From Add Content Market in the course.
    Add From Content Market Button

  2. Find SWEAP Assessments Prod and select the “+” button to add the content. SWEAP supports deep linking. If you click on the SWEAP logo for deep linking, you can select multiple assessments and the plus button will create those assessments in that course context for you.
    highlighting content market's plus button

  3. A Link will now appear on the section. Open the newly created assignment as an instructor, the following screen will appear, select the appropriate instrument in SWEAP you need to administer. Click on the bottom Save button to continue.

  4. After saving it should show a success screen, scroll to the bottom of the list to “Set Up Gradebook” button to complete the gradebook setup.
    Note this screen also shows the resend completion status in case the grade does not transfer over.
    Highlighting Gradebook button
  5. Your gradebook should have a new exclamation mark indicating new additions. It will be listed as “SWEAP Completion” or the name of the instrument. 
    Showing new gradebook entry
  6. Finally when a grade is posted it will appear in the system.
    Showing Complete Grade Posting