CS DropBox - Course File Submission System

CS Dropbox will be retired on October 1, 2019 and replaced by TigerFile.  

 

Student CS DropBox Help:


Getting Started with the CS DropBox system:
CS DropBox is a simple course file upload system that allows students to upload files for assignments in CS courses. Once a file is uploaded to CS DropBox it will be made available to the Professor and Teaching Assistants of the course to download and view. As a student you can also download any file that you uploaded to CS DropBox. All files uploaded to CS DropBox are stored permanently until the course is completed. You can remove files and upload them again at any time as long as the assignment is enabled by the Professor.

CS DropBox uses the OIT CAS: University Central Authentication Service to login to the site. CAS uses your Princeton University netID and password. A CAS-enabled application ensures that your security credentials are not being collected by web-based applications. If you have any questions about CAS, or problems logging into CAS, please check the following link for more information or contact the OIT help desk:
http://helpdesk.princeton.edu/kb/display.plx?id=9921

Image of the OIT CAS Login page:

OIT CAS Login Page

Below is an image of what the CS DropBox looks like when you are linked to an assignment:

CS DropBox Assignment Page

Each assignment page can have up to three different file sections. The "Required Files" section contains files that are required by the instructor for the assignment. The file names of each required file must be the exact same name as listed. If the "Required Files" section asks for a file called "HelloWorld.java" then when you upload a file, it must also be called "HelloWorld.java" or you will get a "Filenames do not match" error. The "Optional Files" section are files that are marked as optional by the instructor. Here too, the file names must be the exact same name as listed. The "Additional Files" section are additional files that can be uploaded for the assignment but are not required or optional. "Additional Files" do not have the file name restriction so you can upload any file with any file name to the "Additional Files" section. File names are restricted to alphanumeric characters - upper and lower case letters and 0-9 digits - plus the period, underscore, and hyphen (minus or dash) characters.

The maximum file size for file uploads on CS DropBox is 50MB. To submit assignment files larger than the limit, students must break the file into smaller pieces, submit them individually, and have the instructor reassemble them. On a Linux system, this is easily accomplished with "split" and "cat".

When you upload a file to CS DropBox you will see an orange progress bar as shown in the following image:

CS DropBox Upload

When files have been uploaded to CS DropBox you will see the file name, file size, and date that the file was uploaded as shown in the following image:

CS DropBox Download

You can download a file previously uploaded to CS DropBox by clicking on the filename.

If you need to remove a file you can click on the red CS DropBox Delete icon. Once the file is removed, you can upload it again to CS DropBox.

It is not necessary to remove a file in order to re-submit a new version. You may re-submit a file at any time by simply uploading the file again to the appropriate section. You will get an error if you try to submit a file to the wrong section.

If an assignment has a due date, it will be shown in the "Due Date" section. If the due date has passed, the date text will be shown in red and the instructor may be notified of the late submission.

Due Date On Time Example:
CS DropBox Download
Late Due Date Example:
CS DropBox Download

Some assignments may require additional checking of the files that are submitted to the CS DropBox system. Assignments with this addtional requirement will have a button on the bottom of the page like the one shown below:
CS DropBox Check Submitted Files

If an assignment has the "Check All Submitted Files" button, then when you submit files for the assignment and click the "Check All Submitted Files" button it will check all the submitted files based on the requirements set by the professor of the course. A window will pop-up with the output of the file check script that looks like the one shown below:

CS DropBox Check Submitted Window

Frequently Asked Questions and Known Issues:

 

  1. File uploads hang and are never uploaded to CS DropBox using Safari on the Mac.
    Note:This bug should be fixed now.

    We are aware of an issue with the Safari browser on the Mac that when you first upload a file it never completes. If you reload the page and upload the file again the upload should complete.
     
  2. File uploads work but when I leave the web browser idle and then upload a file again it hangs.

    This problem is due to a CAS authentication timeout. If you hold the shift button and hit refresh you should be prompted to log in to CAS again and uploads should then work.
     
  3. Unable to connect to fed.princeton.edu during the CAS authentication process.

    If you are unable to login due to a connection failure from fed.princeton.edu, you can wait a few minutes and try again. You should also report the problem to the OIT help desk at "helpdesk@princeton.edu" or call 609.258.4357 and let them know you are unable to connect to the CAS University Central Authentication Service.
     
  4. Which web browsers work with DropBox?

    DropBox has been tested with Internet Explorer 7 & 8, Safari 3 & 4, Firefox 3.6 or higher, Opera 10, and Chrome.

 

Professor, Instructor, and Teaching Assistant Help:

NOTE: CS DropBox will be retired October 1, 2019 and replaced by TigerFile.

Getting Started with the CS DropBox system:
CS DropBox is a simple course file upload system that allows students to upload files for assignments in CS courses. If you are teaching a course that will require files to be uploaded, you can setup CS DropBox by going to https://adm.cs.princeton.edu or you can email csstaff@cs.princeton.edu and let us know which course and who will need access to CS DropBox. You will not be able to login to CS DropBox unless you have setup access for a course in ADM. When your account is activated on DropBox as an instructor, you will also have access to DropBox as a student to test assignments and upload files. You can access CS DropBox by going to the following link:
https://dropbox.cs.princeton.edu/

