Overview

The Student entity is where the magic happens: this entity contains information about the student as well as the scholarship application data.

Details

This section contains detail and usage notes about the elements in the Student entity:

Student.Activities

Detail about a student's community service, hobbies, volunteering and other extracurricular activities. Optional.

Example ValueSnippet:

	<Activities>
    		<Type>Hobby</Type>
    		<Year>High School Grade 12</Year>
    		<Description>Garage band</Description>
    		<SchoolSeasonHoursPerWeek>4</SchoolSeasonHoursPerWeek>
    		<SchoolSeasonWeeksPerYear>36</SchoolSeasonWeeksPerYear>
	</Activities>

Usage Notes:

• Supports detail about hours/week and days/month, information about the organization affiliated with the activity, whether the activity was a graduation requirement, and so forth.

Student.ArmedForcesCharacteristics

Characteristics related to armed forces programs, a student's armed forces service record, and other attributes common to armed forces scholarship applications. Optional.

Example ValueExample Snippet:

	<RelativeServiceRecord>
    <StudentServiceRecord>
		<MilitaryBranch>Army</MilitaryBranch>
        		<ArmedServiceStatus>Veteran</ArmedServiceStatus>
        <WarOrConflict>Vietnam War</WarOrConflict>
    </RelativeServiceRecord>

Usage Notes:

	</StudentServiceRecord>

Usage Notes:

• The history contains a branch (e.g., Army, Navy), and a service status associated with that particular branch (e.g., Veteran, Active Duty). To maintain compatibility with existing semantics, we have implemented the service status as optional.
• The service status adds values of Retired and Reserve Duty.
• The various reserve branches (e.g., Army Reserve, Coast Guard Reserve) have been removed, and instead Reserve Duty service status now indicates that state of being.

• The "VeteranDesc" element has been renamed "MilitaryBranch."

Student.BirthDate

The student's date of birth. Optional.

Example Value: 

• 2000-04-01

Student.BirthPlace

• , and a text field to indicate the name of a war or conflict during which the student served.
• All elements in the Student Service Record entity are optional, but at least one should be present.

Student.BirthDate

The student's date of birth. Optional.

Example Value: 

• 2000-04-01

Student.BirthPlace

The city, state/province, and country where the student was born. The state/province value is the only required value. Optional.

Example ValueExample Snippet:

	<BirthPlace<BirthPlace>
		<City>Santa Monica</City>
		<StateOrProvince>CA</StateOrProvince>
		<StateOrProvinceOtherDesc>Calif.</StateOrProvinceOtherDesc>
		<Country>US</Country>
		<CountryOtherDesc>United States</CountryOtherDesc><Country>US</Country>
	</BirthPlace>

Usage Notes:

• The StateOrProvince and Country elements are enumerations with an "Other" option. The model includes text fields to indicate other birthplace states or countries. 

Student.Citizenship

The student's current citizenship status, the status date, and the country to which the status applies. Optional.

Example ValueExample Snippet: 

	<Citizenship>
		<CitizenshipStatus>U.S. Citizen</CitizenshipStatus>
       	<CitizenshipDate>2000-04-01</CitizenshipDate>
		<CitizenshipCountry>US</CitizenshipCountry>
		<CitizenshipCountryOtherDesc>U.S. of A.</CitizenshipCountryOtherDesc>
	</Citizenship>

Usage Notes:

• We have added two DACA-specific values to the Citizenship Status List enumeration in Snapp:

               Current DACA Status

               Pending DACA Application

• In addition, we have added the following SAR values to the same Citizenship Status List enumeration:

               Conditional Permanent Resident

               FAFSA-Eligible Non-Citizen

               Asylum-Seeker or Asylee

               Cuban or Haitian Entrant

               Humanitarian Parolee

Student.ClassRank

A student's class ranking, including the school to which the ranking applies, the system used (e.g., integer, decile). Optional.

Example Value:

• By convention, a status with a blank citizenship date indicates that the applicant has been in that status since birth.

Student.ClassRank

A student's class ranking, including the school to which the ranking applies, the system used (e.g., integer, decile). Optional.

