Versions Compared

Version Old Version 8 New Version 9
Changes made by

Jaidaa Shafaei

Jaidaa Shafaei

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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

  • /staff

  • /staffEducationOrganizationAssignmentAssociations

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:

    • uri://dpi.wi.gov/ProgramAssignmentDescriptor#O

    • uri://ed-fi.org/ProgramAssignmentDescriptor#Other

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:

  • /staff

  • /staffEducationOrganizationAssignmentAssociations

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:

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

  1. Create or search for the staff member in WISEid using the Identity AP

  2. Post the /staff resource.

  3. 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
titleJSON sample for /staffSchoolAssociation:
Code Block
languagejson
{
    "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"
        }
    ]
}

...