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>