Return to Slot_CommaDelimited.tex CVS log

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

Annotation of loncom/html/adm/help/tex/Slot_CommaDelimited.tex, revision 1.9

1.9     ! raeburn     1: \label{Slot_CommaDelimited}\index{slot attributes file}
1.1       rezaferr    2: 	 
1.6       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 Unique IP each student
                     18: \item List of proctor ids
                     19: \item Slot Description
                     20: \item Maximum number of reservations
                     21: \item Resource(s)/Map(s) Restriction
                     22: \item Date range of slot exclusion
                     23: \item Secret word proctor uses to validate
                     24: \item Sections slot is restricted to
                     25: \item Users slot is restricted to
                     26: \end{itemize}
                     27: 
1.5       raeburn    28: The following fields: ``Slot name'', ``Type of slot'', ``Start Time of slot'' and ``End Time of slot'' are required.\\\\
1.2       raeburn    29: 
1.5       raeburn    30: Format restrictions for the required fields are as follows:
1.4       raeburn    31: \begin{itemize}
                     32: \item A Slot name may only contain letters, numbers and underscores.
                     33: \item The Type of slot must be either preassigned or schedulable\_student.
                     34: \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)
                     35: \end{itemize}
1.5       raeburn    36: 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    37: 
1.5       raeburn    38: Format requirements for the optional fields are as follows: 
1.4       raeburn    39: \begin{itemize}
1.7       raeburn    40: \item ``Message when reservation changed'' can be: only\_student, student\_and\_user\_notes\_screen or none.
1.4       raeburn    41: \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:
                     42: \begin{enumerate}
                     43: \item a range, e.g, 35.8.3.[34-56]
                     44: \item partial IP with wildcard, e.g., 35.8.*
                     45: \item domain or subnet: e.g., *.msu.edu
                     46: \item single IP: e.g., 127.0.0.1
                     47: \item single DNS name, e.g., some.name.com
                     48: \end{enumerate}
                     49: \item ``Unique IP each student'' can be yes
                     50: \item ``List of proctor ids'' is a comma separated list of username:domain for users who will proctor.
                     51: \item ``Maximum number of reservations'' is a positive integer 
1.6       raeburn    52: \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.
1.4       raeburn    53: \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.
                     54: \item ``Sections slot is restricted to'' is a comma separated list of course sections
                     55: \item ``Users slot is restricted to'' is a comma separated list of users (each user is in the format username:domain)
                     56: \end{itemize}