![](media/image1.png){width="3.5in" height="3.5in"}

U.S. DEPARTMENT OF EDUCATION

Education Data Exchange Network (EDEN)

X063 - Teacher Quality in Elementary Classes

XML Specifications

**Version 3.1**

**April 2007**

This technical guide was produced under U.S. Department of Education
Contract No. GS00F0049M-ED05P01299 with Perot Systems Government
Services, Inc. Brandon Scott served as the contracting officer's
representative. No official endorsement by the U.S. Department of
Education of any product, commodity, service or enterprise mentioned in
this publication is intended or should be inferred.

**U.S. Department of Education**

Margaret Spellings

*Secretary*

**Office of Planning, Evaluation and Policy Development**

Kerri Briggs

*Acting Assistant Secretary*

![](media/image2.wmf){width="1.3854330708661418in"
height="0.20826771653543308in"}

April 2007

This technical guide is in the public domain. Authorization to reproduce
it in whole or in part is granted. While permission to reprint this
publication is not necessary, the citation should be: U.S. Department of
Education, Office of Planning, Evaluation and Policy Development,
Strategic Accountability Service, *X063 - Teacher Quality in Elementary
Classes XML Specifications*, Washington, D.C., 2007.

This technical guide is also available on the Department's Web site at:
[[http://www.ed.gov/edfacts/]{.underline}](http://www.ed.gov/edfacts/).

On request, this publication is available in alternate formats, such as
Braille, large print, or computer diskette. For more information, please
contact the Department's Alternate Format Center at (202) 260-0852 or
(202) 260-0818.

[]{#__RefHeading___Toc163875026 .anchor}DOCUMENT CONTROL

DOCUMENT INFORMATION

  --------------- ---------------------------------------------------------
  **Title:**      X063 - Teacher Quality in Elementary Classes XML
                  Specifications

  **Revision:**   3.1

  **Issue Date:** April 2007

  **Security      Unclassified -- For Official Use Only
  Level:**        

  **Filename:**   609225.doc
  --------------- ---------------------------------------------------------

DOCUMENT HISTORY

+--------+-------------+-----------------------------------------------+
| **V    | **Date**    | **Summary of Change**                         |
| ersion |             |                                               |
| Nu     |             |                                               |
| mber** |             |                                               |
+--------+-------------+-----------------------------------------------+
| 1.0    |             | Version 1.0 or subsequent updates (i.e. 1.1,  |
|        |             | 1.2, etc) of this file specification is used  |
|        |             | to build files for SYs 2003-04 and 2004-05    |
+--------+-------------+-----------------------------------------------+
| 2.0    |             | Version 2.0 or subsequent updates (i.e. 2.1,  |
|        |             | 2.2, etc) of this file specification is used  |
|        |             | to build files for SY 2005-06                 |
+--------+-------------+-----------------------------------------------+
| 3.0    | 12/2006     | -   3.0: Updated guidance                     |
|        |             |                                               |
|        |             | -   4.2, 5.2, 6.2: Updated the data group     |
|        |             |     name and definition.                      |
|        |             |                                               |
|        |             | -   4.0, 5.0, 6.0: Modified permitted code    |
|        |             |     set for Instructional Assignment.         |
+--------+-------------+-----------------------------------------------+
| 3.1    | March 2007  | -   3.0: Updated guidance regarding the       |
|        |             |     teacher of record                         |
+--------+-------------+-----------------------------------------------+

RELEASE AUTHORIZATION

  ----------------------- -----------------------------------------------
  **Name**                **Signature / Date**

  Author                  

  QA                      

  Release Authority       
  ----------------------- -----------------------------------------------

[]{#__RefHeading___Toc163875027 .anchor}PREFACE

This document provides technical instructions for building files that
can be submitted through the Education Data Exchange Network (EDEN).
This document is used in coordination with the ED*Facts* Workbook and
the EDEN Submission System User Guide.

EDEN is a centralized, coordinated repository of state reported, K-12,
educational data residing at the U.S. Department of Education.  The EDEN
Submission System is an electronic system that facilitates the efficient
and timely transmission of data from SEAs to the U.S. Department of
Education. 

Contents

[DOCUMENT CONTROL ii](#__RefHeading___Toc163875026)

[PREFACE iii](#__RefHeading___Toc163875027)

[1.0 PURPOSE 1](#purpose)

[1.1 Changes from the SY 2005-06 File Specifications
1](#changes-from-the-sy-2005-06-file-specifications)

[1.2 Requirements for Submitting this Data Group
1](#requirements-for-submitting-this-data-group)

[2.0 FILE NAMING CONVENTION 2](#file-naming-convention)

[3.0 GUIDANCE FOR SUBMITTING THIS FILE
3](#guidance-for-submitting-this-file)

[3.1 Application of Zero, Missing and Not Collected
4](#application-of-zero-missing-and-not-collected)

[3.2 XML Specification Headings 4](#xml-specification-headings)

[4.0 STATE EDUCATION AGENCY METRIC OBJECTS
5](#state-education-agency-metric-objects)

[4.1 Category XML Object 5](#category-xml-object)

[4.2 Table Type XML Object 6](#table-type-xml-object)

[4.3 Agency XML Object 7](#agency-xml-object)

[4.4 File Transmit XML Object 8](#file-transmit-xml-object)

[5.0 LOCAL EDUCATION AGENCY METRIC OBJECTS
9](#local-education-agency-metric-objects)

[5.1 Category XML Object 9](#category-xml-object-1)

[5.2 Table Type XML Object 10](#table-type-xml-object-1)

[5.3 Agency XML Object 11](#agency-xml-object-1)

[5.4 File Transmit XML Object 12](#file-transmit-xml-object-1)

[6.0 SCHOOL METRIC OBJECTS 13](#school-metric-objects)

[6.1 Category XML Object 13](#category-xml-object-2)

[6.2 Table Type XML Object 14](#table-type-xml-object-2)

[6.3 Agency XML Object 15](#agency-xml-object-2)

[6.4 File Transmit XML Object 16](#file-transmit-xml-object-2)

# PURPOSE

This document contains instructions for building XML files to submit
ED*Facts* Data Group: Teacher Quality in Elementary Classes Table, ID \#
381. The definition for this data group is in the row "Table Name" in
Table 4.2-1. The Consolidated State Performance Report, which is
legislatively supported by Sections 9302 and 9303 of the Elementary and
Secondary Education Act as amended by the No Child Left Behind Act of
2001, uses this ED*Facts* data group.

A separate document contains the non-XML file formats. General guidance
for constructing all file types may be found in the ED*Facts* Workbook.

## Changes from the SY 2005-06 File Specifications

There have been changes to this file specification:

-   Update the data group name and definition.

-   Modified permitted code set for Instructional Assignment by deleting
    "Bilingual/English as a Second Language instructional assignment."

## Requirements for Submitting this Data Group

This data group is submitted at the following levels:

-   SEA

-   LEA

-   School

Teachers of grades offered at the middle school level are included in
this file if they are not departmentalized. If the teachers of grades
offered at the middle school level are departmentalized, the teachers
should not be included in this file and instead be included in N or X
064 Teacher Quality in Core Secondary Classes.

The following table indicates the valid combinations of categories and
the sub-totals and/or totals needed for this file. An "X" in the column
indicates that the column must be populated when reporting that
particular category. The total indicator must be either "Y" (Yes) or "N"
(No). If the record is for a detail count, specify an "N" (No). If the
record is for a subtotal or grand total, specify a "Y" (Yes).

Table 1.2-1: Teacher Quality in Elementary Classes Table, Required
Categories, and Applicable Totals

  --------------------------------------------------------------------------------------
  **Table Name**    **Instructional   **Qualification   **Total       **Comments**
                    Assignment**      Status            Indicator**   
                                      (Teachers)**                    
  ----------------- ----------------- ----------------- ------------- ------------------
  **ELCLTCHQUAL**   X                 X                 N              

  **ELCLTCHQUAL**                                       Y             Grand Total
  --------------------------------------------------------------------------------------

# FILE NAMING CONVENTION

Being able to readily identify any particular file transmission is an
important consideration for users of the EDEN Data Submission System.
Being able to identify a particular file can greatly facilitate any
technical assistance that may be requested by the state. A maximum of 25
characters (including the file extension) is allowed for the file name.
The following is the naming convention for Teacher Quality in Elementary
Classes transmittal file submissions:

sslev**ELMCLSTEA**vvvvvvv.xml

Where:

> **ss** = Two-character USPS State Abbreviation for the submitting SEA.
>
> **lev** = Three-character abbreviation for the level submitted. Use:
>
> SEA for a State Education Agency Teacher Quality in Elementary Classes
> submission
>
> LEA for a Local Education Agency Teacher Quality in Elementary Classes
> submission
>
> SCH for a School Teacher Quality in Elementary Classes submission
>
> **Filename** = **ELMCLSTEA** (no more than nine digits).
>
> **vvvvvvv** = Up to seven-character alphanumeric string designated by
> the SEA to uniquely identify the individual submission (e.g., ver0001,
> v010803).
>
> **.xml** = The three-character file extension identifying the Data
> Records.

# GUIDANCE FOR SUBMITTING THIS FILE

This file specification collects the unduplicated number of elementary
classes in core academic subjects taught by highly qualified and not
highly qualified teachers. Section 9101(23) of the ESEA defines "highly
qualified."

-   *What are the core academic subjects?* English, reading or language
    arts, mathematics, science, foreign languages, civics and
    government, economics, arts, history, and geography \[Title IX,
    Section 9101(11)\]. While the statute includes the arts in the core
    academic subjects, it does not specify which of the arts are core
    academic subjects; therefore, States must make this determination.

-   *How is a teacher of elementary classes defined?* An individual who
    provides instruction in the core academic areas to classes at the
    elementary level, or individuals who teach at the elementary level
    in an environment other than a *classroom setting (and who maintain
    daily student attendance records)*

-   *How is a class defined?* A class is a setting in which organized
    instruction of core academic course content is provided to one or
    more students (including cross-age groupings) for a given period of
    time. Instruction, provided by one or more teachers or other staff
    members, may be delivered in person or via a different medium.
    Classes that share space should be considered as separate classes if
    they function as separate units for more than 50 percent of the time

-   *Who is the teacher of the class?* The teacher of record (the person
    who is primarily responsible for the instruction that takes place in
    the classroom) is the person who needs to be highly qualified. If a
    class is taught by a non HQT but has a HQT consultative teacher
    attached to it as well the class would NOT be taught by a highly
    qualified teacher.

-   *How should States count teachers in elementary classes?* States
    have two approaches to counting teachers.

    1.  *Count self-*contained classrooms as one class -- If a State
        counts self-contained classrooms as one class, to avoid over
        representing subject area specialists and resource teachers,
        subject area specialists and resource teachers should also be
        counted as teaching one class.

    2.  *Count self-*contained classrooms for each subject taught -- If
        a State counts self contained classrooms for each subject taught
        then the subject area specialists and resource teachers would
        also count as teaching multiple classes.

-   Subtotals and grand totals must be equal to or greater than the sum
    of their parts. If the subtotal or grand total is less than the sum
    of their parts, a Data Error will be issued.

-   The sum of highly qualified and not highly qualified teachers does
    not equal to the sum of all teachers. This designation is only
    assigned to a sub-set of the teaching staff that teaches in specific
    academic subject areas, which could leave some teachers out of the
    overall sum of teachers.

## Application of Zero, Missing and Not Collected

Missing and not collected are not permitted values for "qualification
status (teachers)" because the file should not be submitted if this
information is not available.

## XML Specification Headings

The XML specifications are represented in a table with the headings:

-   Element -- name of the XML element tag.

-   Attribute -- name of the XML attribute tag.

-   Category Value -- name of the category.

-   Char -- the XML element or attribute characteristic as previously
    defined.

-   Definition/Comments -- definition and additional comments related to
    formats or other business rules.

-   Permitted Values -- disaggregated values for data elements.

The Char (characteristics) column in the XML format matrices accepts the
following codes:

Table 3.2-1: EDEN XML Format Codes

  -----------------------------------------------------------------------
  **Code**      **Characteristic**
  ------------- ---------------------------------------------------------
  M             Mandatory Element/Attribute

  O             Optional

  C             Conditionally Required

  MR            Mandatory and Repeatable Element

  OR            Optional and Repeatable Element

  CR            Conditional and Repeatable Element
  -----------------------------------------------------------------------

# STATE EDUCATION AGENCY METRIC OBJECTS

In order to simplify the transmission process, the State Agency has been
separated into three (3) distinct metric and file transmit XML objects.
The XML metric and file transmit objects are the same structure
regardless of the metric information being transmitted. The structure
contains a node that defines the State Agency corresponding to the
submitted metric. In addition, the structure contains nodes representing
characteristics of the metric (Instructional Assignment, Qualification),
the associated value, and whether the metric value is a sub-total or
grand total. The metric objects are contained within the file
transmission objects that define the group of values being submitted.

## Category XML Object

The category XML object is used to define the characteristics associated
with a count. There may be zero, one, or more categories defined for a
count. The XML object matrix is followed by an example of the object.

**Table 4.1-1: SEA, Category XML Object**

  --------------------------------------------------------------------------------------------------------
  **Element**   **Attribute**   **Data Element  **Category    **Char**   **Definition /  **Permitted
                                Name** (from    Value**                  Comments**      Values**
                                Fixed Format                                             
                                document)                                                
  ------------- --------------- --------------- ------------- ---------- --------------- -----------------
  CATEGORY                                                                               

                TYPE                                          M          The             
                                                                         category(ies)   
                                                                         for the table   
                                                                         type.           

                                Instructional                                            **INSTRASSG**
                                Assignment                                               

                                Qualification                                            **QUALSTATTCH**
                                Status                                                   
                                (Teachers)                                               

                VALUE                                         M          The category    
                                                                         permitted       
                                                                         value.          

                                                INSTRASSG                The type of     **REG** --
                                                                         core academic   Regular, core
                                                                         subject class   academic
                                                                         teachers are    instructional
                                                                         teaching.       assignment\
                                                                                         **SPED** --
                                                                                         Special Education
                                                                                         instructional
                                                                                         assignment\
                                                                                         **MISSING**\
                                                                                         **NOTCOLLECT** =
                                                                                         Not Collected

                                                QUALSTATTCH              An indication   **HQ** - Highly
                                                                         of whether      qualified\
                                                                         teachers are    **NHQ** - Not
                                                                         classified as   highly qualified
                                                                         highly          
                                                                         qualified for   
                                                                         their           
                                                                         assignment      
                                                                         according to    
                                                                         state           
                                                                         definition.     
  --------------------------------------------------------------------------------------------------------

Example:

\<CATEGORY TYPE=\"INSTRASSG\" VALUE=\"SPED\"/\>

\<CATEGORY TYPE=\"INSTRASSG\" VALUE=\"REG\"/\>

\<CATEGORY TYPE=\"QUALSTATTCH\" VALUE=\"HQ\"/\>

\<CATEGORY TYPE=\"QUALSTATTCH\" VALUE=\"NHQ\"/\>

## Table Type XML Object

The table type XML object is used to define the type and value of the
count. It may contain category XML objects to define additional
characteristics. The XML object matrix is followed by an example of the
object.

**Table 4.2-1: SEA, Table Type XML Object**

  ----------------------------------------------------------------------------------------------
  **Element**   **Data        **Attribute**    **Char**   **Definition /       **Permitted
                Element Name\                             Comments**           Values**
                **(from Fixed                                                  
                Format                                                         
                document)                                                      
  ------------- ------------- ---------------- ---------- -------------------- -----------------
  TABLETYPE                                                                     

                Table Name    TYPEABBRV        M          The unduplicated     **ELCLTCHQUAL**
                                                          number of elementary 
                                                          classes taught by    
                                                          highly-qualified and 
                                                          not highly-qualified 
                                                          teachers, according  
                                                          to state definition. 
                                                          In general, an       
                                                          elementary teacher   
                                                          has one class, and a 
                                                          specialist has one   
                                                          class.               

                Total         TOTALINDICATOR   M          An indicator that    **N** = specifies
                Indicator                                 defines the count    detail level\
                                                          level (i.e., detail  **Y** = specifies
                                                          level, subtotal      a subtotal or
                                                          level or grand total grand total
                                                          level).              level.

  CATEGORY                                     OR         The categories used   
                                                          to define the        
                                                          characteristics      
                                                          associated with the  
                                                          count.               

  AMOUNT        Class Count                    M          If the count          
                                                          provided is either a 
                                                          subtotal or grand    
                                                          total, it must be    
                                                          equal to or greater  
                                                          than the sum of its  
                                                          parts.               

  EXPLANATION   Explanation                    O          Submitted files will  
                                                          be processed through 
                                                          various edit checks. 
                                                          When unusual         
                                                          conditions are       
                                                          detected, warning    
                                                          errors may be        
                                                          issued, even though  
                                                          the data may be      
                                                          valid. When this     
                                                          occurs, an           
                                                          explanation          
                                                          responding to the    
                                                          warning may be       
                                                          submitted with the   
                                                          data, or after files 
                                                          have been processed. 
                                                          The Department of    
                                                          Education will       
                                                          verify explanations, 
                                                          and after            
                                                          verification, accept 
                                                          the data.            
  ----------------------------------------------------------------------------------------------

The following example shows one detail record followed by a grand total
record.

\<TABLETYPE TYPEABBRV=\"ELCLTCHQUAL\" TOTALINDICATOR=\"N\"\>

\<CATEGORY TYPE=\"QUALSTATTCH\" VALUE=\"HQ\"/\>

\<CATEGORY TYPE=\"INSTRASSG\" VALUE=\"REG\"/\>

\<AMOUNT\>1500\</AMOUNT\>

\<EXPLANATION\> *Explanation goes here* \</EXPLANATION\>

\</TABLETYPE\>

\<TABLETYPE TYPEABBRV=\"ELCLTCHQUAL\" TOTALINDICATOR=\"Y\"\>

\<AMOUNT\>1500\</AMOUNT\>

\<EXPLANATION\> *Explanation goes here* \</EXPLANATION\>

\</TABLETYPE\>

## Agency XML Object

This section defines the XML object used to submit all State Agency
metric information.

**Table 4.3-1: SEA, Agency XML Object**

  ----------------------------------------------------------------------------------------------
  **Element**   **Data        **Attribute**         **Char**   **Definition /      **Permitted
                Element Name\                                  Comments**          Values**
                **(from Fixed                                                      
                Format                                                             
                document)                                                          
  ------------- ------------- --------------------- ---------- ------------------- -------------
  AGENCY                                                                            

                **ID 559\     FIPSSTATECODE         M          The two-digit       For a list of
                **FIPS State                                   Federal Information valid FIPS
                Code                                           Processing          State Codes,
                                                               Standards (FIPS)    refer to the
                                                               for the state,      ED*Facts*
                                                               District of         Workbook.
                                                               Columbia, and the   
                                                               possessions and     
                                                               freely associated   
                                                               areas of the United 
                                                               States (e.g. Puerto 
                                                               Rico).              

                **ID 570\     STATEAGENCYIDNUMBER   M          A number used in    **01** =
                **State                                        EDEN to uniquely    State
                Agency Number                                  identify state      Education
                                                               agencies.  This ID  Agency
                                                               cannot be updated   
                                                               through this file.  

  TABLETYPE                                         MR         The XML Object used  
                                                               to define the type  
                                                               and value of the    
                                                               count.              
  ----------------------------------------------------------------------------------------------

Example:

\<AGENCY FIPSSTATECODE=\"94\" STATEAGENCYIDNUMBER=\"01\"\>

\<TABLETYPE\> *See Table Type XML Object example in Section 4.2*
\</TABLETYPE\>

\</AGENCY\>

## File Transmit XML Object

The file transmit object identifies the metric group being transmitted.
It also identifies whether the metric group is at the State Agency, LEA
or school level. Further, each metric group has an allowable set of
Table Types, categories, and category values that correspond to a
particular reporting period. This section defines the various file
transmit objects and valid metric combinations at the State Agency
level.

**Table 4.4-1: SEA, File Transmit XML Object**

  -------------------------------------------------------------------------------------------------
  **Element**        **Data        **Attribute**    **Char**   **Definition /     **Permitted
                     Element Name\                             Comments**         Values**
                     **(from Fixed                                                
                     Format                                                       
                     document)                                                    
  ------------------ ------------- ---------------- ---------- ------------------ -----------------
  FILETRANSMISSION                                  M                              

                     File Type     FILELAYOUTTYPE   M          Identifies the     **SEA ELEMENTARY
                                                               type of file being CLASSES TEACHER
                                                               submitted.         QUALIFICATION**

                     File          FILEID           M          Any combination of  
                     Identifier                                standard           
                                                               characters to      
                                                               further identify   
                                                               the file as        
                                                               specified by the   
                                                               SEA, e.g., a date, 
                                                               person's name,     
                                                               version number.    

                     File          SCHOOLYEAR       M          Enter the Academic  
                     Reporting                                 School Year for    
                     Period                                    which data is      
                                                               being reported.    
                                                               The required       
                                                               format for         
                                                               entering the File  
                                                               Reporting Period   
                                                               is \"CCYY-CCYY\"   
                                                               or \"CCYY CCYY\",  
                                                               where either a     
                                                               hyphen or a space  
                                                               must separate the  
                                                               beginning and      
                                                               ending years,      
                                                               e.g., 2006-2007 or 
                                                               2006 2007.         

  AGENCY                                            MR         The information     
                                                               that fully         
                                                               identifies the     
                                                               education unit.    
  -------------------------------------------------------------------------------------------------

Example:

\<FILETRANSMISSION\
FILELAYOUTTYPE=\"SEA ELEMENTARY CLASSES TEACHER QUALIFICATION\"

FILEID=\"SEA Teacher Qualifications Elem\"

SCHOOLYEAR=\"2006-2007\"\>

\<AGENCY\> *See Agency XML Object example in Section 4.3* \</AGENCY\>

\</FILETRANSMISSION\>

# LOCAL EDUCATION AGENCY METRIC OBJECTS

In order to simplify the transmission process, the Local Education
Agency has been separated into three (3) distinct metric and file
transmit XML objects. The XML metric and file transmit objects are the
same structure regardless of the metric information being transmitted.
The structure contains a node that defines the LEA that corresponds to
the submitted metric. In addition, the structure contains nodes
representing characteristics of the metric (Instructional Assignment,
Qualification), the associated value, and whether the metric value is a
sub-total or grand total. The metric objects are contained within the
file transmission objects that define the group of values that is being
submitted.

## Category XML Object

The category XML object is used to define the characteristics associated
with a count. There may be zero, one, or more categories defined for a
count. The XML object matrix is followed by an example of the object.

**Table 5.1-1: LEA, Category XML Object**

  ----------------------------------------------------------------------------------------------------------
  **Element**   **Attribute**   **Data Element    **Category    **Char**   **Definition /  **Permitted
                                Name\             Value**                  Comments**      Values**
                                **(from Fixed                                              
                                Format document)                                           
  ------------- --------------- ----------------- ------------- ---------- --------------- -----------------
  CATEGORY                                                                                  

                TYPE                                            M          The              
                                                                           category(ies)   
                                                                           for the table   
                                                                           type.           

                                Instructional                                              **INSTRASSG**
                                Assignment                                                 

                                Qualification                                              **QUALSTATTCH**
                                Status (Teachers)                                          

                VALUE                                           M          The category     
                                                                           permitted       
                                                                           value.          

                                                  INSTRASSG                The type of     **REG** --
                                                                           core academic   Regular, core
                                                                           subject class   academic
                                                                           teachers are    instructional
                                                                           teaching.       assignment\
                                                                                           **SPED** --
                                                                                           Special Education
                                                                                           instructional
                                                                                           assignment\
                                                                                           **MISSING**\
                                                                                           **NOTCOLLECT** =
                                                                                           Not Collected

                                                  QUALSTATTCH              An indication   **HQ** -- Highly
                                                                           of whether      qualified\
                                                                           teachers are    **NHQ** - Not
                                                                           classified as   highly qualified
                                                                           highly          
                                                                           qualified for   
                                                                           their           
                                                                           assignment      
                                                                           according to    
                                                                           state           
                                                                           definition.     
  ----------------------------------------------------------------------------------------------------------

Example:

\<CATEGORY TYPE=\"INSTRASSG\" VALUE=\"SPED\"/\>

\<CATEGORY TYPE=\"INSTRASSG\" VALUE=\"REG\"/\>

\<CATEGORY TYPE=\"QUALSTATTCH\" VALUE=\"HQ\"/\>

\<CATEGORY TYPE=\"QUALSTATTCH\" VALUE=\"NHQ\"/\>

## Table Type XML Object

The table type XML object is used to define the type and value of the
count. It may contain category XML objects to define additional
characteristics. The XML object matrix is followed by an example of the
object.

**Table 5.2-1: LEA, Table Type XML Object**

  ------------------------------------------------------------------------------------------------
  **Element**   **Data        **Attribute**    **Char**   **Definition /         **Permitted
                Element Name\                             Comments**             Values**
                **(from Fixed                                                    
                Format                                                           
                document)                                                        
  ------------- ------------- ---------------- ---------- ---------------------- -----------------
  TABLETYPE                                                                       

                Table Name    TYPEABBRV        M          The unduplicated       **ELCLTCHQUAL**
                                                          number of elementary   
                                                          classes taught by      
                                                          highly-qualified and   
                                                          not highly-qualified   
                                                          teachers, according to 
                                                          state definition. In   
                                                          general, an elementary 
                                                          teacher has one class, 
                                                          and a specialist has   
                                                          one class.             

                Total         TOTALINDICATOR   M          An indicator that      N = specifies
                Indicator                                 defines the count      detail level\
                                                          level (i.e., detail    Y = specifies a
                                                          level, subtotal level  subtotal or grand
                                                          or grand total level). total level.

  CATEGORY                                     OR         The categories used to  
                                                          define the             
                                                          characteristics        
                                                          associated with the    
                                                          count.                 

  AMOUNT        Class Count                    M          If the count provided   
                                                          is either a subtotal   
                                                          or grand total, it     
                                                          must be equal to or    
                                                          greater than the sum   
                                                          of its parts.          

  EXPLANATION   Explanation                    O          Submitted files will    
                                                          be processed through   
                                                          various edit checks.   
                                                          When unusual           
                                                          conditions are         
                                                          detected, warning      
                                                          errors may be issued,  
                                                          even though the data   
                                                          may be valid. When     
                                                          this occurs, an        
                                                          explanation responding 
                                                          to the warning may be  
                                                          submitted with the     
                                                          data, or after files   
                                                          have been processed.   
                                                          The Department of      
                                                          Education will verify  
                                                          explanations, and      
                                                          after verification,    
                                                          accept the data.       
  ------------------------------------------------------------------------------------------------

See Table Type XML Object example in section 4.2.

## Agency XML Object

This section defines the XML object used to submit all Local Education
Agency metric information. The XML object matrix is followed by an
example of the object.

**Table 5.3-1: LEA, Agency XML Object**

  ---------------------------------------------------------------------------------------------
  **Element**   **Data        **Attribute**         **Char**   **Definition /     **Permitted
                Element Name\                                  Comments**         Values**
                **(from Fixed                                                     
                Format                                                            
                document)                                                         
  ------------- ------------- --------------------- ---------- ------------------ -------------
  AGENCY                                                                           

                **ID 559\     FIPSSTATECODE         M          The two-digit      For a list of
                **FIPS State                                   Federal            valid FIPS
                Code                                           Information        State Codes,
                                                               Processing         refer to the
                                                               Standards (FIPS)   ED*Facts*
                                                               for the state,     Workbook.
                                                               District of        
                                                               Columbia, and the  
                                                               possessions and    
                                                               freely associated  
                                                               areas of the       
                                                               United States      
                                                               (e.g. Puerto       
                                                               Rico).             

                **ID 570\     STATEAGENCYIDNUMBER   M          A number used in   **01** =
                **State                                        EDEN to uniquely   State
                Agency Number                                  identify state     Education
                                                               agencies.  This ID Agency
                                                               cannot be updated  
                                                               through this file. 

                **ID 4\       STATELEAIDNUMBER      M          The identifier      
                **State LEA                                    assigned to a      
                Identifier                                     local education    
                                                               agency (LEA) by    
                                                               the State          
                                                               Education Agency   
                                                               (SEA). Also known  
                                                               as State LEA ID.   
                                                               This ID is a       
                                                               required field.    
                                                               This data element  
                                                               cannot be updated  
                                                               through this file. 

  TABLETYPE                                         MR         The XML Object      
                                                               used to define the 
                                                               type and value of  
                                                               the count.         
  ---------------------------------------------------------------------------------------------

Example:

\<AGENCY FIPSSTATECODE=\"94\" STATEAGENCYIDNUMBER=\"01\"

STATELEAIDNUMBER=\"001000-0000001\"\>

\<TABLETYPE\> *See Table Type XML Object example in Section 4.2*
\</TABLETYPE\>

\</AGENCY\>

## File Transmit XML Object

The file transmit object identifies the metric group being transmitted.
It also identifies whether the metric group is at the State Agency, LEA
or school level. Further, each metric group has an allowable set of
Table Types, categories, and category values that correspond to a
particular reporting period. This section defines the various file
transmit objects and valid metric combinations at the LEA level.

**Table 5.4-1: LEA, File Transmit XML Object**

  -----------------------------------------------------------------------------------------------
  **Element**        **Data        **Attribute**    **Char**   **Definition /   **Permitted
                     Element Name\                             Comments**       Values**
                     **(from Fixed                                              
                     Format                                                     
                     document)                                                  
  ------------------ ------------- ---------------- ---------- ---------------- -----------------
  FILETRANSMISSION                                  M                            

                     File Type     FILELAYOUTTYPE   M          Identifies the   **LEA ELEMENTARY
                                                               type of file     CLASSES TEACHER
                                                               being submitted. QUALIFICATION**

                     File          FILEID           M          Any combination   
                     Identifier                                of standard      
                                                               characters to    
                                                               further identify 
                                                               the file as      
                                                               specified by the 
                                                               SEA, e.g., a     
                                                               date, person's   
                                                               name, version    
                                                               number.          

                     File          SCHOOLYEAR       M          Enter the         
                     Reporting                                 Academic School  
                     Period                                    Year for which   
                                                               data is being    
                                                               reported. The    
                                                               required format  
                                                               for entering the 
                                                               File Reporting   
                                                               Period is        
                                                               \"CCYY-CCYY\" or 
                                                               \"CCYY CCYY\",   
                                                               where either a   
                                                               hyphen or a      
                                                               space must       
                                                               separate the     
                                                               beginning and    
                                                               ending years,    
                                                               e.g., 2006-2007  
                                                               or 2006 2007.    

  AGENCY                                            MR         The information   
                                                               that fully       
                                                               describes the    
                                                               education unit.  
  -----------------------------------------------------------------------------------------------

Example:

\<FILETRANSMISSION

FILELAYOUTTYPE=\"LEA ELEMENTARY CLASSES TEACHER QUALIFICATION\"

FILEID=\"LEA Teacher Qualifications Elem\"

SCHOOLYEAR=\"2006-2007\"\>

\<AGENCY\> *See Agency XML Object example in Section 5.3* \</AGENCY\>

\</FILETRANSMISSION\>

# SCHOOL METRIC OBJECTS

In order to simplify the transmission process, the School has been
separated into three (3) distinct metric and file transmit XML objects.
The XML metric and file transmit objects are the same structure
regardless of the metric information being transmitted. The structure
contains a node that defines the school that corresponds to the
submitted metric. In addition, the structure contains nodes representing
characteristics of the metric (Instructional Assignment, Qualification),
the associated value, and whether the metric value is a sub-total or
grand total. The metric objects are contained within the file
transmission objects that define the group of values that is being
submitted.

## Category XML Object

The category XML object is used to define the characteristics associated
with a count. There may be zero, one, or more categories defined for a
count. The XML object matrix is followed by an example of the object.

**Table 6.1-1: School, Category XML Object**

  ----------------------------------------------------------------------------------------------------------
  **Element**   **Attribute**   **Data Element    **Category    **Char**   **Definition /  **Permitted
                                Name\             Value**                  Comments**      Values**
                                **(from Fixed                                              
                                Format document)                                           
  ------------- --------------- ----------------- ------------- ---------- --------------- -----------------
  CATEGORY                                                                                  

                TYPE                                            M          The              
                                                                           category(ies)   
                                                                           for the table   
                                                                           type.           

                                Instructional                                              **INSTRASSG**
                                Assignment                                                 

                                Qualification                                              **QUALSTATTCH**
                                Status (Teachers)                                          

                VALUE                                           M          The category     
                                                                           permitted       
                                                                           value.          

                                                  INSTRASSG                The type of     **REG** --
                                                                           core academic   Regular, core
                                                                           subject class   academic
                                                                           teachers are    instructional
                                                                           teaching.       assignment\
                                                                                           **SPED** --
                                                                                           Special Education
                                                                                           instructional
                                                                                           assignment\
                                                                                           **MISSING**\
                                                                                           **NOTCOLLECT** =
                                                                                           Not Collected

                                                  QUALSTATTCH              An indication   **HQ** - Highly
                                                                           of whether      qualified\
                                                                           teachers are    **NHQ** - Not
                                                                           classified as   highly qualified
                                                                           highly          
                                                                           qualified for   
                                                                           their           
                                                                           assignment      
                                                                           according to    
                                                                           state           
                                                                           definition.     
  ----------------------------------------------------------------------------------------------------------

Example:

\<CATEGORY TYPE=\"INSTRASSG\" VALUE=\"SPED\"/\>

\<CATEGORY TYPE=\"INSTRASSG\" VALUE=\"REG\"/\>

\<CATEGORY TYPE=\"QUALSTATTCH\" VALUE=\"HQ\"/\>

\<CATEGORY TYPE=\"QUALSTATTCH\" VALUE=\"NHQ\"/\>

## Table Type XML Object

The table type XML object is used to define the type and value of the
count. It may contain category XML objects to define additional
characteristics. The XML object matrix is followed by an example of the
object.

**Table 6.2-1: School, Table Type XML Object**

  ----------------------------------------------------------------------------------------------
  **Element**   **Data        **Attribute**    **Char**   **Definition /       **Permitted
                Element Name\                             Comments**           Values**
                **(from Fixed                                                  
                Format                                                         
                document)                                                      
  ------------- ------------- ---------------- ---------- -------------------- -----------------
  TABLETYPE                                    M                                

                Table Name    TYPEABBRV        M          The unduplicated     **ELCLTCHQUAL**
                                                          number of elementary 
                                                          classes taught by    
                                                          highly-qualified and 
                                                          not highly-qualified 
                                                          teachers, according  
                                                          to state definition. 
                                                          In general, an       
                                                          elementary teacher   
                                                          has one class, and a 
                                                          specialist has one   
                                                          class.               

                Total         TOTALINDICATOR   M          An indicator that    **N** = specifies
                Indicator                                 defines the count    detail level\
                                                          level (i.e., detail  **Y** = specifies
                                                          level, subtotal      a subtotal or
                                                          level or grand total grand total
                                                          level).              level.

  CATEGORY                                     OR         The categories used   
                                                          to define the        
                                                          characteristics      
                                                          associated with the  
                                                          count.               

  AMOUNT        Class Count                    M          If the count          
                                                          provided is either a 
                                                          subtotal or grand    
                                                          total, it must be    
                                                          equal to or greater  
                                                          than the sum of its  
                                                          parts.               

  EXPLANATION   Explanation                    O          Submitted files will  
                                                          be processed through 
                                                          various edit checks. 
                                                          When unusual         
                                                          conditions are       
                                                          detected, warning    
                                                          errors may be        
                                                          issued, even though  
                                                          the data may be      
                                                          valid. When this     
                                                          occurs, an           
                                                          explanation          
                                                          responding to the    
                                                          warning may be       
                                                          submitted with the   
                                                          data, or after files 
                                                          have been processed. 
                                                          The Department of    
                                                          Education will       
                                                          verify explanations, 
                                                          and after            
                                                          verification, accept 
                                                          the data.            
  ----------------------------------------------------------------------------------------------

See Table Type XML Object example in section 4.2.

## Agency XML Object

This section defines the XML object used to submit all School metric
information. The XML object matrix is followed by an example of the
object.

**Table 6.3-1: School, Agency XML Object**

  ----------------------------------------------------------------------------------------------
  **Element**   **Data       **Attribute**         **Char**   **Definition /       **Permitted
                Element                                       Comments**           Values**
                Name\                                                              
                **(from                                                            
                Fixed Format                                                       
                document)                                                          
  ------------- ------------ --------------------- ---------- -------------------- -------------
  AGENCY                                                                            

                **ID 559\    FIPSSTATECODE         M          The two-digit        For a list of
                **FIPS State                                  Federal Information  valid FIPS
                Code                                          Processing Standards State Codes,
                                                              (FIPS) for the       refer to the
                                                              state, District of   ED*Facts*
                                                              Columbia, and the    Workbook.
                                                              possessions and      
                                                              freely associated    
                                                              areas of the United  
                                                              States (e.g. Puerto  
                                                              Rico).               

                **ID 570**\  STATEAGENCYIDNUMBER   M          A number used in     01 = State
                State Agency                                  EDEN to uniquely     Education
                Number                                        identify state       Agency
                                                              agencies.  This ID   
                                                              cannot be updated    
                                                              through this file.   

                **ID 4\      STATELEAIDNUMBER      M          The identifier        
                **State LEA                                   assigned to a local  
                Identifier                                    education agency     
                                                              (LEA) by the State   
                                                              Education Agency     
                                                              (SEA). Also known as 
                                                              State LEA ID. This   
                                                              ID is a required     
                                                              field. This data     
                                                              element cannot be    
                                                              updated through this 
                                                              file.                

                **ID 5\      STATESCHOOLIDNUMBER   M          The identifier        
                S**tate                                       assigned to a school 
                School                                        by the State         
                Identifier                                    Education Agency.    
                                                              Also known as the    
                                                              State School         
                                                              Identification       
                                                              Number.  This ID     
                                                              cannot be updated    
                                                              through this file.   

  TABLETYPE                                        MR         The XML Object used   
                                                              to define the type   
                                                              and value of the     
                                                              count.               
  ----------------------------------------------------------------------------------------------

Example:

\<AGENCY FIPSSTATECODE=\"94\" STATEAGENCYIDNUMBER=\"01\"

STATELEAIDNUMBER=\"001000-0000001\"

STATESCHOOLIDNUMBER=\"002000-00002\"\>

\<TABLETYPE\> *See Table Type XML Object example in section 4.2*
\</TABLETYPE\>

\</AGENCY\>

## File Transmit XML Object

The file transmit object identifies the metric group being transmitted.
It also identifies whether the metric group is at the State Agency, LEA,
or school level. Further, each metric group has an allowable set of
Table Types, categories, and category values that correspond to a
particular reporting period. This section defines the various file
transmit objects and valid metric combinations at the school level.

**Table 6.4-1: School, File Transmit XML Object**

  -------------------------------------------------------------------------------------------------
  **Element**        **Data        **Attribute**    **Char**   **Definition /     **Permitted
                     Element Name\                             Comments**         Values**
                     **(from Fixed                                                
                     Format                                                       
                     document)                                                    
  ------------------ ------------- ---------------- ---------- ------------------ -----------------
  FILETRANSMISSION                                  M                              

                     File Type     FILELAYOUTTYPE   M          Identifies the     **SCHOOL
                                                               type of file being ELEMENTARY
                                                               submitted.         CLASSES TEACHER
                                                                                  QUALIFICATION**

                     File          FILEID           M          Any combination of  
                     Identifier                                standard           
                                                               characters to      
                                                               further identify   
                                                               the file as        
                                                               specified by the   
                                                               SEA, e.g., a date, 
                                                               person's name,     
                                                               version number.    

                     File          SCHOOLYEAR       M          Enter the Academic  
                     Reporting                                 School Year for    
                     Period                                    which data is      
                                                               being reported.    
                                                               The required       
                                                               format for         
                                                               entering the File  
                                                               Reporting Period   
                                                               is \"CCYY-CCYY\"   
                                                               or \"CCYY CCYY\",  
                                                               where either a     
                                                               hyphen or a space  
                                                               must separate the  
                                                               beginning and      
                                                               ending years,      
                                                               e.g., 2006-2007 or 
                                                               2006 2007.         

  AGENCY                                            MR         The information     
                                                               that fully         
                                                               describes the      
                                                               education unit.    
  -------------------------------------------------------------------------------------------------

Example:

\<FILETRANSMISSION

FILELAYOUTTYPE=\"SCHOOL ELEMENTARY CLASSES TEACHER QUALIFICATION\"

FILEID=\"SCH Teacher Qualifications Elem\"

SCHOOLYEAR=\"2006-2007\"\>

\<AGENCY\> *See Agency XML Object example in Section 6.3* \</AGENCY\>

\</FILETRANSMISSION\>

![](media/image1.png){width="1.5in" height="1.5in"}

Our mission is to ensure equal access to education and to promote
educational excellence throughout the nation.

www.ed.gov