myPass Signup Letter processor is a background PASI process for those students have had certain interactions with diploma exams and have not already signed up for myPass access.
Currently, 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 “DerSignupLetterProcess”.
The Processing Logic on this Background Processor is as follows:
This background process uses the following information to do its processing:
Once a day the background processor will run this process to create document orders/document order items of type ‘ExpressSignup (Document Type)’. This runs once upon startup of PASI. PASI Core is currently restarted every morning and therefore this background process gets run daily as a result of that. 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:
Gather a list of students with Exam Marks records that:
From these students, exclude students with one or more of the following:
Students those who met the above requirements and have not been excluded will receive:
See Express Letter Authority Blacklist for the full list of authorities that have been blacklisted from having the letter generated for their students.
Where this background process is unsuccessful, it will be retried on the next application restart.
No notification is provided where the background process fails, however this information is visible on the health page that PASI support monitors if something goes wrong.
For each student selected to receive a DER Signup Letter (PDF), a Document Order and a Document Order Item will be produced.
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|
|Payment Transaction ID||Conditional||NULL|
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)|
|Control Schedule Identifier||Optional||NULL|
|Delivery Method||Mandatory||AutomatedMail (Document Delivery Method)|
|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|
* Use the active preferred mailing address on the student. If none, then use the most recently changed student address that is still active.
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.
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.