...
This endpoint is NOT expected from Choice schools.
...
Data Properties:
| Expand |
|---|
| title | Click here to view all data properties under the /staffSchoolAssociation endpoint: |
|---|
|
# | Property Name | Data Type | Public (Required/ Optional/ Conditional) | Choice (Required/ Optional/ Conditional) | Business Definition | Data Element Page | 1.0 | schoolReference. schoolId | integer | REQ'D | NOT REQ'D | The identifier assigned to a school. | https://dpi.wi.gov/wise/data-elements/schoolid | 2.0 | staffReference. staffUniqueId | string | REQ'D | NOT REQ'D | A unique alphanumeric code assigned to a staff. | https://dpi.wi.gov/wise/data-elements/WISEid | 3.0 | calendarReference. calendarCode | string | OPT | NOT REQ'D | The identifier for the Calendar. | N/A | 4.0 | calendarReference. schoolYear | integer | OPT | NOT REQ'D | The identifier for the school year associated with the Calendar. | https://dpi.wi.gov/wise/data-elements/school-year | 5.0 | calendarReference. schoolId | integer | OPT | NOT REQ'D | The identifier assigned to a school. | | 6.0 | schoolYearTypeReference. schoolYear | integer | OPT | NOT REQ'D | Key for School Year | https://dpi.wi.gov/wise/data-elements/school-year | 7.0 | academicSubjectDescriptor | string | OPT | NOT REQ'D | The academic subjects the individual is eligible to teach. | https://dpi.wi.gov/wise/data-elements/academic-subject NOTE: This list includes descriptors for SIS (CEDS & DPI namespace) and Assessment vendors (Ed-Fi namespace). | 8.0 | gradeLevelDescriptor | string | OPT | NOT REQ'D | The grade levels the individual is eligible to teach. | https://dpi.wi.gov/wise/data-elements/grade-level | 9.0 | programAssignmentDescriptor | string | REQ'D | NOT REQ'D | The name of the program for which the individual is assigned; for example: Regular education Title I-Academic Title I-Non-Academic Special Education Bilingual/English as a Second Language. | N/A |
|
...
| Expand |
|---|
| title | Click here to view all the use cases pertaining to the /staffSchoolAssociation endpoint: |
|---|
|
# | Use Case Title | Use Case Description | What to Submit/retrieve |
|---|
1.0 | Create a StaffSchoolAssociation for a staff member present in the district within the WISEid system | Prerequisites: The following records need to be posted to the WISEdata API before posting the /staffSchoolAssociation resource: When the staff is present in the district within the WISEid system, LEA/SIS can post /staffSchoolAssociation by using the staff WISEid from the /staff resource. SIS vendors/LEAs should provide the programAssignmentDescriptor as configured in the SIS. If the SIS vendor designates values such as Bilingual/English as a Second Language, Regular Education, Special Education, Title I-Non-Academic, or Title I-Academic, those values should be sent. If the SIS does not designate one of the values listed above, vendors may send either 'Other' or 'Regular Education.' Note that the value ‘Other’ can be used with either the DPI or Ed-Fi namespace:
| POST on /staffSchoolAssociation: programAssignmentDescriptor: "uri://ed-fi.org/ProgramAssignmentDescriptor#Other", schoolReference: schoolId": 7525 staffReference: staffUniqueId": "1001001001" |
|---|
2.0 | Create a StaffSchoolAssociation for a staff member NOT present in the district within the WISEid system | Prerequisites: The following records need to be posted to the WISEdata API before posting the /staffSchoolAssociation resource: When a staff member is NOT present in the district within the WISEid system, the LEA/SIS must follow these steps to successfully post the /staffSchoolAssociation: Add the staff in the WISEid System and wait for validation to run before posting the /staffSchoolAssociation.
OR (if you have implemented the Staff Identity Integration) Create or search for the staff member in WISEid using the Identity AP Post the /staff resource. Post the /staffEducationOrganizationEmploymentAssociation resource.
| POST on /staff: POST on /staffEducationOrganizationAssignmentAssociations POST on /staffSchoolAssociation |
|---|
3.0 | Update the StaffSchoolAssociation | If the updated data property is a primary key, then vendors will need to insert a new record, then delete the old staffSchoolAssociation record. If the updated data property is NOT a primary key, then vendors would simply update the data property for an existing staffSchoolAssociation record. | PUT on /staffSchoolAssociation |
|---|
4.0 | Delete the StaffSchoolAssociation | The staffSchoolAssociation can be deleted without requiring the deletion of any associated child records first. | DELETE on /staffSchoolAssociation |
|---|
|
...
| Expand |
|---|
| title | JSON sample for /staffSchoolAssociation: |
|---|
|
| Code Block |
|---|
| {
"programAssignmentDescriptor": "uri://ed-fi.org/ProgramAssignmentDescriptor#OtherProgramAssignmentDescriptor#Regular Education",
"calendarReference": {
"calendarCode": "",
"schoolId": 7525,
"schoolYear": 2025
},
"schoolReference": {
"schoolId": 7525
},
"schoolYearTypeReference": {
"schoolYear": 2025
},
"staffReference": {
"staffUniqueId": "1001001001"
},
"academicSubjects": [
{
"academicSubjectDescriptor": "uri://ceds.ed.gov/AcademicSubjectDescriptor#Miscellaneous"
}
],
"gradeLevels": [
{
"gradeLevelDescriptor": "uri://dpi.wi.gov/GradeLevelDescriptor#02"
}
]
} |
|
...