IPASIService2019GetSchoolCalendarYearInformation Method Provincial Approach to Student Information API
This service will retrieve school calendar year information that matches the school calendar keys (school code, school year) provided in the request.

Namespace: PASI.ServiceContract
Assembly: PASI.ServiceContract (in PASI.ServiceContract.dll) Version: 9.23.3.0 (9.23.3.0)
Syntax

List<SchoolCalendarYearInformationResponse> GetSchoolCalendarYearInformation(
	SchoolCalendarYearInformationRequest request
)

Parameters

request
Type: PASI.DataContract.V201204SchoolCalendarYearInformationRequest
An instance of the SchoolCalendarYearInformationRequest data contract.

Return Value

Type: ListSchoolCalendarYearInformationResponse
SchoolCalendarYearInformationResponse class which contains information about the school calendar year on which the school calendar keys had matched on the request.

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.

No additional errors for this service.
Remarks

This service is intended to be used during the data synchronization process using the IsDataAvailable service. See the Expected Versions section for important details on how this service will return data.

This service operation will retrieve SchoolCalendarYearInfoSet objects that match the passed in Id(s) (A combination of school code, school year) provided in the request. The operation returns a list of SchoolCalendarYearInformationResponse data contracts containing the 'Status' and the School Calendar Year Information Set for each requested Id. School Calendar Year information such as Grades Offered, Programs Offered and Instructional Days etc is returned in the response.

The Status property will indicate (for each school calendar requested) whether school calendar year data is available. This property will return a DataAvailabilityStatus.Normal if a school calendar year was found or DataAvailabilityStatus.Unknown if no data was found.

Request and Response Class Diagram



Request Fields

Full Property NameTypeRequiredOther Attributes
CallerInfoCallerInfoYes
CallerInfo.ClientMessageIDStringYesValue 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.SentUtcTimeDateTimeYes
CallerInfo.SoftwareSoftwareYes
CallerInfo.Software.BuildNumberStringYesValue 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.ManufacturerStringYesValue 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.ProductStringYesValue 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.VersionStringYesValue 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.UserUserYes
CallerInfo.User.IPAddressStringYesValue 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.LocalIDStringYesValue 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.NameStringYesValue 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.OrganizationCodeStringYesValue must be no more than 6 characters
SchoolCalendarYearsList<EntityKeyVersionInfo>Yes
SchoolCalendarYears.ExpectedVersionNullable`1No
SchoolCalendarYears.KeyStringYes


Response Fields

Full Property NameTypeRequiredOther Attributes
List<SchoolCalendarYearInformationResponse>List<SchoolCalendarYearInformationResponse>No
List<SchoolCalendarYearInformationResponse>.AvailabilityStatusStringNo
List<SchoolCalendarYearInformationResponse>.CalendarYearInfoSetSchoolCalendarYearInfoSetNo
List<SchoolCalendarYearInformationResponse>.CalendarYearInfoSet.CalendarsList<SchoolCalendarYearInfo>No
List<SchoolCalendarYearInformationResponse>.CalendarYearInfoSet.Calendars.CalendarRefIdGuidYes
List<SchoolCalendarYearInformationResponse>.CalendarYearInfoSet.Calendars.CalendarTypeStringYesValue 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]
List<SchoolCalendarYearInformationResponse>.CalendarYearInfoSet.Calendars.ClosingDateDateTimeYes
List<SchoolCalendarYearInformationResponse>.CalendarYearInfoSet.Calendars.GradesOfferedList<SchoolGradeOffering>No
List<SchoolCalendarYearInformationResponse>.CalendarYearInfoSet.Calendars.GradesOffered.GradeLevelStringYes
List<SchoolCalendarYearInformationResponse>.CalendarYearInfoSet.Calendars.GradesOffered.ProgrammingTypeStringYes
List<SchoolCalendarYearInformationResponse>.CalendarYearInfoSet.Calendars.OpeningDateDateTimeYes
List<SchoolCalendarYearInformationResponse>.CalendarYearInfoSet.Calendars.ProgramsOfferedList<SchoolProgramOffering>No
List<SchoolCalendarYearInformationResponse>.CalendarYearInfoSet.Calendars.ProgramsOffered.ProgramTypeStringYes
List<SchoolCalendarYearInformationResponse>.CalendarYearInfoSet.PasiCoreVersionInt64Yes
List<SchoolCalendarYearInformationResponse>.CalendarYearInfoSet.RefIdStringNo
List<SchoolCalendarYearInformationResponse>.CalendarYearInfoSet.SchoolCodeStringYesValue must be in the form of a number between '0001' and '9999'
List<SchoolCalendarYearInformationResponse>.CalendarYearInfoSet.SchoolYearInt16YesValue must be between 1900 and 2100
List<SchoolCalendarYearInformationResponse>.CalendarYearInfoSet.SourceVersionInt64Yes
See Also

Reference