Annotation of loncom/html/adm/help/tex/Docs_Adding_External_Tool.tex, revision 1.1
1.1 ! raeburn 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 type
! 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 Title -- title to use for tool instance on the Course Contents page.
! 43:
! 44: \end{itemize}
! 45:
! 46: If external LTI tools can be used in the course's domain, you will select the
! 47: name of the tool you wish to use from the ``Select'' drop-down list. Doing
! 48: so will cause the options for the tool to be displayed. If display is in
! 49: an iframe, by default, but you are permitted to choose one of the other types,
! 50: then click tab or window will cause additional elements to be displayed.
! 51:
! 52: Your domain coordinator can tell you what data are sent to the external tool
! 53: when it is displayed. Typically, though, this will include the username of the
! 54: user, as well as the user's current ``LTI'' role. LTI uses a more restricted
! 55: set of roles -- Instructor, Content Developer, Teaching Assistant or Learner --
! 56: than are available in LON-CAPA. Your domain coordinator will have decided on
! 57: the mapping to an LTI role to be used for each standard LON-CAPA role. At a minimum
! 58: you can expect that Course Coordinator (LON-CAPA) will map to Instructor (LTI),
! 59: Student (LON-CAPA) will map to Learner (LTI).
! 60:
! 61: Under the LTI protocol, the user's identity, as well as the course context, will
! 62: be sent to the external tool in an encrypted form, and the tool (the LTI Provider)
! 63: will trust the user's identity and role sent from LON-CAPA (the LTI Consumer),
! 64: and then assign appropriate privileges to the user within the tool.
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>