Table of Contents
Official Mark myPass Sign-Up Processor
The Official Mark myPass Sign-up processor is a background PASI process for students who have an official mark and have not already signed up for myPass access. This process runs once a day upon restart of the system.
Note: This background processor uses a Primary Node Processor rather than the task runner. The class name for this is “OMSignupLetterProcess”.
Processing Logic
The processing logic is as follows:
- Do Nothing, if the student already has a ‘Self’ myPass Connection as the student already has access to myPass.
- If the student does not have an ‘Self’ myPass connection, but has an active email address in PASI, then send myPass OM Signup Email to the student.
- If the student does not have an active email address in PASI, then send the OM signup letter PDF to the active mailing address in PASI for the student.
- If a letter is being sent this will generate document orders of document type ‘ExpressSignup’ using the Construct Document Order (System Service) PASI Core service.
Information Consumed
This background process uses the following information:
- selected marks from the official mark
Processing Rules
Once a day the background processor runs this process to create document orders/document order items of type ‘ExpressSignup (Document Type)’. This process runs upon startup of PASI Core. PASI Core is restarted every morning, hence this background process runs daily after startup.
The timeframe of each run is not handled through a configuration element, but is a feature of the framework that is used to run background processes. The background processor completes the following steps.
Gather a list of students with Official Mark records where:
- The Official Mark has a selected mark with the 'Last Updated UTC' in the last 30 days,
From these students, exclude students that have one or more of the following:
- Are under 13 years of age. Students under 13 years of age are not permitted to access their information via myPass.
- Have previously received a om_mypass_signup_letter_pdf
- Have previously received a om_mypass_signup_email
- Already have a student connection with a relationship type of “Self” and a status of “Student Hold”, “Active”, or “Suspended”.
- Do not have a Current Mailing Address.
- Only have school enrolment(s) in blacklisted authorities (see section Blacklisted Authorities) for the school year of the added/modified selected exam mark. Deleted school enrollments are ignored in this check.
Note: Do not exclude students that attended a blacklisted authority and a non-blacklisted authority in the same school year as the selected mark.
Students who meet the above requirements and have not been excluded will receive:
- A myPass OM Signup Email if they have an active email address,
- A myPASS OM Signup Letter (PDF) if they do not have an active email address.
- The background processor will use Construct Document Order (System Service) to create Document Orders and Document Order Items for theses students. Refer here for information on the document order and document order items that are created.
Blacklisted Authorities
See Express Letter Authority Blacklist for the full list of authorities that have been blacklisted from having the letter generated for their students.
Background Process Unsuccessful
Where this background process is unsuccessful, it will be retried on the next application restart.
No notification is provided when the background process fails, however this information is visible on the health page that PASI support monitors if something goes wrong.
Information Produced
For each student selected to receive a DER Signup Letter (PDF), a Document Order and a Document Order Item will be produced.
Document Order
The following information, found in values column will be provided when creating a Document Order for each student. If not mentioned, optional fields on the service request shall take the default value as defined by the PASI core service.
| Document Order Request Properties | Optionality | DERSignup Order Values |
|---|---|---|
| Created By Source System | Mandatory | ”PASI Core” |
| Request Method | Mandatory | ”Not Applicable” |
| Order Requestor By | Optional | “Alberta Education” |
| Placed By Education Account | Optional | NULL |
| Organization of Education Account | Optional | NULL |
| Order Placed Date/Time | Optional | Current Date and Time |
| Status | Mandatory | Ordered |
| Payment Transaction ID | Conditional | NULL |
| Payment Method | Conditional | NULL |
| Is Deleted | Mandatory | False |
Document Order Item
One Document Order Item will be created for the Document Order above containing the following:
| Document Order Item Data Element | Optionality | DERSignup Order Item Values |
|---|---|---|
| Student ASN | Mandatory | Student ASN identified in #1 |
| Document Type | Mandatory | ExpressSignup (Document Type) |
| Amount Collected | Mandatory | 0 |
| Control Schedule Identifier | Optional | NULL |
| Delivery Method | Mandatory | AutomatedMail (Document Delivery Method) |
| Language | Mandatory | English |
| Number of Copies | Mandatory | 1 |
| Recipient Is Student | Mandatory | True |
| Recipient Name | Mandatory | Preferred Name of the Student Max 60 chars Refer to PASI Data Format Guidelines for format guidelines. |
| Recipient Address Lines, Recipient Address City Name, Recipient Address State/Province, Recipient Address Postal/ZIP Code AND Recipient Country Name | Conditional | Current Mailing Address for the student is used.
|
| Recipient City* | Conditional | This element shall take the City component of the student’s mailing address. Max 60 chars |
| Recipient Province/State* | Conditional | If mailing address is found, this element shall take the Province/State component. Max 20 chars |
| Recipient Postal Code/Zip* | Conditional | If mailing address is found, this element shall take the Postal Code/Zip component. Max 15 chars |
| Recipient Country* | Conditional | If mailing address is found, this element shall take the Country component. Max 60 chars |
| Recipient Fax Number | Conditional | NULL |
| Re-Order Of Document Order Item | Conditional | NULL |
| Re-Order Reason | Conditional | NULL |
* Use the active preferred mailing address on the student. If none, then use the most recently changed student address that is still active.
Signup Access Code
One Access Code (Signup Code) for the Document Order and Document Order Item above containing the following:
| Access Code Data Element | Values |
|---|---|
| Student (Signup Code) | Student ASN identified in #1 |
| Access Code (Signup Code) | Unique Access Code This is the Access Code used to complete the myPass Connection in myPass. The format of the access code is an eight digit alpha-numeric, mixed case code. |
| Expiry Date (Signup Code) | DocumentOrder.OrderPlacedDate + Expiry Period from configuration file Initially, this date is set while processing the signup orders based on Document Order Created Date and PASI configuration value for DER Signup Expiry Period. This will take the value of Document Order Created Date + Expiry Period from configuration file. After a certain number of unsuccessful attempts with this access code, myPass signup process will expire the Access Code. It will also be expired when the signup process is successfully completed or if there is another Student Connection found while completing the sign up process using this access code. |
Configuration File
PASI configuration file includes a configuration value for Signup Access Code expiration (DerSignupAccessCodeExpiryDays) This value is a configurable value and it is initially has been set to 60 days.