...
A person's name and UH Number. RetrofitPerson is sent before any refreshStudentAcademicProfile or refreshInstructorAssignment message
| Code Block |
|---|
ROUTING KEY: person.refresh
{
"messageType":"refreshPerson",
"transmissionDate":"2016-05-09 13:58:00",
"bannerEventNumber": ,
"messageBody":{
"fullName":"",
"firstName":"",
"preferredFirstName":"",
"lastName":"",
"middleName":"",
"nameSuffix":"",
"uhUuid":"",
"pidm":
}
}
|
| Code Block |
|---|
ROUTING KEY: person.retrofit
{
"messageType":"retrofitPerson",
"transmissionDate":"2016-05-09 13:58:00",
"bannerEventNumber": ,
"messageBody":{
"uhUuid":"",
"actions":[
{
"messageType":"refreshPerson",
"messageBody":{
"fullName":"",
"firstName":"",
"preferredFirstName":"",
"lastName":"",
"middleName":"",
"nameSuffix":"",
"uhUuid":"",
"pidm":
}
}
]
}
} |
Students
Useful for creating groups of students by major.
| Code Block |
|---|
ROUTING KEY: studentAcademicProfile.refresh
{
"messageType":"refreshStudentAcademicProfile",
"transmissionDate":"2015-10-30 14:29:16",
"messageBody":{
"uhUuid":"12345678",
"pidm":123456,
"studentAcademicProfile":[
{
"startingTerm":"201430",
"endingTerm":"999999",
"residency":"N",
"studentStatus":"AS",
"studentType":"C",
"studentCurriculum":[
{
"priority":1,
"org":"KAP",
"campus":"KAP",
"level":"UG",
"program":"AS-NMA-ANIM",
"major":"NMA",
"degreeGoal":"AS",
"college":"AR",
"department":"AR"
},
{
"priority":2,
"org":"MAN",
"campus":"MAN",
"level":"UG",
"program":"ART-BA",
"major":"ART",
"degreeGoal":"BA",
"college":"10",
"department":"ARTH"
}]
},
{
"startingTerm":"201310",
"endingTerm":"201430",
"residency":"N",
"studentStatus":"AS",
"studentType":"C",
"studentCurriculum":[
{
"priority":1,
"org":"KAP",
"campus":"KAP",
"level":"UG",
"program":"AS-NMA-ANIM",
"major":"NMA",
"degreeGoal":"AS",
"concentration":"ANIM",
"college":"AR",
"department":"AR"
}]
}]
}
} |
Registration
| Code Block |
|---|
ROUTING KEY: studentRegistration.refresh
{
"messageType":"refreshStudentRegistration",
"transmissionDate":"2015-10-30 14:29:16",
"messageBody":{
"uhUuid":"12345678",
"pidm":123456,
"term":"201430",
"courseList":[
{
"org":"KAP",
"subjectCode":"MUS",
"courseNumber":"121Z",
"crn":"12345",
"creditHours":2.0,
"registrationStatus":"RW",
"withdrawn":"N",
"waitlisted":"N"
}
],
"totalCreditHours":2.0
}
}, |
Instructor
...
The retrofitPerson message is sent before any refreshStudentAcademicProfile or refreshInstructorAssignment message. We don't need retrofitPerson before any other type of messages because a person is either a student or faculty, and those two messages appear for a student or faculty respectively before any other type of messages (e.g. refreshStudentAcademicProfile for a student appears before any refreshStudentRegistration messages, so we don't need to send a retrofitPerson before every registration message)
NOTE: refreshPerson uses a built-in trigger which fires on events other than name changes. You may get refreshPerson messages where the name data hasn't changed.
| Code Block |
|---|
ROUTING KEY: person.retrofit
{
"messageType":"retrofitPerson",
"transmissionDate":"2016-05-09 13:58:00",
"bannerEventNumber": ,
"messageBody":{
"uhUuid":"",
"actions":[
{
"messageType":"refreshPerson",
"messageBody":{
"fullName":"",
"firstName":"",
"preferredFirstName":"",
"lastName":"",
"middleName":"",
"nameSuffix":"",
"uhUuid":"",
"pidm":
}
}
]
}
} |
Students
Useful for creating groups of students by major.
| Code Block |
|---|
ROUTING KEY: studentAcademicProfile.refresh
{
"messageType":"refreshStudentAcademicProfile",
"transmissionDate":"2015-10-30 14:29:16",
"messageBody":{
"uhUuid":"12345678",
"pidm":123456,
"studentAcademicProfile":[
{
"startingTerm":"201430",
"endingTerm":"999999",
"residency":"N",
"studentStatus":"AS",
"studentType":"C",
"studentCurriculum":[
{
"priority":1,
"org":"KAP",
"campus":"KAP",
"level":"UG",
"program":"AS-NMA-ANIM",
"major":"NMA",
"degreeGoal":"AS",
"college":"AR",
"department":"AR"
},
{
"priority":2,
"org":"MAN",
"campus":"MAN",
"level":"UG",
"program":"ART-BA",
"major":"ART",
"degreeGoal":"BA",
"college":"10",
"department":"ARTH"
}]
},
{
"startingTerm":"201310",
"endingTerm":"201430",
"residency":"N",
"studentStatus":"AS",
"studentType":"C",
"studentCurriculum":[
{
"priority":1,
"org":"KAP",
"campus":"KAP",
"level":"UG",
"program":"AS-NMA-ANIM",
"major":"NMA",
"degreeGoal":"AS",
"concentration":"ANIM",
"college":"AR",
"department":"AR"
}]
}]
}
} |
Registration
| Code Block |
|---|
ROUTING KEY: studentRegistration.refresh
{
"messageType":"refreshStudentRegistration",
"transmissionDate":"2015-10-30 14:29:16",
"messageBody":{
"uhUuid":"12345678",
"pidm":123456,
"term":"201430",
"courseList":[
{
"org":"KAP",
"subjectCode":"MUS",
"courseNumber":"121Z",
"crn":"12345",
"creditHours":2.0,
"registrationStatus":"RW",
"withdrawn":"N",
"waitlisted":"N"
}
],
"totalCreditHours":2.0
}
}, |
Consider including sectionNumber in the courseList, it is friendlier than CRN and goes well together with subjectCode and courseNumber.
Instructor
| Code Block |
|---|
ROUTING KEY: instructorAssignment.refresh
{
"messageType":"refreshInstructorAssignment",
"transmissionDate":"2015-10-30 14:29:16",
"bannerEventNumber":36524674,
"messageBody":{
"org":"HAW",
"term":"201610",
"subjectCode":"",
"courseNumber":"",
"sectionNumber":"",
"crn":"15720",
"instructorList":[
{
"pidm":123456,
"uhUuid":"10101010",
"lastName":"Fiction",
"firstName":"Pulp",
"middleName":"P",
"primary":"Y"
},
{
"pidm":155552,
"uhUuid":"10202020",
"lastName":"Minde",
"firstName":"Neva",
"orgpreferredFirstName":"HAWNeva",
"term":"201610", "subjectCodemiddleName":"U",
"courseNumber":"", "courseSectionprimary":"N",
"crn":"15720",
}
"instructorList":[ ]
}
} |
Note: an empty instructorList means that there are no instructors assigned to this course section. If subjectCode, courseNumber and sectionNumber are missing, interpret this message as a course section deletion.
Course Section
| Code Block |
|---|
ROUTING KEY: courseSection.refresh
{
"pidmmessageType":123456"refreshCourseSection",
"transmissionDate":"2015-10-30 14:31:20",
"uhUuid":"10101010"bannerEventNumber":12341322,
"messageBody":{
"lastNameorg":"FictionMAU",
"term":"201630",
"firstNamecrn":"Pulp12123",
"subjectCode":"DENT",
"middleNamecourseNumber":"P152",
"primarysectionNumber":"Y0"
,
}"sectionStatus":"A",
"courseStartDate":"2016-01-11",
{ "courseEndDate":"2016-05-13",
"pidmmaximumEnrollment":15555212,
"waitlistCapacity":0,
"uhUuidmeetingTimesList":"10202020",
[
"lastName":"Minde",{
"firstNamedays":"NevaM",
"middleNamemeetingStartTime":"U08:00",
"primarymeetingEndTime":"N08:50",
} ]"building":"NOII",
} } |
Course Section
| Code Block |
|---|
ROUTING KEY: courseSection.refresh { "messageTyperoomNumber":"refreshCourseSection201",
"transmissionDatemeetingStartDate":"20152016-10-30 14:31:20",01-11",
"bannerEventNumber":12341322, "messageBodymeetingEndDate":{
"2016-05-13",
"org":"MAU", "termmeetingType":"201630CLAS",
"crn":"12123", },
"subjectCode":"DENT", "courseNumber":"152",
{
"sectionNumber":"0", "sectionStatusdays":"AT",
"courseStartDate":"2016-01-11", "courseEndDatemeetingStartTime":"2016-05-1308:00",
"maximumEnrollment":12, "meetingEndTime"waitlistCapacity:"11:0,
50",
"meetingTimesList":[ {"building":"NOII",
"daysroomNumber":"M",
"meetingStartTimemeetingStartDate":"08:002016-01-11",
"meetingEndTimemeetingEndDate":"08:502016-05-13",
"buildingmeetingType":"NOIICLAS",
"roomNumber":"201"},
],
"meetingStartDate":"2016-01-11",
"title":"Chairside Dent Asst"
}
} |
If subjectCode, courseNumber and sectionNumber are missing, interpret this message as a course section deletion
Published by UHIMS to the Banner exchange
Affiliation
| Code Block |
|---|
ROUTING KEY: affiliation.add
{
"meetingEndDatemessageType":"2016-05-13"addAffiliation",
"messageBody":
{
"meetingTypeuhUuid":"CLAS10202020",
"role":"u",
},
"org":"WIN"
}
}
ROUTING KEY: affiliation.delete
{
"messageType":"deleteAffiliation",
"messageBody":
{
"daysuhUuid":"T10202020",
"role":"u",
"meetingStartTimeorg":"08:00WIN",
}
} |
Home Campus
| Code Block |
|---|
ROUTING KEY: homeCampus.add
{
"messageType":"addHomeCampus",
"meetingEndTimemessageBody":"11:50",
{
"uhUuid":"10202020",
"buildingorg":"NOIIWIN",
}
}
ROUTING KEY: homeCampus.modify
{
"roomNumbermessageType":"modifyHomeCampus",
"messageBody":
{
"meetingStartDateuhUuid":"2016-01-1110202020",
"org":"WIN",
"meetingEndDateoldOrg":"2016-05-13LEE",
}
}
ROUTING KEY: homeCampus.delete
{
"meetingTypemessageType":"CLASdeleteHomeCampus",
"messageBody":
{
},
] "uhUuid":"10202020",
"titleorg":"Chairside Dent AsstWIN"
}
} |