IPASIService2019SubmitSchoolCalendarYear Method Provincial Approach to Student Information API
Ministry only service. This service will allow the Ministry Client to update School Calendar Year information in the PASI Core.

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

SubmitResponse SubmitSchoolCalendarYear(
	SubmitSchoolCalendarYearRequest request
)

Parameters

request
Type: PASI.DataContract.V2009SubmitSchoolCalendarYearRequest
One of the properties of the School Calendar Year Information data contract is its school code. In order for PASI to accept a school calendar year it must know about the school before submitting the school calendar year. If a school code is not found an exception will be throw on submission and the record will not be saved.

Return Value

Type: SubmitResponse
On a successful submission contains the updated PASICoreVersion number for the submitted school. If it was unsuccessful there will be one or more errors attached and the PASICoreVersion will be zero.
The Id in this case will return the SchoolCalendarYearInfoSet RefId (which is SchoolCode, SchoolYear)

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.

9003
Remarks

This service operation will allow the Ministry Client to update or add a school calendar year record in PASI core which is one or more calendars differing on calendar type. If PASI does not currently have a school calendar year with the school code and school year passed in it will treat this as a new school calendar year record and add it to PASI core. If PASI core does have the passed in school code and school year it will be treated as an update and all PASI's information on the school calendar year in question will be completely replaced with the information passed in.

Request and Response Class Diagram



Request Fields

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


Response Fields

Full Property NameTypeRequiredOther Attributes
SubmitResponse.IdStringNo
SubmitResponse.PASICoreVersionInt64No
SubmitResponse.RejectionsList<Rejection>No
SubmitResponse.Rejections.CodeStringYes
SubmitResponse.Rejections.DescriptionStringYes
See Also

Reference