Return to Slot_CommaDelimited.tex CVS log

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

- Typo

\label{Slot_CommaDelimited}\index{slot attributes 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., list 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.

Once uploaded, you will be prompted to identify the contents of each column in your CSV data. The following fields are supported:
\begin{itemize}
\item Slot name
\item Type of slot
\item Start Time of slot
\item End Time of slot
\item Reservation Start Time
\item Reservation End Time
\item Message when reservation changed
\item IP or DNS restriction
\item Unique IP each student
\item List of proctor ids
\item Slot Description
\item Maximum number of reservations
\item Resource(s)/Map(s) Restriction
\item Date range of slot exclusion
\item Secret word proctor uses to validate
\item Sections slot is restricted to
\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.\\\\

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 (also known as `symbs'). If the identifier is for a map (i.e., .sequence or .page) then all resources in that map may use the slot. A list of unique identifiers in a course is available from: Course Editor $>$ Content Utilities $>$ List Resource Identifiers.
\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}