Creating and Formatting the Text File
The text file that you use to import class data can be generated from a student information system (SIS) or created manually. It must be a tab-delimited text file that contains the columns listed in the table below.
There are three example text files in the SIS Importer ZIP file for your reference.
Column Name |
Description |
Instructions |
class_name |
The name of the class |
Each class must have a unique name. |
jss_group |
The name of the mobile device group in the JSS that you want to use to assign students to the class |
There are two ways to assign students to a class: by entering a group name in the jss_group column, or by entering usernames in the student_usernames column. If you choose to enter usernames, the jss_group column can be left blank. If you enter information in both columns, the usernames in the student_usernames column will be ignored. Groups entered in this column must exist in the JSS. In addition, if there are multiple rows for one class, the group name must appear in the first row for the class. |
site_name |
The name of the site that the class belongs to |
To import class data that includes a site, you must use an SIS Importer instance that has credentials for a JSS user account with access to the specified site. For complete JSS user account requirements, see the “Requirements” section. |
student_usernames |
The usernames of students in the class |
Each username must be separated by a line break or a comma. For more information, see the instructions for the jss_group column. |
teacher_usernames |
The username(s) of the teacher(s) |
Each username must be separated by a line break or a comma. |
meeting_day |
The day of the week that the class meets |
You can enter a single day or multiple days. Each day must be separated by a space. Abbreviations for the days of the week are: M, T, W, Th, F, Sa, and Su. |
start_time |
The start time for the class |
You must enter one time only. The time can be in any of the following formats:
Each class in the text file must use the same time format. |
end_time |
The end time for the class |
See the instructions for the start_time column. |
apple_tv_udids |
The UDID of each Apple TV device that is assigned to the class |
Each UDID must be separated by a line break or a comma. |