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

U.S. DEPARTMENT OF EDUCATION

Education Data Exchange Network (EDEN)

X028 - School Computer

XML Specifications

Version 2.0

**December 2005**

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

Tom Luce

*Assistant Secretary*

December 2005

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, EDEN, *X028 - School Computer XML
Specifications v2.0*, Washington, D.C., 2005.

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

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___Toc124606664 .anchor}DOCUMENT CONTROL

DOCUMENT INFORMATION

  --------------- ---------------------------------------------------------
  **Title:**      X028 - School Computer XML Specifications

  **Revision:**   2.0

  **Issue Date:** December 2005

  **Security      
  Level:**        

  **Filename:**   541162.doc
  --------------- ---------------------------------------------------------

DOCUMENT HISTORY

+--------+--------+-------------+--------------------------------------+
| **V    | **     | **Resp\     | **Summary of Change**                |
| ersion | Date** | I           |                                      |
| Nu     |        | ndividual** |                                      |
| mber** |        |             |                                      |
+--------+--------+-------------+--------------------------------------+
| 1.1    | 9      |             | -   4.0: Removed reference to XML    |
|        | /19/05 |             |     schema                           |
+--------+--------+-------------+--------------------------------------+
| 2.0    | 1      |             | -   Formatting changes               |
|        | 0/3/05 |             |                                      |
+--------+--------+-------------+--------------------------------------+

RELEASE AUTHORIZATION

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

  Author                  

  QA                      

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

[]{#__RefHeading___Toc124606665 .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 EDEN 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___Toc124606664)

[Preface iii](#__RefHeading___Toc124606665)

[1.0 Purpose 1](#purpose)

[1.1 Changes from the 03-04 and 04-05 school year file specification
1](#changes-from-the-03-04-and-04-05-school-year-file-specification)

[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 2](#xml-specification-headings)

[4.0 School Metric Objects 3](#school-metric-objects)

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

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

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

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

# Purpose

This document contains instructions for building XML files to submit
EDEN Data Group: School Computer Table, ID# 525.

A separate document contains the non-XML file formats. General guidance
for constructing all EDEN file types may be found in the *Education Data
Exchange Network (EDEN)* *Workbook*.

The data group in this file specification is intended to supply
information to address the percentage of schools with internet access
for the Office of Educational Technology.

## Changes from the 03-04 and 04-05 school year file specification

There have been no changes to the record layout used in this file
specification. The changes made are:

-   Removed reference to XML schema

-   Formatting changes

## Requirements for submitting this Data Group

This data group is submitted at the following levels:

-   School

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: School Computer Tables, Required Categories, and
Applicable Totals**

  --------------------------------------------------------------------------
  Table Name    Internet      Instructional   Total         Comments
                Access Type   Setting         Indicator     
  ------------- ------------- --------------- ------------- ----------------
  **SCHCOMP**   X             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 School Computer transmittal
file submissions:

sslev**SCHCMPUTR**vvvvvvv.xml

Where:

> **ss** = Two-character USPS State Abbreviation for the submitting SEA.
>
> **lev** = Three-character abbreviation for the level submitted. Use:
>
> SCH for a School, School Computer submission
>
> **Filename** = **SCHCMPUTR** (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.

**NOTE:** For additional information on file naming conventions, refer
to the *Education Data Exchange Network (EDEN) Workbook.*

# GUIDANCE FOR SUBMITTING THIS FILE

No subtotals or grand total are required for this file.

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

# School Metric Objects

The School 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 school that corresponds
to the submitted metric. In addition, the structure contains nodes
representing characteristics of the metric (internet access,
instructional setting), 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: School, Category XML Object**

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

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

                         Internet Access                                      **INTERNETACC**
                         Type                                                 

                         Instructional                                        **INSTRSET**
                         Setting                                              

             VALUE                                     M      The category     
                                                              permitted       
                                                              value.          

                                         INTERNETACC          An indication   **DIALUP** --
                                                              of the type of  Dial-Up
                                                              internet access connectivity\
                                                              available.      **HSPEED** - High
                                                                              Speed Ethernet or
                                                                              Wireless
                                                                              Connectivity\
                                                                              **NONE** - No
                                                                              Connectivity\
                                                                              **MISSING**\
                                                                              **NOTCOLLECT** =
                                                                              Not Collected

                                         INSTRSET             A location in a **C** --
                                                              school where    Classroom\
                                                              instruction is  **CL** - Computer
                                                              provided.       Lab\
                                                                              **MC** - Media
                                                                              Center\
                                                                              **O** -- Other\
                                                                              **MISSING**\
                                                                              **NOTCOLLECT** =
                                                                              Not Collected
  ----------------------------------------------------------------------------------------------

Example:

\<CATEGORY TYPE=\"INTERNETACC\" VALUE=\"DIALUP\"/\>

\<CATEGORY TYPE=\"INSTRSET\" VALUE=\"C\"/\>

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

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

                Table Name   TYPEABBRV        M      The unduplicated number  **SCHCOMP**
                                                     of instructional         
                                                     computers in the school. 

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

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

  AMOUNT        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                                 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.                    
  -----------------------------------------------------------------------------------------

Example:

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

\<CATEGORY TYPE=\"INTERNETACC\" VALUE=\"DIALUP\"/\>

\<CATEGORY TYPE=\"INSTRSET\" VALUE=\"C\"/\>

\<AMOUNT\>1\</AMOUNT\>

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

\</TABLETYPE\>

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

\<CATEGORY TYPE=\"INTERNETACC\" VALUE=\"HSPEED\"/\>

\<CATEGORY TYPE=\"INSTRSET\" VALUE=\"CL\"/\>

\<AMOUNT\>2\</AMOUNT\>

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

\</TABLETYPE\>

## 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 4.3-1: School, 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
              **FIPS State                               Federal Information of valid
              Code                                       Processing          FIPS State
                                                         Standards (FIPS)    Codes,
                                                         for the state,      refer to
                                                         District of         the EDEN
                                                         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 Agency                               EDEN to uniquely    State
              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 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=\"99\" STATEAGENCYIDNUMBER=\"01\"

STATELEAIDNUMBER=\"006000-0000001\"

STATESCHOOLIDNUMBER=\"006000-00002\"\>

\<TABLETYPE *See 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: School, 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  **SCHOOL
                                                          of file being        COMPUTER**
                                                          submitted.           

                     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.,  
                                                          2005-2006 or 2005    
                                                          2006.                

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

Example:

\<FILETRANSMISSION FILELAYOUTTYPE=\"SCHOOL COMPUTER\"

FILEID=\"School Computer file\"

SCHOOLYEAR=\"2005 2006\"\>

\<AGENCY\> *See the agency element for description* \</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