Example Snippet:

	<ClassRank>
		<School>
			<SchoolName>Austin High School</SchoolName>
          	<NCESCode>480894000294</NCESCode>
          	<CEEBCode>440320</CEEBCode>
          	<SchoolType>High school</SchoolType>
          	<OtherSchoolDesc>Other School Description</OtherSchoolDesc>
          	<SchoolAddress>
				<AddressLine1>1715 West Cesar Chavez</AddressLine1>
          		<AddressLine2>Buildings 1-4</AddressLine2>
          		<NCESCode>480894000294<<City>Austin</NCESCode>City>
          		<CEEBCode>440320<<StateOrProvince>TX</CEEBCode>StateOrProvince>
          		<SchoolType>High<StateOrProvinceOtherDesc>Other State school<Description</SchoolType>StateOrProvinceOtherDesc>
          	<OtherSchoolDesc>Other School Description</OtherSchoolDesc>		<ZipOrPostalCode>78703</ZipOrPostalCode>
          	<SchoolAddress> 				<AddressLine1>1715 West Cesar Chavez</AddressLine1><Country>US</Country>
          		<AddressLine2>Buildings<CountryOtherDesc>Country 1-4<Other</AddressLine2>CountryOtherDesc>
          		<City>Austin</City>
         </SchoolAddress>
		<StateOrProvince>TX</StateOrProvince>
         </School>
		<StateOrProvinceOtherDesc>Other State Description</StateOrProvinceOtherDesc>
         		<ZipOrPostalCode>78703</ZipOrPostalCode>
          		<Country>US</Country>
          		<CountryOtherDesc>Country Other</CountryOtherDesc>
          	</SchoolAddress>
		</School>
		<System>Integer</System>
		<ClassRank>15</<System>Integer</System>
		<ClassRank>15</ClassRank>
		<ClassSize>100</ClassSize>
		<ClassRankPercentile>.15</ClassRankPercentile>
	</ClassRank>

Usage Notes:

• Note that 1 is highest (so 98th 2nd percentile would look awesome in this context, 2nd 98th percentile would not).

Student.ContactInfo

One of only two required entities on the Student entity.

Example ValueExample Snippet:

	<ContactInfo>
		<Email>testy.mctestface@example.com</Email>
		<PrimaryPhoneNumber>512-555-1212</PrimaryPhoneNumber>
		<IsPrimaryPhoneTextCapable>true</IsPrimaryPhoneTextCapable>
		<AlternatePhoneNumber>512-555-1111</AlternatePhoneNumber>
		<IsAlternatePhoneTextCapable>false</IsAlternatePhoneTextCapable>
	</ContactInfo>

Usage Notes:

• Every valid Snapp XML data file should have a ContactInfo entity with an Email element.

Student.CurrentAddress

The student's current address. Optional.

Example ValueExample Snippet:

	<CurrentAddress>
		<AddressLine1>1234 Maple Street</AddressLine1>
		<AddressLine2>Apt. 1303</AddressLine2>
		<City>Austin</City>
		<StateOrProvince>TX</StateOrProvince>
		<StateOrProvinceOtherDesc>Tex.</StateOrProvinceOtherDesc>
		<ZipOrPostalCode>78701</<ZipOrPostalCode>78701</ZipOrPostalCode>
		<Country>US</Country>
		<CountryOtherDesc>United States of America</CountryOtherDesc>
	</CurrentAddress>

Usage Notes:

• This is the place where the student is residing at the time of the application, which may be a dorm, boarding school, or similar.
• Contrast with Student.PermanentAddress.

Student.CurrentMajors

The student's current field of study. Optional.

Example ValueExample Snippet:

	<CurrentMajors>
		<MajorName>English Literature</MajorName>
		<MajorCIPCode>23.0101</MajorCIPCode>
		<MajorRank>1</MajorRank>
	</CurrentMajors>

Usage Notes:

• By convention, applies to current college students or dual-enrolled high-school students only – only — meaning scholarship programs targeted at graduating high school students will usually not include this information.
• Contrast with Student.IntendedMajors. 

Student.CurrentEnrollments

Each application may note zero, one, or multiple CurrentEnrollment entities. Optional.

