MN v3.3 - Course Course Associations

Classic View: System Administration > Ed-Fi 

Search Terms: Ed-Fi

This entity supports associations from State, District, and College courses.

There are three categories of records, each involving the connection of one type of course data to another:

  • A District Course associated to a State Course
  • A District Course associated to a College Course
  • A College Course associated to a State Course

In each case, a set of courseCode/educationOrganizationId data is being associated with a different set of courseCode/educationOrganizationId data.

District Course associated to a State Course:

Click here to expand...

  • District Course:
  1. courseCode: course.courseID
  2. educationOrganizationId: 
    1. Report the Ed-Fi District ID
    2. If Ed-Fi District ID is NULL, report:
      1. ttddddmmm

        where:

        1. tt = district type
        2. dddd = district number, left zero filled
        3. mmm = 000 for all organizations reported in Ed-Fi
  • State Course:
  1. courseCode: course.stateCode (State Code)
  2. educationOrganizationId: 999999000

District Course associated to a College Course

Click here to expand...

  • District Course:
  1. courseCode: course.courseID
  2. educationOrganizationId: 
    1. Report the Ed-Fi District ID
    2. If Ed-Fi District ID is NULL, report:
      1. ttddddmmm

        where:

        1. tt = district type
        2. dddd = district number, left zero filled
        3. mmm = 000 for all organizations reported in Ed-Fi
  • College Course: 
  1. courseCode: dddd-CustomCourse.value (Course.collegeCourseCode = College Course Code)
    1. dddd = district number, left zero filled
  2. educationOrganizationId: (College Code)

College Course associated to a State Course

Click here to expand...

  • College Course:
  1. courseCode: dddd-CustomCourse.value (College Course Code)
    • dddd = district number, left zero filled
  2. educationOrganizationId: (College Code)
  • State Course: 
  1. courseCode: course.stateCode (State Code)
  2. educationOrganizationId: 999999000

Object Triggering Logic

This table describes logic for triggering syncing of this object.

ActionTrigger
Post

When a new Course record is saved, and there is a value saved in the State Code, College Code and College Course Code fields:

  • Trigger a District Course > State Course when: 
    1. A State Code is saved on the Course editor; and
    2. The College Place Holder checkbox is unchecked
  • Trigger a District Course > College Course when:
    1. A College Code is saved on the Course editor; and
    2. A College Course Code is saved on the Course editor; and
    3. The College Place Holder checkbox is unchecked
  • Trigger a College Course > State Course when:
    1. A State Code is saved on the Course editor; and
    2. A College Code is saved on the Course editor; and
    3. A College Course Code is saved on the Course editor; and
    4. The College Place Holder checkbox is checked
DeleteWhen a course record is deleted.
  • In the scenario where a record has been previously posted, related to either a College Course or State Course scenario, and the related College Course Code or State Code (respectively) has been edited or deleted


School Exclude, Calendar Exclude, Resource Toggle and Resync Logic

This table describes the School Exclude, Calendar Exclude, Resource Toggle and Resync logic of this object.

ActionTrigger
NoneIf a resource is toggled to 'OFF' after data has sent, all sent data will remain in the ODS but no new data will send.
DeleteIf a resource is toggled to 'OFF" after data has sent and an action is performed that would trigger a delete, that data will remain in the ODS until a resync is done.
DeleteIf a mapping is removed in Resource Preferences, and data has been sent to the ODS predicated on the Resource Preferences mapping record (i.e., a District > College CCA record was posted), the record will be deleted from the ODS and the Ed-Fi Identity Mapping table.
ResyncIf a record is in the Ed-Fi Identity Mapping table and not in the ODS, it will be deleted from the Ed-Fi Identity Mapping table.
ResyncIf a record is in the ODS and it does not have a matching record in Campus or the Ed-Fi Identity Mapping table, it will be deleted from the ODS.
ResyncIf a mapping is changed in Resource Preferences, a resync will need to be done to reflect the changes.

Natural Key Changes, Cascading Updates, and Deletes Logic

