Schoolzilla has a file-based connector with Skyward SMS where the files drop nightly to a secure SFTP site. Schoolzilla sets up the SFTP site and will share information with you (contact support or your implementation specialist if you need assistance with that).
In order for Schoolzilla to connect to your Skyward instance, you'll need to import and configure the Schoolzilla packages in SkyBuild. After you follow these instructions, files will drop nightly and be ingested by Schoolzilla.
Setting up Exports for Current Year Data
- Log into Skyward as an administrator.
- Click the Administration tab at the top of the screen.
- Under the Skybuild box in the upper right, click Exports.
- Then click Export File Builder - EF.
- On the right side menu, click the Import Interface button.
- Click the arrow buttons at the bottom of the page until you find the following interfaces:
- SchZilla_Attend
- Schzilla_Att_H
- Schzilla_Behave
- Schzilla_Beha_H
- Schzilla_Common
- Schzilla_Comm_H
- Schzilla_Grades
- Schzilla_Grad_H
Click on one of the Schoolzilla interface files listed above. (In the example below, we selected SchZilla_Attend_CY.txt first, but you can select the interfaces in any order you wish.)
- With the interface highlighted, click the Select button.
- You should land on the Export File Builder page and see the interface you just imported listed.
- Repeat this process until all of the Schoolzilla interfaces have been added to the Export File Builder.
Editing Exports for Current Year Data
Next, you will need to edit each interface for SFTP upload – the credentials needed for this will be provided to you by a Schoolzilla contact.
- Start this by highlighting a package and click the Edit button in the upper right.
- This will open an edit window to enter the credentials. Please enter the access credentials provided by Schoolzilla. For the path, please enter /import/Current for the current year (CY) interface exports and /import/Historical for the historical (_H) package exports. Repeat for all packages.
Note: All the packages that end in _H are for historical extracts that will only need to be adjusted and run/uploaded once.
- Once you have added this information to all 8 interfaces, you will then need to edit the files within the current year interfaces (SchZilla_Attend, Schzilla_Behave, Schzilla_Common, Schzilla_Grades).
Select an interface and click to expand to view the files.
-
For each file, on the right there is an option to Edit File. Click Edit File to make adjustments to output on the file.
IMPORTANT – Do not edit the file name or output of the file. Most are set with defaults, but you have options for grades and schools if you need to filter.
- For the option of Grade/Grad Yr - enter the lowest grade and highest grade. The default is set for K-12.
- If you do not want students lower than Kindergarten, there is no need to change this option, but if there are students in the district and you want reporting capabilities on them you will need to edit this in each of the files.
- If you use a grade level value higher than 12, you must also update this range.
- You also have the option to remove filtering to include any possible grade level value.
- There is NO NEED to filter entities as Schoolzilla can do the filtering on our end when the site is reviewed.
- For the option of Grade/Grad Yr - enter the lowest grade and highest grade. The default is set for K-12.
-
Please make the following updates to the files, as appropriate for your district.
SchZilla_Attend
-
AttendancePr
- Grade/Grad Yr – Enter the lowest grade and highest possible grade (inc. graduated) or modify to not filter.
- Button for Absence Types – Use this button to open the edit window and for each section click Add All for each type.
-
StuSchedule
- Grade/Grad Yr - Enter the lowest grade and highest possible grade (inc. graduated) or modify to not filter.
- Student Ranges - Enter the lowest and highest grade you'd like to populate - default is set for 00 to 00 and will cause the file to be too small.
SchZilla_BeHave
-
ActionOffense
- Grade/Grad Yr - enter the lowest grade and highest possible grade (inc. graduated) or modify to not filter.
SchZilla_Common
- Entity - No changes needed
- Term - No changes needed
-
Student
- Grade/Grad Yr - enter the lowest grade and highest possible grade (inc. graduated) or modify to not filter.
- Staff - No changes needed
- Course - No changes needed
- Section - No changes needed
-
StudentEnr
- Grade/Grad Yr - Enter the lowest grade and highest possible grade (inc. graduated) or modify to not filter.
-
ProgramEnr
- Grade/Grad Yr - Enter the lowest grade and highest possible grade (inc. graduated) or modify to not filter.
-
EntryWithdraw
- Grade/Grad Yr - Enter the lowest grade and highest possible grade (inc. graduated) or modify to not filter.
- Note: Enrollment records for every school year for every student are a prerequisite to populate the Grade Level at the Time demographic option in Schoolzilla dashboards.
SchZilla_Grades
- Grade Buckets - No changes needed.
- Grade Periods - No changes needed.
-
StudentGrades
- Grade/Grad Yr - Enter the lowest grade and highest possible grade (inc. graduated) or modify to not filter.
-
GPA
- Grade/Grad Yr - Enter the lowest grade and highest possible grade (inc. graduated) or modify to not filter.
-
Subj and Skill
- Grade/Grad Yr - Enter the lowest grade and highest possible grade (inc. graduated) or modify to not filter.
Editing Exports for Historical Data
To ensure accurate and comprehensive historical data, it is critical that the following settings are in place for all files that include student-level data:
- CY Status, NY Status and CY Member should all be set to both.
- Graduation Years
- Grade level ranges should be unfiltered OR represent the lowest and highest possible grades anytime in the last 5 years. Please keep in mind, you want to include data for graduated students, so if a different grade level (e.g. 99) is used when graduated, that value should be the highest range.
Historical files are required once during setup and again adhoc if data changes are made. Before exporting, make the required package updates below. Once updated, export the files, and import them to the file directory provided by Schoolzilla (/import/Historical).
SchZilla_Att_H
-
AttendancePrd
- CY Status, NY Status and CY Member - Ensure all are set to both.
- Grade/Grad Yr - Enter the lowest grade and highest possible grade (inc. graduated) or modify to not filter.
- Button for Absence Types – Click this button to open the edit window and for each section click Add All for each type.
- Attendance Ranges – Leave the date as a range and enter in up to the last 5 years (ex: 08/01/2016 – 7/31/2022)
-
StuSchedule
- CY Status, NY Status and CY Member - Ensure all are set to both.
- Grade/Grad Yr - Enter the lowest grade and highest possible grade (inc. graduated) or modify to not filter.
- Class Ranges - Enter the date up to the last 5 years (ex: 08/01/2016 – 7/31/2022)
- Student Ranges - Enter the lowest and highest grade you'd like to populate. Warning! default is set for 00 to 00 which will exclude most data.
SchZilla_BeHave
-
ActionOffense
- Grade/Grad Yr - Enter the lowest grade and highest possible grade (inc. graduated) or modify to not filter.
- Discipline Offense Ranges – Offense Date – Enter dates up to the last 5 years (ex: 08/01/2014 – 7/31/2020)
- Discipline action Ranges – Action Date - Enter dates up to the last 5 years (ex: 08/01/2014 – 7/31/2020)
SchZilla_Common
- Entity - No changes needed
-
Term
- Class Ranges – Control Set Date - Enter dates up to the last 5 years (ex: 08/01/2016 – 7/31/2022)
-
Student
- CY Status, NY Status and CY Member - Ensure all are set to both.
- Grade/Grad Yr - Enter the lowest grade and highest possible grade (inc. graduated) or modify to not filter.
- Staff - No changes needed
- Course - No changes needed
-
Section
- Class Ranges – Control Set Date - Enter dates up to the last 5 years (ex: 08/01/2016 – 7/31/2022)
-
StudentEnr
- CY Status, NY Status and CY Member - Ensure all are set to both.
- Grade/Grad Yr - Enter the lowest grade and highest possible grade (inc. graduated) or modify to not filter.
- Class Ranges – Control Set Date - Enter dates up to the last 5 years (ex: 08/01/2016 – 7/31/2022)
-
ProgramEnr
- CY Status, NY Status and CY Member - Ensure all are set to both.
- Grade/Grad Yr - Enter the lowest grade and highest possible grade (inc. graduated).
- Services Ranges – DO NOT add a check in the AS OF DATE - Enter dates up to the last 5 years (ex: 08/01/2016 – 7/31/2022)
-
EntryWithdraw
- CY Status, NY Status and CY Member - Ensure all are set to both.
- Grade/Grad Yr - Enter the lowest grade and highest possible grade (inc. graduated) or modify to not filter.
- Entry/Withdrawal Ranges - Because Skyward SMS does not require a new entry record every school year, it is important that the range set here includes the earliest possible entry date for students who would have been enrolled anytime in the last 5 years. To reduce risk of unintentionally excluding student records, we recommend a broad range (ex: 01/01/1990 – 7/31/2050)
- Note: Enrollment records for every school year for every student are a pre-requisite to populate the Grade Level at the Time demographic option in Schoolzilla dashboards.
SchZilla_Grades
- Grade Periods: No changes needed
-
StudentGradeBuckets
- Confirm CY Status, NY Status, CY Member all set to both.
- Grade/Grad Yr - Enter the lowest grade and highest possible grade (inc. graduated) or modify to not filter.
- Class Ranges – Control Set Date - Enter dates up to the last 5 years (ex: 08/01/2016 – 7/31/2022)
-
GPA
- Confirm CY Status, NY Status, CY Member all set to both.
-
Grade/Grad Yr - Enter the lowest grade and highest possible grade (inc. graduated) or modify to not filter.
Exporting the Schoolzilla Interfaces
Now that all 8 interfaces have been edited with the correct parameters, you are ready to schedule the interfaces for export. Back on the Export File Builder page, click Export in the upper right corner.
This will create the initial export and allow you to review a report which should show a successful transaction. If the report doesn't show a successful submission, confirm your username and password.
Now, repeat this step for each export.
Setting Up Scheduling
- Next, schedule these exports to run nightly. To do so, click on the printer icon in the very top right corner of the Export File Builder page.
- This will bring up a new modal called My Print Queue, seen below.
With the first export script already highlighted here, click the Tasks button on the right, and then click Schedule This.
- On the modal that appears, change the start time to 02:00 AM. Next, scroll to the bottom of the window and click the FTP Connection link.
- A new window called FTP Connections will open. Click Add on the right side menu.
- Enter the Schoolzilla SFTP information that was provided by your Schoolzilla contact, along with the path of /import/Current.
- Click Save.
- Click the Save button. Select the Schoolzilla Export connection on the FTP Connections window. It should populate in your export window.
- Click the Save button. The interface will now export on the daily schedule you defined.
Repeat this step for each export listed that has "CY" in the file name (CY stands for current year).
Your files should now be scheduled to export to Schoolzilla nightly!
Additional Information
Please also see these articles for additional metadata we need uploaded to My Data in order to configure enrollment and attendance data correctly:
-
AttendancePr