IPASIService2020SubmitPhoneNumber Method Provincial Approach to Student Information API
This service is used to submit (add, correct, delete) a phone number for a student.

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

SubmitResponse SubmitPhoneNumber(
	SubmitPhoneNumberRequest request
)

Parameters

request
Type: PASI.DataContract.V2018SubmitPhoneNumberRequest
Contains the new phone number to attach to a student and the PhoneNumberId that should be corrected if that is the intention

Return Value

Type: SubmitResponse
The Id returned in this service will be the RefId of the phone number. If an additional phone number could not be added the Id will be returned as zero. The PASICoreVersion is the new version for the student.

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.

9002, 9006, 9010, 9011, 9078, 11251, 11252, 11253, 11254, 11255, 11256, 11257, 11261
Remarks

This service will add a phone number to a student. If the intention is to correct a phone number that was entered incorrectly originally, the RefId property on the PhoneNumber should be set to the appropriate Id which will update the existing phone number instead of creating a new one.

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
DeletePhoneNumberBooleanYes
ExpireCurrentBooleanNo
IsPreferredBooleanNo
PASICoreVersionInt64Yes
PhoneNumberPhoneNumberYes
PhoneNumber.EffectiveDateDateTimeYes
PhoneNumber.ExpiryDateDateTimeNo
PhoneNumber.ExtensionStringNoValue must be no more than 7 characters
PhoneNumber.IsListableStringYesValue must be one of (Y, N, U)
PhoneNumber.LastUpdateUtcTimeDateTimeNo
PhoneNumber.NumberStringYesValue must be no more than 16 characters
PhoneNumber.RefIdInt32Yes
PhoneNumber.TypeStringYesValue must be an appropriate PhoneType code value
SourceChangeCodeInt16No
StateProvinceIdStringYesValue must be in the form of a number between '000000001' and '999999999'


Response Fields

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

Reference