Page Comparison

#

Property Name

Data Type

Public (Required/ Optional/ Conditional)

Choice (Required/ Optional/ Conditional)

Business Definition

Data Element Page

1.0

parentUniqueId*

string

REQ'D

REQ'D

A unique alphanumeric code assigned to a parent.

parentUniqueId: [LEA ID+’-’+parent unique ID in SIS system]

https://dpi.wi.gov/wise/data-elements/parent-guardian-wisedata

2.0

firstName

string

REQ'D

REQ'D

A name given to an individual at birth, baptism, or during another naming ceremony, or through legal change.

NA

3.0

middleName

string

OPT

OPT

A secondary name given to an individual at birth, baptism, or during another naming ceremony.

NA

4.0

LastSurname

string

REQ'D

REQ'D

The name borne in common by members of a family.

NA

5.0

generationCodeSuffix

string

OPT

OPT

An appendage, if any, used to denote an individual's generation in his family (e.g., Jr., Sr., III).

NA

6.0

parentAddress

arrayOPT

CONDITIONALLY REQ’D

OPTCONDITIONALLY REQ’D

An unordered collection of parentAddresses. Parent's address, if different from the student address and/or [Placeholder] when the student's Economically Disadvantaged Type (FRAN) is either 'Free' or 'Reduced'.

NA

7.0

addressTypeDescriptor

stringOPT

CONDITIONALLY REQ’D

OPTCONDITIONALLY REQ’D

The type of address listed for an individual or organization. Values are: Mailing, and Home.

NA

8.0

streetNumberName

stringOPT

CONDITIONALLY REQ’D

OPTCONDITIONALLY REQ’D

The street number and street name or post office box number of an address.

NA

9.0

apartmentRoomSuiteNumber

stringOPT

CONDITIONALLY REQ’D

OPTCONDITIONALLY REQ’D

The apartment, room, or suite number of an address.

NA

10.0

city

stringOPT

CONDITIONALLY REQ’D

OPTCONDITIONALLY REQ’D

The name of the city in which an address is located.

NA

11.0

stateAbbreviationDescriptor

stringOPT

CONDITIONALLY REQ’D

OPTCONDITIONALLY REQ’D

The abbreviation for the state (within the United States) or outlying area in which an address is located.

NA

12.0

postalCode

stringOPT

CONDITIONALLY REQ’D

OPTCONDITIONALLY REQ’D

The five or nine digit zip code or overseas postal code portion of an address.

NA

13.0

parentElectronicMail

array

OPT

OPT

An unordered collection of parentElectronicMails. The numbers, letters, and symbols used to identify an electronic mail (e-mail) user within the network to which the individual or organization belongs.

NA

14.0

electronicMailTypeDescriptor

string

OPT

OPT

The type of email listed for an individual or organization. Values are: Home/Personal, or Work

NA

15.0

electronicMailAddress

string

OPT

OPT

The electronic mail (e-mail) address listed for an individual or organization.

NA

16.0

parentLanguage

array

OPT

OPT

An unordered collection of parentLanguages. The language(s) the individual uses to communicate. It is strongly recommended that entries use only ISO 639-2 language codes.

NA

17.0

languageDescriptor

string

OPT

OPT

A specification of which written or spoken communication is being used.

NA

18.0

parentTelephone

array

OPT

OPT

An unordered collection of parentTelephones. The 10-digit telephone number, including the area code, for the person.

NA

19.0

telephoneNumberTypeDescriptor

string

OPT

OPT

The type of communication number listed for an individual or organization. Values are: Mobile (M); Home (H); Work (W); and Other (O).

NA

20.0

telephoneNumber

string

OPT

OPT

The telephone number including the area code, and extension, if applicable.

NA

Sending parent/guardian information for each parent/guardian

The parent/guardian data collection is optional for LEAs to submit to WISEdata.

• The vendor authorization is based on that LEA ID prefix (e.g. 5006058-JS007), which is the LEA ID in the target year, i.e. 2021-22 SY.