Example ValueExample Snippet:

	<CurrentEnrollments>
		<School>
			<SchoolName>Austin High School</SchoolName>
          	<NCESCode>480894000294</NCESCode>
         	<CEEBCode>440320</CEEBCode>
         	<SchoolType>High school</SchoolType>
         	<OtherSchoolDesc>Other School Description</OtherSchoolDesc>
          	<SchoolAddress>
				<AddressLine1>1715 West Cesar Chavez</AddressLine1>
          		<AddressLine2>Buildings 1-4</AddressLine2>
          		<City>Austin</City>
          		<StateOrProvince>TX</StateOrProvince>
          		<StateOrProvinceOtherDesc>Other State Description</StateOrProvinceOtherDesc>
          		<ZipOrPostalCode>78703</ZipOrPostalCode>
          		<Country>US</Country>
          		<CountryOtherDesc>Country Other</CountryOtherDesc>
			</SchoolAddress>
			</School>
			<SchoolProgram>High school</SchoolProgram>
			<EnrollmentOtherDesc>Enrollment Other Description</EnrollmentOtherDesc>
			<ExpectedGraduationDate>2018-06-02</ExpectedGraduationDate>
     </CurrentEnrollments>

Usage Notes:

• As the name implies, these are intended to reflect the current status of a student as of the application date, along with an expected graduation date.
• Contrast this with the Student.GraduationInfo element which contains information about a graduation that has already happened.
• The NCES and CEEB code elements are optional but strongly encouraged.
• By convention, an entry with a NCES or CEEB code does not need to contain the SchoolAddress entity. Conversely, including the SchoolAddress is encouraged when the NCES or CEEB code is not available since positively identifying a school by name alone can be difficult.

Student.CollegeChoices

The student's college choices. Includes ranking information (to indicate first, second, etc., choices) and the application status (e.g., applied, accepted, declined). Optional.

Example ValueExample Snippet:

	<CollegeChoices>
		<College>
			<SchoolName>Pepperdine University</SchoolName>
			<NCESCode>121150</NCESCode>
			<CEEBCode>4630</CEEBCode>
			<SchoolType>College</SchoolType>
			<OtherSchoolDesc>Other Final College Choice
Description</OtherSchoolDesc>
			<SchoolAddress>
				<AddressLine1>24255 Pacific Coast Highway</AddressLine1>
				<AddressLine2>Building A</AddressLine2>
				<City>Malibu</City>
				<StateOrProvince>CA</StateOrProvince>
				<StateOrProvinceOtherDesc>State or Province Other</StateOrProvinceOtherDesc>
				<ZipOrPostalCode>90263<<ZipOrPostalCode>90263</ZipOrPostalCode>
				<Country>US</Country>
				<CountryOtherDesc>Country Other Desc</CountryOtherDesc>
			</SchoolAddress>
		</College>
		<CollegeChoiceRank>3</CollegeChoiceRank>
		<CollegeApplicationStatus>Accepted</CollegeApplicationStatus>
		<CollegeApplicationStatusOtherDesc>College Application Status Other 
		   Description</CollegeApplicationStatusOtherDesc>
	</CollegeChoices>

Usage Notes:

• Compare to Student.FinalCollegeChoice.

Student.CollegeReadinessProgram

• The NCES and CEEB code elements are optional but strongly encouraged.
• By convention, an entry with a NCES or CEEB code does not need to contain the SchoolAddress entity. Conversely, including the SchoolAddress is encouraged when the NCES or CEEB code is not available since positively identifying a school by name alone can be difficult.

Student.CollegeReadinessProgram

The college readiness program or programs in which a student has participated (e.g., AVID, NMSI). The list is based on the CollegeReadinessProgramList enumeration. Optional.

Example ValueExample Snippet:

	<CollegeReadinessPrograms>
		<ProgramName>Breakthrough Austin</ProgramName>
		<ProgramOtherDesc>Program Other Description</ProgramOtherDesc>
		<CounselorFirstName>Manuel</CounselorFirstName>
		<CounselorLastName>Diaz</CounselorLastName>
		<CounselorEmail>md@example.edu</CounselorEmail>
		<CounselorPhoneNumber>512-555-9876</CounselorPhoneNumber>
		<LengthOfParticipation>P2Y</LengthOfParticipation>
	</CollegeReadinessPrograms>

Usage Notes:

