ps-emails

ps-emails is a worker that scrapes these student emails. The regular ps worker posts a ps_email worker on completion.

The ps_emails worker requires "Full" permission to the /admin/importexport/exportstudents.html page.

Note: PowerSchool 7+ systems contain a school-editable email field which is not exportable via DDE.

Deployment

Deploy with ark.

ark start ps-emails -e production

Testing

Manually verifying if ps-emails will work for a district

1. Go to <district_url>/admin to log in
2. Go to <district_url>/admin/students/home.html?selectstudent=
3. Go to <district_url>/admin/importexport/exportstudents.html and then verify that we can click "Submit" to begin exporting.
4. The exported file should be a file of the field used for SIS ID and DCID which we then iterate over to download each user's email.

Development

Install Dependencies

npm install

Running locally

SYSTEM_ID=<system_id> DISTRICT_ID=<district_id> ark start -l -e clever-dev

Known Issue

For some ps systems running ps-emails locally fails with the error "pskey-missing". Use a worker in AWS to sync instead i.e., submit a job to ps_emails in clever-dev or production. If you want to debug something on a local machine pick a different system id.

Symptom:

[ps-emails]  {"title":"pskey-missing","level":"error","source":"ps-emails","system_id":"51f85b9f660107c928000010","district_id":"51f85b9f660107c92800000b","ps_version":"10.0.2"}
[ps-emails]  {"title":"user-error","err":"Our worker is being blocked","level":"info","source":"ps-emails","system_id":"51f85b9f660107c928000010","district_id":"51f85b9f660107c92800000b","ps_version":"10.0.2"}