opendataConcordiaU / documentation

Documentation and examples on the use of Concordia University open data API
36 stars 4 forks source link

Course Schedule API inconsistency questions #17

Open volovikariel opened 1 year ago

volovikariel commented 1 year ago

I've noticed some things that look like inconsistencies, but I'm not sure if they are.

Here's a response returned from calling the course schedule BIOL/201 endpoint:

{
  "courseID": "002625",
  "termCode": "2141",
  "session": "13W",
  "subject": "BIOL",
  "catalog": "201",
  "section": "50",
  "componentCode": "LEC",
  "componentDescription": "Lecture",
  "classNumber": "1161",
  "classAssociation": "1",
  "courseTitle": "INTRODUCTORY BIOLOGY",
  "topicID": "",
  "topicDescription": "",
  "classStatus": "Active",
  "locationCode": "LOY",
  "instructionModeCode": "P",
  "instructionModeDescription": "In Person",
  "meetingPatternNumber": "1",
  "roomCode": "CC320",
  "buildingCode": "CC",
  "room": "320",
  "classStartTime": "18.30.00",
  "classEndTime": "21.00.00",
  "modays": "N",
  "tuesdays": "Y",
  "wednesdays": "N",
  "thursdays": "N",
  "fridays": "N",
  "saturdays": "N",
  "sundays": "N",
  "classStartDate": "07/05/2014",
  "classEndDate": "19/08/2014",
  "career": "Undergraduate",
  "departmentCode": "BIOLOGY",
  "departmentDescription": "Biology",
  "facultyCode": "AS",
  "facultyDescription": "Faculty of Arts & Science",
  "enrollmentCapacity": "72",
  "currentEnrollment": "66",
  "waitlistCapacity": "0",
  "currentWaitlistTotal": "0",
  "hasSeatReserved": ""
}
  1. mondays is misspelled as modays. Would it be possible to get this fixed? image

  2. In the docs it marks the type of section as an integer. image But it's actually either a string (e.g: 04L) or an integer, it should be marked as having the type string instead so as to handle both cases, shouldn't it?

  3. hasSeatReserved is marked as a boolean, but it's sometimes empty (neither Y nor N, just ""), is there a reason why it doesn't default to N?

  4. Additionally, the currentWaitlistTotal is sometimes -1, why is that?

    {
    courseID: '004436',
    termCode: '2152',
    session: '13W',
    subject: 'CIVI',
    catalog: '432',
    section: 'LL-X',
    componentCode: 'LAB',
    componentDescription: 'Laboratory',
    classNumber: '1729',
    classAssociation: '1',
    courseTitle: 'SOIL MECHANICS',
    topicID: '',
    topicDescription: '',
    classStatus: 'Active',
    locationCode: 'SGW',
    instructionModeCode: 'P',
    instructionModeDescription: 'In Person',
    meetingPatternNumber: '1',
    roomCode: 'H0015',
    buildingCode: 'H',
    room: '0015',
    classStartTime: '17.15.00',
    classEndTime: '19.05.00',
    modays: 'Y',
    tuesdays: 'N',
    wednesdays: 'N',
    thursdays: 'N',
    fridays: 'N',
    saturdays: 'N',
    sundays: 'N',
    classStartDate: '14/09/2015',
    classEndDate: '20/09/2015',
    career: 'Undergraduate',
    departmentCode: 'BCEE',
    departmentDescription: 'Building Civil & Environ Engineering',
    facultyCode: 'ENCS',
    facultyDescription: 'Gina Cody School of Engineering & Computer Science',
    enrollmentCapacity: '14',
    currentEnrollment: '14',
    waitlistCapacity: '4',
    currentWaitlistTotal: '-1',
    hasSeatReserved: ''
    }
  5. Additionally, the currentEnrollment is sometimes -1, why is that?

    {
    courseID: '040862',
    termCode: '2152',
    session: '13W',
    subject: 'FTRA',
    catalog: '531',
    section: 'AA',
    componentCode: 'LEC',
    componentDescription: 'Lecture',
    classNumber: '3373',
    classAssociation: '1',
    courseTitle: 'INITIA TRADUCTION G?N?RALE',
    topicID: '',
    topicDescription: '',
    classStatus: 'Active',
    locationCode: 'SGW',
    instructionModeCode: 'P',
    instructionModeDescription: 'In Person',
    meetingPatternNumber: '1',
    roomCode: 'H429',
    buildingCode: 'H',
    room: '429',
    classStartTime: '18.00.00',
    classEndTime: '20.15.00',
    modays: 'N',
    tuesdays: 'N',
    wednesdays: 'Y',
    thursdays: 'N',
    fridays: 'N',
    saturdays: 'N',
    sundays: 'N',
    classStartDate: '08/09/2015',
    classEndDate: '07/12/2015',
    career: 'Undergraduate',
    departmentCode: 'ETUDFRANC',
    departmentDescription: 'Etudes Francaises',
    facultyCode: 'AS',
    facultyDescription: 'Faculty of Arts & Science',
    enrollmentCapacity: '15',
    currentEnrollment: '-1',
    waitlistCapacity: '10',
    currentWaitlistTotal: '0',
    hasSeatReserved: 'Y'
    }
opendataConcordiaU commented 1 year ago

I will relay these questions to the data owners to see if if the know what is this about. Maybe they'll have an explanation or a fix for it.

volovikariel commented 1 year ago

@opendataConcordiaU Any update? Just checking in~

lib-development-concordiaU commented 1 year ago

I'm sorry ... I haven't heard back from the team in charge of this. I will ask again

volovikariel commented 5 months ago

Any updates? ><

opendataConcordiaU commented 5 months ago

ohh .. the last new message that I got was that the enrolment issue was resolved. I assumed this was fine. Is still a happening ?

volovikariel commented 5 months ago

Point 4 and 5 seem to be resolved - thank you :partying_face: Points 1, 2 and 3 points are still present