IPASIService2019CreateStudent Method Provincial Approach to Student Information API
This service will create a new student and accept all data related to the student in a single service call. During this service the PASI core will create a State Province Id (Alberta Student Number) for the new student which uniquely identifies a student within the province.

After a student has been created in PASI core the additional services described in this document can be used to modify the student data. This service is only for initial creation.

Namespace: PASI.ServiceContract
Assembly: PASI.ServiceContract (in PASI.ServiceContract.dll) Version: 9.25.26.0 (9.25.26.0)
Syntax
Copy
SubmitResponse CreateStudent(
	CreateStudentRequest request
)

Parameters

request
Type: PASI.DataContract.V2018CreateStudentRequest
This represents the entire request. During student creation the PASI will internal attempt to identify the student with the name and birthday information provided in the StudentIdentificationInfo record. If a high quality match is found the creation will be rejected. If the supplied information is indeed a new student the AcknowledgeSimilarStateProvinceIdList must be populated with all high quality StateProvinceIds found. This is to ensure that a user has verified the student they are creating doesn't exist.

The ExtendedInfo object on the request may contain additional information about a student in future releases. This field is currently not used.

Return Value

Type: SubmitResponse
The Id returned in this service will be the new StateProvinceId for the Student. If a Student could not be created the Id will be returned as zero.

The PASICoreVersion is the new version for the student. This will be zero if the student could not be created.

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.

11203, 11204, 11206, 11207, 11208, 11217, 11219, 11220, 11221, 11222, 11223, 11224, 11225, 11231, 11233, 11401, 11402, 11403, 11404, 11405, 12006
Remarks
If a Identification record and alias name are provided the alias will become the student's preferred name record.

Request and Response Class Diagram



Request Fields

Full Property NameTypeRequiredOther Attributes
AcknowledgeSimilarStateProvinceIdListList<String>No
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
GenderStringYesValue must be an appropriate Gender code value
IdentificationRecordIdentityInfoYes
IdentificationRecord.BirthDateDateTimeYes
IdentificationRecord.DocumentIssueDateDateTimeNo
IdentificationRecord.DocumentNumberStringNoValue must be 4 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]
IdentificationRecord.DocumentTypeStringYesValue must be an appropriate SourceDocumentType code value
IdentificationRecord.FirstNameStringYesValue must be no more than 50 characters Value must only contain letters (A-Z), hyphens (-), apostrophes ('), periods (.), spaces ( ), or accented letters (ÀÁÂÃÄÅÇÈÉÊËÌÍÎÏÑÒÓÔÕÖÙÚÛÜÝàáâãäåçèéêëìíîïñòóôõöùúûüýÿ)
IdentificationRecord.IsNameExactBooleanYes
IdentificationRecord.LastNameStringYesValue must be no more than 50 characters Value must only contain letters (A-Z), hyphens (-), apostrophes ('), periods (.), spaces ( ), or accented letters (ÀÁÂÃÄÅÇÈÉÊËÌÍÎÏÑÒÓÔÕÖÙÚÛÜÝàáâãäåçèéêëìíîïñòóôõöùúûüýÿ)
IdentificationRecord.MiddleNameStringNoValue must be no more than 50 characters Value must only contain letters (A-Z), hyphens (-), apostrophes ('), periods (.), spaces ( ), or accented letters (ÀÁÂÃÄÅÇÈÉÊËÌÍÎÏÑÒÓÔÕÖÙÚÛÜÝàáâãäåçèéêëìíîïñòóôõöùúûüýÿ)
IdentificationRecord.SuffixStringNoValue must be no more than 15 characters Value must only contain letters (A-Z), hyphens (-), apostrophes ('), periods (.), spaces ( ), or accented letters (ÀÁÂÃÄÅÇÈÉÊËÌÍÎÏÑÒÓÔÕÖÙÚÛÜÝàáâãäåçèéêëìíîïñòóôõöùúûüýÿ)


Response Fields

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

Reference

IPASIService2019 Interface
PASI.ServiceContract Namespace