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

U.S. DEPARTMENT OF EDUCATION

Education Data Exchange Network (EDEN)

X086 - Children Involved with Firearms XML Specifications

**Version 2.1**

**January 2007**

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

U.S. Department of Education

Margaret Spellings

*Secretary*

Office of Planning, Evaluation and Policy Development

Kerri Briggs

*Acting Assistant Secretary*

January 2007

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

This technical guide is also available on the Department's Web site at:
[**http://www.ed.gov/about/inits/ed/pbdmi/index.html**](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___Toc158739991 .anchor}DOCUMENT CONTROL

DOCUMENT INFORMATION

  --------------- ---------------------------------------------------------
  **Title:**      X086 - Children Involved with Firearms XML Specifications

  **Revision:**   2.1

  **Issue Date:** January 2007

  **Security      
  Level:**        

  **Filename:**   374713.doc
  --------------- ---------------------------------------------------------

DOCUMENT HISTORY

  ------------------------------------------------------------------------
  **Version   **Date**     **Summary of Change**
  Number**                 
  ----------- ------------ -----------------------------------------------
  2.1         1/15/07      3.0: Updated guidance section to explain the
                           use of permitted values related to expulsion.

                           
  ------------------------------------------------------------------------

RELEASE AUTHORIZATION

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

  Author                  

  QA                      

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

[]{#__RefHeading___Toc158739992 .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___Toc158739991)

[PREFACE iii](#__RefHeading___Toc158739992)

[1.0 PURPOSE 1](#purpose)

[1.1 Changes from 03-04 and 04-05 File Specifications
1](#changes-from-03-04-and-04-05-file-specifications)

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

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

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

[3.1 XML Specification Headings 4](#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 8](#table-type-xml-object)

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

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

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

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

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

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

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

# PURPOSE 

This document contains instructions for building XML files to submit
EDEN Data Group: Children Involved with Firearms Table, ID# 596.

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

This data group is intended to provide part of the data required under
the Gun-Free Schools Act Report as required by the Elementary and
Secondary Education Act (ESEA), Title IV, Part A, Subpart 3, as amended
by the No Child Left Behind Act of 2001.

## Changes from 03-04 and 04-05 File Specifications

There have been no changes to the record layout used in this file
specification.

## Requirements for Submitting this Data Group

The data group is submitted at the following levels:

-   SEA

-   LEA -- for all LEAs receiving Elementary and Secondary Education Act
    (ESEA) funds.

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: Children Involved with Firearms Tables, Required
Categories, and Applicable Totals**

  ------------------ -------------- -------------- -------------- --------------
  **Table Name**     **Weapon       **Firearm      **Total        **Comments**
                     Type**         Incident       Indicator**    
                                    Result**                      

  **CHLINVWFRARM**   X                             N              

  **CHLINVWFRARM**                  X              N              
  ------------------ -------------- -------------- -------------- --------------

##   {#section .unnumbered}

# 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 Children Involved with
Firearms transmittal file submissions:

sslevCHLINVARMvvvvvvv.ext

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 Children Involved with Firearms
> submission
>
> LEA for a Local Education Agency Children Involved with Firearms
> submission
>
> **Filename** = **CHLINVARM** (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

This file only reports students, not incidents. Firearm incidents are
reported in the related file X094 -- Firearm Incidents XML
Specifications.

Indicate all students in your State who were found to have brought a
firearm to school or possessed a firearm at school during the school
year. Any student found to have brought or possessed a firearm at school
should be reported in this file, even if the expulsion is shortened or
no penalty is imposed. A firearm, other than a handgun, rifle, or
shotgun, is defined under 18 U.S.C. 921. That definition is provided
under the "Other" value under Weapon Type.

If the same student is involved in more than one incident that involves
bringing or possessing a firearm at school, report that student once in
each table of this file with the most severe result for that student or
the most applicable Weapon Type value for all incidents.

The Gun Free Act requires a one year expulsion for bringing a firearm to
a school: Permitted value - Expulsion not modified/no alternative
placement (EXPNOTMODNOALT).

Any student covered by the provisions of IDEA who brought a firearm to
school or possessed a firearm at school should also be included, even if
it is determined that the incident is a manifestation of the student's
disability.

If the act is a manifestation of a disability, then the expulsion can be
modified under IDEA: Permitted value - Expulsion modified because of
IDEA (EXPMODIDEA). This permitted value assumes that alternative
placement is provided because under IDEA children with disabilities are
required to be provided services. In some circumstances, the one year
expulsion can be shorted for reasons other than IDEA: Permitted value -
Expulsion modified not because of IDEA (EXPNOTMODIDEA). During an
expulsion (one year or shorten), an IDEA student must be provided with
services (alternative placement). Non-IDEA students can be provided
services (alternative placement).

If under a full one year expulsion, alterative services are provided
regardless of whether the student is covered under IDEA or not:
Permitted value - Expulsion with alternative placement (EXPALT).

If under a modified expulsion for reasons other than IDEA, alternative
services are provided: Permitted value - Expulsion modified/alternative
placement (EXPMODALT).

If an SEA cannot distinguish between modifications of expulsion of
students covered by IDEA resulting from IDEA and resulting from other
reasons, the modified expulsions of these students should be reported as
modified because of IDEA (EXPMODIDEA).

In some cases, there is no expulsion because the student was removed for
other reasons: Permitted Value - Removal for other reason (such as
death, withdrawal, or incarceration).

While it should be rare, other disciplinary action may be taken:
Permitted Value - Other disciplinary action (OTHERDISACTION). In even
rarer cases, no disciplinary action is taken: Permitted Value - No
action taken (NOACTION).

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

##   {#section-1 .unnumbered}

# STATE EDUCATION AGENCY METRIC OBJECTS

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

## Category XML Object

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

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

+-------+----+------------+--------+---+------------+----------------+
| *     | *  | **Data     | **Ca   | * | **         | **Permitted    |
| *Elem | *A | Element    | tegory | * | Definition | Values**       |
| ent** | tt | Name**\    | V      | C | /          |                |
|       | ri | (from      | alue** | h | Comments** |                |
|       | bu | Fixed      |        | a |            |                |
|       | te | Format     |        | r |            |                |
|       | ** | document)  |        | * |            |                |
|       |    |            |        | * |            |                |
+=======+====+============+========+===+============+================+
| CAT   |    |            |        |   |            |                |
| EGORY |    |            |        |   |            |                |
+-------+----+------------+--------+---+------------+----------------+
|       | TY |            |        | M | The        |                |
|       | PE |            |        |   | cat        |                |
|       |    |            |        |   | egory(ies) |                |
|       |    |            |        |   | for the    |                |
|       |    |            |        |   | table      |                |
|       |    |            |        |   | type.      |                |
+-------+----+------------+--------+---+------------+----------------+
|       |    | Weapon     |        |   |            | **WEAPONTYPE** |
|       |    | Type       |        |   |            |                |
+-------+----+------------+--------+---+------------+----------------+
|       |    | Firearm    |        |   |            | **FIREARMINC** |
|       |    | Incident   |        |   |            |                |
|       |    | Result     |        |   |            |                |
+-------+----+------------+--------+---+------------+----------------+
|       | V  |            |        | M | The        |                |
|       | AL |            |        |   | category   |                |
|       | UE |            |        |   | permitted  |                |
|       |    |            |        |   | value.     |                |
+-------+----+------------+--------+---+------------+----------------+
|       |    |            | WEAP   |   | The type   | **HANDGUNS     |
|       |    |            | ONTYPE |   | of weapon. | --** Handguns  |
|       |    |            |        |   |            |                |
|       |    |            |        |   |            | **RIFLESHOTGUN |
|       |    |            |        |   |            | --**           |
|       |    |            |        |   |            | R              |
|       |    |            |        |   |            | ifles/Shotguns |
|       |    |            |        |   |            |                |
|       |    |            |        |   |            | **MULTIPLE**   |
|       |    |            |        |   |            | -- More than   |
|       |    |            |        |   |            | one type of    |
|       |    |            |        |   |            | weapon or      |
|       |    |            |        |   |            | firearm.       |
|       |    |            |        |   |            |                |
|       |    |            |        |   |            | **OTHER** --   |
|       |    |            |        |   |            | See Note 1\    |
|       |    |            |        |   |            | **MISSING**\   |
|       |    |            |        |   |            | **NOTCOLLECT** |
|       |    |            |        |   |            | -- Not         |
|       |    |            |        |   |            | Collected      |
+-------+----+------------+--------+---+------------+----------------+
|       |    |            | FIRE   |   | The type   | **EX           |
|       |    |            | ARMINC |   | of action  | PNOTMODNOALT** |
|       |    |            |        |   | used to    | -- Expulsion   |
|       |    |            |        |   | discipline | not            |
|       |    |            |        |   | students   | modified/no    |
|       |    |            |        |   | involved   | alternative    |
|       |    |            |        |   | in firearm | placement      |
|       |    |            |        |   | incidents. |                |
|       |    |            |        |   |            | *              |
|       |    |            |        |   |            | *EXPMODALT** - |
|       |    |            |        |   |            | Expulsion      |
|       |    |            |        |   |            | modifi         |
|       |    |            |        |   |            | ed/alternative |
|       |    |            |        |   |            | placement      |
|       |    |            |        |   |            |                |
|       |    |            |        |   |            | **EXPMODIDEA** |
|       |    |            |        |   |            | -- Expulsion   |
|       |    |            |        |   |            | modified       |
|       |    |            |        |   |            | because of     |
|       |    |            |        |   |            | IDEA           |
|       |    |            |        |   |            |                |
|       |    |            |        |   |            | **E            |
|       |    |            |        |   |            | XPNOTMODIDEA** |
|       |    |            |        |   |            | -- Expulsion   |
|       |    |            |        |   |            | modified not   |
|       |    |            |        |   |            | because of     |
|       |    |            |        |   |            | IDEA           |
|       |    |            |        |   |            |                |
|       |    |            |        |   |            | **EXPALT** --  |
|       |    |            |        |   |            | Expulsion with |
|       |    |            |        |   |            | alternative    |
|       |    |            |        |   |            | placement      |
|       |    |            |        |   |            |                |
|       |    |            |        |   |            | *              |
|       |    |            |        |   |            | *REMOVEOTHER** |
|       |    |            |        |   |            | -- Removal for |
|       |    |            |        |   |            | other reason   |
|       |    |            |        |   |            | (such as       |
|       |    |            |        |   |            | death,         |
|       |    |            |        |   |            | withdrawal, or |
|       |    |            |        |   |            | incarceration) |
|       |    |            |        |   |            |                |
|       |    |            |        |   |            | **OT           |
|       |    |            |        |   |            | HERDISACTION** |
|       |    |            |        |   |            | -- Other       |
|       |    |            |        |   |            | disciplinary   |
|       |    |            |        |   |            | action         |
|       |    |            |        |   |            |                |
|       |    |            |        |   |            | **NOACTION**   |
|       |    |            |        |   |            | -- No action   |
|       |    |            |        |   |            | taken\         |
|       |    |            |        |   |            | **MISSING**\   |
|       |    |            |        |   |            | **NOTCOLLECT** |
|       |    |            |        |   |            | -- Not         |
|       |    |            |        |   |            | Collected      |
+-------+----+------------+--------+---+------------+----------------+

**Note 1**: Other - As defined in 18 USC 921, including any weapon
(including a starter gun) which will or is designed to or may readily be
converted to expel a projectile by the action of any explosive; the
frame or receiver of handguns and rifles/shotguns; any firearm muffler
or firearm silencer; any destructive device, which includes (a) any
explosive, incendiary, or poison gas (1) bomb, (2) grenade, (3) rocket
having a propellant charge of more than four ounces, (4) missile having
an explosive or incendiary charge of more than one quarter ounce, (5)
mine, or (6) similar device; (b) any weapon which will, or which may be
readily converted to, expel a projectile by the action of an explosive
or other propellant, and which has any barrel with a bore of more than
one-half inch in diameter; (c) any combination or parts either designed
or intended for use in converting any device into any destructive
device, and from which a destructive device may be readily assembled.

Example:

\<CATEGORY TYPE=\"WEAPONTYPE\" VALUE=\"RIFLESHOTGUN\"/\>

\<CATEGORY TYPE=\"FIREARMINC\" VALUE=\"EXPNOTMODNOALT\"/\>

## Table Type XML Object

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

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

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

                Table Name    TYPEABBRV        M          The unduplicated     **CHLINVWFRARM**
                                                          number of children   
                                                          who were involved in 
                                                          an incident          
                                                          involving a firearm. 

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

Example:

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

\<CATEGORY TYPE=\"WEAPONTYPE\" VALUE=\"RIFLESHOTGUN\"/\>

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

\<EXPLANATION/\>

\</TABLETYPE\>

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

\<CATEGORY TYPE=\"WEAPONTYPE\" VALUE=\"HANDGUNS\"/\>

\<AMOUNT\>3\</AMOUNT\>

\<EXPLANATION/\>

\</TABLETYPE\>

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

\<CATEGORY TYPE=\"FIREARMINC\" VALUE=\"EXPNOTMODNOALT\"/\>

\<AMOUNT\>4\</AMOUNT\>

\<EXPLANATION/\>

\</TABLETYPE\>

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

\<CATEGORY TYPE=\"FIREARMINC\" VALUE=\"EXPMODIDEA\"/\>

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

\<EXPLANATION/\>

\</TABLETYPE\>

## Agency XML Object

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

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

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

                **ID 559\    FIPSSTATECODE         M          The two-digit        For a list of
                **FIPS State                                  Federal Information  valid FIPS
                Code                                          Processing Standards State Codes,
                                                              (FIPS) for the       refer to the
                                                              state, District of   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                                       EDEN to uniquely     State
                Agency                                        identify state       Education
                Number                                        agencies. This ID    Agency
                                                              cannot be updated    
                                                              through this file.   

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

Example:

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

> \<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: SEA, 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  **SEA
                                                              of file being        CHILDREN
                                                              submitted.           INVOLVED WITH
                                                                                   FIREARMS**

                     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 identifies the 
                                                              education unit.      
  ----------------------------------------------------------------------------------------------

Example:

\<FILETRANSMISSION

FILELAYOUTTYPE=\"SEA CHILDREN INVOLVED WITH FIREARMS \"

FILEID=\"State Children Involved with Firearms\"

SCHOOLYEAR=\"2005 2006\"\>

\<AGENCY\>*See the agency element for description*\</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 (Weapon Type, Firearm
Incident), and the associated value. The metric objects are contained
within the file transmission objects that define the group of values
that is being submitted.

## Category XML Object

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

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

+-------+----+------------+--------+---+---------+------------------+
| *     | *  | **Data     | **Ca   | * | **Def   | **Permitted      |
| *Elem | *A | Element    | tegory | * | inition | Values**         |
| ent** | tt | Name**\    | V      | C | /       |                  |
|       | ri | (from      | alue** | h | Com     |                  |
|       | bu | Fixed      |        | a | ments** |                  |
|       | te | Format     |        | r |         |                  |
|       | ** | document)  |        | * |         |                  |
|       |    |            |        | * |         |                  |
+=======+====+============+========+===+=========+==================+
| CAT   |    |            |        |   |         |                  |
| EGORY |    |            |        |   |         |                  |
+-------+----+------------+--------+---+---------+------------------+
|       | TY |            |        | M | The     |                  |
|       | PE |            |        |   | catego  |                  |
|       |    |            |        |   | ry(ies) |                  |
|       |    |            |        |   | for the |                  |
|       |    |            |        |   | table   |                  |
|       |    |            |        |   | type.   |                  |
+-------+----+------------+--------+---+---------+------------------+
|       |    | Weapon     |        |   |         | **WEAPONTYPE**   |
|       |    | Type       |        |   |         |                  |
+-------+----+------------+--------+---+---------+------------------+
|       |    | Firearm    |        |   |         | **FIREARMINC**   |
|       |    | Incident   |        |   |         |                  |
|       |    | Result     |        |   |         |                  |
+-------+----+------------+--------+---+---------+------------------+
|       | V  |            |        | M | The     |                  |
|       | AL |            |        |   | c       |                  |
|       | UE |            |        |   | ategory |                  |
|       |    |            |        |   | pe      |                  |
|       |    |            |        |   | rmitted |                  |
|       |    |            |        |   | value.  |                  |
+-------+----+------------+--------+---+---------+------------------+
|       |    |            | WEAP   |   | The     | **HANDGUNS --**  |
|       |    |            | ONTYPE |   | type of | Handguns         |
|       |    |            |        |   | weapon. |                  |
|       |    |            |        |   |         | **RIFLESHOTGUN   |
|       |    |            |        |   |         | --**             |
|       |    |            |        |   |         | Rifles/Shotguns  |
|       |    |            |        |   |         |                  |
|       |    |            |        |   |         | **MULTIPLE** --  |
|       |    |            |        |   |         | More than one    |
|       |    |            |        |   |         | type of weapon   |
|       |    |            |        |   |         | or firearm.      |
|       |    |            |        |   |         |                  |
|       |    |            |        |   |         | **OTHER** -- See |
|       |    |            |        |   |         | Note1 in section |
|       |    |            |        |   |         | 4.1 above.\      |
|       |    |            |        |   |         | **MISSING**\     |
|       |    |            |        |   |         | **NOTCOLLECT**   |
|       |    |            |        |   |         | -- Not Collected |
+-------+----+------------+--------+---+---------+------------------+
|       |    |            | FIRE   |   | The     | **               |
|       |    |            | ARMINC |   | type of | EXPNOTMODNOALT** |
|       |    |            |        |   | action  | -- Expulsion not |
|       |    |            |        |   | used to | modified/no      |
|       |    |            |        |   | dis     | alternative      |
|       |    |            |        |   | cipline | placement        |
|       |    |            |        |   | s       |                  |
|       |    |            |        |   | tudents | **EXPMODALT** -  |
|       |    |            |        |   | i       | Expulsion        |
|       |    |            |        |   | nvolved | modi             |
|       |    |            |        |   | in      | fied/alternative |
|       |    |            |        |   | firearm | placement        |
|       |    |            |        |   | inc     |                  |
|       |    |            |        |   | idents. | **EXPMODIDEA**   |
|       |    |            |        |   |         | -- Expulsion     |
|       |    |            |        |   |         | modified because |
|       |    |            |        |   |         | of IDEA          |
|       |    |            |        |   |         |                  |
|       |    |            |        |   |         | *                |
|       |    |            |        |   |         | *EXPNOTMODIDEA** |
|       |    |            |        |   |         | -- Expulsion     |
|       |    |            |        |   |         | modified not     |
|       |    |            |        |   |         | because of IDEA  |
|       |    |            |        |   |         |                  |
|       |    |            |        |   |         | **EXPALT** --    |
|       |    |            |        |   |         | Expulsion with   |
|       |    |            |        |   |         | alternative      |
|       |    |            |        |   |         | placement        |
|       |    |            |        |   |         |                  |
|       |    |            |        |   |         | **REMOVEOTHER**  |
|       |    |            |        |   |         | -- Removal for   |
|       |    |            |        |   |         | other reason     |
|       |    |            |        |   |         | (such as death,  |
|       |    |            |        |   |         | withdrawal, or   |
|       |    |            |        |   |         | incarceration)   |
|       |    |            |        |   |         |                  |
|       |    |            |        |   |         | **               |
|       |    |            |        |   |         | OTHERDISACTION** |
|       |    |            |        |   |         | -- Other         |
|       |    |            |        |   |         | disciplinary     |
|       |    |            |        |   |         | action           |
|       |    |            |        |   |         |                  |
|       |    |            |        |   |         | **NOACTION** --  |
|       |    |            |        |   |         | No action taken\ |
|       |    |            |        |   |         | **MISSING**\     |
|       |    |            |        |   |         | **NOTCOLLECT**   |
|       |    |            |        |   |         | -- Not Collected |
+-------+----+------------+--------+---+---------+------------------+

Example:

\<CATEGORY TYPE=\"WEAPONTYPE\" VALUE=\"HANDGUNS\"/\>

\<CATEGORY TYPE=\"FIREARMINC\" VALUE=\"EXPMODALT\"/\>

## Table Type XML Object

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

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

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

                Table Name    TYPEABBRV        M          The unduplicated       **CHLINVWFRARM**
                                                          number of children who 
                                                          were involved in an    
                                                          incident involving a   
                                                          firearm.               

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

See Example in Section 5.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       For a list of
                **FIPS State                                   Federal Information valid FIPS
                Code                                           Processing          State Codes,
                                                               Standards (FIPS)    refer to the
                                                               for the state,      EDEN
                                                               District of         Workbook.
                                                               Columbia, and the   
                                                               possessions and     
                                                               freely associated   
                                                               areas of the United 
                                                               States (e.g.,       
                                                               Puerto Rico).       

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

                **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=\"80\" STATEAGENCYIDNUMBER=\"01\"
STATEALEAIDNUMBER=\"001000-0000001\"\>

> \<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 5.4-1: LEA, File Transmit XML Object**

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

                     File Type     FILELAYOUTTYPE   M          Identifies the type **LEA
                                                               of file being       CHILDREN
                                                               submitted.          INVOLVED WITH
                                                                                   FIREARMS**

                     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                                            M          The information      
                                                               that fully          
                                                               describes the       
                                                               education unit.     
  ----------------------------------------------------------------------------------------------

Example:

\<FILETRANSMISSION

FILELAYOUTTYPE=\"LEA CHILDREN INVOLVED WITH FIREARMS\"

FILEID=\"LEA Children Involved with Firearms\"

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