IPASIService2017SubmitStudentIdentificationInformation Method Provincial Approach to Student Information API
This service will allow the modification of a Student's legal name and/or birth date while capturing the information about the documentation that supports the name and birth date.

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

SubmitResponse SubmitStudentIdentificationInformation(
	SubmitStudentIdentificationInformationRequest request
)

Parameters

request
Type: PASI.DataContract.V2017SubmitStudentIdentificationInformationRequest
This object will contain information about a student's identity (legal name and birth date and gender) as well as information about the documentation that supports that claim (i.e. current system value, parental declaration, birth certificate, etc). In the case where the document is a government issued document additional information can be captured. This can be useful in confirming the student's identity if the same document is presented in the future for identity

Return Value

Type: SubmitResponse
The Id returned in this service will be the RefId of the Student Identification Info. If a Student Identification Info 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, 9011, 9014, 9023, 9065, 11203, 11204, 11206, 11207, 11208, 11210, 11217, 11219, 11220, 11221, 11222, 11223, 11224, 11225, 11231, 11233, 11235, 11406, 11407, 11502, 12006
Remarks

The types supported in the DocumentationType property can be broken down into three categories:

Verified

The information provided originated on a document issued by a recognized government organization. An example of a Verified document type is a birth certificate which is a government issued document where the name and birth date can be confirmed.

Self Verified

The information provided originated on a document signed by the student and/or the student's parent/guardian. An example of a self verified document type would be Parental Declaration.

Unverified

The information provided did not originate from any form of documentation. This could be for data that previously existed in a Student Information System that the source cannot be confirmed.

When calling the SubmitStudentIdentity service the caller cannot replace a verified document type with anything other than another verified documentation type. For example: if there is currently a birth certificate captured for student "John Doe" they cannot try to change their legal name with a Parental Declaration to "Johnny Doe". It is probable in this case that what should happen is an alias be created (using SubmitStudentAlias) for this student which would not affect their legal name.

Corrections can still be provided for StudentIdentificationInfo object using this service. A name that was entered incorrectly from a birth certificate can be "corrected" by using the RefId property of the StudentIdentificationInfo object to specify which object should be updated.

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
IsPreferredBooleanNo
StateProvinceIdStringYesValue must be in the form of a number between '000000001' and '999999999'
StudentIdentityStudentIdentityInfoYes
StudentIdentity.BirthDateDateTimeYes
StudentIdentity.DocumentIssueDateDateTimeNo
StudentIdentity.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]
StudentIdentity.DocumentTypeStringYesValue must be an appropriate SourceDocumentType code value
StudentIdentity.FirstNameStringYesValue must be no more than 50 characters Value must only contain letters (A-Z), hyphens (-), apostrophes ('), periods (.), spaces ( ), or accented letters (ÀÁÂÃÄÅÇÈÉÊËÌÍÎÏÑÒÓÔÕÖÙÚÛÜÝàáâãäåçèéêëìíîïñòóôõöùúûüýÿ)
StudentIdentity.IsNameExactBooleanYes
StudentIdentity.LastNameStringYesValue must be no more than 50 characters Value must only contain letters (A-Z), hyphens (-), apostrophes ('), periods (.), spaces ( ), or accented letters (ÀÁÂÃÄÅÇÈÉÊËÌÍÎÏÑÒÓÔÕÖÙÚÛÜÝàáâãäåçèéêëìíîïñòóôõöùúûüýÿ)
StudentIdentity.MiddleNameStringNoValue must be no more than 50 characters Value must only contain letters (A-Z), hyphens (-), apostrophes ('), periods (.), spaces ( ), or accented letters (ÀÁÂÃÄÅÇÈÉÊËÌÍÎÏÑÒÓÔÕÖÙÚÛÜÝàáâãäåçèéêëìíîïñòóôõöùúûüýÿ)
StudentIdentity.SuffixStringNoValue must be no more than 15 characters Value must only contain letters (A-Z), hyphens (-), apostrophes ('), periods (.), spaces ( ), or accented letters (ÀÁÂÃÄÅÇÈÉÊËÌÍÎÏÑÒÓÔÕÖÙÚÛÜÝàáâãäåçèéêëìíîïñòóôõöùúûüýÿ)
StudentPASICoreVersionInt64Yes


Response Fields

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

Reference