Changes

''oTTs, On-Time Timesheets'', is an online system that allows Professors and Students to work collaboratively on System Design Projects. Seneca College's Computer Studies Department emphasizes strong team building skills, and achieves this through team projects. In the past, student and team progress have been monitored and maintained using conventional word processing documents. These conventional methods have proven to be difficult to synchronize between group members, and tended to lack substantial effort from those who were required to use them. ''oTTs'' creates an online environment where professors and students can work together to create and maintain personal timesheets and group project files. By allowing easy maintenance of projects and students for the professor, and simple manipulation functionality of timesheets and project files for students, ''oTTs'' takes the large task of project maintenance, and makes it simple for all of those involved.

#Compatible Browser (see [[#Browser_Compatibility|''Section 2.2 Browser Compatibility'']])

oTTs strives to achieve a uniform appearance across all browsers and has been tested extensively on Firefox 2.0 and Internet Explorer 7. Either browser must have javascript Javascript enabled for full and proper functionality to work.

For the best performaceperformance, it is suggested that FireFox 2.0 is used, and the system be viewed in full screen modeunder a monitor resolution of 1024x768.

Make sure you have installed and met all system requirements listed in [[#System_Requirements| ''Section 2.1 System Requirements (link..?)'']]. This document will describe how to install ''oTTs'' assuming these requirements have been met.<br /><br />

# Enter your user ID and password, and click ''Connect''<br/> (INSERT SCREEN SHOT)[[Image:connect.JPG|center|Figure 1.1 - Connect]]

# Once the validation is complete, run the script by pressing ''F5''. The query should read ''1 row(s) affected.'' The database is now setup. <br/>(INSERT SCREEN SHOT)<br />'''Note[[Image:''' By default after the script has been executed, there will be a master adminstrator login in the databaseexecute_sql_script. It is recommended to use this login in order to create the initial adminstrator login before using the systemJPG|center|550px|Figure 1. It is also '''''highly''''' recommended that the master administrator login be deleted upon initial login. Since the master adminsitrator login does not have a valid email, simply changing the password is not allowed.<br/><br />====Master Adminstrator Login Information===='''User ID:''' master_admin <br />'''Password:''' master_password <br />2 - Executing SQL Script]]

# Using Visual Studio 2005, open the Web Site Project, ''oTTs''.# In the Solutions Explorer, right click the Project's name, and select "Copy Web Site"<br />[[Image:copy_website.JPG|center|250px|Figure 1.3 - Copy Web Site]]# Connect to the Remote Web Site, http://warp.senecac.on.ca/bts630_071a01<br/>[[Image:connect_remote_1.JPG|center|650px|Figure 1.4 - Connect to Remote Web Site]]# Select all of the files from the Local Web Site, and copy them to the Remote Web Site.<br/>[[Image:copy_website_1.JPG|center|450px|Figure 1.5 - Copy to Remote Web Site]]# Check that the web site is running successfully, http://warp.senecac.on.ca/bts630_071a01<br/>

There are two types of accepted users that may log into ''oTTs'', ; students and administrators. The two login types are distinguished by their email e-mail addresses, students . Students have an email addresses address with domains the domain of ''"learn.senecac.on.ca"'' and professors have an email addresses address with domains the domain of ''"senecac.on.ca"''. User The user ID's for both login types are each their respective email prefix, for . For example a user with the email address of ''johndoe@learn.senecac.on.ca'', their will have a user id would be ID of ''johndoe''. Each user's initial password wil will be emailed e-mailed to them upon creation of their account by the administrator, the system and this default password may be changed at any time by using the "Change Password" function (see [[#Change_Password_Function|''Section 3.1.2 Change Password Function'']] for details).

At the main login screen, users will be autheticated, authenticated and directed to the their appropriate screen. If a user has forgotten their password, it may be retrieved by clicking on the ''Reset Password Link'' located above the login button, (see ''Figure 2.1''). The user must enter an email address that either has the domain of ''senecac.on.ca'' for a administrator, or a domain of ''learn.senecac.on.ca'' for a student. The user must enter a valid email address associated with their account inorder in order to have their password reset and emailed to themby the system. For reference, see ''Figure 2.2''. <br />

Passwords may be changed by the user at any time by clicking on the ''Change Password'' button on the default screenfor either login type, see ''Figure 2.3.1''. A floating pop-up box will be displayed, and the screen below will be disabled. The user can You may change their your password, or cancel the action without any changes occuringoccurring. When changing a password you must enter your old password, enter your new password and then confirm it. Once all the fields have been validated, and you've clicked the "''Change''" button, your new password will be emailed to you by the system. The ''Change Password'' box will then disappear and the screen below will become reactivated. For reference, see ''Figure 2.3.2''.<br/>'''Note:''' The Change Password popup box is draggable, you may move it around the screen to any location that you wish.<centerbr/>[[Image:change_password_2_3change_password_2_3_1.JPG|center|300px|Figure 2.3 .1 - Change Password]]<br/>[[Image:change_password_2_3_2.JPG|center>|650px|Figure 2.3.2 - Change Password]]

The role of the Administrator user is to create and maintain all users and their associated projects, as well as semester start/end dates, and project/individual deadlines. When an administrator logs in, the default tabs are Summary, Manage Semester, Manage Project, Manage Users , and Deadlines, all of which are described in the following sections. The layout is shown in ''Figure 3.1''. <br/>[[Image:admin_default_3_1.JPG|center|650px|Figure 3.1 - Administration Layout]]

An administrator Every student account must create at least one be associated with a project, in order to do so, a project must be created before creating any adding a student accountsaccount. Each  ====Adding a Project====When adding a project , you must have an enter a unique project ID, and a name for the project name assoicated with it. Once all fields have been validated, you may then click the "''Add Project''" button. When a project is added it is marked active for , and associated with the current semester. Only active projects are displayed in the display listproject table. For reference, see ''Figure 3.2.1''.<br/>[[Image:add_project.JPG|center|650px|Figure 3.2.1 - Adding a Project]] ====Editing a Project's Details====To edit a project's details, press the "Edit" button located to the far right of the project's record. This will load the project's details into the form to the left. The project ID will be disabled; however you will be able to edit the project's name. To change a project's ID, you must delete the entire project (see [[#Deleting_a_Project|''Section 3.2.1.3 Deleting a Project'']]), and when then re-add (see [[#Adding_a_Project|''Section 3.2.1.1 Adding a Project'']]) it. For reference, see ''Figure 3.2.2''. <br/>[[Image:edit_project.JPG|center|650px|Figure 3.2.2 - Editing a Project's Details]] ====Deleting a Project====To delete a project, select the check box to the left of the record in the table. You may select more than one project at a time. Once you have selected all of the projects you wish to delete, click the "''Delete Project(s)''" button. You will be prompted with a confirmation box, if you wish to continue, please click "''Ok''", if you do not want to continue with the delete, please click "''Cancel''". When a project is deleted, all assoicated associated users, timesheets , and tasks are deleted as well. Upon deletion the administrator is prompted with an confirmation boxFor reference, confirming the delete. The layout of the Manage Project Screen can be seen in see ''Figure 3.2.3 and 3.2.4''.<br/>[[Image:manage_project_3_2delete_project_1.JPG|center|650px|Figure 3.2.3 - Deleting a Project]]<br/>[[Image:delete_projects_2.JPG|center|650px|Figure 3.2 .4 - Manage ProjectsDeleting a Project Confirmation]]

An adminstrator administrator can add or edit two types of users, ; other administrators or students. The type of user being added or edited is determined by which radio button is selected, this . This radio button also determines which user table is displayed to the right. Each user is identified by a user ID, this user ID is automatically assigned by using the prefix of the user's email address. A valid email address must be entered, the prefix can only contain letters (a-zAz,A-Z), number (0-9), and special chacters characters of (- _ or .), they must also be longer than one character. Administration email addresses are automatically assigned the the domain of "''senecac.on.ca''", and student email addresses are automatically assigned the domain of "''learn.senecac.on.ca''". Once all of the corresponding fields have been entered and validated, the user is emailed an auto-generated password, this password should be changed as soon as possible using the ''Change Password'' function (see [[#Change_Password_Function|''Section 3.1.2Change Password Function'']]). A description of how to add or edit each type of user is listed below.

To add an administrator, make sure the "''AdminstratorAdministrator''" radio button is selected. You must enter a first and last name of the administrator, each may only be a maximum of fifty characters. An email address prefix must also be entered, currently . Currently on the Seneca College Web Mail, a valid professor email address should be formatted as "''first_name.last_name''". The email prefix may only be thirty-six characters long. Once all of the required fields have been entered, click the "''Add Administrator''" button, and the new administrator will be shown in the table to the right. If there are any validation errors, they will be shown below each of the fields. For reference, see ''Figure 3.3''<br/>

To add a student, make sure the "''Student''" radio button is selected. You must enter a first and last name of the student, ; each may only be a maximum of fifty characters. An email address prefix must also be entered, ; the email prefix may only be twenty characters long. Each student must also be assoicated associated with a project, to . To do this , select a project name from the ''Project Name'' drop down list (the project ID is assoicated associated within this drop down list). Once all of the required fields have been entered, click the "''Add Student''" button, and the new student will be shown in the table to the right. If there are any validation errors, they will be shown below each of the fields. <br/> A group of students may be entered at one time by uploading a Comma Separated Value File (CSV), File in the file upload section (see ''Figure 3.4''). <br/>The format of the file should be as follows: '''Last_Name, First_Name, Student_ID, Project_ID''', making sure that each field is separated by a comma. <br/>An example of a record in this file would look like the following:<br/>'''Doe, John, JDoe, bts630_071g01'''<br/>For reference, see ''Figure 3.4''<br/>

To edit a user's details, press the "''Edit''" button located to the far right of the user's record. This will load the user's details into the form to the left. The email prefix will be disabled, and you will only be able to edit the enabled fields (first name and last name for an administrator, and first name, last name, and project ID/project name for a student). Once you have edited the details, you can submit the changes by clicking the "''Update <User Type>''" button.<br/>'''Note:''' If you would like to change the user's email address, you will have to delete the user, and re-add them. (For deleting instructions please see [[#Deleting_a_User|''Section 3.2.2.4Deleting a User'']], and for adding instructions please see [[#Adding_an_Administrator_User|''Section 3.2.2.1 Adding an Administrator'']] or [[#Adding_a_Student_User|''Section 3.2.2.2Adding a Student'']]) . For reference, see ''Figure 3.5''.<br/>[[Image:edit_user.JPG|center|650px|Figure 3.5 - Edit User Details]]

To delete a user, select the check box to the left of their record in the table. You may select more than one user at a time. Once you have selected all of the users you wish to delete, click the "''Delete <User Type>''" button. You will be promted prompted with a confirmation box, if you wish to continue, please click "''Ok''", if you do not want to continue with the delete, please click "''Cancel''". For reference, see ''Figure 3.6.1 and 3.6.2''. <br/>'''Note:''' If you are deleting a student, you will also be deleting all associated timesheets and tasks for this student. <br/>[[Image:delete_user_1.JPG|center|650px|Figure 3.6.1 - Delete User]]<br/>[[Image:delete_user_2.JPG|center|650px|Figure 3.6.2 - Delete User]]

The administrator can create two types of deadlines, : individual work deadlines for students, or and project work deadlines that are to be completed by all project members.

To select a certain type of deadline, select the appropreiate appropriate radio button, "''Individual''" or "''Project''". For an "''Individual''" deadline, you may select a "''Timesheet''" or "''Other''". For a "''Project''" deadline, you may select a "''Project File''" or "''Other''", for reference see ''Figure 3.7.1 and 3.7.2''. <br/>[[Image:add_deadline_1.JPG|center|650px|Figure 3.7.1 - Adding a Individual Deadline]]<br /> When selecting "''Other''" for either deadline type, a textbox will appear where you must enter a description for that item. For reference see ''Figure 3.7.2''. Once you have selected your deadline type and item name/description, you must select a due date that falls within the dates of the current semester; the current date is highlighted with a border in light grey. After all fields have been validated, you may click the "''Add Deadline''" button. [[Image:add_deadline_2.JPG|center|650px|Figure 3.7.2 - Adding a Project DeadlineOther Description]]<br/>

The project file contains all the tasks that a group has completed or is going to complete. All tasks are broken in Summary Tasks that categorizes these tasks. A student may be assigned to a task, or the task may be left unassigned. The total hours spent on a task for the duration of the project is also displayed. A student may edit for a task is assigned to, only if the student has not already started the task. Also, a task may not be deleted if a task has been started. For examplea sample Project File, Create Tables might be one see ''Figure 4.9''.<br/>[[Image:project_file.JPG|center|650px|Figure 4.9 - Sample Project File]] ====Adding a Summary Task====To add a summary task to the project file, click on the "''Add Summary Task''" button in your Database categorythe upper left hand corner. A box will appear to in the upper right hand corner, you must enter a summary task name, and then click "''Add''". The box will then disappear. For reference, see ''Figure 4.10.1''<br/>[[Image:project_file_1.JPG|center|650px|Figure 4.10.1 - Adding a Summary Task]]

Time is broken into hours====Editing a Summary Task's Details====To edit a summary task's details, click on the "''Edit''" button to the right of the summary take name. A box will appear in the upper right hand corner. To edit the details, change the name in the ''Task Name'' field, and fractions if necessarythen click "''Update''". The editing box will then disappear. For examplereference, 3see ''Figure 4.33 hours represents 3 hours and 20 minutes10. Which you can get by calculating (time you spent in minutes)2''<br/60>[[Image:project_file_2.JPG|center|650px|Figure 4.10.2 - Editing a Summary Task's Details]]

===Reminders=Deleting a Summary Task====A summary task may only be deleted where there are no tasks associated with it, therefore a "''Delete''" button will only appear if it is allowed. To delete a summary task, click the "''Delete''" button to the right of the summary task name. A confirmation box will appear, click "''Ok''" to confirm the delete, or "''Cancel''" to cancel the delete. For reference, see ''Figure 4.10.3''<br/>[[Image:project_file_3.JPG|center|650px|Figure 4.10.3 - Deleting a Summary Task]] ====Adding a Task====To add a task to the project file, click on the "''Add Task''" button that is to the right of a summary task name. A popup window will appear to in the upper right hand corner; you must enter a task name, and select a project member to assign it to. If you do not wish to assign the task, select "''Not Assigned''". Then click "''Add''" button. The calendar has coloured days for popup box will then disappear. For reference, see ''Figure 4.10.4''<br/>[[Image:project_file_4.JPG|center|650px|Figure 4.10.3 - Adding a quick analysis Task]] ====Editing a Task's Details====A task may only be edited if the task hasn't been started, therefore a "''Edit''" button will only appear if it is allowed. To edit a task's details, click on the "''Edit''" button to the right of future deadlinesthe task name. A popup box will appear in the upper right hand corner. To edit the details, change the name in the ''Task Name'' field, and/or change the assignee, and then click "''Update''". The editing popup box will then disappear. For reference, see ''Figure 4.10.5''<br/>[[Image:project_file_5.JPG|center|650px|Figure 4.10.4 - Editing a Task's Details]]

* Purple days represent deadlines that ====Deleting a Task====A task may only be deleted if the entire team task hasn't been started, therefore a "''Delete''" button will only appear if it is responsible forallowed. To delete a task, click the "''Delete''" button to the right of the task name. A confirmation box will appear, click "''Ok''" to confirm the delete, or "''Cancel''" to cancel the delete. For reference, see ''Figure 4.10.6''<br/>[[Image:project_file_6.JPG|center|650px|Figure 4.10.6 - Deleting a Task]]

===Reminders===Students are required to meet certain deadlines throughout the duration of the project. Each student is responsible for submitting a weekly timesheet and maintaining their project's project file, as well as several other personal and group deadlines. The calendar to the left visually displays upcoming due dates by highlighting the due dates with a coloured border for quick analysis. A legend for each type of due date is displayed directly below the calendar. The legend colours are described below: <br/>* Green days represent individual Today's Date is outlined in Light Grey.* a Project Deadline is outlined in Bright Light Blue.* an Individual Deadline is outlined in Light Steel Blue.* a Project Deadline and an Individual Deadline due on the same day is outlined in Dark Blue.To the right, a table is displayed showing a list of upcoming deadlines , detailing the type of deadline, the document description and timesheet deadlinesthe due date. For reference, see ''Figure 4.11''.<br/>[[Image:reminders.JPG|center|650px|Figure 4.11 - Reminders]]