@@ -20,24 +20,21 @@ To create an annotation problem, you'll add the Annotation advanced component to
#. Add the Annotation advanced component.
#. On the **Settings** menu, click **Advanced Settings**.
#. From the **Settings** menu select **Advanced Settings**.
#. On the **Advanced Settings** page, locate the **Manual Policy Definition** section, and then locate the **advanced_modules** policy key (this key is at the top of the list).
#. In the field for the **Advanced Module List** policy key, place your
cursor between the brackets.
.. image:: /Images/AdvancedModulesEmpty.png
:alt: Image of the Manual Policy Definition section of the Advanced Settings page
3. Under **Policy Value**, place your cursor between the brackets, and
then enter the following. Make sure to include the quotation marks.
#. Enter the following value. Make sure to include the quotation marks.
``"annotatable"``
#. At the bottom of the page, click **Save Changes**.
4. At the bottom of the page, click **Save Changes**.
The page refreshes automatically. At the top of the page, you see a
notification that your changes have been saved.
#. Return to the unit where you want to add the specialized problem. The
5. Return to the unit where you want to add the specialized problem. The
list of possible components now contains an Advanced component.
.. image:: /Images/AdvancedComponent.png
...
...
@@ -46,8 +43,8 @@ To create an annotation problem, you'll add the Annotation advanced component to
2. Add the **Instructions** and **Guided Discussion** segments of the
problem.
#. In the unit where you want to create the problem, click **Advanced**
under **Add New Component**.
#. In the unit where you want to create the problem, under **Add New
Component** click **Advanced**.
#. In the list of problem types, click **Annotation**.
#. In the component that appears, click **Edit**.
#. In the component editor, replace the example code with your own code.
- You can add external LTI content that is displayed only, such as
textbook content that doesn’t require a student response.
- You can add external LTI content that requires a student response. An
external provider will grade student responses.
- You can use the component as a placeholder for syncing with an external grading system.
* You can add external LTI content that is displayed only, such as textbook
content that doesn’t require a student response.
* You can add external LTI content that requires a student response. An external
provider will grade student responses.
* You can use the component as a placeholder for syncing with an external
grading system.
For example, the following LTI component incorporates a Cerego tool that students interact with.
...
...
@@ -40,7 +43,8 @@ unit, you need the following information.
provider. The launch URL is the URL that Studio sends to the external
LTI provider so that the provider can send back students’ grades.
- The **lti_passports** policy key. This policy key has three parts: an LTI ID, a client key, and a client secret.
- The **LTI Passports** policy key. This policy key has three parts: an LTI ID,
a client key, and a client secret.
- The **LTI ID**. This is a value that you create to refer to the external LTI
provider. You should create an LTI ID that you can remember easily.
...
...
@@ -61,11 +65,11 @@ unit, you need the following information.
may be a string of numbers and letters such as **23746387264** or
**yt4984yr8**.
To create the **lti_passports** policy key, combine the LTI ID, client key, and client secret in the following format (make sure to include the colons):
To create the **LTI Passports** policy key, combine the LTI ID, client key, and client secret in the following format (make sure to include the colons):
``lti_id:client_key:client_secret``
For example, an **lti_passports** policy key may resemble any of the following:
For example, an **LTI Passports** policy key may resemble any of the following:
#. On the **Settings** menu, click **Advanced Settings**.
#. On the **Advanced Settings** page, locate the **advanced_modules** policy key (this key is at the top of the list).
#. In the field for the **Advanced Module List** policy key, place your cursor
between the brackets.
#. Under **Policy Value**, place your cursor between the brackets, and
then enter ``“lti”``. Make sure to include the quotation marks, but
not the period.
#. Enter ``“lti”``. Make sure to include the quotation marks, but not the
period.
.. image:: /Images/LTIPolicyKey.png
:width: 500
:alt: Image of the advanced_modules key in the Advanced Settings page, with the LTI value added
**Note** If the **Policy Value** field already contains text, place your
cursor directly after the closing quotation mark for the final item, and
then enter a comma followed by ``“lti”`` (make sure that you include the
quotation marks).
.. note:: If the **Advanced Module List** field already contains text, place your cursor directly
after the closing quotation mark for the final item, and then enter a comma
followed by ``“lti”`` (make sure that you include the quotation marks).
#. At the bottom of the page, click **Save Changes**.
4. At the bottom of the page, click **Save Changes**.
The page refreshes automatically. At the top of the page,
you see a notification that your changes have been saved.
...
...
@@ -113,18 +116,23 @@ you see a notification that your changes have been saved.
Step 2. Register the External LTI Provider
==========================================
To register the external LTI provider, you’ll add the **lti_passports** policy key to the course's advanced settings.
To register the external LTI provider, you’ll add the **LTI Passports** policy
key to the course's advanced settings.
#. On the **Advanced Settings** page, locate the **lti_passports**
#. On the **Advanced Settings** page, locate the **LTI Passports**
policy key.
#. In the **Policy Value** field for the **lti_passports** policy key, place your cursor between the brackets, and then enter the **lti_passports** policy key surrounded by quotation marks.
#. Place your cursor between the brackets.
#. Enter the **LTI Passports** policy key surrounded by quotation marks.
For example, the text in the **Policy Value** field may resemble the following.
For example, the text in the **LTI Passports** field may resemble the following.
If you have multiple LTI providers, separate the values for each **lti_passports** policy key with a comma. Make sure to surround each entry with quotation marks.
If you have multiple LTI providers, separate the values for each **LTI
Passports** policy key with a comma. Make sure to surround each entry with
quotation marks.
.. code-block:: xml
...
...
@@ -132,12 +140,11 @@ To register the external LTI provider, you’ll add the **lti_passports** policy
@@ -34,11 +34,16 @@ Step 1. Obtain Information from VitalSource
To create a VitalSource Bookshelf e-reader, you need the following information from Vital Source:
- The **lti_passports** policy key. This policy key enables you to create an LTI component for the VitalSource Bookshelf e-reader. For more information about the **lti_passports** policy key, see :ref:`LTI Information` in :ref:`LTI Component`.
- The **LTI Passports** policy key. This policy key enables you to create an
LTI component for the VitalSource Bookshelf e-reader. For more information
about the **LTI Passports** policy key, see :ref:`LTI Information` in
:ref:`LTI Component`.
- The Vital Souce Book ID (VBID) for your e-book. This is a specific code that Vital Source creates for the book when Vital Source adds the e-book to its inventory.
To obtain this information, your course team selects a member point person (MPP) to work with Vital Source. Vital Source delivers the **lti_passports** policy key and VBID to the MPP.
To obtain this information, your course team selects a member point person
(MPP) to work with Vital Source. Vital Source delivers the **LTI Passports**
policy key and VBID to the MPP.
.. _VS Modify Advanced Settings:
...
...
@@ -47,30 +52,36 @@ To obtain this information, your course team selects a member point person (MPP)
Step 1. Modify the Course's Advanced Settings
=============================================
In this step, you'll modify the course's advanced settings to allow you to create an LTI component and add the **lti_passports** policy key for Vital Source.
In this step, you'll modify the course's advanced settings to allow you to
create an LTI component and add the **LTI Passports** policy key for Vital
Source.
#. In Studio, click the **Settings** menu, and then click **Advanced Settings**.
#. On the **Advanced Settings** page, locate the **advanced_modules** policy key.
#. In the field for the **Advanced Module List** policy key, place your cursor
between the brackets.
#. Under **Policy Value**, place your cursor between the brackets, and then enter ``“lti”``. Make sure to include the quotation marks, but not the period.
#. Enter ``“lti”``. Make sure to include the quotation marks, but not the
period.
.. image:: /Images/LTIPolicyKey.png
:alt: Image of the advanced_modules key in the Advanced Settings page, with the LTI value added
:alt: Image of the Advanced Module List key in the Advanced Settings page, with the LTI value added
**Note** If the **Policy Value** field already contains text, place your cursor directly after the closing quotation mark for the final item, and then enter a comma followed by ``“lti”`` (make sure that you include the quotation marks). For example, the text in the **Policy Value** field may resemble the following:
.. note:: If the value field already contains text, place your cursor directly after the closing quotation mark for the final item, and then enter a comma followed by ``“lti”`` (make sure that you include the quotation marks). For example, the value for **Advanced Module List** may resemble the following:
``["value_1","lti"]``
4. Scroll down to the **lti_passports** policy key.
4. Scroll down to the **LTI Passports** policy key.
#. Under **Policy Value**, place your cursor between the brackets, and then enter the value for the **lti_passports** policy key that you obtained from Vital Source. Make sure to surround the value with quotation marks.
#. In the policy value field, place your cursor between the brackets, and then
enter the value for the **LTI Passports** policy key that you obtained from
Vital Source. Make sure to surround the value with quotation marks.
For example, the value in this field may resemble the following:
For example, the value in this field may resemble the following:
#. On the **Settings** menu, click **Advanced Settings**.
#. On the **Advanced Settings** page, locate the **Manual Policy Definition** section, and then locate the **advanced_modules** policy key (this key is at the top of the list).
#. In the field for the **Advanced Module List** policy key, place your
cursor between the brackets.
#. Under **Policy Value**, place your cursor between the brackets, and
then enter the following. Make sure to include the quotation marks.
#. Enter the following value. Make sure to include the quotation marks.
``"word_cloud"``
#. At the bottom of the page, click **Save Changes**.
4. At the bottom of the page, click **Save Changes**.
The page refreshes automatically. At the top of the page, you see a
notification that your changes have been saved.
#. Return to the unit where you want to add the specialized problem. The
5. Return to the unit where you want to add the specialized problem. The
list of possible components now contains an Advanced component.
#. In the unit where you want to create the problem, click **Advanced**