• Used by some scholarship programs as an eligibility requirement.
• The list was crafted by polling implementers (primarily the Dell Scholars Program) and desktop research.
• Other. The list includes an "Other" option, in which case sending systems should populate the ProgramOtherDesc element with the name or description of a College Readiness Program not found on the list.
• None. The list includes a "None" option. "None" is reserved for affirming that the applicant has not participated in a college readiness program. Do not use the selection to mean "not indicated" – instead, simply omit the optional CollegeReadinessProgram complex type altogether. 

Student.Disabled

Whether or not the student has a disability. Optional.

Example ValueExample Snippet:

	<Disabled>false</Disabled>

Usage Notes:

• By convention, implies a formal disability classification per law or regulation such as the Americans with Disabilities Act. In that context, the definition is a person who has a physical or mental impairment that substantially limits one or more major life activity.
• Implementers should omit this element if not indicated.

Student.DisabilityDesc

A brief description of a student's disability, if the Disabled element is set to true. Optional.

Example ValueExample Snippet:

	<DisabilityDesc>None</DisabilityDesc>

Usage Notes:

• By convention, should be required if Student.Disabled is set to true.

Student.EducationLevel

Student's highest completed level of school. Optional.

Example Snippet:

	<EducationLevel>
		<CurrentGradeLevel>High School Senior</CurrentGradeLevel>
		<EducationLevel>Some high school</EducationLevel>
	</EducationLevel>

Usage Notes:

• Graduating high school senior applicants should use the "Some High School" high school value.
• Note: CurrentGradeLevel is a subset of Compare with Student.EducationLevel. It The CurrentGradeLevel indicates the current grade level at the time of application. EducationLevel  EducationLevel refers to the highest education level achieved at some point in the past. 

Student.Employed

An indicator for whether the student was currently employed at the time the application was filled out. Optional.

Example Snippet:

<Employed>false</Employed>

Usage Notes:

• Intended for paid employment (vs. unpaid or volunteer work).
• Implementers should omit this element if not indicated.

Student.Essays.EssayContent

The Snapp Data Standard supports the exchange of essays. This element contains a student's essay text. It's assumed that some essay modification and customization by the applicant may be necessary.

Example Snippet:

	<Essays>
		<EssayType>Favorite activity</EssayType>
		<EssayContent>My favorite activity is writing short, pithy essays for scholarship applications. Ideally,                   		though, there would be some sort of system that would make this task, enjoyable as it is, less repetitive.		</EssayContent>
	</Essays>

Usage Notes:

• The text is limited to 4000 characters. The design intent is to handle a reasonably large maximum length while not requiring receiving systems to handle arbitrarily large essays.
• The essay content should be unformatted, without HTML markup or other text tagging. 
• If a sending application allows text longer than the allowable 4000 characters, senders can supply truncated text. Sending applications are encouraged to clip whole words to get the text down to 3996 characters and insert a space followed by a faux ellipsis (i.e., "...") at the end of the essay. This is not required, but provides a visual clue to applicants that there was additional text without assuming anything about the program flow of the receiving system.
• See the EssayTypeList documentation for a list of essay prompts supported and a crosswalk/comparison of enumeration values to actual questions.

Student.FinalCollegeChoice

An indicator of the college a student intends to attend. Includes an application status, so implementers can infer a difference between intent and a likely future. Optional.

Example Snippet:

	<FinalCollegeChoice>
		<College>
			<SchoolName>Pepperdine University</SchoolName>
			<NCESCode>121150</NCESCode>
			<CEEBCode>4630</CEEBCode>
			<SchoolType>College</SchoolType>
			<OtherSchoolDesc>Other Final College Choice Description</OtherSchoolDesc>
			<SchoolAddress>
				<AddressLine1>24255 Pacific Coast Highway</AddressLine1>
				<AddressLine2>Building A</AddressLine2>
				<City>Malibu</City>
				<StateOrProvince>CA</StateOrProvince>
				<StateOrProvinceOtherDesc>State or Province Other</StateOrProvinceOtherDesc>
				<ZipOrPostalCode>90263</ZipOrPostalCode>
				<Country>US</Country>
				<CountryOtherDesc>Country Other Desc</CountryOtherDesc></SchoolAddress>
			</SchoolAddress>
		</College>
		<CollegeChoiceRank>3</CollegeChoiceRank>
		<CollegeApplicationStatus>Accepted</CollegeApplicationStatus>
		<CollegeApplicationStatusOtherDesc>College Application Status Other Description
		<Description</CollegeApplicationStatusOtherDesc>
	</FinalCollegeChoice>

