Return to Docs_Adding_External_Tool.tex CVS log

Up to [LON-CAPA] / loncom / html / adm / help / tex

- For 2.11.2 (modified)
  Include changes in 1.3

    1: \label{Docs_Adding_External_Tool}
    2: 
    3: External tools which support the LTI (Learning Tool Interoperability)
    4: standard can be included within a LON-CAPA course.  Which tools are available,
    5: as well as the options which can be set by a Coordinator when including 
    6: one of the available tools within a course or community, are set by the Domain 
    7: Coordinator at a domain level. 
    8: 
    9: The full range of options which may be available to the Coordinator in the course
   10: or community are:
   11: 
   12: \begin{itemize}
   13: 
   14: \item Display target
   15: \begin{itemize}
   16: \item iframe -- the tool will be launched within the standard interface, (i.e.,
   17: inline menu including navigation controls, and links/icons)
   18: 
   19: \item tab -- a page containing a link to launch the tool will be displayed
   20: in a separate web browser tab.
   21: 
   22: \item window -- a page containing a link to launch the tool will be displayed
   23: in a separate web browser window.
   24: 
   25: \end{itemize}
   26: 
   27: \item Display options -- if display is tab or window, additional options may be available:
   28: 
   29: \begin{itemize}
   30: 
   31: \item Link Text -- the text used in the link which launches the tool
   32: \item Explanation -- optional text block (HTML mark-up can be used)
   33: displayed below the link
   34: \item Width/Height -- if display is window, width and height of the new window
   35: can be set by specifying the number of pixels to use for each. 
   36: 
   37: \end{itemize}
   38: 
   39: \item Course label -- e.g., institutional course code (sent on launch of tool)
   40: \item Course title -- Course Title
   41: 
   42: \item Append to URL -- you can specify text to append to the default URL 
   43: (shown) which will be requested on launch.
   44: 
   45: \item Title -- title to use for tool instance on the Course Contents page.
   46: 
   47: \end{itemize}
   48: 
   49: If external LTI tools can be used in the course's domain, you will select the
   50: name of the tool you wish to use from the ``Select'' drop-down list. Doing 
   51: so will cause the options for the tool to be displayed. If display is in
   52: an iframe, by default, but you are permitted to choose one of the other types,
   53: then click tab or window will cause additional elements to be displayed.
   54: 
   55: Your domain coordinator can tell you what data are sent to the external tool
   56: when it is displayed. Typically, though, this will include the username of the
   57: user, as well as the user's current ``LTI'' role. LTI uses a more restricted
   58: set of roles -- Instructor, Content Developer, Teaching Assistant or Learner --
   59: than are available in LON-CAPA. Your domain coordinator will have decided on
   60: the mapping to an LTI role to be used for each standard LON-CAPA role. At a minimum
   61: you can expect that Course Coordinator (LON-CAPA) will map to Instructor (LTI),
   62: Student (LON-CAPA) will map to Learner (LTI).
   63: 
   64: Under the LTI protocol, the user's identity, as well as the course context, will
   65: be sent to the external tool in an encrypted form, and the tool (the LTI Provider)
   66: will trust the user's identity and role sent from LON-CAPA (the LTI Consumer),
   67: and then assign appropriate privileges to the user within the tool.