Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions source/instructors/admin/integration/intro.rst
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ Integrating with your LMS system (Canvas etc.)
lms-systems/system-specific-directions
lms-students
lti-enrol
open-student-assignments-lms
grading
lti-app
lti-keys-and-urls-information
Expand Down
12 changes: 6 additions & 6 deletions source/instructors/admin/integration/lms-systems/blackboard.rst
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
Blackboard LTI 1.x
==================

Please be sure to check out the :ref:`Codio LTI App <lti-app>` which allows for an easy way to integrate and to map Codio course assignments to your LMS system. The `following page <http://library.blackboard.com/ref/df5b20ed-ce8d-4428-a595-a0091b23dda3/Content/_admin_app_system/admin_app_basic_lti_tool_providers.htm>`_ explains how to set up external apps in Blackboard Learn.
Please be sure to check out the :ref:`Codio LTI App <lti-app>` which allows for an easy way to integrate and to map Codio course assignments to your LMS. The `following page <https://library.blackboard.com/ref/df5b20ed-ce8d-4428-a595-a0091b23dda3/Content/_admin_app_system/admin_app_basic_lti_tool_providers.htm>`_ explains how to set up external apps in Blackboard Learn.

In Codio:

Expand All @@ -26,8 +26,8 @@ Enable LTI for Your Course
Bring up the LTI Integration Information
----------------------------------------

6. Click your user name in the bottom left of your dashboard
7. Choose your Organization
6. Click your username in the top-right corner of your dashboard.
7. Choose your Organization.
8. Click the **LTI Integrations** tab to bring up the following settings.

.. image:: /img/lti/LTIintegrationinfo.png
Expand Down Expand Up @@ -81,7 +81,7 @@ In Codio
24. On the main course screen, make sure the **Edit Assignments** tab is selected.
25. Click the **Add Assignment** button and select **Project Based**.
26. Select a project that has some autograded assessments. The **My First Project** that you created earlier in the Onboarding Guide has some auto-graded assessments. You can also assign another project but you will need to manually grade the assignment so there are some scores to pass back to the Blackboard gradebook.
27. Once the assignment has been added to the course, you should click the icon with 3 blue dots and select **LTI Integration URL**.
27. Once the assignment has been added to the course, you should click the three dots to the right of that assignment and select **LTI Integration URL**.
28. You should copy the LTI integration url to the clipboard by clicking on the field (it will auto copy).

.. figure:: /img/lti/LMS-Unit-URL.png
Expand All @@ -99,12 +99,12 @@ We now return to Blackboard complete the mapping.
33. In the **Web Link Information** section ...
34. Enter a name for the content
35. Paste in the **LTI Integration URL** that you just copied to the clipboard from Codio
36. Check the box **Ths is a link to a tool provider**
36. Check the box **This is a link to a tool provider**
37. Select **Yes** for the field **Enable Evaluation** after which more fields will appear
38. Set the points you want to award for this content (Codio will automatically scale the percentage value it uses to the points you specify here)
39. Save the content settings.

Authentication and account creation
-----------------------------------

To add students/teachers see :ref:`Users account creation <lms-users>`
To add students/teachers, see :ref:`User account creation <lms-users>`.
4 changes: 3 additions & 1 deletion source/instructors/admin/integration/lms-systems/d2l.rst
Original file line number Diff line number Diff line change
Expand Up @@ -61,7 +61,7 @@ Enable LTI for Your Course
Bring up the LTI Integration Information
****************************************

1. Click your user name in the bottom left of your dashboard.
1. Click your username in the top-right corner of the dashboard, then select **Organizations**.
2. Choose your Organization.
3. Click the **LTI Integrations** tab to bring up the following settings.

Expand Down Expand Up @@ -144,3 +144,5 @@ Based on the LMS role, if teachers join Codio via the LMS, the following will ap
+----------------------+-----------------------------------------------------------------------------------------------------+
| Mentor | TEACHER (with :ref:`read only <add-teachers>` access to the course} |
+----------------------+-----------------------------------------------------------------------------------------------------+

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why did this get added here?


Original file line number Diff line number Diff line change
Expand Up @@ -64,3 +64,5 @@ Removing
.. Note:: Removing the integration link will mean students will not be able to access any of their assignments any longer from Google Classroom

.. |Connect to Codio| image:: /img/google_classlist.png


Original file line number Diff line number Diff line change
Expand Up @@ -112,4 +112,6 @@ In Schoology
23. Go back to Schoology and paste the **LTI Integration URL** into the URL field of the Add External Tool form from step 20.
24. You can enable grading on external tool items which adds the material to your Gradebook so that you can assign a grade for each student who completes the assignment launched via the external tool.

