[LON-CAPA-cvs] cvs: loncom /html/adm/help/tex Slot_About.tex Slot_ChoosingResources.tex Slot_CommaDelimited.tex Slot_SelectingField.tex doc/help course.manual.texxml

rezaferry lon-capa-cvs@mail.lon-capa.org
Tue, 05 Dec 2006 14:29:24 -0000


This is a MIME encoded message

--rezaferry1165328964
Content-Type: text/plain

rezaferry		Tue Dec  5 09:29:24 2006 EDT

  Added files:                 
    /loncom/html/adm/help/tex	Slot_ChoosingResources.tex 
                             	Slot_CommaDelimited.tex 
                             	Slot_SelectingField.tex 

  Modified files:              
    /doc/help	course.manual.texxml 
    /loncom/html/adm/help/tex	Slot_About.tex 
  Log:
  Added some documentation for slots. Also placed it in the course coordinator manual
  
  
--rezaferry1165328964
Content-Type: text/plain
Content-Disposition: attachment; filename="rezaferry-20061205092924.txt"

Index: doc/help/course.manual.texxml
diff -u doc/help/course.manual.texxml:1.14 doc/help/course.manual.texxml:1.15
--- doc/help/course.manual.texxml:1.14	Mon Nov  6 15:00:44 2006
+++ doc/help/course.manual.texxml	Tue Dec  5 09:29:21 2006
@@ -443,6 +443,36 @@
 			</subsection>
 	</section>
 
+	<section name="Slot Management">
+		<file name="Slot_About.tex" />
+		<subsection name="Adding Slot Using the Interface">
+			<file name="Slot_AddInterface.tex" />
+			<subsubsection name="Required Slot Attributes">
+					<file name="Slot_RequiredAttributes.tex" />
+			</subsubsection>
+			<subsubsection name="Optional Slot Attributes">
+					<file name="Slot_OptionalAttributes.tex" />
+			</subsubsection>
+			<subsubsection name="Selecting Resource Available Within Slots">
+					<file name="Slot_ChoosingResources.tex" />
+			</subsubsection>
+			<subsubsection name="Specifying Proctors">
+					<file name="Slot_SpecifyProctors.tex" />
+			</subsubsection>
+			<subsubsection name="Specifying Users">
+					<file name="Slot_RestrictAvailibility.tex" />
+			</subsubsection>
+		</subsection>
+		<subsection name="Uploading Slot Files">
+			<file name="Slot_CommaDelimited.tex" />
+			<subsubsection name="Specifying Types of Input Fields">
+					<file name="Slot_SelectingField.tex" />
+			</subsubsection>
+		</subsection>
+		<subsection name="Editing and Deleting Slots">
+			<file name="Slot_EditDelete.tex" />
+		</subsection>
+	</section>
 	<section name="Student Grade Access">
 		<file name="Quick_Grades_Description.tex" />
 		<subsection name="Changing Course Environment for Student Access of Spreadsheet">
Index: loncom/html/adm/help/tex/Slot_About.tex
diff -u loncom/html/adm/help/tex/Slot_About.tex:1.1 loncom/html/adm/help/tex/Slot_About.tex:1.2
--- loncom/html/adm/help/tex/Slot_About.tex:1.1	Mon Nov 27 22:03:12 2006
+++ loncom/html/adm/help/tex/Slot_About.tex	Tue Dec  5 09:29:21 2006
@@ -1,7 +1,8 @@
 \label{Slot_About}
 
-A course coordinator can add slots, by going clicking \fbox{parm} (Managing Parameters) on the main menu and then clicking on the link Managing Slots. The link will guide you to a page showing all available slots. You can control which slots to show based on opening date, as well as what slot information to show.
+A course coordinator can add slots, by pressing \textbf{parm} (Managing Parameters) on the main menu and then clicking on the link Managing Slots. The link will guide you to a page showing all available slots. You can control which slots to show based on opening date, as well as what slot information to show.
 	
