This service will return the Evaluated Mark Status objects based on the Evaluated Mark Id(s) passed in.
Namespace: PASI.ServiceContract
Assembly: PASI.ServiceContract (in PASI.ServiceContract.dll) Version: 9.23.3.0 (9.23.3.0)
Syntax
List<EvaluatedMarkStatusResponse> GetEvaluatedMarkStatus( EvaluatedMarkStatusRequest request )
Parameters
- request
- Type: PASI.DataContract.V201204EvaluatedMarkStatusRequest
The request contains a list of Evaluated Mark Id (GUID) and a list of Evaluated Mark version numbers the client is aware of (not Evaluated Mark Status version).
Return Value
Type: ListEvaluatedMarkStatusResponseA list of EvaluatedMarkStatusResponse object. Each response object may contain one or more CoreAlerts, the source Evaluated Mark version number that created this status, and the source Evaluated Mark object itself. Each CoreAlert represents a piece of Evaluated Mark information that may need correction. For more information on CoreAlerts see the overview section here.
Service Validations
The following codes can be returned from the service operation. This list also shows core alerts that could be generated as a result calling this service. These codes are in addition to the standard set of codes that can be returned defined as in the Approach to Error Reporting. Click the link for the details.
40303, 40305, 40306, 40315, 40316, 40317, 40319, 40320, 40326, 40330, 40332, 40333, 40334, 40337, 40338, 40343, 40345, 40348, 40354, 40355, 40357, 40358, 40359, 40361, 40362, 40366, 40371, 40372, 40383, 40395Remarks
This service will return one or more EvaluatedMarkStatus objects. These represent the current core alerts attached to each Evaluated Mark record in the PASI core. This information can then be used to create end user work items when data changes are required.
The EvaluatedMarkStatusResponse object will contains the source Evaluated Mark object if the KnownEvaluatedMarkVersion in the request is not equal to the version used to calculate the status (this may result in PASI retrieving the proper version of the Evaluated Mark from the Shadow table). If the KnownEvaluatedMarkVersion is equal to the current version or the current version was not used (KnownEvaluatedMarkVersion is null) to create the current status (Evaluated Mark is newer) than nothing is returned.
The process that generates the Status object in PASI core is asynchronous. This process is initiated by submitting an Evaluated Mark (calling SubmitEvaluatedMark) but the completion is dependent on the number of Evaluated Marks being submitted at the time by all PASI clients. With this in mind the best strategy for obtaining the status object as soon as available is through the use of the IsDataAvailable service. Even if there are no issues with an Evaluated Mark a status object will still be generated.
Since the business rules surrounding an Evaluated Mark are dependent on more than just the information supplied by the Evaluated Mark an Evaluated Mark Status object can change even if the Evaluated Mark doesn't. Below is a list of actions that can trigger an Evaluated Mark Status to be updated in PASI core:
- Evaluated Mark – Submitting an update to the Evaluated Mark
- Student School Enrolment – Any of the submit Student School Enrolment services are called
- SchoolCalendarYear – PASI core receives an update to a calendar from the Ministry
- School – PASI core receives an update to a School from the Ministry
- SchoolAuthority – PASI core receives an update to a School Authority from the Ministry
- Evaluated Mark Status Acknowledgment - By Acknowledging a core alert the status object is regenerated so the version number is increase and it will be synchronized.
Request and Response Class Diagram
Request Fields
| Full Property Name | Type | Required | Other Attributes |
|---|---|---|---|
| CallerInfo | CallerInfo | Yes | |
| CallerInfo.ClientMessageID | String | Yes | Value must be no more than 50 characters Value must not have control characters, leading, trailing or multiple embedded spaces. Content must not match regular expression: ^\s|\s{2,}|\s$|[\x00-\x19]|[\x7F-\x9F]|[^\x00-\xFF] |
| CallerInfo.SentUtcTime | DateTime | Yes | |
| CallerInfo.Software | Software | Yes | |
| CallerInfo.Software.BuildNumber | String | Yes | Value must be no more than 30 characters Value must not have control characters, leading, trailing or multiple embedded spaces. Content must not match regular expression: ^\s|\s{2,}|\s$|[\x00-\x19]|[\x7F-\x9F]|[^\x00-\xFF] |
| CallerInfo.Software.Manufacturer | String | Yes | Value must be no more than 100 characters Value must not have control characters, leading, trailing or multiple embedded spaces. Content must not match regular expression: ^\s|\s{2,}|\s$|[\x00-\x19]|[\x7F-\x9F]|[^\x00-\xFF] |
| CallerInfo.Software.Product | String | Yes | Value must be no more than 100 characters Value must not have control characters, leading, trailing or multiple embedded spaces. Content must not match regular expression: ^\s|\s{2,}|\s$|[\x00-\x19]|[\x7F-\x9F]|[^\x00-\xFF] |
| CallerInfo.Software.Version | String | Yes | Value must be no more than 30 characters Value must not have control characters, leading, trailing or multiple embedded spaces. Content must not match regular expression: ^\s|\s{2,}|\s$|[\x00-\x19]|[\x7F-\x9F]|[^\x00-\xFF] |
| CallerInfo.User | User | Yes | |
| CallerInfo.User.IPAddress | String | Yes | Value must be no more than 50 characters Value must not have control characters, leading, trailing or multiple embedded spaces. Content must not match regular expression: ^\s|\s{2,}|\s$|[\x00-\x19]|[\x7F-\x9F]|[^\x00-\xFF] |
| CallerInfo.User.LocalID | String | Yes | Value must be no more than 50 characters Value must not have control characters, leading, trailing or multiple embedded spaces. Content must not match regular expression: ^\s|\s{2,}|\s$|[\x00-\x19]|[\x7F-\x9F]|[^\x00-\xFF] |
| CallerInfo.User.Name | String | Yes | Value must be no more than 100 characters Value must not have control characters, leading, trailing or multiple embedded spaces. Content must not match regular expression: ^\s|\s{2,}|\s$|[\x00-\x19]|[\x7F-\x9F]|[^\x00-\xFF] |
| CallerInfo.User.OrganizationCode | String | Yes | Value must be no more than 6 characters |
| EvaluatedMarkIds | List<StatusRefIdVersionInfo> | Yes | |
| EvaluatedMarkIds.ExpectedVersion | Nullable`1 | No | |
| EvaluatedMarkIds.KnownSourceVersion | Nullable`1 | No | |
| EvaluatedMarkIds.RefId | Guid | Yes |
Response Fields
See Also