PREVIOUS VERSION

This site is the documentation for a Scholar Snapp Austin (v3.0), a previous version of the Scholar Snapp Technology Suite.

The Snapp solution is currently backward-compatible with v3.0, but all new development projects should leverage Scholar Snapp Technology Suite Berkeley (v4.0).

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 5 Next »

The final draft of the Scholar Snapp v3.0 data standard for the 2017-2018 application cycle was published on May 15, 2017. The Snapp Central API currently accepts and emits Snapp v2.0, the previous version. Development on the Snapp Central API to accommodate v3.0 is in progress (ETA July/August 2017). We encourage all new integrators to use v3.0.

Overview

Snapp contains a number of enumerations (i.e., value lists). These enumerations range from a list of states and provinces, to grading scales, to essay prompts. This section provides detail about a few noteworthy enumerations in the Snapp data standard. Where possible, an external reference is provided to give some insight into how we picked the values. 

Details

This section contains detail and usage notes about the enumerations in Snapp:

General - Other Values

Many enumerations have an "Other" value. If an Other value is present, it's usually at the bottom of the list (in the XSD). Most enumerations with an "Other" value have a companion text field to provide additional information. For example, entities that reference the CountryList enumeration have a CountryOther text field to contain the name of a country not provided in the enumeration.

AttachedFileTypeList

Used by Student.AttachedFile.FileDescription. Contains a structured list of file types. Many of the types are, by design, general in nature, usually where implementers have requested the ability to exchange a type of attachment but where norms aren't established in the application space.

By convention, the following usage is recommended for each type:

Enumeration ValueDescriptionUsage Notes
AudioAny audio file.General-purpose type.
College Board CSS PROFILE - DataThe College Scholarship Service PROFILE data from College Board. Detailed financial information typically used by private universities to determine an applicant's financial need.This CSS PROFILE type is used to convey a machine-readable version of the PROFILE. College Board provides this information as XML. Student applicants will typically not upload this file themselves. Programs should only provide this file if they have the rights to do so.
College Board CSS PROFILE - PrintableSame as above, only human-readable.This CSS PROFILE type is used to convey a human-readable version of the PROFILE information.
Degree CertificateA file or image of a degree proving attainment of a degree.Typically a PDF or image type.
Diploma CertificateA file or image of a certificate of graduation.Typically a PDF or image type.
FAFSAA file copy of a student's Free Application for Federal Student Aid information. Used by most public institutions and many private institutions to establish financial need.

Typically a PDF.

See USDoE MyStudentData File for a machine-readable version of this information.

Formal Student Portrait - Large

A formal portrait of the applicant. Typically:

  • Is professionally produced
  • Is on a neutral background or backdrop
  • Has only the student in the frame

Typically an image file type such as JPG, PNG. Can be a GIF, but that doesn't help the complexion.

Contrast with Informal Picture of Student.

Formal Student Portrait - SmallSame as above, only smaller file size.

Typically a small image file type such as JPG, PNG, GIF.

Contrast with Informal Picture of Student.

Informal Picture of StudentA selfie, snapshot, or other informal picture of the student.Contrast with the two Formal Student Portrait items above.
Medical DocumentAny medical document.For all practical purposes, a general-purpose type. (X-rays? Doctors' notes? Admission form?)
PictureAny picture.General-purpose type.
Portfolio DocumentAn example of an applicant's work.Can be any human-readable document type. Typically PDF.
Proof of AchievementAn award, certificate, affidavit, or other proof of an applicant's achievement.Can be any human-readable document type.
Proof of EmploymentA letter from an employer, pay stub, or other proof that the applicant is employed.Can be any human-readable document type. Typically PDF.
Recommendation/Reference LetterA letter of recommendation or reference on behalf of the applicant. Typically a formal letter from an institution.Can be any human-readable document type. Typically PDF.
School Acceptance LetterEvidence that an applicant has been accepted into a particular school or program. Typically contains the word "congratulations" somewhere in the text.Can be any human-readable document type. Typically PDF.
Student Aid Report (SAR)The Student Aid Report summarizes the information an applicant submits on the Free Application for Federal Student Aid (FAFSA) form.Can be any human-readable document type. Typically PDF.
TranscriptThe student's academic history.Can be any human-readable document type. Typically PDF.
USDoE MyStudentData File

A downloadable version of the FAFSA information available from the U.S. Department of Education.

For information on the MyStudentData program, see this page.

A CSV data file.
VideoAny video file.General-purpose type.
OtherA type not found in the above categories (or worthy of additional explanation).The AttachedFileType.FileOtherDesc element can convey a description of the file. By convention, implementers should always include a FileOtherDesc when Other is selected.

Data Standard Documentation Contents

  • No labels