Annotation of loncom/html/adm/help/tex/Slot_Use.tex, revision 1.1

1.1     ! raeburn     1: \label{Slot_Use}
        !             2: 
        !             3: If you wish to restrict access to content in a course to particular IP address(es) 
        !             4: and/or dates, one way to do that would be to use the ``Client IP/Name Access Control'' parameter 
        !             5: to control access by IP address, and the parameters: Problem Opening Date/Problem Due Date 
        !             6: (for problems), and Content Open Date/Content Close Date (for other types of content) to 
        !             7: control access by date.
        !             8: 
        !             9: LON-CAPA also provides a separate mechanism to restrict access to assessment item(s), 
        !            10: i.e., resource(s) with a file extension of .problem or .Task, or a gradable external tool,
        !            11: which can be useful in the case where students will reserve access in advance to content 
        !            12: at a particular time and/or place. 
        !            13: 
        !            14: One example would be a laboratory which has limited seating, and which is offered multiple 
        !            15: times over a given time period, but for which students should only be able to reserve access 
        !            16: for one particular opportunity.  To support that type of scenario, slots would be used.
        !            17: 
        !            18: Slots can also provide access control in which a proctor either directly, or remotely, must 
        !            19: enter a pre-determined proctor username and passphrase to check-in a student into a slot. 
        !            20: Prior to check-in, the proctor can validate that the student who will receive access to 
        !            21: content protected by a slot is the actual owner of the username for whom access is 
        !            22: being granted.
        !            23: 
        !            24: One example would be an online exam in a testing center, in which a proctor would type in 
        !            25: the proctor username and passphrase into the proctor validation screen after verification of 
        !            26: the student's official photo ID.  Another example would be an online exam in which a remote 
        !            27: proctor would temporarily take control of the user's keyboard and enter the proctor username 
        !            28: and passphrase remotely into the user's web browser.
        !            29: 
        !            30: Lastly, slots can also be used as a reservation system, e.g., for office hours, where there 
        !            31: is no need for a student to actually submit anything to the assessment item for which access 
        !            32: is controlled by slots, but the time/date of the reservation itself made by a student to 
        !            33: gain access is of value. 
        !            34: 
        !            35: \textbf{Course Coordinator View}
        !            36: 
        !            37: There are two parts to the process of using slots to control access to assessment items.
        !            38: \begin{enumerate}
        !            39: 
        !            40: \item An instructor will create the slot using the Slot Management utility
        !            41: \item An instructor will assign use of slots to particular resource(s) in the course using 
        !            42: the Parameter Manager to set the ``Use slot based access controls'' (useslots) parameter 
        !            43: to one of the three ``Yes'' options.
        !            44: 
        !            45: \end{enumerate}
        !            46: 
        !            47: The slot management utility can also be used to modify slot settings after a slot has been 
        !            48: created.  Slots can be created in two ways:
        !            49: 
        !            50: \begin{itemize}
        !            51: 
        !            52: \item Interactively, by using the multi-page slot ``helper'' web form which prompts for the 
        !            53: choices to be made when configuring a slot.
        !            54:  
        !            55: \item By creating a comma-separated-value (CSV) file containing slot attributes and uploading 
        !            56: the file using the Slot Management utility.
        !            57: 
        !            58: \end{itemize}
        !            59: 
        !            60: \begin{figure}
        !            61: \begin{center}\includegraphics[width=0.70\paperwidth]{slots_creation}\end{center}
        !            62: \caption{Slot Creation Buttons}
        !            63: \end{figure}
        !            64: 
        !            65: In both cases an instructor will use the multi-page slot ``helper'' web form should modifications 
        !            66: be needed to the configuration of a slot after it has been created.
        !            67: 
        !            68: As Course Coordinator use Settings $>$ Slots to access the Slot Management Utility.
        !            69: 
        !            70: \begin{figure}
        !            71: \begin{center}\includegraphics[width=0.70\paperwidth]{slots_manager}\end{center}
        !            72: \caption{Slot Management Utility}
        !            73: \end{figure}
        !            74: 
        !            75: Slots are of two types:
        !            76: \begin{enumerate}
        !            77: 
        !            78: \item instructor-assigned
        !            79: \item student-schedulable
        !            80: 
        !            81: \end{enumerate}
        !            82: 
        !            83: In the case of an instructor-assigned slot, after a slot has been created, and the 
        !            84: ``Use slot based access controls'' (useslots) parameter has been set to yes, the name 
        !            85: of the slot needs to be included in the value set for the ``Slots of availability'' (available) 
        !            86: parameter. That parameter can contain multiple : separated slot names, if multiple 
        !            87: instructor-assigned opportunities are to be provided to students to access a particular 
        !            88: resource or folder.
        !            89: 
        !            90: \begin{figure}
        !            91: \begin{center}\includegraphics[width=0.70\paperwidth]{slots_instructor_assigned}\end{center}
        !            92: \caption{Parameter setting for instructor-assigned slot}
        !            93: \end{figure}
        !            94: 
        !            95: In the case of a student-schedulable slot, there is no need to set any parameter besides the 
        !            96: ``Use slot based access controls'' (useslots) parameter.
        !            97: 
        !            98: \begin{figure}
        !            99: \begin{center}\includegraphics[width=0.70\paperwidth]{slots_params}\end{center}
        !           100: \caption{Parameter setting for student-schedulable slot}
        !           101: \end{figure}
        !           102: 
        !           103: Although a Course Coordinator can use parameter management tools to display the ``Slots of 
        !           104: availability selected by student'' (availablestudent) parameter, those tools only allow it 
        !           105: to be set for the scope of a specific user.  In any event, there is no need to use those tools
        !           106: because the Slot Management Utility provides a mechanism to view a list of students who have 
        !           107: reserved a slot, and to remove some or all of the reservations, as needed.
        !           108: 
        !           109: For student-schedulable slots, each slot includes a History link below the Edit link in the
        !           110: leftmost column of the table of slots. The History link provides access to information about
        !           111: reservations changes for the slot, including who made the change, and in what context. 
        !           112: 
        !           113: \begin{figure}
        !           114: \begin{center}\includegraphics[width=0.70\paperwidth]{slots_summary_cc}\end{center}
        !           115: \caption{Reservation listing for student-schedulable slots}
        !           116: \end{figure}
        !           117: 
        !           118: The expectation for student-schedulable slots is that each student will use the `Reservations' 
        !           119: item included in the inline menu in a course with one or more such slots, in order to add, 
        !           120: change or drop reservations for resources which are using them.
        !           121: 
        !           122: In the case of a student-schedulable slot, the slot will only be selectable by the student 
        !           123: for use for any resources which require a slot (i.e., for which the value in effect for 
        !           124: the useslots parameter is yes), if all of the following are true:
        !           125: 
        !           126: \begin{itemize}
        !           127: 
        !           128: \item The resource is open, i.e., between open date and due date (if set).
        !           129: \item The slot start date is in the future.
        !           130: \item Any conditions on slot use based on resource, and/or section, and/or specific users are 
        !           131: met.
        !           132: 
        !           133: \end{itemize}
        !           134: 
        !           135: Further constraints on whether a particular student-schedulable slot will be selectable by 
        !           136: a student are available by setting one or more of:
        !           137: 
        !           138: \begin{enumerate}
        !           139: 
        !           140: \item Period of time when this slot can only be uniquely chosen
        !           141: \item Time students can start reserving
        !           142: \item Time students can no longer reserve
        !           143: \item Maximum number of students allowed in this slot
        !           144: 
        !           145: \end{enumerate}
        !           146: 
        !           147: \begin{figure}
        !           148: \begin{center}\includegraphics[width=0.80\paperwidth]{slots_timeline}\end{center}
        !           149: \caption{Reservability and Accessibility Timeline}
        !           150: \end{figure}
        !           151: 
        !           152: Note: a slot may not be reserved by a student after the open date/time of the slot.
        !           153: 
        !           154: If there are multiple items in a course for which ``useslots'' is set to yes, a student may 
        !           155: make multiple reservations with a single slot, if resource-use restrictions on the slot 
        !           156: permit it.
        !           157: 
        !           158: If there are multiple student-schedulable slots available in a course, with start times in 
        !           159: the future, more than one slot may be reserved by a particular student for a particular 
        !           160: resource, if uniqueness and/or resource use restrictions permit it.
        !           161: 
        !           162: \begin{figure}
        !           163: \begin{center}\includegraphics[width=0.80\paperwidth]{slots_uniqueness}\end{center}
        !           164: \caption{Uniqueness constraints for multiple slots}
        !           165: \end{figure}
        !           166: 
        !           167: Furthermore, both instructor-assigned slot(s) and student-schedulable slot(s) can be in 
        !           168: effect for a particular student for a particular resource.
        !           169: 
        !           170: On the student's side, information about items in course for which access is restricted 
        !           171: by slot is available from any of the following:
        !           172: 
        !           173: \begin{itemize}
        !           174: 
        !           175: \item The ``Manage Reservations'' utility accessed via the ``Reservations'' item in the inline menu.
        !           176: \item Status information for each resource in the Course Contents listing.
        !           177: \item Attempted display of the resource itself in the course.
        !           178: 
        !           179: \end{itemize}
        !           180: 
        !           181: In all three cases, if one or more slots have already been selected to apply to a 
        !           182: particular student when accessing that resource, and the end date/time has not yet 
        !           183: been reached, the description of the (selected) slot with the earliest (future) opening 
        !           184: date/time will be displayed alongside the resource name in the contents listing, or 
        !           185: below the message: ``Access requires reservation to work at specific time/place'', 
        !           186: when displaying the resource.
        !           187: 
        !           188: Prior to the start date/time both the ``Manage Reservations'' utility, reached via 
        !           189: ``Reservations'' in the inline menu and the URL for the resource itself, will provide buttons 
        !           190: to Change or Drop an existing reservation, or to Select another reservation.
        !           191: 
        !           192: When a student displays a resource for which a pre-assigned or selected slot is now open, 
        !           193: i.e., the start date/time of the slot is in the past, and the end date/time is in the 
        !           194: future, and any IP-based restrictions included for the slot are satisfied for the student's 
        !           195: current IP address, than either the resource will be displayed, or a Proctor validation 
        !           196: screen will be displayed in the case where check-in by a proctor has not yet occurred for 
        !           197: a slot which needs it.
        !           198: 
        !           199: If the useslots parameter for a resource is set to yes, and it has a slot scope which 
        !           200: applies to the enclosing map/folder, then there are two additional possibilites: either 
        !           201: check-in only applies to the resource itself, or check-in for a resource automatically 
        !           202: propagates the checked-in status to other resources in the same map/folder.
        !           203: 
        !           204: Once checked-in, the resource itself will be displayed, and the countdown icon above the
        !           205: resource will countdown to the earliest of the following:
        !           206: 
        !           207: \begin{itemize}
        !           208: 
        !           209: \item the due date/time
        !           210: \item the slot end date/time,
        !           211: \item the time-limit, for a resource or folder in which the interval (time-limit) parameter
        !           212: is in use (after the ``Show Resource'' button has been pushed to start the timer).
        !           213: 
        !           214: \end{itemize}
        !           215: 
        !           216: Once the slot end date/time is reached for the checked-in slot currently in effect for access 
        !           217: to the resource, if there are additional slot(s) which may be used to satisfy the ``useslots'' 
        !           218: requirement for access, those slot(s) will then come into play.
        !           219: 
        !           220: If there is a student-schedulable slot, which is reservable (i.e., both the slot start time 
        !           221: and end reservation time are in the future, and if a cap on number of students, if set, has 
        !           222: not been reached), then a student can reserve the slot in order to resume access to the 
        !           223: resource after the slot start time (which could require new proctor validation).
        !           224: 
        !           225: Conversely, if the student already has a reservation for this second slot for this particular 
        !           226: resource, then assuming IP-based restrictions are met, the student will either be shown a 
        !           227: proctor validation screen if the slot uses a proctor, or if not, will be checked-in 
        !           228: automatically when displaying the resource.
        !           229: 
        !           230: \begin{figure}
        !           231: \begin{center}\includegraphics[width=0.65\paperwidth]{slots_proctor_validate}\end{center}
        !           232: \caption{Proctor validation screen}
        !           233: \end{figure}
        !           234: 
        !           235: \textbf{Student View}
        !           236: 
        !           237: In the case where an open resource has slot-based access, the Course Contents listing will
        !           238: include information about the current reservation status.
        !           239: 
        !           240: \begin{figure}
        !           241: \begin{center}\includegraphics[width=0.60\paperwidth]{slots_navmaps}\end{center}
        !           242: \caption{Contents Listing with Reservation Status}
        !           243: \end{figure}
        !           244: 
        !           245: The expectation for student-schedulable slots is that each student will use the `Reservations'
        !           246: item included in the inline menu in a course with one or more such slots, in order to add
        !           247: change or drop reservations for resources in a course which use them. 
        !           248: 
        !           249: \begin{figure}
        !           250: \begin{center}\includegraphics[width=0.70\paperwidth]{slots_student_reserve}\end{center}
        !           251: \caption{Interface for Initial Reservation}
        !           252: \end{figure}
        !           253: 
        !           254: If there is no `uniquely-chosen' restriction in force, then Select button(s) will be available 
        !           255: for additional slots after making a reservation. If, however, slots can only be selected one at 
        !           256: a time then the other Select button(s) will become `Change reservation' button(s) after a reservation 
        !           257: has been made.  If a student wants to display just a single resource for which student-schedulable slots 
        !           258: are available then if the resource itself is accessed before the slot start time the same `Select' 
        !           259: button(s) will be shown for applicable slot(s).
        !           260: 
        !           261: \begin{figure}
        !           262: \begin{center}\includegraphics[width=0.70\paperwidth]{slots_change_resv}\end{center}
        !           263: \caption{Interface for Additional Reservation}
        !           264: \end{figure}
        !           265: 
        !           266: If the `Change Reservation' button is pushed then a confirmation page will be displayed 
        !           267: which includes a `Process the change' button to push to complete the switch of reservation
        !           268: (with `uniquely-chosen' restriction) from one slot to another.
        !           269: 
        !           270: \begin{figure}
        !           271: \begin{center}\includegraphics[width=0.70\paperwidth]{slots_change_confirm}\end{center}
        !           272: \caption{Reservation switch confirmation}
        !           273: \end{figure}
        !           274: 
        !           275: Once the slot start time is reached, when a student accesses the particular assignment either
        !           276: the resource will be displayed immediately (assuming any location-based conditions are met),
        !           277: or if proctor validation is required, a web form will be displayed which requires entry of
        !           278: the proctor's username and the secret word used for check-in, as set in the particular slot's 
        !           279: configuration.

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>