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

**U.S. DEPARTMENT OF EDUCATION**

**Education Data Exchange Network (EDEN)**

**X010 - School Choice - Transferred XML Specifications**

**Version 3.1**

**SY 2006 -- 07**

**November 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**

Williamson Evers

*Assistant Secretary*

November 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,
*X010 - School Choice - Transferred XML Specifications*, Washington,
D.C., 2007.

This technical guide is also available on the Department's Web site at:
<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___Toc182988661 .anchor}DOCUMENT CONTROL

DOCUMENT INFORMATION

  --------------- ---------------------------------------------------------
  **Title:**      X010 - School Choice - Transferred XML Specifications

  **Revision:**   Version 3.1

  **Issue Date:** November 2007

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

  **Filename:**   740085.doc
  --------------- ---------------------------------------------------------

DOCUMENT HISTORY

+-------+-------------+-----------------------------------------------+
| **Ve  | **Date**    | **Summary of Change**                         |
| rsion |             |                                               |
| Num   |             |                                               |
| ber** |             |                                               |
+-------+-------------+-----------------------------------------------+
| 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   | May 2007    | Updated for SY 2006-07                        |
|       |             |                                               |
|       |             | -   1.0: Updated Data Groups' Names.          |
|       |             |                                               |
|       |             | -   1.0, 4.2, 5.2: Removed Data Group 577 --  |
|       |             |     Students Eligible for School Choice       |
|       |             |     Transfer.                                 |
|       |             |                                               |
|       |             | -   1.2, 6.0: Removed the School Level        |
|       |             |     collection for Data Groups 544, 574, and  |
|       |             |     579                                       |
|       |             |                                               |
|       |             | -   1.3: Changed the Definition for Data      |
|       |             |     Group 574 -- School Choice -- Applied for |
|       |             |     Transfer.                                 |
|       |             |                                               |
|       |             | -   1.3: Changed the Definition for Data      |
|       |             |     Group 579 -- School Choice -- Offered.    |
|       |             |                                               |
|       |             | -   1.3: Changed the Definition for Data      |
|       |             |     Group 544 -- School Choice --             |
|       |             |     Transferred.                              |
+-------+-------------+-----------------------------------------------+
| 3.1   | November    | -   1.3-1: Updated the "Data Group            |
|       | 2007        |     Definition" table.                        |
+-------+-------------+-----------------------------------------------+

RELEASE AUTHORIZATION

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

  Author                  

  QA                      

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

[]{#__RefHeading___Toc182988662 .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,
ED*Facts* Business Rules Guide and the EDEN Submission System User
Guide.

EDEN is a centralized, coordinated repository of state reported, K
through 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___Toc182988661)

