Return to Docs_Adding_External_Tool.tex CVS log

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

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.