Uploading External Rosters to Mallard

To upload a roster to Mallard, you will need to get the roster on your computer as a text file. This text file may be in one of two formats - either the colon delimited format, which contains one line of fields per user, with the individual fields separated by colons, or the special University of Illinois format, which also contains one line of fields per user but in a wider format separated by sequences of whitespace and commas.

Colon-delimited format:

Generally colon-delimited rosters are either typed in by hand or generated using a program to convert them from some other site-specific format. You may wish to contact your Mallard Adminstrator for details on obtaining rosters for your course. Colon-delimited rosters should contain one line of information per user, in the following format.
login:name:section:access level:other:id

You may omit the "id", "other", "section", and "access level" items. You must supply the "login" and "name" fields for every user. Omitting the "id" or "other" fields will cause those fields to be left blank. If you omit the section, it will default to "Other". If you omit the access level, it will default to "student".

Allowable values for the access level are given below:

University of Illinois format:

University of Illinois format rosters are output directly from the University of Illinois' UI Direct registration system. This is the site specific format used at the University of Illinois. Rosters in this format may be emailed to you from the UI Direct program. You may wish to contact your Mallard Administrator for details on this procedure.

Uploading the rosters:

Once you have the rosters on your computer, go into Mallard and click on the User Information icon from the home page. At the bottom of that page, choose the correct format for your roster and click on "Upload Roster". You will be taken to a page where you will type in the name of the file in which the roster is stored on your computer. Click on "Preview Roster". The roster will be displayed for you in the usual Mallard format, as a table of users.

If the roster appears correct, you may choose to either overwrite any old existing roster with this new roster (which automatically deletes any users in the old roster) or simply add the new roster to the existing roster, in which case none of the previous users are deleted. If you choose the latter option, attempting to add users who already exist will cause no problems - the new entries will be rejected in favor of the preexisting duplicates.

Comments? Questions? General harassment? Mail it to maiko@wocket.csl.uiuc.edu