IPASIService2017SubmitSchoolInformation Method Provincial Approach to Student Information API
This service will allow the Ministry Client to update School 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 SubmitSchoolInformation(
	SubmitSchoolInformationRequest request
)

Parameters

request
Type: PASI.DataContract.V2017SubmitSchoolInformationRequest
The school information record to be updated/added containing names, addresses, contact information, etc. Addresses, Classfications, Name, and SchoolAuthorityCode lists should contain historical records as well. For example if the school has changed its name once it is expected that two name records would be sent to PASI core. This is required because it is a full record replacement. If PASI Core doesn't receive the history it is unable to provide it to clients.

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 returned on the SubmitResponse in this case will be the School Code.

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.

9004
Remarks

This service operation will allow the Ministry client to update or add a school record in PASI core. If PASI does not currently have a school with the school code passed in it will treat this as a new school and add it to PASI core. If PASI core does have the passed in school code it will be treated as an updated and all PASI's information on the school in question will be completely replaced with the information passed in.

The PasiCoreVersion must be passed in with the version being updated. If the passed in version does not match the current version in the PASI core an exception will be throw indicating they are out of sync, which is a signal to the client to get the latest (using GetSchoolInformation) and try the submission again if required.

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
SchoolSchoolInformationYes
School.AddressesList<Address>No
School.Addresses.AddressTypeStringYesValue must be an appropriate AddressType code value
School.Addresses.CityStringNoValue must be no more than 60 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]
School.Addresses.CountryStringYesValue must be no more than 60 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]
School.Addresses.EffectiveDateDateTimeYes
School.Addresses.ExpiryDateDateTimeNo
School.Addresses.LastUpdateUtcTimeDateTimeNo
School.Addresses.PostalCodeStringNoValue must be no more than 15 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]
School.Addresses.RefIdInt32Yes
School.Addresses.StateProvinceStringNoValue must be no more than 20 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]
School.Addresses.StreetStringYesValue must be no more than 140 characters Value must not have control characters, leading, trailing or multiple embedded spaces. Value must not contain empty lines and each line must be delimited with a carriage return and line feed. Content must not match regular expression: [\x00-\x08]|[\x0E-\x19]|[\x7F-\x9F]|[^\x00-\xFF]|(^|\n)\s*\r|\n\s*(\r|$)|[^\r]\n|\r[^\n]
School.ClassificationsList<SchoolClassification>No
School.Classifications.ClassificationTypeStringYesValue must be an appropriate SchoolClassificationType code value
School.Classifications.EffectiveDateDateTimeYes
School.Classifications.IsActiveBooleanYes
School.CodeStringYesValue must be in the form of a number between '0001' and '9999'
School.EmailAddressStringNo
School.FaxNumberStringNo
School.NameList<OrganizationName>Yes
School.Name.EffectiveDateDateTimeYes
School.Name.NameStringYes
School.PasiCoreVersionInt64Yes
School.PhoneNumberStringNo
School.SchoolAuthorityCodeList<SchoolAuthorityCodeInfo>Yes
School.SchoolAuthorityCode.AuthorityCodeStringYesValue must be in the form of a number between '0001' and '9999'
School.SchoolAuthorityCode.EffectiveDateDateTimeYes
School.SourceVersionInt64Yes
School.StatusList<OrganizationStatus>Yes
School.Status.EffectiveDateDateTimeYes
School.Status.IsActiveBooleanYes


Response Fields

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

Reference