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

**U.S. DEPARTMENT OF EDUCATION**

**Education Data Exchange Network (EDEN)**

**X118 -- Homeless Students Enrolled -- School Year Count**

**XML Specifications**

**Version 3.0**

**SY 2006-07**

**(New for 2006-07)**

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

Doug Mesecar

*Acting Assistant Secretary*

May 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, *X118
-- Homeless Students Enrolled -- School Year Count 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___Toc166578514 .anchor}DOCUMENT CONTROL

DOCUMENT INFORMATION

  --------------- ---------------------------------------------------------
  **Title:**      X118 -- Homeless Students Enrolled -- School Year Count
                  XML Specifications

  **Revision:**   Version 3.0

  **Issue Date:** May 2007

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

  **Filename:**   306102.doc
  --------------- ---------------------------------------------------------

DOCUMENT HISTORY

+--------+---------+---------------------------------------------------+
| **V    | *       | **Summary of Change**                             |
| ersion | *Date** |                                                   |
| Nu     |         |                                                   |
| mber** |         |                                                   |
+========+=========+===================================================+
|        |         | -                                                 |
+--------+---------+---------------------------------------------------+
|        |         | -                                                 |
+--------+---------+---------------------------------------------------+
|        |         | -                                                 |
+--------+---------+---------------------------------------------------+

RELEASE AUTHORIZATION

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

  Author                  

  QA                      

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

[]{#__RefHeading___Toc166578515 .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
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___Toc166578514)

