Tool Search: MT Extracts
The Roster Extract contains information related to student roster data. This extract matches the Roster Upload import file.
![Screenshot of the Roster Extract Editor.](http://dyzz9obi78pm5.cloudfront.net/app/image/id/66c8881c4a96f1ba4305b1be/n/mt-roster-extract-editor.jpg)
Tool Rights
Read - Generate extract.
Write - N/A
Add - N/A
Delete - N/A
Report Logic
This report can run against a district’s active year as well as any prior year and in both District Edition and State Edition against District Edition data.
File Formats
The extract can be generated in the following formats:
- State Format (TSV)
- HTML
- CSV
- XML
Use the State Format when all data has been reviewed for accuracy and information is ready to be uploaded. Use one of the other formats for data review and testing.
Generate Extract
- Select the Roster option from the Extract Type dropdown list.
- Select the desired Format from the dropdown list.
- Choose the desired calendar(s) from the Calendar list.
- Click the Generate Report button. The extract displays in a new window in the selected format.
Example
![Screenshot of the Roster Extract HTML Example.](http://dyzz9obi78pm5.cloudfront.net/app/image/id/66c8884dd89cf010d708e2ae/n/mt-roster-extract-html-858323.jpg)
Layout
Header Layout
Data Element | Description |
---|---|
Record Type | The abbreviation for the type of file generated. This reports as HD. Alphanumeric, 2 characters (HD) |
Date | The most recent date a change was made on the file or the date the file was generated. Date field, 10 characters (MM/DD/YYYY) |
Time | The most recent time a change was made on the file or the date the file was generated. Time field, 8 characters (HH:MM:SS) |
Version | The most current version of the file interface specification and references to the application system. This field reports as MT9.1. Alphanumeric, 5 characters (MT9.1) |
Upload Layout
# | Data Element | Description | Location |
---|---|---|---|
1 | Record Type | The abbreviation for the type of file generated. This reports as RU. Alphanumeric, 2 characters (RU) | N/A |
2 | District Number | The unique identifier assigned to the district by the OPI. String, 4 characters | District Information > State District Number District.number |
3 | School Number | The unique identifier assigned to the school by the OPI. String, 4 characters | School Information > State School Number School.number |
4 | Calendar Number | The unique calendar identifier. String, 4 characters | Calendar > Number Calendar.number |
5 | Course Number | The number assigned to the course. Alphanumeric, 13 characters | Course > Course Number Course.number |
6 | Section Code | The section number assigned to the section. String, 4 digits | Section > Section Number Section.number |
7 | State ID | The student's state ID number. Numeric, 9 digits | Demographics > State ID Identity.stateID |
8 | Student First Name | The student's first name. Alphanumeric, 50 characters | Demographics > First Name Identity.firstName |
9 | Student Last Name | The student's last name. Alphanumeric, 50 characters | Demographics > Last Name Identity.lastName |
10 | Roster Start Date | The first day of the roster. Alphanumeric, 10 characters (MM/DD/YYYY) | Roster > Start Date Roster.startDate |
11 | Roster End Date | The last day of the roster. Alphanumeric, 10 characters (MM/DD/YYYY) | Roster > End Date Roster.endDate |
12 | Year | The end year for assignment. Numeric, 4 digits (YYYY) | Calendar > School Year School.year |