This service is used to manage a Student Email for a Student in PASI Core. This service can be used to perform the following actions:

• Add a new email address
• Update an existing email address
• Delete an existing email address

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

The following Student Email information is provided when using this service (* denotes mandatory information):

• Alberta Student Number*
• Reference ID* - Zero (0) when adding a new email address to the ASN
• Email Address*
• Is Active*

In addition:

• Delete Email Address* can be used to indicate that the email address should be deleted

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

• Rule 9002 - Invalid ASN
• Rule 9006 - Invalid Reference ID
• Rule 9066 - Organization Not Associated to Student
• Rule 9011 - Secondary ASN
• Rule 9014 - PASI Core Out of Date
• Rule 9023 - Empty Update
• Rule 11601 - Duplicate Email Address
• Rule 11608 - Invalid E-mail Address

This service will provide the following functions based on the request and what information exists in PASI.

Add – When an email address, ASN, and zero (0) reference ID and the ASN email address combination does not exist a new email address record is created for the ASN.

• If the email address is already being used by another student in an undeleted PED self-connection (‘Active’, ‘Student Hold’, or ‘Suspended’):
  • use rule 11608 to reject the new email address
• If there are other student(s) sharing the active email address in PASI and none of the email(s) are being used in an undeleted PED self-connection (‘Active’, ‘Student Hold’, or ‘Suspended’).:
  • set all of the active email address (IsInvalid flags = ‘Yes’) (including the IsInvalid flag for the new email address)

Update – When the email reference ID has been included in the request

• If the email address is already being used by another student in an undeleted PED self-connection (“Active”, “Student Hold”, or “Suspended”).:
  • use Rule 11608 - Invalid E-mail Address to reject the updated email address
• If there are other student(s) in PASI sharing the updated email address and none of the email(s) are being used in an undeleted PED self-connection (“Active”, “Student Hold”, or “Suspended”).:
  • set all of the active email address (IsInvalid flags = ‘Yes’) (including the IsInvalid? flag for the updated email address) in PASI
• If there was only one student sharing the previous email address (the email address before the update):
  • set the active email address (IsInvalid flag = ‘No’) for that email address (Note: if there was more than one student sharing that email at the time of the update then the IsInvalid flags should remain ‘Yes’).
    
    

Delete – When the delete email address indicator is true

• If there is one other student with that same email address:
  • set the active email address (IsInvalid flag = ‘No’) (Note: if there was more than one student sharing that email then the IsInvalid flags should remain ‘Yes’).
    

Note: When an email address is deleted the email reference ID is no longer valid for the student; therefore, if an update is attempted for the deleted record, validation rule 9006 should be returned.

When a Student Email record is added, updated, or deleted, a Student Status Processor Trigger is created to trigger recalculation of the Validation Status for the Student.

Anytime the IsInvalid flag is updated, the student status processor is triggered for those student(s) to reassess work item Rule 11607 - Invalid E-mail Address.

A successful response to this service will include:

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