[PREFACE iii](#__RefHeading___Toc166578515)

[1.0 PURPOSE 1](#purpose)

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

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

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

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

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

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

[4.1 Category XML Object 4](#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)

# PURPOSE 

This document contains instructions for building XML files to submit
ED*Facts* Data Group: Homeless Students Enrolled -- School Year Count
Table, ID# 655. The definition for this data group is in the row "Table
Name" in Table 4.2-1.

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.

The data in this file specification is currently collected through the
Consolidated State Performance Report Part I, Section 1.9 for monitoring
and reporting section 724 of the Elementary and Secondary Education Act.

## Changes from SY 2005--06 File Specifications

Not applicable. This is a new specification for SY 2006--07.

## Requirements for Submitting this Data Group

The data group is submitted at the following levels:

-   LEA -- for all LEAs that have students

Records for LEAs need only include those grade levels offered at the
LEA. For example, if the highest grade at an LEA is 6^th^, the record
for that LEA does not need to include grades 7^th^ through 12^th^.

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 "N" (No) because no
subtotals or grand totals are required for this file.

**Table 1.2--1: Homeless Students Enrolled -- SY Count Table, Required
Categories, and Applicable Totals**

  -------------------------------------------------------------------------------
                       **Grade Level **Homeless     **Total       **Comments**
                       (Program      Primary        Indicator**   
                       Services)**   Nighttime                    
                                     Residence**                  
  -------------------- ------------- -------------- ------------- ---------------
  **HOMLESENROLCNT**   X                            N             

  **HOMLESENROLCNT**                 X              N             
  -------------------------------------------------------------------------------

# 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 Homeless Students Enrolled
transmittal file submissions:

sslev**HLSTDENCT**vvvvvvv.xml

Where:

> **ss** = Two--character USPS State Abbreviation for the submitting
> SEA.
>
> **lev** = Three--character abbreviation for the level submitted. Use:
>
> LEA for a Local Education Agency Homeless Students Enrolled
>
> -- SY Count submission
>
> **Filename** = **HLSTDENCT** (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 cumulative unduplicated number of
homeless students enrolled in public school at any time during the
school year.

Homeless is defined as children/youth who lack a fixed, regular, and
adequate nighttime residence, and includes:

(1) students who are sharing the housing of other persons due to loss of
    housing, economic hardship, or a similar reason; are living in
    motels, hotels, trailer parks, or camping grounds due to the lack of
    alternative adequate accommodations; are living in emergency or
    transitional shelters; are abandoned in hospitals; or are awaiting
    foster care placement;

(2) students who have a primary nighttime residence that is a public or
    private place not designed for or ordinarily used as a regular
    sleeping accommodation for human beings (within the meaning of
    section 103(a)(2)(C));

(3) students who are living in cars, parks, public spaces, abandoned
    buildings, substandard housing, bus or train stations, or similar
    settings; and

(4) migratory students who qualify as homeless for the purposes of this
    subtitle because they are living in circumstances described in (1)
    through (3) above.

The homeless primary nighttime residence is determined at the time of
the initial identification as homeless. Below is additional information
about the permitted values for homeless primary nighttime residence:

-   Shelters include transitional housing and awaiting foster care.

-   Doubled-up means living with another family.

-   Unsheltered includes cars, parks, campgrounds, temporary trailers,
    and abandoned buildings.

Fields that are defined as "Number" can contain values with leading
zeros or without leading zeros. Additionally, when submitting fixed
format files, "Number" fields can be either right or left justified.
This applies to the following fields:

-   "Total Records in File" in the Header

-   "File Record Number" in the Data Record

-   "Count" fields in the Data Record, i.e., Teacher Count, Student
    Count

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

#  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 (Academic Subject, Grade
Level, etc), 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 4.1--1: LEA, Category XML Object**

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

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

                                Grade Level                                             **GRADELVLPROG**
                                (Program                                                
                                Services)                                               

                                Homeless                                                **HOMELSPRMRES**
                                Primary                                                 
                                Nighttime                                               
                                Residence                                               

                VALUE                                        M          The category    
                                                                        permitted       
                                                                        value.          

                                              GRADELVLPROG              The grade level **PK** =
                                                                        or primary      Prekindergarten\
                                                                        instructional   **KG** =
                                                                        level of        Kindergarten\
                                                                        students        **01** = Grade 1\
                                                                        receiving       **02** = Grade 2\
                                                                        services.       **03** = Grade 3\
                                                                                        **04** = Grade 4\
                                                                                        **05** = Grade 5\
                                                                                        **06** = Grade 6\
                                                                                        **07** = Grade 7\
                                                                                        **08** = Grade 8\
                                                                                        **09** = Grade 9\
                                                                                        **10** = Grade 10\
                                                                                        **11** = Grade 11\
                                                                                        **12** = Grade 12\
                                                                                        **AE** = Adult
                                                                                        Education\
                                                                                        **MISSING**\
                                                                                        **NOTCOLLECT** =
                                                                                        Not Collected

                                              HOMELSPRMRES              The type of     **S** = Shelters\
                                                                        nighttime       **D** =
                                                                        residence for   Doubled--up\
                                                                        homeless        **U** =
                                                                        students. (See  Unsheltered\
                                                                        3.0 Guidance    **HM** =
                                                                        for additional  Hotels/Motels\
                                                                        explanation of  **O** = Other\
                                                                        permitted       **MISSING**
                                                                        values.)        
  --------------------------------------------------------------------------------------------------------

Example:

\<CATEGORY TYPE="GRADELVLPROG" VALUE="PK"/\>

\<CATEGORY TYPE="HOMELSPRMRES" VALUE="S"/\>

## 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: LEA, Table Type XML Object**

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

                Table Name    TYPEABBRV        M          The cumulative       **HOMLESENROLCNT**
                                                          unduplicated number  
                                                          of homeless students 
                                                          enrolled at any time 
                                                          during the school    
                                                          year.                

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

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

  AMOUNT        Student 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 U.S. Department  
                                                          of Education will    
                                                          verify explanations, 
                                                          and after            
                                                          verification, accept 
                                                          the data.            
  -------------------------------------------------------------------------------------------------

Example:

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

\<CATEGORY TYPE="GRADELVLPROG" VALUE="PK"/\>

\<AMOUNT\>10\</AMOUNT\>

\</TABLETYPE\>

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

\<CATEGORY TYPE="HOMELSPRMRES" VALUE="S"/\>

\<AMOUNT\>10\</AMOUNT\>

\</TABLETYPE\>

## 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 4.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      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                                        identify state      Education
                Number                                        agencies. This ID   Agency
                                                              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.  

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

Example:

\<AGENCY FIPSSTATECODE="94\" STATEAGENCYIDNUMBER="01\"
STATELEAIDNUMBER="006000--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 State Agency, LEA,
and school level.

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

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

                     File Type     FILELAYOUTTYPE   M          Identifies the type **LEA
                                                               of file being       HOMELESS
                                                               submitted.          STUDENTS
                                                                                   ENROLLED SY
                                                                                   COUNT**

                     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   
                     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="LEA HOMELESS STUDENTS ENROLLED SY COUNT\"

FILEID="X118 Homeless Stud. Enroll SY CT\"

SCHOOLYEAR="2006 2007\"\>

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