--- loncom/html/adm/help/tex/Slot_CommaDelimited.tex	2017/01/16 23:16:39	1.3
+++ loncom/html/adm/help/tex/Slot_CommaDelimited.tex	2021/01/17 22:19:50	1.4
@@ -1,8 +1,8 @@
-	 \label{Slot_CommaDelimited}
+\label{Slot_CommaDelimited}
 	 
-	 Another way of entering slot information is by uploading a comma separated (CSV) file. An easy way to create this type of file is to use a spreadsheet application such as Microsoft Excel, and save the file as a comma separated value (CSV) file.
+If you will be creating several slots you may prefer to create them by uploading a comma separated value (CSV) file containing slot configuration information with one line of data per slot. An easy way to create this type of file is to use a spreadsheet application such as Microsoft Excel, and save the file as a Text (CSV) file.  If you use a text editor directly to create the file, you should use double quotes around any values which themselves contain a comma (e.g., lit of proctor ids). 
 	 
-	 To upload a file press the \textbf{Upload Slot List} button on top of the page. On the first page, select the file with the slot data to upload by pressing the \textbf{Browse button}. There is an option to ignore the first line. This is useful when the first line of your comma delimited file consists of headers for each field. You can also upload space and tab delimited file by changing the type combo box. Press \textbf{Upload} to upload the file.
+To upload a file press the \textbf{Upload Slot List} button on top of the page. On the first page, select the file with the slot data to upload by pressing the \textbf{Browse button}. There is an option to ignore the first line. This is useful when the first line of your comma delimited file consists of headers for each field. You can also upload space and tab delimited file by changing the type combo box. Press \textbf{Upload} to upload the file.
 
 Once uploaded, you will be prompted to identify the contents of each column in your CSV data. The following fields are supported:
 \begin{itemize}
@@ -25,9 +25,32 @@ Once uploaded, you will be prompted to i
 \item Users slot is restricted to
 \end{itemize}
 
-The following fields: ``Slot name'', ``Type of slot'', ``Start Time of slot'' and ``End Time of slot'' are required.
+\\The following fields: ``Slot name'', ``Type of slot'', ``Start Time of slot'' and ``End Time of slot'' are required.\\
 
-A Slot name may only contain letters, numbers and underscores.
-The Type of slot must be either preassigned or schedulable\_student.
-The four Time fields:  Start Time, End Time, Reservation Start Time, Reservation End Time permit a variety of formats.
-For example, the following formats are permitted: `YYYYMMDDHHMMSS'' and ``MM/DD/YYYY HH:MM:SS''
+\\Format restrictions for the required fields are as follows:
+\begin{itemize}
+\item A Slot name may only contain letters, numbers and underscores.
+\item The Type of slot must be either preassigned or schedulable\_student.
+\item The four Time fields: Start Time, End Time, Reservation Start Time, Reservation End Time permit a variety of formats (for example: YYYYMMDDHHMMSS and MM/DD/YYYY HH:MM:SS)
+\end{itemize}
+End Time must be later than Start time. If no Reservation Start Time is specified, the slot can be reserved after the open date.  If no Reservation End Time is specified, the slot can be reserved up until the slot start time.\\
+
+\\Format requirements for the optional fields are as follows:
+\begin{itemize}
+\item ``Message when reservation changed'' can be: only_student, student_and_user_notes_screen or none.
+\item ``IP or DNS restriction'' is a comma-separated list.  If a particular IP restriction is: deny access from, prepend ! to the item.  Individual IP/DNS items can have one of the following formats:
+\begin{enumerate}
+\item a range, e.g, 35.8.3.[34-56]
+\item partial IP with wildcard, e.g., 35.8.*
+\item domain or subnet: e.g., *.msu.edu
+\item single IP: e.g., 127.0.0.1
+\item single DNS name, e.g., some.name.com
+\end{enumerate}
+\item ``Unique IP each student'' can be yes
+\item ``List of proctor ids'' is a comma separated list of username:domain for users who will proctor.
+\item ``Maximum number of reservations'' is a positive integer 
+\item ``Resource(s)/Map(s) Restriction'' is a comma separated list of unique resource identifiers (aka `symbs'). If the symb is for a map (i.e., .sequence or .page) then all resources in that map may use the slot.
+\item ``Date range of slot exclusion'' contains two dates separated by a comma.  The second date/time must post-date the first date/time. Permitted formats for each date/time are the same as for the four time fields.
+\item ``Sections slot is restricted to'' is a comma separated list of course sections
+\item ``Users slot is restricted to'' is a comma separated list of users (each user is in the format username:domain)
+\end{itemize}