SIMS 7 - TPExamsRead

TPExamsRead.GetXmlExamSeasons()

This interface gets all the Exam Seasons as set in the SIMS Examinations Organiser Module.

 Sample code and output for this interface is shown below:

TPExamsRead examRead = new TPExamsRead();
string testdata = examRead.GetXmlExamsSeason();

<?xml version="1.0" encoding="iso-8859-1" standalone="yes"?>
<ExamSeasons>
  <ExamSeason>
    <SeasonID>1</SeasonID>
    <SeasonName>November Exams 2003</SeasonName>
    <EventInstanceId>8908</EventInstanceId>
    <CalendarYear>2003</CalendarYear>
    <SeasonStatus>L</SeasonStatus>
    <DefaultSeason>F</DefaultSeason>
    <ResultSetID>4</ResultSetID>
    <CategoryID>11</CategoryID>
    <InternalCandidateGroupID>1940</InternalCandidateGroupID>
    <ExternalCandidateGroupID>1941</ExternalCandidateGroupID>
    <SeasonCandidateGroup>1942</SeasonCandidateGroup>
    <SeasonStart>2003-11-01T00:00:00</SeasonStart>
    <SeasonEnd>2003-11-30T00:00:00</SeasonEnd>
  </ExamSeason>
  <ExamSeason>
    <SeasonID>2</SeasonID>
    <SeasonName>November Exams 2001</SeasonName>
    <EventInstanceId>8909</EventInstanceId>
    <CalendarYear>2001</CalendarYear>
    <SeasonStatus>C</SeasonStatus>
    <DefaultSeason>F</DefaultSeason>
    <ResultSetID>5</ResultSetID>
    <CategoryID>12</CategoryID>
    <InternalCandidateGroupID>1943</InternalCandidateGroupID>
    <ExternalCandidateGroupID>1944</ExternalCandidateGroupID>
    <SeasonCandidateGroup>1945</SeasonCandidateGroup>
    <SeasonStart>2001-11-01T00:00:00</SeasonStart>
    <SeasonEnd>2001-11-30T00:00:00</SeasonEnd>
  </ExamSeason>

TPExamsRead.GetXmlDefaultExamSeason()

This interface gets the default Exam Season as set in the SIMS Examinations Organiser Module.

Sample code and output for this interface is shown below:

TPExamRead examRead = new TPExamRead();
string testdata = examRead.GetXmlDefaultExamSeason();

<?xml version="1.0" encoding="iso-8859-1" standalone="yes"?>
<ExamSeasons>
  <ExamSeason>
    <SeasonID>38</SeasonID>
    <SeasonName>November Exams 2011</SeasonName>
    <EventInstanceId>29271</EventInstanceId>
    <CalendarYear>2011</CalendarYear>
    <SeasonStatus>O</SeasonStatus>
    <DefaultSeason>T</DefaultSeason>
    <ResultSetID>90</ResultSetID>
    <CategoryID>233</CategoryID>
    <InternalCandidateGroupID>6463</InternalCandidateGroupID>
    <ExternalCandidateGroupID>6464</ExternalCandidateGroupID>
    <SeasonCandidateGroup>6465</SeasonCandidateGroup>
    <SeasonStart>2011-11-01T00:00:00</SeasonStart>
    <SeasonEnd>2011-11-30T00:00:00</SeasonEnd>
  </ExamSeason>
</ExamSeasons>

TPExamsRead.GetXmlExamTimetable(int personID, int seasonID)

This interface returns the Exam timetable for a student for a specific season.

Sample code and output for this interface is shown below:

TPExamRead examRead = new TPExamRead();
string testdata = examRead.GetXmlExamTimetable(7388, 10);