Usage Notes:

• Compare with Student.CollegeChoices. 
• Can indicate a preference if the applicant has not yet been accepted or declined.
• If a student has been accepted at multiple institutions, should indicate the college at which the student plans to attend. 

Student.Gender

Student Gender refers to the current biological sex of the applicant. Optional.

Example Snippet:

	<Gender>Male</Gender>

Usage Notes:

• Because the  Snapp Profile treats gender information as optional, applicants are not required to enter gender or gender identity information when using the online Snapp Application form. The application's online help makes this clear. If gender identity data is present (e.g., if received from a partner requiring the information), students can remove that information from their profile.
• There is a simple, nullable gender field indicating the applicant's current biological sex. Most of our current scholarship providers use a binary Male / Female choice – and for many, the value is required. Similarly, many partners have indicated that they're addressing gender identity by providing options equivalent to "Male," "Female," and "Choose not to respond." So, we will continue to have the simple M/F/unspecified value to remain compatible with those scholarship providersSome applications define gender as the biological sex of the applicant at birth. For some applicant pools, it's reasonable to treat that as equivalent to the Snapp definition (i.e., the current biological sex) and for other applicant pools it may not be reasonable. Gender is optional in the Snapp Profile, so scholarship programs exchanging data with Snapp may use their discretion as to whether to include or ignore this value. Note that the GenderIdentity element provides a means to indicate a change in biological sex after birth.

Student.GenderIdentity

The Gender Identity for a student provides detail about the biological sex of the applicant as well as the applicant's sexual identity. Optional.

Example Snippet:

	<GenderIdentity>Prefer to Self-Identify (Other)</GenderIdentity>

Usage Notes:

• If gender Gender identity data is present (e.g., if received from a partner requiring the information), students can remove that information from their profile.
• To date, we haven't found an authoritative standard that is reasonably inclusive of the values found represented by the LBGTQIA acronym and our partners. We've created an amalgam of values from various studies, sources such as the GLAAD Media Reference Guide, and the values in use by partners. 
• Some is a sensitive topic. We provide support for the notion of gender identity with an approach that's we hope is both sensitive and practical. A common piece of advice when asking how to convey gender identity information is "Don't ask." However, given our history providing support and interest from current partners, we do provide support. In addition, some scholarship programs are for the benefit of individuals with a specific gender identity, and our nascent scholarship search feature can use this information to provide applicants with scholarship options for which they qualify.
• We provide support for the notion of gender identity with an approach that's both sensitive and practical. A common piece of advice when asking how to convey gender identity information is "Don't ask." However, given our history providing support and interest from current partners, we do intend to provide support in the Berkeley version of Snapp. In addition, some scholarship programs are for the benefit of individuals with a specific gender identity, and our nascent scholarship search feature can use this information to provide applicants with scholarship options for which they qualify.
• Support Gender identity is optional, and if gender identity data is present (e.g., if Snapp receives data from a partner requiring the information), applicants have the option to remove that information from their Snapp Profile.
• To date, we haven't found an authoritative standard that is reasonably inclusive of the values found represented by the LBGTQIA acronym and our partners. We've created an amalgam of values from various studies, sources such as the GLAAD Media Reference Guide, and the values in use by partners.
• We support an explicit "Prefer Not to Answer" option. Rather than simply leave the Identity field optional, some applications and surveys offer a way for the applicant to indicate they would prefer not to answer. We are accommodating that – in addition to leaving the element optional.
• Use a "Prefer to Self-Identify (Other)" value for Gender Identity. Many surveys and applications asking about gender identity support a free-form text field. To support these partners, we have added Snapp includes a "Prefer to Self-Identify (Other)" value in the Gender Identity enumeration with an accompanying 100-character text field. Generally speaking,   "Prefer to Self-Identify" or similar inclusive language is used to indicate a free-form entry for this value. But, we include "Other" in the value text as a hint for technologists and analysts doing data mapping. This element is analogous to Facebook's "Custom" gender option. 

