Submit Identification Information

Note: Prior to the 2018 endpoint, this service was referred to as Submit Student Identification Information.

An Identification Record is used to outline the Legal Student Name, Birth Date, and the Source of this information for a Student in PASI. This service is used to manage Student Identification Information in the PASI Core. This service can be used to:

  • Update the existing Student Identification Information

The Student Identification object will contain information about a student's identity (legal name and birth date) 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.

Security

The service can be accessed by systems with the Submit Student User role.

Request Information

The request identifies if a create, update, or delete should be performed for provided Student Identification Information.

The following information is provided when using this service:

Request Validations

The following rules are used to validate the information provided in the request:

Service Functionality

Once the information is successfully validated, the information will be recorded within the PASI Core.

If a Reference Id has not been provided, then one of the following conditions applies when it comes to updating name records:

#Name UpdateSource Document UpdatedDetails
1 Y Y

The user is attempting to add a new legal name for the student:

  1. The name that was previously identified as the legal name is left as is.
  2. PASI will look to see if the submitted name exists already on the student (deleted or not) with matching name parts (first name, middle name, last name, and suffix). If there is then that name’s RefId will be returned (and undeleted if it was deleted with name audit).
  3. If the submitted name does not exist on the student already, then the submitted name is added and the name on the student’s current identity is updated to be the new name.
2 Y N

The user is attempting to update the legal name for the student. PASI will look to see if the submitted name exists already on the student (deleted or not) with matching name parts:

  1. If the submitted name already exists on the student, then the following will happen:
    1. If the already existing name is the preferred name, then the current identity name will become the preferred name.
    2. The already existing name will be marked as deleted.
    3. The student’s identity name will be updated with the submitted name.
  2. If the submitted name does not already exist on the student, then the name is updated.
3 N Y The user is attempting to correct source document information only. No changes to the names will occur.

If the service is being used on an endpoint older than IPASIService2018 and a Reference Id has been provided, the Student Document Reference ID within the student identity table may be updated to reflect the linked to Student Document.

Health Version Updates

The PASI Core Version (Student Health Version) for the student will be updated when one of the following data elements is updated by using this service:

Note: If the update changes which name record is identified as the ‘legal name’ or the name record that is identified as the ‘preferred name’ then also update the health Version

Elections Alberta Triggers

An Elections Alberta Trigger will be created/updated when:

Responsible School Processor Trigger

When the Birth Date associated to a Primary ASN is updated, a Responsible School Processor Trigger record is created:

Status Processor Triggers

When a Student Identity record is added to a Primary ASN, the following Status Processor Triggers are created:

When the Document Type or Birth Date associated to a Primary ASN is updated, the following Status Processor Triggers are created:

For all other Student Identity updates, the following Status Processor Triggers are created:

When a change to the student's Birth Date results in a change to the student's Maturity Date, a Course Enrolment Status Processor Trigger will be created for any of the student's Course Enrolment records with a Course Enrolment Start Date that is between the old and the new maturity date.

myPass Connections updates

If the Birth Date is updated, then:

Updates to the Information Disclosure Restrictions

Scheduled Student Record Disposal Date

This service will recalculate the Scheduled Student Record Disposal Date based on an updated birth date. If the current Scheduled Student Record Disposal Date is different than the newly calculated date, the Scheduled Student Record Disposal Date on the student's record will be updated.

Auditing

The usage of this service is audited using Service Auditing including the auditing of Caller Information.

Since this service can modify the student identification and/or the names on the student the service will need to generate the appropriate audit events:

Response Information

A response to a Submit Identification Information request identifies if the request was successfully applied. If not successful, the response identifies which validation rules failed.

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

The following information is returned after a successful request has been processed: