Annotation of loncom/html/adm/help/tex/Slot_CommaDelimited.tex, revision 1.4.2.4
1.4.2.4 ! raeburn 1: \label{Slot_CommaDelimited}\index{slot attributes file}
1.1 rezaferr 2:
1.4.2.2 raeburn 3: 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).
1.1 rezaferr 4:
1.4 raeburn 5: 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.
1.2 raeburn 6:
7: Once uploaded, you will be prompted to identify the contents of each column in your CSV data. The following fields are supported:
8: \begin{itemize}
9: \item Slot name
10: \item Type of slot
11: \item Start Time of slot
12: \item End Time of slot
13: \item Reservation Start Time
14: \item Reservation End Time
15: \item Message when reservation changed
16: \item IP or DNS restriction
17: \item List of proctor ids
18: \item Slot Description
19: \item Maximum number of reservations
1.4.2.1 raeburn 20: \item Resource Restriction
1.2 raeburn 21: \item Date range of slot exclusion
22: \item Secret word proctor uses to validate
23: \item Sections slot is restricted to
24: \item Users slot is restricted to
25: \end{itemize}
26:
1.4.2.2 raeburn 27: The following fields: ``Slot name'', ``Type of slot'', ``Start Time of slot'' and ``End Time of slot'' are required.\\\\
1.2 raeburn 28:
1.4.2.2 raeburn 29: Format restrictions for the required fields are as follows:
1.4 raeburn 30: \begin{itemize}
31: \item A Slot name may only contain letters, numbers and underscores.
32: \item The Type of slot must be either preassigned or schedulable\_student.
33: \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)
34: \end{itemize}
1.4.2.2 raeburn 35: 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.\\\\
1.4 raeburn 36:
1.4.2.2 raeburn 37: Format requirements for the optional fields are as follows:
1.4 raeburn 38: \begin{itemize}
1.4.2.2 raeburn 39: \item ``Message when reservation changed'' can be: only\_student, student\_and\_user\_notes\_screen or none.
1.4.2.1 raeburn 40: \item ``IP or DNS restriction'' is a comma-separated list of allowed IP addresses or hostnames. Individual IP/DNS items can have one of the following formats:
1.4 raeburn 41: \begin{enumerate}
42: \item a range, e.g, 35.8.3.[34-56]
43: \item partial IP with wildcard, e.g., 35.8.*
44: \item domain or subnet: e.g., *.msu.edu
45: \item single IP: e.g., 127.0.0.1
46: \item single DNS name, e.g., some.name.com
47: \end{enumerate}
48: \item ``Unique IP each student'' can be yes
49: \item ``List of proctor ids'' is a comma separated list of username:domain for users who will proctor.
50: \item ``Maximum number of reservations'' is a positive integer
1.4.2.2 raeburn 51: \item ``Resource Restriction'' is the unique resource identifier (also known as a `symb'). A list of unique identifiers in a course is available from: Course Editor $>$ Content Utilities $>$ List Resource Identifiers.
1.4 raeburn 52: \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.
53: \item ``Sections slot is restricted to'' is a comma separated list of course sections
54: \item ``Users slot is restricted to'' is a comma separated list of users (each user is in the format username:domain)
55: \end{itemize}
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>