Student.GovernmentAidParticipation

Information about the program or programs in which a student participates. Optional.

Example Value:

• FreeOrReducedSchoolLunch

Usage Notes:

• Used by some applications as eligibility criteria.

Student.GPA

A student's grade point average information. Optional.

Example

Snippet:

	<GPA>
		<School>
			<SchoolName>Austin High School</SchoolName>
			<NCESCode>480894000294</NCESCode>
			<CEEBCode>440320</CEEBCode>
			<SchoolType>High school</SchoolType>
			<OtherSchoolDesc>Other School Description</OtherSchoolDesc>
			<SchoolAddress>
				<AddressLine1>1715 West Cesar Chavez</AddressLine1>
				<AddressLine2>Buildings 1-4</AddressLine2>
				<City>Austin</City>
				<StateOrProvince>TX</StateOrProvince>
				<StateOrProvinceOtherDesc>Other State Description</StateOrProvinceOtherDesc>
				<ZipOrPostalCode>78703</ZipOrPostalCode>
				<Country>US</Country>
				<CountryOtherDesc>Country Other</CountryOtherDesc>
			</SchoolAddress>
		</School>
		<CumulativeGPA>
			<SchoolYear>High School Grade 11</SchoolYear>
			<GPA>3.9</GPA>
			<Scale>4.0</Scale>
			<ScaleOther>Four-point-oh</ScaleOther>
			<Weighted>false</Weighted>
		</CumulativeGPA>
	</GPA>

Usage Notes:

• Can be reported for each grade level on a variety of scales (e.g., 4.0, 100, Alphabetic). 
• Averages reported for multiple grades are cumulative, meaning that a value for 10th grade should be a cumulative average that includes 9th grade.
• Can indicate weighted or unweighted GPA.

Student.GraduationInfo

The GraduationInfo entity conveys information about an applicant's graduation record. Optional.

Example Snippet:

	<GraduationInfo>
		<Graduated>false</Graduated>
		<GraduationType>High school</GraduationType>
		<GraduationTypeOtherDesc>Graduation Type Other Description</GraduationTypeOtherDesc>
		<GraduationSchool>
			<SchoolName>Austin High School</SchoolName>
			<NCESCode>480894000294</NCESCode>
			<CEEBCode>440320</CEEBCode>
			<SchoolType>High school</SchoolType>
			<OtherSchoolDesc>Other School Description</OtherSchoolDesc>
			<SchoolAddress>
				<AddressLine1>1715 West Cesar Chavez</AddressLine1>
				<AddressLine2>Buildings 1-4</AddressLine2>
				<City>Austin</City>
				<StateOrProvince>TX</StateOrProvince>
				<StateOrProvinceOtherDesc>Other State Description</StateOrProvinceOtherDesc>
				<ZipOrPostalCode>78703</ZipOrPostalCode>
				<Country>US</Country>
				<CountryOtherDesc>Country Other</CountryOtherDesc>
			</SchoolAddress>
		</GraduationSchool>
		<GraduationDate>2018-06-02</GraduationDate>
		<GraduationCity>Austin</GraduationCity>
		<GraduationStateOrProvince>TX</GraduationStateOrProvince>
		<GraduationStateOrProvinceOtherDesc>Tejas</GraduationStateOrProvinceOtherDesc>
		<GraduationZIPOrPostalCode>78703</GraduationZIPOrPostalCode>
		<GraduationCountry>US</GraduationCountry>
		<GraduationCountryOtherDesc>U.S. of A.</GraduationCountryOtherDesc>
	</GraduationInfo>

Usage Notes:

• This The GraduationInfo entity also conveys information about graduation-equivalent certifications such as the GED program. 
• Worth noting is that the GraduationInfo is intended to support historical graduation information, that is, a graduation event that has already happened. Contrast this with the Student.CurrentEnrollments entity that notes an applicant's present enrollment status and future-looking, expected graduation date. 
• If the Student.GraduationInfo.Graduated flag is present and false, affirms that a student has not yet graduated. However, implementers sending data should consider using the Student.CurrentEnrollments if the intent is to convey that a current high school student is attending school but has not yet graduated.

Student.Income

The student's current income at the time the application was completed. Optional.

