--- loncom/html/adm/help/tex/Course_Prefs_ExternalTools.tex 2024/01/25 19:19:52 1.1 +++ loncom/html/adm/help/tex/Course_Prefs_ExternalTools.tex 2024/01/26 19:55:35 1.1.2.1 @@ -2,7 +2,7 @@ The domain coordinator for your domain can choose to enable definition and configuration of External Tools by course type, or for specific course(s). If tool definition is available in your course you will be able to use: Settings $>$ Course Settings $>$ Display (``External Tools'' checked) to create new External Tool definitions for use in your course, or to modify existing ones. -Note: External Tools may also have been defined at a domain level for use in your course. If the tool you want to use is already available then you do not need to define your own, but can simply click``External'' in the function categories listed at the right side of the Course Editor, below the editor tabs, and then click ``External Tool''. From there you'll choose `` Defined in domain'' and select the tool to add. If the tool you want to use is not available at a domain level, then after you have defined the tool (see below) clicking the ``Defined in course'' option will allow you to add an instance of that tool to the folder currently being edited. Tools added to the ``Supplemental content'' area will not store grades passed back from the Provider. If you wish to use that functionality you should add a tool instance to a folder or sub-folder in the ``Main Content'' area, and check ``Yes'' for Gradable. +Note: External Tools may also have been defined at a domain level for use in your course. If the tool you want to use is already available then you do not need to define your own, but can simply click``Upload'' in the function categories listed at the right side of the Course Editor, below the editor tabs, and then click ``External Tool''. From there you'll choose `` Defined in domain'' and select the tool to add. If the tool you want to use is not available at a domain level, then after you have defined the tool (see below) clicking the ``Defined in course'' option will allow you to add an instance of that tool to the folder currently being edited. Tools added to the ``Supplemental content'' area will not store grades passed back from the Provider. If you wish to use that functionality you should add a tool instance to a folder or sub-folder in the ``Main Content'' area, and check ``Yes'' for Gradable. By defining an External Tool in a course you enable use of LON-CAPA as an LTI Consumer (where LTI = Learning Tool Interoperability). Under the LTI protocol, the user's identity, as well as the course context, can be sent to the external tool (the Provider), which will trust the identity and role information provided by LON-CAPA (the Consumer). Any LON-CAPA data being provided are included in an encrypted form in the tool launch page sent to the user's web browser by LON-CAPA. The external tool will assign appropriate privileges to the user within the tool, based on the user's role. @@ -10,7 +10,7 @@ The shared key and secret used to encryp When you use Settings $>$ Course Settings $>$ Display (``External Tools'' checked) a table will be displayed listing all currently available External Tools (i.e., LTI Providers) defined in the course, as well as an ``Add'' checkbox (for the last row in the table), used to add a new External Tool. -Internally in LON-CAPA each external tool you configure for your course receives a unique numerical ID (starting at 1), which remains unchanged, regardless of any future changes made to the configuration for that particular tool. A drop-down list in the left column of the External Tools table can be used to change the order in which available tools are listed in both the configuration table, and also in the dropdown list in the ``External Tool'' item in the Course Editor (``External tab''), when one or more tools are available. +Internally in LON-CAPA each external tool you configure for your course receives a unique numerical ID (starting at 1), which remains unchanged, regardless of any future changes made to the configuration for that particular tool. A drop-down list in the left column of the External Tools table can be used to change the order in which available tools are listed in both the configuration table, and also in the dropdown list in the ``External Tool'' item in the Course Editor (``Upload'' tab), when one or more tools are available. Settings available in each External Tool definition are: