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

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

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

Usage Notes:

• Existing Armed Forces Student Characteristics elements that represent service and status into a single entity indicating Service History were refactored. Elements affected by this reorganization include VeteranDesc (a 0-n enumeration), Veteran (a Boolean status), and Active Duty (another Boolean status).
• The history now 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

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

Example Value:

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

Student.Citizenship

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

Example Value: 

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

	<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>
          		<City>Austin</City>
          		<StateOrProvince>TX</StateOrProvince>
          		<StateOrProvinceOtherDesc>Other State Description</StateOrProvinceOtherDesc>
         		<ZipOrPostalCode>78703</ZipOrPostalCode>
          		<Country>US</Country>
          		<CountryOtherDesc>Country Other</CountryOtherDesc>
          	</SchoolAddress>
		</School>
		<System>Integer</System>
		<ClassRank>15</ClassRank>
		<ClassSize>100</ClassSize>
		<ClassRankPercentile>.15</ClassRankPercentile>
	</ClassRank>

Usage Notes:

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

Student.ContactInfo

One of only two required entities on the Student entity.

Example Value:

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

	<CurrentAddress>
		<AddressLine1>1234 Maple Street</AddressLine1>
		<AddressLine2>Apt. 1303</AddressLine2>
		<City>Austin</City>
		<StateOrProvince>TX</StateOrProvince>
		<StateOrProvinceOtherDesc>Tex.</StateOrProvinceOtherDesc>
		<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 Value:

	<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 – 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 Value:

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

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

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

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

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

	<DisabilityDesc>None</DisabilityDesc>

Usage Notes:

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

Student.CurrentGradeLevel

Applicant's current grade level. Optional.

Example Value:

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

Usage Notes:

Student.EducationLevel

Student's highest completed level of school. Optional.

Example Value:

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

Student.Employed

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

Example Value:

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

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

	<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>
		</College>
		<CollegeChoiceRank>3</CollegeChoiceRank>
		<CollegeApplicationStatus>Accepted</CollegeApplicationStatus>
		<CollegeApplicationStatusOtherDesc>College Application Status Other Description
		</CollegeApplicationStatusOtherDesc>
	</FinalCollegeChoice>

Usage Notes:

• Compare with Student.CollegeChoices. 

Student.Gender

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

Example Value:

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

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

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

Usage Notes:

• If 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 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 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 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:

Usage Notes:

• Used by some applications as eligibility criteria.

Student.GPA

A student's grade point average information. Optional.

Example Value:

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

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

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

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

ExampleValue:

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

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

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

Student.ScholarshipPurpose

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

Example Value:

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

Student.SimpleTranscript

A container for structured transcript information. Optional.

Example Value:

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

Student.SimpleTranscript.ClassNameOtherDesc

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

Example Value:

<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 – 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 Value:

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

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

	<TimeAtCurrentAddress>P3Y1M</TimeAtCurrentAddress>

Usage Notes:

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

               P2Y6M means 2 years, 6 months
               P30M means 30 months (i.e., 2 years, 6 months)
               P3Y means 3 years

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