Example Snippet:

	<Income>
		<Amount>500</Amount>
		<Currency>USD</Currency>
	</Income>

Usage Notes:

• Intended for income earned by the student.
• Information about a parent's income is contained in Student.FAFSA and Student.Relatives.

Student.IntendedDiscipline

The student's intended line of work or field of expertise after graduation. Optional.

Example

Snippet:

	<IntendedDiscipline>ForeignRelations</IntendedDiscipline>

Usage Notes:

• Usually relates to a current or intended major, but is not the same thing. For example, a student majoring in French Literature might list "Education" or "Foreign Relations" or some other line of work as their intended discipline.

Student.IntendedMajors

The student's intended areas of study when in school. Optional.

Example Value:

	<IntendedMajors>
		<MajorName>English Literature</MajorName>
		<MajorCIPCode>23.0101</MajorCIPCode>
		<MajorRank>1</MajorRank>
	</IntendedMajors>

Usage Notes:

• Contrast with Student.CurrentMajors.

Student.Name

One of only two always-required entities in the Student

entity.

Example Snippet:

	<Name>
		<Salutation>Mr.</Salutation>
		<FirstName>Testy</FirstName>
		<MiddleName>Thomas</MiddleName>
		<LastName>McTestface</LastName>
		<Suffix>Jr.</Suffix>
		<PreferredName>Tron</PreferredName>
	</Name>

Usage Notes:

• Every valid Snapp XML data file should have a Student's first and last nameinclude Student.FirstName and Student.LastName.

Student.Race

The student's race or races. Optional.

Example Value:

	<Race>American Indian or Alaska Native</Race>

Usage Notes:

• The Race selections align with the U.S. Census Bureau and U.S. DoE values.
• In keeping with the Census Bureau approach, the Snapp Data Standard supports one or multiple selections. 
• Similar to the Census Bureau approach, the Snapp standard does not have a "primary" indicator. If an application supports an primary indicator, simply enter that value first in the Race enumeration. Thus, if an application system that only supports a single selection receives a file with multiple selections, the application should select the first value that appears.
• Snapp does not support an explicit "chose not to provide" value. Implementers should simply omit the Race element.

Student.PermanentAddress

The student's permanent home, often the address of their parent or guardian. Optional.

Example Snippet:

	<PermanentAddress>
		<AddressLine1>1234 Maple Street</AddressLine1>
		<AddressLine2>Apt. 1303</AddressLine2>
		<City>Austin</City>
		<StateOrProvince>TX</StateOrProvince>
		<StateOrProvinceOtherDesc>Tejas</StateOrProvinceOtherDesc>
		<ZipOrPostalCode>78701</ZipOrPostalCode>
		<Country>US</Country>
		<CountryOtherDesc>USA</CountryOtherDesc>
	</PermanentAddress>

Usage Notes:

• Contrast with Student.CurrentAddress, though often the same.CurrentAddress (though often the same).
• The permanent address is used, for example, when an applicant is currently in boarding school, a dormitory, or with their parents in a temporary military posting, or in some other temporary housing situation and needs to indicate a stable address at which they can receive correspondence.

Student.ScholarshipPurpose

The type of school for which the student seeks a scholarship (e.g., 2-year program, 4-year program). Optional.

Example Snippet:

	<ScholarshipPurpose>
		<Purpose>4-year program</Purpose>
		<PurposeOtherDesc>Purpose Other Description</PurposeOtherDesc>
	</ScholarshipPurpose>

Student.SimpleTranscript

A container for structured transcript information. Optional.

Example Snippet:

	<SimpleTranscript>
		<ClassName>Calculus</ClassName>
		<Year>High School Grade 12</Year>
		<Status>In progress</Status>
		<Grade>B</Grade>
		<Scale>Alphabetic</Scale>
		<Type>General</Type>
		<School>
			<SchoolName>Austin High School</SchoolName>
			<NCESCode>480894000294</NCESCode>
			<CEEBCode>440320</CEEBCode>
			<SchoolType>High school</SchoolType>
			<OtherSchoolDesc>Other School Description</OtherSchoolDesc>
			<SchoolAddress>
				<AddressLine1>1715 West Cesar Chavez</AddressLine1>
				<AddressLine2>Buildings 1-4</AddressLine2>
				<City>Austin</City>
				<StateOrProvince>TX</StateOrProvince>
				<StateOrProvinceOtherDesc>Other State Description</StateOrProvinceOtherDesc>
				<ZipOrPostalCode>78703</ZipOrPostalCode>
				<Country>US</Country>
				<CountryOtherDesc>Country Other</CountryOtherDesc>
			</SchoolAddress>
		</School>
	</SimpleTranscript>

