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

1.1.2.5 ! raeburn     1: \label{Slot_Use}\index{slots}\index{reservations}
1.1       raeburn     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: 
1.1.2.2   raeburn     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, which can be useful in the 
1.1.2.1   raeburn    11: case where students will reserve access in advance to content at a particular time and/or place.
1.1       raeburn    12: 
                     13: One example would be a laboratory which has limited seating, and which is offered multiple 
                     14: times over a given time period, but for which students should only be able to reserve access 
                     15: for one particular opportunity.  To support that type of scenario, slots would be used.
                     16: 
                     17: Slots can also provide access control in which a proctor either directly, or remotely, must 
                     18: enter a pre-determined proctor username and passphrase to check-in a student into a slot. 
                     19: Prior to check-in, the proctor can validate that the student who will receive access to 
                     20: content protected by a slot is the actual owner of the username for whom access is 
                     21: being granted.
                     22: 
                     23: One example would be an online exam in a testing center, in which a proctor would type in 
                     24: the proctor username and passphrase into the proctor validation screen after verification of 
                     25: the student's official photo ID.  Another example would be an online exam in which a remote 
                     26: proctor would temporarily take control of the user's keyboard and enter the proctor username 
                     27: and passphrase remotely into the user's web browser.
                     28: 
                     29: Lastly, slots can also be used as a reservation system, e.g., for office hours, where there 
                     30: is no need for a student to actually submit anything to the assessment item for which access 
                     31: is controlled by slots, but the time/date of the reservation itself made by a student to 
1.1.2.2   raeburn    32: gain access is of value.\\\\
1.1       raeburn    33: 
                     34: \textbf{Course Coordinator View}
                     35: 
                     36: There are two parts to the process of using slots to control access to assessment items.
                     37: \begin{enumerate}
                     38: 
                     39: \item An instructor will create the slot using the Slot Management utility
                     40: \item An instructor will assign use of slots to particular resource(s) in the course using 
                     41: the Parameter Manager to set the ``Use slot based access controls'' (useslots) parameter 
                     42: to one of the three ``Yes'' options.
                     43: 
                     44: \end{enumerate}
                     45: 
                     46: The slot management utility can also be used to modify slot settings after a slot has been 
                     47: created.  Slots can be created in two ways:
                     48: 
                     49: \begin{itemize}
                     50: 
                     51: \item Interactively, by using the multi-page slot ``helper'' web form which prompts for the 
                     52: choices to be made when configuring a slot.
                     53:  
                     54: \item By creating a comma-separated-value (CSV) file containing slot attributes and uploading 
1.1.2.3   raeburn    55: the file using the Slot Management utility, see ``Uploading Slot Attributes File'' section (\ref{Slot_CommaDelimited}).
1.1       raeburn    56: 
                     57: \end{itemize}
                     58: 
                     59: \begin{figure}
                     60: \begin{center}\includegraphics[width=0.70\paperwidth]{slots_creation}\end{center}
                     61: \caption{Slot Creation Buttons}
                     62: \end{figure}
                     63: 
                     64: In both cases an instructor will use the multi-page slot ``helper'' web form should modifications 
                     65: be needed to the configuration of a slot after it has been created.
                     66: 
                     67: As Course Coordinator use Settings $>$ Slots to access the Slot Management Utility.
                     68: 
                     69: \begin{figure}
                     70: \begin{center}\includegraphics[width=0.70\paperwidth]{slots_manager}\end{center}
                     71: \caption{Slot Management Utility}
                     72: \end{figure}
                     73: 
                     74: Slots are of two types:
                     75: \begin{enumerate}
                     76: 
                     77: \item instructor-assigned
                     78: \item student-schedulable
                     79: 
                     80: \end{enumerate}
                     81: 
                     82: In the case of an instructor-assigned slot, after a slot has been created, and the 
                     83: ``Use slot based access controls'' (useslots) parameter has been set to yes, the name 
                     84: of the slot needs to be included in the value set for the ``Slots of availability'' (available) 
                     85: parameter. That parameter can contain multiple : separated slot names, if multiple 
                     86: instructor-assigned opportunities are to be provided to students to access a particular 
                     87: resource or folder.
                     88: 
                     89: \begin{figure}
                     90: \begin{center}\includegraphics[width=0.70\paperwidth]{slots_instructor_assigned}\end{center}
                     91: \caption{Parameter setting for instructor-assigned slot}
                     92: \end{figure}
                     93: 
                     94: In the case of a student-schedulable slot, there is no need to set any parameter besides the 
                     95: ``Use slot based access controls'' (useslots) parameter.
                     96: 
                     97: \begin{figure}
                     98: \begin{center}\includegraphics[width=0.70\paperwidth]{slots_params}\end{center}
                     99: \caption{Parameter setting for student-schedulable slot}
                    100: \end{figure}
                    101: 
1.1.2.2   raeburn   102: Although a Course Coordinator can use either Settings $>$ Content Settings $>$ Edit Resource 
                    103: Parameters - Table Mode or Settings $>$ Content Settings $>$ Modify Resource Parameters -  
                    104: Overview Mode to display values set for specific users for ``Slots of availability selected 
                    105: by student'' (availablestudent), the preferred method is to use the Slot Management Utility. 
                    106: The utility provides the ability to view a list of students who have reserved a slot, and 
                    107: also to remove some or all of the reservations, as needed.
1.1       raeburn   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 
1.1.2.2   raeburn   228: automatically when displaying the resource.\\\\
1.1       raeburn   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>