Please do not point students directly to https://dropbox.cs.princeton.edu/ as that will show a "Missing course and/or assignment in URL" page. You should instead point students to the assignment links that are created when you setup an assignment. By not having a browsable directory structure - a conscious design decision - DropBox is better allowed to integrate into BlackBoard and course web sites instead of the other way around. DropBox was built as a simple file management service, and we did not want to turn DropBox into a course management service like Moodle or BlackBoard. The design goal was to make DropBox modular to plug into BlackBoard and other course management sites.

CS DropBox uses the OIT CAS: University Central Authentication Service to login to the site. CAS uses your Princeton University netID and password. A CAS-enabled application ensures that your security credentials are not being collected by web-based applications. If you have any questions about CAS or problems logging into CAS please check the following link for more information or contact the OIT help desk:
http://helpdesk.princeton.edu/kb/display.plx?id=9921

Image of the OIT CAS Login page:

OIT CAS Login Page

Below is an image of what the CS DropBox looks like when you login to a course:

CS DropBox Assignment Page

Create Assignment:

CS DropBox Assignment Create Page
When you want to create a new assignment, just click the "Create New Assignment" button and that will display a text box to type the assignment name. The assignment will be disabled by default so that students will not have access to the link until you finish editing the assignment.

Edit Assignment:

CS DropBox Assignment Edit Page
Clicking the edit pencil icon will display a window to edit all the details of the assignment. The assignment name is also the name of the link that students will use to access the assignment. You can also add a brief description of the assignment and set the due date for the assignment. If you check the "Enabled / Accessible to Students" box, this will enable the link so students can access the assignment. The "Edit Filenames" section is used to define files that the student would upload. DropBox allows for 3 different file sections. The "Required Files" section contains files that are required by the instructor for the assignment. The file names of each required file must be the exact same name as listed. If the "Required Files" section asks for a file called "HelloWorld.java" then when you upload a file it must also be called "HelloWorld.java" or you will get a "Filenames do not match" error. The "Optional Files" section are files that are marked as optional by the instructor. Here too, the file names must be the exact same name as listed. The "Additional Files" section are additional files that can be uploaded for the assignment but are not required or optional. "Additional Files" do not have the file name restriction so you can upload any file with any file name to the "Additional Files" section. File names are restricted to alphanumeric characters - upper and lower case letters and 0-9 digits - plus the period, underscore, and hyphen (minus or dash) characters. When you enter an assignment file name the default is "Required Files" and if you select "Is Optional", those files will go in the "Optional Files" section. If you check the "Use Submission script" box, this will cause a "Check All Submitted Files" button to appear on the Student user interface. See the RunScript documentation for more details.  If you check the "Allow students to indicate that they 
are not done with the assignment" box, this will cause a check box to appear on the Student user interface allowing them to do so.  See the Student Not Done Checkbox section below for more details.

Assignment Link:

CS DropBox Assignment Link
After you edit an assignment, you will be returned to the main page and see a list of all the assignments created. If you click on the assignment name, you will see the assignment page that the students will use to submit files. Please note that the assignment must be "Enabled" for the link to work. The assignment link is what you should use to link students to the assignment from your course web pages. This is the only way students will be able to access the assignment as DropBox does not have a browsable directory structure for students at https://dropbox.cs.princeton.edu/.

Copy Assignment:

CS DropBox Assignment Copy
You can copy an assignment from one course to another by selecting the assignment you would like to copy and clicking on the copy icon. This will bring up another window to input an assignment name and select the course into which to copy it.

Copy All Assignments:

CS DropBox Assignment Copy All
The copy all assignments button will copy all the assignments in the selected course and bring up a window to select the course into which to copy the assignments.
CS DropBox Assignment Copy All Submit

Assignment Email Notifcation:

You can enable email notifcation per assignment, which will send email when students submit after the assignment due date. We are currently sending the notifications to email lists setup on https://lists.cs.princeton.edu/mailman/listinfo with the list name as dropbox-notify-cos### for each course on DropBox. You will need to subscribe to the list if you want to get the notifications. Email notifications are sent once a day at midnight.

Students Files:

Files that are uploaded by students to DropBox can be found on the CS filesystem at /n/fs/dropbox/Files, listed by course. The files stored in /n/fs/dropbox/Files are a read-only copy. If you need to write the files, please copy them somewhere else. Files are also available from the DropBox website on the 'Files' tab. Web file download allows you to download all files in a course, all files for a certain assignment, or download by individual student.

Student Enrollment in DropBox:

Students are enrolled automatically in DropBox based on a feed we get from the University Registrar. If you find that a student is not able to login to DropBox, please let us know and we can add them manually to the DropBox enrollment list.

Student Not Done Checkbox:

You can enable the "NOTDONE" feature per assignment, which will present students with a checkbox to indicate if they are not done with an assignment.

If a student visits/reloads the submission page before the deadline,
    the text reads:
       "[ ] I am NOT done with my assignment; it will not be ready before
            the deadline. (I will uncheck this box when I am done with
            the assignment.)"

If the student visits/reloads the submission page after the deadline,
    the text reads:
       "[ ] I am NOT done with my assignment.
            (I will uncheck this box when I am done with the assignment.)"

The checkbox is initally unchecked. If the student changes the state of the box from unchecked to checked, the CS DropBox system will create a zero-length file named NOTDONE as part of the student's assignment files.  If the student changes the state of the box from checked to unchecked, the CS DropBox system will remove the signal file named NOTDONE. If the late assignment email notification is enabled, the file deletions of NOTDONE files, (only) after the deadline, will be included in the email.