.. Note:: LTI and external tool materials that have grading enabled in Schoology do not trigger submission notifications, grading reminders, or overdue notifications because Schoology does not automatically detect submissions from external tools.
.. Note:: LTI and external tool materials that have grading enabled in Schoology do not trigger submission notifications, grading reminders, or overdue notifications because Schoology does not automatically detect submissions from external tools.


37 changes: 0 additions & 37 deletions source/instructors/admin/integration/lti-app.rst
Original file line number Diff line number Diff line change
Expand Up @@ -201,43 +201,6 @@ LTI 1.1



LTI 1.3
"""""""

**Custom parameters claim object**
specified in https://purl.imsglobal.org/spec/lti/claim/custom

**actual_user**


+------------------+---------------------------------------------------------------+--------------------------------------------------+
| Parameter | Description | Example |
+==================+===============================================================+==================================================+
| id | id= lms user identification | "actual_user_id": "123" |
| | | |
| | This is equivalent of sub when the request is executed | |
| | without changing the current user. | |
+------------------+---------------------------------------------------------------+--------------------------------------------------+
| email | email= actual user email | |
| | | |
| | This will be used for registration if | "actual_user_email": "lms-admin@email.com" |
| | custom_actual_user_id is not matched to an existed user. | |
+------------------+---------------------------------------------------------------+--------------------------------------------------+
| role | role= actual user role | |
| | | |
| | This should not be Student-like role. | "actual_user_role": "Instructor" |
+------------------+---------------------------------------------------------------+--------------------------------------------------+
| given_name | given_name= actual user given name | "actual_user_given_name": "Name" |
+------------------+---------------------------------------------------------------+--------------------------------------------------+
| family_name | family_name= actual user family name | "actual_user_family_name": "Family" |
+------------------+---------------------------------------------------------------+--------------------------------------------------+
| full_name | full_name= actual user full name | |
| | | |
| | This could be omitted if | "actual_user_full_name": "Name Family" |
| | custom_actual_user_name_family and | |
| | custom_actual_user_name_given passed. | |
+------------------+---------------------------------------------------------------+--------------------------------------------------+

.. Note:: The parameters should be set by LMS dynamically based on current user, not statically. If you need assistance contact help@codio.com

.. important:: Canvas/Moodle/Blackboard do not support this feature.
Expand Down
31 changes: 6 additions & 25 deletions source/instructors/admin/integration/lti1-3BS-D2L.rst
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,12 @@ Access LTI Integration settings in Codio
Copy fields from Codio to Brightspace/D2L
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. important::
When copying links, please use the copy button adjacent to each link to ensure accuracy and prevent linking errors.




.. figure:: /img/lti/codiolti13settings.png
:alt: LTI 1.3 settings in Codio
:width: 350px
Expand Down Expand Up @@ -122,28 +128,3 @@ First enable :ref:`LTI Constant URLs <lti-keys-and-urls-information>` for your c



LTI 1.3 Dynamic Registration
-----------------------------


Dynamic Registration simplifies the setup process by automatically sharing configuration information between Tools and LMS systems.


Access LTI Integration Settings in Codio
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~


.. image:: /img/lti/codiolti13settings.png
:alt: LTI 1.3 settings in Codio
:align: right
:width: 350px
:class: img-responsive


1. Click your username in the top-right corner, then select **Organizations** from the menu.
2. In the **Organizations** area, click the name of your organization.
3. Select the **LTI Integrations** tab.
4. Scroll down to the **LTI Integration 1.3** section.
5. The **Dynamic Registration URL** is at the bottom of the list, you can copy it by clicking on the **Dynamic Registration URL** button.


139 changes: 0 additions & 139 deletions source/instructors/admin/integration/lti1-3Blackboard.rst
Original file line number Diff line number Diff line change
Expand Up @@ -77,142 +77,3 @@ In Blackboard:
- Paste the **LTI Integration URL** you copied in the last step into the **Configuration URL** field for your assignments.


Blackboard LTI 1.x
-------------------

Please be sure to check out the :ref:`Codio LTI App <lti-app>` which allows for an easy way to integrate and to map Codio course assignments to your LMS. The `following page <https://library.blackboard.com/ref/df5b20ed-ce8d-4428-a595-a0091b23dda3/Content/_admin_app_system/admin_app_basic_lti_tool_providers.htm>`_ explains how to set up external apps in Blackboard Learn.

In Codio:

Enable LTI for Your Course
~~~~~~~~~~~~~~~~~~~~~~~~~~

1. Open the course you would like to connect or create a new course.
2. Make sure you have at least one published assignment or add a new one. (see :ref:`Add and Remove Course Assignments <add-remove-assignment>`)
3. Select the **LTI/LMS** tab.
4. Select the **ENABLE LTI** option.

