About This File
Objective
This plugin adds an option to consolidate duplicate contacts found when looking at a student's profile.
Disclaimers/Known Issues
-
PowerSchool has some known issues with consolidation and this plugin does not resolve those. If you perform a consolidation using this plugin and the people are not consolidated, that would have happened whether you used this plugin or not. Please do not report bugs for that.
- The only bugs that would be mine to solve are those on the student's Contacts page itself.
- Once you click Consolidate Contacts and are taken to another page, the plugin is not involved anymore.
- No warranties, expressed nor implied, are offered with your use of this plugin. Support is not guaranteed for this plugin. Questions may be posted in the Comments section of this download. Bug reports not listed above should be e-mailed directly to me at allevanc@d91.k12.id.us or you may use the private messaging area of the forum if you prefer.
How to Install the Plugin
You must have PowerSchool 12.0 (or newer) to use this plugin. Contact consolidation was not a part of the system before that.
Feel free to refer to PowerSource article 80644 if you want additional information on installing the plugin. The section of the manual is called Plugin Management.
- Download the plugin and save it somewhere you can find again shortly.
- From the Start page, choose System ► System Settings ► Plugins Management Configuration.
- Click on Install.
- Click Choose File next to Plugin Installation File.
- Browse to the file you downloaded in Step 1 and select it.
- Click Install.
- The plugin was installed successfully. should appear at the top. Check the "enable" box for the D91 Consolidate Contacts at Student.
- Click Enable to complete the installation. You should get Plugin successfully enabled.
How to Update the Plugin
These steps assume that the old plugin is still installed and enabled. If not, the steps may be slightly different.
- Download the plugin and save it somewhere you can find again shortly.
- From the Start page, choose System ► System Settings ► Plugins Management Configuration.
- Locate D91 Consolidate Contacts at Student in the listing, then click on its name.
- Click on Update.
- Click Choose File next to Plugin Installation File.
- Browse to the file you downloaded in Step 1 and select it.
- Click Submit.
- A Loading screen should appear. Depending on how many customizations you have, it may say that for up to 2 minutes.
- When it finishes updating, you may briefly see a green message about the plugin being updated successfully.
- A tray should slide open automatically asking if you want to Enable the new version of the plugin. Choose Enable to complete the upgrade.
How to Use the Plugin
- Search for a student and access their Contacts page.
- A new column of checkboxes is added to the right as well as a new action item, Consolidate Contacts.
- For a given contact, check off all of the duplicates and click Consolidate Contacts.
- If one or more names do not match, a warning appears in case you clicked that by mistake.
- The rest of the consolidation process is handled by PowerSchool's core consolidation process.
How to Uninstall the Plugin
If you're having issues with the current version, please let me know in the comments tab below. If you decide not to keep the plugin, these are the steps to remove it from your system:
- From the Start Page, choose System ► System Settings ► Plugin Management Configuration.
- Find the plugin and click the Delete button on the right.
- Confirm the deletion.
Last, But Not Least
I hope this helps! Please do me a favor and leave a review (in the Review tab below) if you use my plugin and let me know how it worked for you. If you have general questions, feedback, technical issues, or typos with the plugin or its documentation, feel free to use the Comments tab to let me know. Support is not guaranteed but I'll help if I can.
Thank you!
--Vance M. Allen
What's New in Version 2019.01.23.2
Released
New with Version 2019.01.23.2
- FIXED: Using any available Student Contacts options should no longer mangle the plugin. (No more frustrating refreshes!)
- FIXED: Show All now works, so you can now consolidate inactive duplicates if you wish.
-
FIXED: Consolidation should no longer produce errors as a result of the plugin.
- I am not sure when this broke. Probably in 12.1 or 12.1.1.
- PowerSchool used to just pass the contact IDs to the consolidation page (easy). Now it requires an API call to "select" them (much more complicated), much like how other customizations have had to set your student selection.
- I no longer have access to older versions of PowerSchool and was unsuccessful in finding out if the new API I'm using has existed all along. Please advise if this new plugin fails on an older version of PowerSchool.
- FIXED: Latency and slow connections should no longer break the plugin.
- FIXED: The plugin has found it's 'match', so the Console Log should no longer complain it's undefined.
- IMPROVED: The entire plugin was rewritten to improve performance and stability.
- IMPROVED: Existing AngularJS functionality on the page is leveraged to improve stability.
- IMPROVED: This plugin should no longer scare any other Student Contacts plugins off the playground (i.e. other plugins should now work properly and well alongside this one).
If you discover any bugs with the plugin not excluded in the description, please e-mail me directly at allevanc@d91.k12.id.us.