• The order for posting JSON is: /student, /studentSchoolAssociation, /parent, then /studentParentAssociation

• The First Name, Last Name, and Parent Unique ID are required data properties. Other data properties are optional.

• Without posting the /studentParentAssociation record, vendor cannot do a GET on /parent

• The /Parent record cannot be updated until the /studentParentAssociation record is posted.

POST on /parents:
parentUniqueId : EdFiLEAid+’-’+’parentuniqueidinSISsystem
firstName:
lastSurname:
middleName:
generationCodeSuffix: I through XV, Sr, Jr, and SJ (trailing punctuation must be removed from the from the string)
addresses:
addressTypeDescriptor: Home; and Mailing
city
postalCode
stateAbbreviationDescriptor
streetNumberName
apartmentRoomSuiteNumber
electronicMails:
electronicMailTypeDescriptor: Home/Personal; and Work
electronicMailAddress
languages:
languageDescriptor
telephones
telephoneNumber
telephoneNumberTypeDescriptor: Mobile; Home; Work; and Other

Submit the student's parent/guardian information for Milwaukee School District

(This only applies to vendors that support Carmen Schools and Milwaukee College Prep 'MCP')

Milwaukee School District uses three different SIS vendors. Therefore, vednors supporting Carmen and MCP schools will need to included something to differentiate the parents from MPS and each other.

SIS vendors can use the individual Schoolid as part of the ParentUniqueId, but they would need to appropriately handle students moving between their schools.

Otherwise, they could pick a single SchoolId, or 'Carmen'/'MCP', or 'PowerSchool'/'Skyward', or anything else that would make sense, such as a tenant number if available in the SIS.

Student's /parent and /StudentParentAssociation endpoints is successfully submitted with the Parent Unique ID may be as follows:

Ed-Fi LEA ID +'-'+'Differentiating Factor'+'-'+ Parent Unique ID in SIS System

Differentiating Factor: Something that uniquely identifies the parent within the SIS and is not also used by another SIS to identify parent in the same district.

Sending parent/guardian information when they more than one students in the same LEA

• DPI expects one /parent record when parent/guardian has multiple students attending the same LEA.

• One /studentParentAssociation record should be submitted for each student

Sending parent/guardian information when they have multiple addresses

Parents/guardians could have multiple households and multiple address. DPI only requires primary home address and mailing address of parent/guardian if different than the home address.

Every school district has a different process for parent data sharing agreement. However, parents/guardians can choose to opt-in or opt-out of the agreement. By law, parents/guardians always have the right to opt-out at any time of the school year. Until they opt-out default is opt-in for data sharing which includes address as well.

POST on /parents:
addresses:
addressTypeDescriptor : Home
city
postalCode
stateAbbreviationDescriptor
streetNumberName
apartmentRoomSuiteNumber

addressTypeDescriptor : Mailing
city
postalCode
stateAbbreviationDescriptor
streetNumberName
apartmentRoomSuiteNumber

Sending the address for a parent who opted out of address data sharing

• If opt-out from data sharing happened before submitting address to WISEdata, then do NOT submit student address to WISEdata.

• If opt-out from data sharing happens after submitting address to WISEdata, then delete the address of student from API.

DPI may share parents addresses with the WI Depertment of Health Services (DHS) for immunization matching purposes. If districts opts-out of using immunization services, then student addresses is not passed to DHS.

Sending parent/guardian information when student transferres transferred to a new LEA

Because the parentUniqueId includes the LEA ID, each LEA is expected to send /parent AND /studentParentAssociation records

LEA 1: submits a /Parent record AND a /studentParentAssociation record

AND

LEA 2: submits a /Parent record AND a /studentParentAssociation record

Updating parent/guardian information for a student

There is an Ed-Fi issue when SIS vendors do a POST->GET->DELETE->POST on /parent using the same unique id. This issue appears to be a problem for v3.4, but not for v5.2.

Instead of deleting a /parent record, vendors should update (PUT) the rcords with the changes.