<?xml version="1.0" encoding="iso-8859-1" standalone="yes"?>
<ExamTimeTableEntries>
  <ExamTimeTableEntry>
    <SeasonName>June (Summer) Exams 2010</SeasonName>
    <ComponentSittingID>33</ComponentSittingID>
    <ComponentSittingTime> 9:00AM</ComponentSittingTime>
    <ComponentSittingDate>Mon 14 Jun</ComponentSittingDate>
    <BoardAbbreviation>AQA</BoardAbbreviation>
    <Level>GCSE/FC</Level>
    <ElementCode>3031H</ElementCode>
    <ElementTitle>Geography A Tier H</ElementTitle>
    <ComponentCode>3031/1H</ComponentCode>
    <ComponentTitle>Geography A Paper 1 Tier H</ComponentTitle>
    <Duration>1h 45m</Duration>
    <Room>Main Hall</Room>
    <Seat />
    <ExamNumber>8215</ExamNumber>
    <UCI>159370085128A</UCI>
    <ULN>2415375806</ULN>
    <PersonName>Carpenter, Jerry</PersonName>
    <CurrentYear>13</CurrentYear>
    <CurrentReg>(M)</CurrentReg>
    <SchoolCentreNumber>73159</SchoolCentreNumber>
    <Code />
    <Description />
    <ExamDate>2010-06-14T09:00:00</ExamDate>
    <SpecialConsideration>False</SpecialConsideration>
  </ExamTimeTableEntry>
  <ExamTimeTableEntry>
    <SeasonName>June (Summer) Exams 2010</SeasonName>
    <ComponentSittingID>31</ComponentSittingID>
    <ComponentSittingTime> 1:15PM</ComponentSittingTime>
    <ComponentSittingDate>Fri 11 Jun</ComponentSittingDate>
    <BoardAbbreviation>AQA</BoardAbbreviation>
    <Level>GCSE/FC</Level>
    <ElementCode>3543H</ElementCode>
    <ElementTitle>D &amp; T: Graphic Products Tier H</ElementTitle>
    <ComponentCode>3543/H</ComponentCode>
    <ComponentTitle>D &amp; T: Graphic Products Paper H</ComponentTitle>
    <Duration>2h 00m</Duration>
    <Room>English Room 1</Room>
    <Seat />
    <ExamNumber>8215</ExamNumber>
    <UCI>159370085128A</UCI>
    <ULN>2415375806</ULN>
    <PersonName> Carpenter, Jerry</PersonName>
    <CurrentYear>13</CurrentYear>
    <CurrentReg>(M)</CurrentReg>
    <SchoolCentreNumber>73159</SchoolCentreNumber>
    <Code />
    <Description />
    <ExamDate>2010-06-11T13:15:00</ExamDate>
    <SpecialConsideration>False</SpecialConsideration>
  </ExamTimeTableEntry>

TPAttendanceRead.GetXmlAbsentStudentsForRegGroups(int regGroupID, DateTime effectiveDate)

This interface gets all the students for the supplied Registration Group for the supplied date. If a 0 regGroupID is passed in, then all student absences will be returned for the supplied effectiveDate.

Sample code and output for this interface is shown below:

TPAttendanceRead attendanceRead = new TPAttendanceRead();
string testdata = attendanceRead.GetXmlAbsentStudentsForRegGroups(457, DateTime.Parse("2014-03-11"));

  <?xml version="1.0" encoding="iso-8859-1" standalone="yes" ?> 
  <AbsentStudentSessions>
  <AbsentStudentSession>
  <StudentID>8989</StudentID> 
  <FirstName>Rebecca</FirstName> 
  <LastName>Cantabrigian</LastName> 
  <BaseGroupID>457</BaseGroupID> 
  <GroupName>8E</GroupName> 
  <Session>AM</Session> 
  <Mark>I</Mark> 
  </AbsentStudentSession>
  <AbsentStudentSession>
  <StudentID>8989</StudentID> 
  <FirstName>Rebecca</FirstName> 
  <LastName>Cantabrigian</LastName> 
  <BaseGroupID>457</BaseGroupID> 
  <GroupName>8E</GroupName> 
  <Session>PM</Session> 
  <Mark>I</Mark> 
  </AbsentStudentSession>
  <AbsentStudentSession>
  <StudentID>9256</StudentID> 
  <FirstName>Joe</FirstName> 
  <LastName>Agathocleous</LastName> 
  <BaseGroupID>457</BaseGroupID> 
  <GroupName>8E</GroupName> 
  <Session>AM</Session> 
  <Mark>I</Mark> 
  </AbsentStudentSession>