Resource Preferences (Kansas v3.6)

Tool Search: Configuration

The Ed-Fi Configuration tool is used to establish Ed-Fi data resources. Once Resource Preferences have been selected, the following occurs:

  1. A valid configuration is made. 
  2. Ed-Fi IDs are assigned to users. 
  3. Data flows properly from Campus to Ed-Fi.

Screenshot of the Ed-Fi Configuration editorEd-Fi Configuration

Prerequisites

Resource Preferences

Resource Preferences determine which information is sent to Ed-Fi. These options apply to all schools within the district. Some mapping screens may be 'read only' when specific business rules are required by your state. Refer to the Ed-Fi v3.6 articles for these business rules. 

For each resource, choose Edit or Configure to map items like Scores or Grade Levels to an Ed-Fi Code. These items are called Descriptors.

  • Configure displays when preferences have not previously been saved. 
  • Edit displays when preferences have already been set and saved. 

Resources can be expanded by clicking the plus sign or collapsed by clicking the minus sign.

Screenshot of the Resource Preferences editorResource Preferences

When the Configure or Edit button does not display, the resource does not need to be mapped and the toggle button can be used to turn the resource on or off. Select a link below to view how to set the Resource Preferences.

 Resources should be toggled off until all data setup is complete and the district is ready to send data to Ed-Fi.
  1. Select the Resource Preferences button for the current school year. This name may vary depending on the Connection Name that was entered when adding the Connection, but should be similar to 23-24 KS Configuration. The list of available resources displays.
  2. Click the Edit or Configure button to modify the resource preferences.
  3. Click Save when finished mapping the Descriptors.
  4. Turn the resource preference to ON.
  5. Close the Resource Preferences when finished.

Any item not mapped DOES NOT REPORT to Ed-Fi.

Screenshot of mapping an ed-fi resourceMap the Campus Code to the Ed-Fi Code

Kansas Ed-Fi v3.6 Resource Preferences

The following provides details on each Resource and the desired preference for proper reporting with the state of Kansas.

ResourcePreferences
Grade Levels

The Grade Levels Resource cannot be toggled on or off because multiple resources use to determine grade level information. 


Each Grade Level Name available in the district needs to be mapped to a corresponding Ed-Fi Code.


See the Grade Levels article for more information.
Grade Information
Grades
Map the Grade Type Descriptors of Grading Task to the Ed-Fi Code (Semester, Term, Quarter).
Grading Periods
Map the Grading Period Descriptor - First Nine Weeks, First Semester, etc.
Schedule Information
Course OfferingsNo additional configuration is needed.
SectionsMap the Educational Environment Descriptors and the Course Level Characteristic Descriptions to the appropriate Ed-Fi Code.
SessionsMap the Term (Q1, Q2, etc.) for each calendar.
Click here to expand...

Select the Ed-Fi Term Type that matches the majority of the sections within the school.
  • Example: If quarters are set on the Calendar and the sections are scheduled for 4 quarters, then the Ed-Fi Term Type for all 4 quarters should be set to Full School Year. 
  • Example: If quarters are set on the Calendar and the sections are scheduled for 2 quarters, then the Ed-Fi Term Type should be set to Fall Semester for Q1 and Q2, and Spring Semester set for Q3 and Q4.

Session names must be unique in Ed-Fi. In Campus, the Term Descriptor is used for the session name, and in Kansas this is identical across districts for tuition out schools, allowing only one district to submit the session. The Session Name Override checkbox has been added to the Sessions resource preferences in Kansas to allow districts to select when they need the session name to be unique for tuition out schools. This checkbox should only be used by districts with tuition out schools. 


The same Ed-Fi Term Type can be selected for multiple terms if they should be grouped together to make one term. The earliest Start Date and latest End Date will be used in reporting the Sessions resource.


When Term Descriptors are changed, a resync on Sessions for the impacted school(s) must be completed. If any dependent data of Sessions has been sent for the prior term, the dependent data will be deleted and inserted with the new Term Descriptor. Dependent resources include Courses, Course Offerings, Sections, Student Section Associations, Staff Section Associations, Grades, and Student Section Attendance Events and can potentially cause a large amount of data in the Event Queue to be processed.


Term Descriptor Overrides should only be set on a course or section if it does not use the same term that is set on the Term Schedule in Step #1.  A new Sessions resource will be created using the Section Placements to determine the Start and End Dates.


When Term Descriptor Overrides are changed, a resync on Sessions for the impacted school(s) must be completed. If any dependent data of Sessions has been sent for the prior term, the dependent data will be deleted and inserted with the new Term Descriptor Override. Dependent resources include Courses, Course Offerings, Sections, Student Section Associations, Staff Section Associations, Grades, and Student Section Attendance Events and can potentially cause a large amount of data in the Event Queue to be processed.

Multiple Term Schedules

Using multiple Term Schedules with Ed-Fi is not supported due to the natural key conflicts with the Ed-Fi framework.   If you have courses or sections that align to a different Term Schedule than what is set for Term Descriptors on the Primary Term Schedule, you must use the Ed-Fi Term Override fields on the Course or Section in order to report the proper Term Descriptors to Ed-Fi.   All other data that reports to Ed-Fi with a Sessions reference will report from the Primary Term schedule only.


There is an Ed-Fi Term Descriptor Override checkbox on the Course Editor and Course Section Editor if the Calendar Term selection needs to be different for certain courses or certain course sections.  Once the Ed-Fi Term Descriptor Override checkbox is checked, alternate Terms can be set in the Sessions Resource Preferences.

Student Information
School School Associations
Map the Enrollment State End Status to the appropriate Ed-Fi Code for Exit Withdraw Type Descriptors.