Annotation of loncom/html/adm/help/tex/Docs_Adding_External_Tool.tex, revision 1.2.2.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:
1.2 raeburn 42: \item Append to URL -- you can specify text to append to the default URL
43: (shown) which will be requested on launch.
44:
1.1 raeburn 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.
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>