This table describes the Natural Key Changes/Cascading Updates and Deletes logic of this object.

ActionTrigger
Delete/PostIf any of the following changes in the Schools resource:
If the School Number/Ed-Fi School Number changes, a delete/post will occur with the cascading deletes from the change triggers, for any District Course records.
Delete/PostIf the College Course Code or State Code changes, a delete/post will occur with the cascading deletes from the School ID Change triggers, for any College Course or State Course records.
Delete/PostIf the College Place Holder is unchecked, a delete/post will occur with the cascading deletes for College → State Course Course/Course associations.


Scope Year Logic

This table describes scope year logic of this object.

Business Rules
Course Course Associations will report to the configured year they are aligned to:
  • Data will only send for years that have valid configuration


Resource Preferences


Data ElementMapping Needed
course.number: course.namepostSecondaryInstitution


Object Data Elements

This table describes data elements sent within the Parents resource.

Data Element LabelBusiness RequirementBusiness RulesM, C or O

Data Source 

GUI Path

Database
Field
course
Reference

courseCode: A unique alphanumeric code assigned to a course.


educationOrganizationId: The identifier assigned to an education organization.


courseCode:

  1. Check to see if it is a District course or a College course being reported.
    • If it is a District course, report the courseID.
    • If it is a College course, report the District Number - College Course Code from the Course editor. ex. '215-ECO 101'

educationOrganizationId:

  1. Check to see if it is a District course or a College course being reported.
    • If it is a District course:
      1. Report the Ed-Fi District ID
      2. If Ed-Fi School ID is NULL, report:
      3. ttddddmmm

        where:

        • tt = district type
        • dddd = district number, left zero filled
        • mmm = 000 for all organizations reported in Ed-Fi
    • If it is a College course, report the College Code.
M

CourseCode:

Course > CourseID


Course > College Course Code


education

OrganizatonId:

System Administration > Resources > District > District Record > Ed-Fi District ID


tt: System Administration > Resources > District Information > district record > Type


dddd: System Administration > Resources > District Information > District Record > State District Number


Course > College Code


CourseCode:

course.courseID


education

OrganizatonId:

District.type

District.number



toCourse
Reference

courseCode: A unique alphanumeric code assigned to a course.


educationOrganizationId: The identifier assigned to an education organization.



courseCode:

Check to see if it is a District course, a College course, or a State course being reported.
  1. If it is a District course, report the courseID.
  2. If it is a College course, report the District Number - College Course Code from the Course editor. ex. '215-ECO 101'
  3. If it is a State course, report the 5 digit State Code from the Course editor.
  • Strip leading zero from state code, if applicable.
  • Error message generates if state course code is not numeric or not 5 digits.

educationOrganizationId:

Check to see if it is a District course, a College course, or a State course being reported.
  1. If it is a District course, 
    • Report the Ed-Fi District ID.
    • If Ed-Fi District ID is NULL, report:
      1. ttddddsssmmm

        where:

        • tt = district type
        • dddd = district number, left zero filled.
        • sss = school number, left zero filled.
        • mmm = 000 for all organizations reported in Ed-Fi.
  2. If it is a College course, report the College Code.
  3. If it is a State course, report '999999000'.

M

CourseCode:

Course > CourseID


Course > College Course Code


Course > State Code


education

OrganizatonId:

System Administration > Resources > District > District Record > Ed-Fi District ID


tt: System Administration > Resources > District Information > district record > Type


dddd: System Administration > Resources > District Information > district record > State District Number


Course > College code


CourseCode:

course.courseID


Course.collegeCourseCode course.stateCode


educationOrganizatonId:

District.type

District.number




Resource Preferences Continued

The Ed-Fi Configuration tool is used to establish Ed-Fi data resources.

The following describes how to enable the Course Course Associations resource for Ed-Fi reporting. If the Configure or Edit button do not display, then the resource does not need to be mapped and the toggle button can be used to turn the resource on or off.

  1. Set the Course Course Associations preference to ON.