[PREFACE iii](#__RefHeading___Toc182988662)

[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)

[1.3 Key Definitions 2](#key-definitions)

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

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

[3.1 XML Specification Headings 5](#xml-specification-headings)

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

[4.1 Category XML Object 6](#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 9](#table-type-xml-object-1)

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

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

# PURPOSE

This document contains instructions for building XML files to submit
ED*Facts* Data Groups:

-   School Choice -- Transferred, ID \# 544

-   School Choice -- Applied for Transfer, ID \# 574

-   School Choice -- Offered, ID \# 579.

The definition for these data groups are in the column "Data Group
Definition" in Table 1.3-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
these ED*Facts* data groups.

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

## Changes from the SY 2005-06 File Specifications

There have been significant changes to this file specification:

-   Removed Data Group 577 -- Students Eligible for School Choice
    Transfer

-   Removed the School Level collection for Data Groups 544, 574, and
    579

-   Changed the Definition for Data Group 574 -- School Choice --
    Applied for Transfer -- to clarify that these are eligible students
    who applied for transfer

-   Changed the Definition for Data Group 579 -- School Choice --
    Offered - to clarify that this is an unduplicated count of eligible
    students who were offered the opportunity to apply for transfer

-   Changed the Definition for Data Group 544 -- School Choice --
    Transferred - to clarify that these are eligible students who
    transferred

-   Updated Data Group Names

## Requirements for submitting this Data Group

This data group is submitted at the following levels:

-   SEA

-   LEA

## Key Definitions

**Table 1.3-1: School Choice - Transferred, Key Definitions Table**

  -------------------------------------------------------------------------------
  **Data Group**   **Abbreviation**   **Data Group Definition**
  ---------------- ------------------ -------------------------------------------
  School Choice -  TRANFSTUDCH        The unduplicated number of eligible
  Transferred                         students who transferred to another school
                                      under the provisions for public school
                                      choice in accordance with Title I, Part A,
                                      Section 1116.

  School Choice -  TRANFSTUDAPP       The unduplicated number of eligible
  Applied for                         students who applied to transfer to another
  Transfer                            public school under the provisions for
                                      public school choice in accordance with
                                      Title I, Part A, Section 1116.

  School Choice -  TRANFSTUDOFF       The number of students, among those who
  Offered                             applied to transfer to another public
                                      school under Title I, Part A, Section 1116,
                                      the public school choice provisions, who
                                      were actually offered the opportunity to
                                      transfer by their LEAs.
  -------------------------------------------------------------------------------

# 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 School Choice - Transferred
transmittal file submissions:

sslev**STUCHOICE**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 School Choice - Transferred
> submission
>
> LEA for a Local Education Agency School Choice - Transferred
> submission
>
> **Filename** = **STUCHOICE** (no more than nine characters).
>
> **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 counts of students who were eligible to
transfer to another public school under the provisions of public school
choice in the No Child Left Behind legislation.[^1] Each count in this
file is a discreet count of students at the SEA or LEA level. The count
should reflect the cumulative total of students for the school year who
fall in each category (eligible to transfer, applied to transfer, and
transferred), not the number of times a student was eligible, applied,
or transferred.

If a student transferred, that student should have been offered an
opportunity to transfer and applied to transfer, and should be counted
in those categories, too. Therefore, the count of students who applied
to transfer should be equal to or greater than the number of students
who transferred. Similarly, the count of students who were offered an
opportunity to apply for transfer should be equal to or greater than the
number of students who applied to transfer.

For those LEAs that have open enrollment and other choice programs, the
LEA may consider a student as eligible for and participating in Title I
public school choice if the student meets the following conditions:

-   Has a \"home\" or \"neighborhood\" school (to which the student
    would have been assigned, in the absence of a choice program) that
    receives Title I funds and has been identified, under the statute,
    as in need of improvement, corrective action, or restructuring; and

-   Has elected to enroll, at some point since July 1, 2002 (the
    effective date of the Title I choice provisions) and after the home
    school has been identified as in need of improvement, in a school
    that has not been so identified and is attending that school.[^2]

For those LEAs that are not able to offer public school choice (i.e.,
LEAs in which all schools in a grade level are schools in need of
improvement, LEAs which have only a single school at that grade level,
or LEAs whose schools are so remote from one another that choice is
impracticable), count as eligible all students who attend Title I
schools identified for improvement. States should report that no
eligible schools or students were provided the option to transfer, and
should provide an explanation why choice is not possible within the LEA
in the Explanations field. For example, "All schools in the LEA are in
need of improvement therefore school choice was not offered", "There is
only one school with grades 6-8 in this LEA, so offering choice is not
possible", or "Offering school choice is not possible due to the
distance between schools" would suffice as explanations for the three
situations given above.

## 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.1-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

The State Education Agency file is composed of 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
Education Agency corresponding to the submitted metric. In addition, the
structure contains nodes representing characteristics of the metric
(Choice), the associated value, and whether the metric value is a
subtotal or grand total. The metric objects are contained within the
file transmission objects that define the group of values being
submitted.

## Category XML Object

There is no category XML Object for School Choice - Transferred because
there are no categories.

## 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**

+--------+--------+----------+---+-------------------------+----------+
| **Ele  | **Data | **Att    | * | **Definition /          | **P      |
| ment** | E      | ribute** | * | Comments**              | ermitted |
|        | lement |          | C |                         | Values** |
|        | Name\  |          | h |                         |          |
|        | *      |          | a |                         |          |
|        | *(from |          | r |                         |          |
|        | Fixed  |          | * |                         |          |
|        | Format |          | * |                         |          |
|        | doc    |          |   |                         |          |
|        | ument) |          |   |                         |          |
+========+========+==========+===+=========================+==========+
| TAB    |        |          |   |                         |          |
| LETYPE |        |          |   |                         |          |
+--------+--------+----------+---+-------------------------+----------+
|        | Table  | T        | M | The identifier of the   | **TRANF  |
|        | Name   | YPEABBRV |   | data group:             | STUDCH** |
|        |        |          |   |                         |          |
|        |        |          |   | -   TRANFSTUDCH (ID     | **TRANFS |
|        |        |          |   |     544)                | TUDAPP** |
|        |        |          |   |                         |          |
|        |        |          |   | -   TRANFSTUDAPP (ID    | **TRANFS |
|        |        |          |   |     574)                | TUDOFF** |
|        |        |          |   |                         |          |
|        |        |          |   | -   TRANFSTUDOFF (ID    | ([see    |
|        |        |          |   |     579)                | Key      |
|        |        |          |   |                         | Def      |
|        |        |          |   |                         | initions |
|        |        |          |   |                         | in       |
|        |        |          |   |                         | Section  |
|        |        |          |   |                         | 1.3](#k  |
|        |        |          |   |                         | ey-defin |
|        |        |          |   |                         | itions)) |
+--------+--------+----------+---+-------------------------+----------+
|        | Total  | TOTALI   | M | An indicator that       | **N** =  |
|        | Ind    | NDICATOR |   | defines the count level | s        |
|        | icator |          |   | (i.e., detail level,    | pecifies |
|        |        |          |   | subtotal level or grand | detail   |
|        |        |          |   | total level).           | level    |
+--------+--------+----------+---+-------------------------+----------+
| AMOUNT | S      |          | M | If the count provided   |          |
|        | tudent |          |   | is either a subtotal or |          |
|        | Count  |          |   | grand total, it must be |          |
|        |        |          |   | equal to or greater     |          |
|        |        |          |   | than the sum of its     |          |
|        |        |          |   | parts.                  |          |
+--------+--------+----------+---+-------------------------+----------+
| EXPLA  | Expla  |          | O | Submitted files will be |          |
| NATION | nation |          |   | 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 U.S. Department of  |          |
|        |        |          |   | Education will verify   |          |
|        |        |          |   | explanations, and after |          |
|        |        |          |   | verification, accept    |          |
|        |        |          |   | the data.               |          |
+--------+--------+----------+---+-------------------------+----------+

Example:

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

\<AMOUNT\>421\</AMOUNT\>

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

\</TABLETYPE\>

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

\<AMOUNT\>618\</AMOUNT\>

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

\</TABLETYPE\>

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

\<AMOUNT\>500\</AMOUNT\>

\</TABLETYPE\>

## Agency XML Object

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

Table 4.3-1: SEA, 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 Federal  For a list of
                **FIPS                                       Information Processing valid FIPS
                State Code                                   Standards (FIPS) for   State Codes,
                                                             the state, District of refer to the
                                                             Columbia, and the      ED*Facts*
                                                             possessions and freely Workbook.
                                                             associated areas of    
                                                             the United States      
                                                             (e.g., Puerto Rico).   

                **ID 570\   STATEAGENCYIDNUMBER   M          A number used in EDEN  **01** =
                **State                                      to uniquely identify   State
                Agency                                       state agencies.  This  Education
                Number                                       ID cannot be updated   Agency
                                                             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 SEA or LEA 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 SEA and LEA level.

Table 4.4-1: SEA, File Transmit XML Object

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

                     File Type    FILELAYOUTTYPE   M          Identifies the type of    **SEA CHOICE
                                                              file being submitted.     PROVISIONS**

                     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, and version number. 

                     File         SCHOOLYEAR       M          Enter the Academic School  
                     Reporting                                Year for which data is    
                     Period                                   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                                           M          The information that       
                                                              fully identifies the      
                                                              education unit.           
  ----------------------------------------------------------------------------------------------------

Example:

\<FILETRANSMISSION FILELAYOUTTYPE=\"SEA CHOICE PROVISIONS\"

FILEID=\"SEA Transfer Provision\"

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 (Choice), the associated
value, and whether the metric value is a subtotal 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

There is no category XML Object for School Choice - Transferred because
there are no categories.

## 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

+--------+------+----------+---+--------------------------+----------+
| **Ele  | **   | **Att    | * | **Definition /           | **P      |
| ment** | Data | ribute** | * | Comments**               | ermitted |
|        | Ele  |          | C |                          | Values** |
|        | ment |          | h |                          |          |
|        | N    |          | a |                          |          |
|        | ame\ |          | r |                          |          |
|        | **(  |          | * |                          |          |
|        | from |          | * |                          |          |
|        | F    |          |   |                          |          |
|        | ixed |          |   |                          |          |
|        | Fo   |          |   |                          |          |
|        | rmat |          |   |                          |          |
|        | d    |          |   |                          |          |
|        | ocum |          |   |                          |          |
|        | ent) |          |   |                          |          |
+========+======+==========+===+==========================+==========+
| TAB    |      |          |   |                          |          |
| LETYPE |      |          |   |                          |          |
+--------+------+----------+---+--------------------------+----------+
|        | T    | T        | M | The identifier of the    | **TRANF  |
|        | able | YPEABBRV |   | data group:              | STUDCH** |
|        | Name |          |   |                          |          |
|        |      |          |   | -   TRANFSTUDCH (ID 544) | **TRANFS |
|        |      |          |   |                          | TUDAPP** |
|        |      |          |   | -   TRANFSTUDAPP (ID     |          |
|        |      |          |   |     574)                 | **TRANFS |
|        |      |          |   |                          | TUDOFF** |
|        |      |          |   | -   TRANFSTUDOFF (ID     |          |
|        |      |          |   |     579)                 | ([see    |
|        |      |          |   |                          | Key      |
|        |      |          |   |                          | Def      |
|        |      |          |   |                          | initions |
|        |      |          |   |                          | in       |
|        |      |          |   |                          | Section  |
|        |      |          |   |                          | 1.3](#k  |
|        |      |          |   |                          | ey-defin |
|        |      |          |   |                          | itions)) |
+--------+------+----------+---+--------------------------+----------+
|        | T    | TOTALI   | M | An indicator that        | **N** =  |
|        | otal | NDICATOR |   | defines the count level  | s        |
|        | I    |          |   | (i.e., detail level,     | pecifies |
|        | ndic |          |   | subtotal level or grand  | detail   |
|        | ator |          |   | total level).            | level    |
+--------+------+----------+---+--------------------------+----------+
| AMOUNT | Stu  |          | M | If the count provided is |          |
|        | dent |          |   | either a subtotal or     |          |
|        | C    |          |   | grand total, it must be  |          |
|        | ount |          |   | equal to or greater than |          |
|        |      |          |   | the sum of its parts.    |          |
+--------+------+----------+---+--------------------------+----------+
| EXPLA  |      |          | O | Submitted files will be  |          |
| NATION |      |          |   | 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 U.S.      |          |
|        |      |          |   | 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                                       Comments**              Values**
                Name\                                                                 
                **(from                                                               
                Fixed Format                                                          
                document)                                                             
  ------------- ------------ --------------------- ---------- ----------------------- -------------
  AGENCY                                                                              

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

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

                **ID 4\      STATELEAIDNUMBER      M          The identifier assigned  
                **State LEA                                   to a local education    
                Identifier                                    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=\"002000-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 SEA or LEA 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 SEA and LEA level.

Table 5.4-1: LEA, File Transmit XML Object

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

                     File Type    FILELAYOUTTYPE   M          Identifies the type of    **LEA CHOICE
                                                              file being submitted.     PROVISIONS**

                     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, and version number. 

                     File         SCHOOLYEAR       M          Enter the Academic School  
                     Reporting                                Year for which data is    
                     Period                                   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 CHOICE PROVISIONS\"

FILEID=\"LEA Transfer Provision\"

SCHOOLYEAR=\"2006-2007\"\>

\<AGENCY\> *See Agency XML Object example in Section 5.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

[^1]: School choice data groups are all supported by Title I, Part A,
    Section 1116.

[^2]: Adapted from OESE policy letter of August 2004. The policy letter
    may be found on the Department's web page at
    <http://www.ed.gov/policy/elsec/guid/stateletters/choice/choice081804.html>.