Usage Notes:

• As the name implies, it's a fairly basic/simple list of transcript entries identifying a class name, grade level, grade achieved, class properties (e.g., AP, Pre-AP, Honors, IB), class status (e.g., complete, in progress)., AP, Pre-AP, Honors, IB), class status (e.g., complete, in progress).  
• By convention, if the NCES and/or CEEB code is present (and deemed reliable by the application host providing the user-facing input method), the school address can be omitted. Conversely, if there is no NCES and/or CEEB code, or it's deemed unreliable, then application hosts are encouraged to provide at least a city and state or ZIP code.

Student.SimpleTranscript.ClassNameOtherDesc

Detail about a class, and a description when an "Other" class name is indicated. Optional.

Example Snippet:

<ClassNameOtherDesc>Literature</ClassNameOtherDesc>	

Usage Notes:

• By convention, should be required when the "Other" class name is indicated.
• The Student.SimpleTranscript entity contains a ClassName enumeration which has a structured list of class types. The list is fairly general. Implementers may use the ClassNameOtherDesc element to house a more specific name for a class – class — even when the type selected by the student is not "Other." There should be no expectation that a receiving system will have a matching algorithm to handle unstructured text, but if the receiving system uses unstructured text to populate its transcript data then it may get value from the ClassNameOtherDesc element.

Student.StudentReferences

The student's references, such as school counselors, registrars, and recommenders. Optional.

Example Snippet:

	<StudentReferences>
		<ReferenceName>
			<Salutation>Mr.</Salutation>
			<FirstName>Edward</FirstName>
			<MiddleName>M.</MiddleName>
			<LastName>Rooney</LastName>
			<Suffix>III</Suffix>
			<PreferredName>Eddie-Baby</PreferredName>
		</ReferenceName>
		<ReferenceContactInfo>
			<Email>erooney@example.edu</Email>
			<PrimaryPhoneNumber>512-555-6545</PrimaryPhoneNumber>
			<IsPrimaryPhoneTextCapable>true</IsPrimaryPhoneTextCapable>
			<AlternatePhoneNumber>512-555-3746</AlternatePhoneNumber>
			<IsAlternatePhoneTextCapable>false</IsAlternatePhoneTextCapable>
		</ReferenceContactInfo>
		<Relationship>Other</Relationship>
		<RelationshipOtherDesc>Relationship Other Description</RelationshipOtherDesc>
		<YearsKnown>4</YearsKnown>
		<TitleOrOccupation>Guidance Counselor</TitleOrOccupation>
		<CompanyName>Austin High School</CompanyName>
	</StudentReferences>

Usage Notes:

• Includes basic contact information, length of time the student has known the individual, the type of relationship.
• While the type of relationship allows for a relative/family member, this entity is usually reserved for non-familial references.

Student.TestScores

A student's results on tests such as the PSAT, SAT, ACT and other exams. Allows students to specify a test type, a score, a test date. Contains an "Other" value (e.g., for statewide test results). Optional.

Example Snippet:

	<TestScores>
		<Test>SAT Total</Test>
		<Score>1350</Score>
		<ScoreType>Highest ever score</ScoreType>
		<ScoreDate>2018-01-10</ScoreDate>
	</TestScores>

Student.TimeAtCurrentAddress

The length of time the student has lived at their current address (i.e., the Student.CurrentAddress).

Example Snippet:

	<TimeAtCurrentAddress>P3Y1M</TimeAtCurrentAddress>

Usage Notes:

• This element uses the fun and seldom-seen xs:duration type. For example:

• By convention, implementers generally use years and months. Note that the xs:duration type allows days, minutes, seconds.
• The xs:duration also supports time differentials like 30 minutes ago, and other durations that are invalid in the context of Snapp, so implementers should check this carefully when importing information.