-Each slot can be edited or deleted according to your needs. When a slot is deleted, students cannot use that slot anymore, even if they have been scheduled to take it before deletion.
-	
-There are two ways of creating slot, using the web interface in LON CAPA and uploading a comma delimited file. Uploading a file allows you to use other applications in creating a comma delimited file, and automate the entry of multiple slots (See Upload Slot File \ref{Slot_CommaDelimited}).
+There are two ways of creating slot, using the web interface in LON CAPA (see Adding Slot Using the Interface \ref{Slot_AddInterface}) and uploading a comma delimited file. Uploading a file allows you to use other applications in creating a comma delimited file, and automate the entry of multiple slots (see Upload Slot File \ref{Slot_CommaDelimited}).
+
+Each slot can be edited or deleted according to your needs (see Editing and Deleting Slots \ref{Slot_EditDelete}). When a slot is deleted, students cannot use that slot anymore, even if they have been scheduled to take it before deletion.
+

Index: loncom/html/adm/help/tex/Slot_ChoosingResources.tex
+++ loncom/html/adm/help/tex/Slot_ChoosingResources.tex
\label{Slot_ChoosingResources}
	 
You can also specify which resources/files can a student open during the slot time. To do this, you must set that the slot is restricted to a specific resource (on the optional attributes page). When this option is selected, the next page allows you to choose which resource this slot is restricted to. 
	 

Index: loncom/html/adm/help/tex/Slot_CommaDelimited.tex
+++ loncom/html/adm/help/tex/Slot_CommaDelimited.tex
	 \label{Slot_CommaDelimited}
	 
	 Another way of entering slot is by uploading a comma delimited file. A comma delimited file is a text file that separates each field with a comma. An easy way to create comma delimited files is to use a spreadsheet application such as Microsoft Excel, and save the file as a comma separated value (CSV) 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

Index: loncom/html/adm/help/tex/Slot_SelectingField.tex
+++ loncom/html/adm/help/tex/Slot_SelectingField.tex
 \label{Slot_SelectingField}
	 
 The system will read the file into the system. You will then be prompted to specify the input type of each field. A set of types is given for each field. There are three mandatory types, slot name, starting time, and ending time. A mandatory type means that a field must be specified having that meaning.  The input choices are as follows:
	 
 \begin{itemize}
	 \item \textbf{Slot name}. The name or identifier of the slot. The name of the slot must be unique, and it must have no spaces. This input is mandatory, you must specify a field for this input type.  	
	 \item \textbf{Type of slot}. This determines whether students are allowed to schedule him/herself for this slot or whether the instructors assign students to this slot. The valid inputs for this field is either "preassigned" or "student\_selectable". There must be no space before or after the comma. If this type is not specified, the slot type defaults to preassigned or instructors assignable.	
	 \item \textbf{Slot Description}. A description of the slot.	
	 \item \textbf{Start Time of slot}. This determines the time when a slot starts to open. This input type is mandatory. There are various accepted  format for this field. Two of which are "YYYYMMDDHHMNSS" and "MM/DD/YYYY HH:MM:SS".   	
	 \item \textbf{End Time of slot}. This determines the time when a slot ends and a user cannot access the resource. This input is mandatory. The accepted format for this field is the same as for the start time of slot.
	 \item \textbf{Reservation Start Time}.	This determines when a student can start reserving for the slot. The accepted format for this field is the same as for the start time of slot.
	 \item \textbf{Date range of slot exclusion}. Sometimes a student is limited to a number of slot use for a particular date period. This field allows a range of dates where a student may not have more than one slot reservation/use. The format is "StartingDate - EndingDate", where starting date and ending date are time, which is the same for start time of slots. 	
	 \item \textbf{Maximum number of reservations}. The number of students allowed to reserve this slot. This is useful when slots are opened in a classroom/lab, and there is a limited number of seats. 	
	 \item \textbf{IP or DNS restriction}. The set of computers that can be used to use this slot between the starting time and the ending time of slots. This can be a set of IP addresses separated by spaces, or with the use of wildcards (*), or even computer names.  	
	 \item \textbf{List of proctor ids}. The list of proctor id that must authenticate the student before the student can open the slot. The proctor ids are separated by a space.  
	 \item \textbf{Secret word proctor uses to validate}. The password the proctors use when authenticating the students.	
	 \item \textbf{Resource Restriction}. Restricts which page (only test/homework pages) can be opened using this slot. This is a url of the page that is restricted by the source. 	
	 \item \textbf{Sections slot is restricted to}. When choosing preassigned slot type, you can choose a section that can open this slot. Only students in that section can open a particular slot. Separate slots by spaces.	
	 \item \textbf{Users slot is restricted to}. When choosing preassigned slot type, you can choose a list of students that can open this slot. Student ids are separated by spaces.
 \end{itemize}

--rezaferry1165328964--