SIMS 7 - TPAssessment

TPAssessment.GetXmlAssessmentResults(int personId,DateTime startDate,DateTime endDate)

This interface gets the Assessment results of a personId [student] passed as input valid within the date range supplied. Sample code and output for this interface is shown below

TPAssessment assessmentInfo = new TPAssessment();
string data = assessmentInfo.GetXmlAssessmentResults(3998,DateTime.Parse("08/07/2009"),DateTime.Parse("20/07/2009"));

<?xml version="1.0" encoding="iso-8859-1" standalone="yes"?>
<Results>
  <Result>
    <PersonID>3998</PersonID>
    <Assessment>GCSE Maths Combined</Assessment>
    <Description />
    <Result>A</Result>
    <Notes />
    <DateAchieved>2009-07-09T00:00:00</DateAchieved>
    <isDataEntryCompleted>T</isDataEntryCompleted>
  </Result>
</Results>

TPAssessment.GetXmlAssessmentResultsExtended (int personId,DateTime startDate,DateTime endDate)

This interface gets the Assessment results of a personId [student] passed as input valid within the date range supplied. It is an extended version of GetXmlAssesmentResults and gets extra fields as below:

• DateAchieved – This will map to the date when results were collected or entered into SIMS system
• ResultDate – This will map to the date when the results were taken.
• OperatorID – This will be personId of the person who has entered the results into SIMS system
• OwnerID – This will be personId of the person who owns the results.

Sample code and output for this interface is shown below

string filePath = @"D:\Partner Support\resultset\ResultSets.xml";

StreamReader streamReader = new StreamReader(filePath, Encoding.UTF8);
string text = streamReader.ReadToEnd();
streamReader.Close();

SIMS.Processes.TPAssessment tpAssessment = new SIMS.Processes.TPAssessment();
tpAssessment.SetResultsetGuids(text);

<?xml version="1.0" encoding="iso-8859-1" standalone="yes"?>
<Results>
  <Result>
    <PersonID>3998</PersonID>
    <Assessment>GCSE Maths Combined</Assessment>
    <Description />
    <Result>A</Result>
    <Notes />
    <DateAchieved>2009-08-09T00:00:00</DateAchieved>
    <ResultDate >2009-06-25T00:00:00</ResultDate >
   <OperatorID>2</OperatorID>
   <OwnerID>26</OwnerID>
    <isDataEntryCompleted>T</isDataEntryCompleted>
  </Result>
</Results>

TPAssessment.SetResultsetGuids(string mappingTableXml)

This interface has been introduced in the 2013 Autumn Release.  It allows the Guids to be set to a known value for partners to have subsequent access to the results import api.

Here is an example of the input xml

<MappingTable>
<Supplier>As_Agency_Name</Supplier>
<Mappings>
<Map>
<ExternalID>uniquecode_001</ExternalID>
<Guid>5A961E1C-308B-48A6-9FE2-5A46939B1E45</Guid>
</Map>
<Map>
<ExternalID>uniquecode_002</ExternalID>
<Guid>77BB03D0-1FF1-4A74-AD2C-BDF99B063239</Guid>
</Map>
<Map>
<ExternalID>uniquecode_003</ExternalID>
<Guid>62CAADB1-E9FD-434F-B1E0-DB44B224ED10</Guid>
</Map>
</Mappings>
</MappingTable>