[LON-CAPA-cvs] cvs: loncom /html/adm/help/tex Docs_Adding_External_Tool.tex

[raeburn]

raeburn		Thu Jan 25 19:51:24 2024 EDT

  Modified files:              
    /loncom/html/adm/help/tex	Docs_Adding_External_Tool.tex 
  Log:
  - Documentation for management of External Tool instances in Course Editor
    updated with information about availability of tools defined in course.
  
  
Index: loncom/html/adm/help/tex/Docs_Adding_External_Tool.tex
diff -u loncom/html/adm/help/tex/Docs_Adding_External_Tool.tex:1.3 loncom/html/adm/help/tex/Docs_Adding_External_Tool.tex:1.4
--- loncom/html/adm/help/tex/Docs_Adding_External_Tool.tex:1.3	Sun May 24 22:20:40 2020
+++ loncom/html/adm/help/tex/Docs_Adding_External_Tool.tex	Thu Jan 25 19:51:24 2024
@@ -1,10 +1,13 @@
 \label{Docs_Adding_External_Tool}
 
-External tools which support the LTI (Learning Tool Interoperability)
-standard can be included within a LON-CAPA course.  Which tools are available,
-as well as the options which can be set by a Coordinator when including 
-one of the available tools within a course or community, are set by the Domain 
-Coordinator at a domain level. 
+A domain coordinator determines whether External Tools which support the LTI 
+(Learning Tool Interoperability) standard should be available in each course
+type, or in specific course(s), and also whether definition and configuration
+of such tools are permitted within your course.
+
+External Tools may have been defined at a domain level for use in your course, 
+and if so, the options which can be set when including one of the available tools 
+within a course or community, will also have been set in the domain.
 
 The full range of options which may be available to the Coordinator in the course
 or community are:
@@ -50,18 +53,24 @@
 
 \end{itemize}
 
-If external LTI tools can be used in the course's domain, you will select the
-name of the tool you wish to use from the ``Select'' drop-down list. Doing 
+If External Tools can be used in the course's domain, you will choose
+either ``Defined in domain'' or ``Defined in course'' to populate the
+``Select'' drop-down list with a list of available tools. Choose the 
+name of the tool you wish to use from the drop-down list. Doing 
 so will cause the options for the tool to be displayed. If display is in
 an iframe, by default, but you are permitted to choose one of the other types,
 then click tab or window will cause additional elements to be displayed.
 
-Your domain coordinator can tell you what data are sent to the external tool
-when it is displayed. Typically, though, this will include the username of the
-user, as well as the user's current ``LTI'' role. LTI uses a more restricted
-set of roles -- Instructor, Content Developer, Teaching Assistant or Learner --
-than are available in LON-CAPA. Your domain coordinator will have decided on
-the mapping to an LTI role to be used for each standard LON-CAPA role. At a minimum
+For tools defined in the domain, your domain coordinator can tell you what
+data are sent to the external tool when it is displayed.  Typically, though,  
+this will include the username of the user, as well as the user's current 
+``LTI'' role. For tools defined in the course, you can see what data are sent
+ny using Settings $>$ Course Settings $>$ Display (``External Tools'' checked).
+
+LTI uses a more restricted set of roles -- Instructor, Content Developer,
+Teaching Assistant or Learner -- than are available in LON-CAPA. For tools
+defined in the domain, your domain coordinator will have decided on the
+mapping to an LTI role to be used for each standard LON-CAPA role. At a minimum
 you can expect that Course Coordinator (LON-CAPA) will map to Instructor (LTI),
 Student (LON-CAPA) will map to Learner (LTI).