Need to export data from your Human Resources or Student Information System (SIS)?
If you use CatapultEMS only, refer to the document below. If you also use CatapultConnect, see Tips for SIS export (CatapultConnect and CatapultEMS) for a broader export.
Key points for automation
-
File Transfer: via SFTP
-
Format: .csv
-
Headers: Include headers as the first line of each file. Match the exact order and spelling of the headers listed below.
-
Filename: Match filename exactly.
-
Staff / Student / StaffToStudent files: Send nightly before 11:30 pm PST.
-
SchoolExport: Export one time and share via Google Drive or SFTP folder.
Contents
StaffExport.csv*
-
id,school,nameFirst,nameLast,email,mobileNumber,title
-
id*: The staff/teacher ID can be numerical or alphabetical. To associate teachers with students, this ID must match the teacher ID listed in the StaffToStudentExport.csv. If your organization/district does not need student rosters, then this ID can be anything.
-
school* (or site): School/site code from the Student Information System (SIS) that the staff member works. If a staff member works at multiple sites, add separate lines for each site. For example:
0000001,10,John,Smith,jsmith@example.com,555-555-5555,Teacher
0000001,20,John,Smith,jsmith@example.com,555-555-5555,Teacher
Note: If any of the data differs between lines (e.g. id, name, mobileNumber, or title), the import uses data from the first line. -
nameFirst*: First name of staff
-
nameLast*: Last name of staff
-
email*: District email of staff
-
mobileNumber: Staff mobile number, if available. 10 digits. Flexible on parentheses, hyphens and spaces.
-
title(*): Job title for staff. Any staff member with the title "Teacher" or "Instructor" initially appear in the "Staff" tab in CatapultEMS. All others initially appear in the "Other Staff" tab. A title change does not affect the access level for existing users. (For example, if a user is already under "Other Staff" or "Site Safety Team", changing the title to "Teacher" does not automatically move them to the "Staff" tab). This column is highly recommended but not required.
-
CatapultEMS always adds new users and new user locations based on the StaffExport.csv. CatapultEMS can optionally deactivate users and user locations that no appear in the StaffExport.csv. The latter is ideal if your organization has accurate data on which staff belong to each site/school.
StudentExport.csv*
Sample file: StudentExport.csv
-
id,school,nameFirst,nameLast,mobileNumber,email,contactNamePrimary,contactPhonePrimary,contactEmailPrimary,contactNameSecondary,contactPhoneSecondary,contactEmailSecondary
-
id*: student ID number from SIS and can be numerical or alphabetical
-
school* (or site): school code from SIS
-
nameFirst*: first name of student
-
nameLast*: last name of student
-
mobileNumber: mobile number of student. Important: Only include if students are receiving alerts in contract
-
email: email of student. Important: Only include if students are receiving alerts in contract
-
contactNamePrimary (or contactName1): Name of primary contact. If the name includes a comma (e.g. "Smith, John" or "John Smith, Jr.") please add quotes around the name. (Some software does this automatically for CSV files).
-
contactPhonePrimary (or contactPhone1): Phone number of primary contact, if applicable
-
contactEmailPrimary (or contactEmail1): Email of primary contact, if applicable
-
contactNameSecondary (or contactName2): Name of secondary contact, if applicable. If the name includes a comma (e.g. "Smith, John" or "John Smith, Jr.") please add quotes around the name. (Some software does this automatically for CSV files).
-
contactPhoneSecondary (or contactPhone2): Phone number of secondary contact, if applicable
-
contactEmailSecondary (or contactEmail2): Email of secondary contact, if applicable
-
If your contract includes more than two student contacts, the column names would be contactName3,contactPhone3,contactEmail3, with the number increasing to 4, 5, etc.
Alternatively, you can list only one contact per line (but repeat the student info).
StaffToStudentExport.csv*
Sample file: StaffToStudentExport.csv
Remember to limit this to current classes only.
PowerSchool users: For the fastest setup, use the Catapult EMS plugin for PowerSchool.
-
school,teacher,student,period,name,courseNumber,sectionNumber
-
school* (or site): school code from SIS
-
teacher*: Must match the Staff ID from the StaffExport file.
-
student*: Must match the Student ID from the StudentExport file.
-
period*: Usually a number, but can also be 'homeroom' or '0', if applicable. If a teacher has multiple class rosters (e.g. secondary school) then each class needs a different period.
-
name*: course name
-
courseNumber: if applicable
-
sectionNumber: if applicable
-
SchoolExport (Excel or CSV)*
-
One-time export for internal reference by a human. (Nightly uploads of this file not required or needed.)
-
schoolCode,schoolSiteName,address,phoneNumber,mergeWithSchoolCode
-
schoolCode: school code from SIS
-
schoolSiteName: name of school or site
-
address: address of school or site
-
phoneNumber: phone number of school or site
-
mergeWithSchoolCode: Use this to merge schools or sites based on the location. Merged sites function as one site in CatapultEMS, if applicable.
-
* Required for setup.