.. image:: /img/lti/enable-lti.png
:alt: enable lti

5. Click **Save Changes**.

Bring up the LTI Integration Information
----------------------------------------

6. Click your user name in the bottom left of your dashboard
7. Choose your Organization
8. Click the **LTI Integrations** tab to bring up the following settings.

.. image:: /img/lti/LTIintegrationinfo.png
:alt: Org LTI info


In Blackboard
~~~~~~~~~~~~~

The Blackboard user who carries out these steps must be a Blackboard system administrator.

9. Create a new Course in Blackboard. We suggest you create a test course called **Codio Blackboard** before you do it with a production course.
10. Look for the **System Admin** tab near the top right of the page and select it.
11. Look for the **Building Blocks** section and select it.
12. Click on **LTI tool providers**.
13. Click on **Register Provider Domain** in the menu bar.
14. In the **Provider Domain** field, enter ``apollo.codio.com``.
15. In the **Default Configuration** section, set **Default Configuration** to be **Set globally**.
16. In the **Organization Policies** section you should
17. set **Send User Data** to **Send user data only over SSL**.
18. in **User Fields to Send** you should set all 3 fields (Constituency in Course, Name, Email Address).

In Codio and Blackboard
~~~~~~~~~~~~~~~~~~~~~~~

19. Now return to the **Default Configuration** section in Blackboard. We will now copy the following global integration fields from Codio to Blackboard.

- LTI Consumer -> Tool Provider Key
- LTI Secret -> Tool Provider Secret

Codio course setup
------------------

You need to perform the following actions one time only for a course. The Blackboard user who carries out these steps does not need to be a system administrator but must have suitable privileges to edit courses and assignments.

20. In Codio, go to your course and click on the **LTI/LMS** tab.
21. Go to the **LTI/LMS Settings** area.
22. At the top is a switch **Enable LTI** which you should check is enabled.
23. Below this is an empty field **Course LMS URL**. Switch back to Blackboard and make sure you are on the main the Codio Blackboard course you created earlier. Copy the url in the address bar of your browser to the clipboard and paste it into the above mentioned field in Codio.

This URL ensures that Codio knows how to redirect students back to the correct Blackboard course should they attempt to access the course through their dashboard.

Mapping an assignment to Blackboard Content
-------------------------------------------

The final mapping step needs to be taken for each individual assignment within Codio. It maps a piece of Blackboard content to a Codio assignment.

In Codio
~~~~~~~~

24. On the main course screen, make sure the **Edit Assignments** tab is selected.
25. Click the **Add Assignment** button and select **Project Based**.
26. Select a project that has some autograded assessments. The **My First Project** that you created earlier in the Onboarding Guide has some auto-graded assessments. You can also assign another project but you will need to manually grade the assignment so there are some scores to pass back to the Blackboard gradebook.
27. Once the assignment has been added to the course, you should click the 3 dots to the right of that assignment and select **LTI Integration URL**.
28. You should copy the LTI integration url to the clipboard by clicking on the field (it will auto copy).

.. figure:: /img/lti/LMS-Unit-URL.png
:alt: Unit URL

In Blackboard
~~~~~~~~~~~~~

We now return to Blackboard complete the mapping.

29. Make sure you have selected the Blackboard course.
30. Click **Content** in the left hand menu.
31. Select or hover over **Build Content** in the menu bar
32. Select **Web Link**.
33. In the **Web Link Information** section ...
34. Enter a name for the content
35. Paste in the **LTI Integration URL** that you just copied to the clipboard from Codio
36. Check the box **This is a link to a tool provider**
37. Select **Yes** for the field **Enable Evaluation** after which more fields will appear
38. Set the points you want to award for this content (Codio will automatically scale the percentage value it uses to the points you specify here)
39. Save the content settings.

Authentication and account creation
-----------------------------------

To add students/teachers see :ref:`Users account creation <lms-users>`

LTI 1.3 Dynamic Registration
-----------------------------


Dynamic Registration simplifies the setup process by automatically sharing configuration information between Tools and LMS systems.


Access LTI Integration Settings in Codio
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~


.. image:: /img/lti/codiolti13settings.png
:alt: LTI 1.3 settings in Codio
:align: right
:width: 350px
:class: img-responsive


1. Click your username in the top-right corner, then select **Organizations** from the menu.
2. In the **Organizations** area, click the name of your organization.
3. Select the **LTI Integrations** tab.
4. Scroll down to the **LTI Integration 1.3** section.
5. The **Dynamic Registration URL** is at the bottom of the list, you can copy it by clicking on the **Dynamic Registration URL** button.










Loading