How To: Resolve Email Notification Scheduler Failure After Python 3.11 Migration

Overview

When migrating to Python 3.11, the Email Notification scheduler Add-on may fail. This issue occurs particularly if the Email Notification Add-on was originally installed on Python 3.8. The reasons for failure include:

1. The ipyvuetify package is not installed in Python 3.11.

2. A major version change in the pandas package installed in Python 3.11 is causing code compatibility issues.

Please note that the Email Notification Scheduler functionality has been replaced by the Notifications on Conditions, which we recommend using for enhanced performance and support.

Solution

Re-Install the Email Notification Scheduler

If you have manually modified any files under /Email Notifications folder, please create a backup of them before proceeding with the steps below to avoid losing any custom configurations.

1. Open the Project with the Email Notification Scheduler Add-on Installed.
   If you're not sure which project includes the Email Notification Scheduler, follow these steps

   1. Open the Email Notification Scheduler Add-on Tool.

   2. Copy the URL up to the project ID in this format: <domain>/data-lab/<project_id>.

   3. Paste the copied URL into a new browser tab to access the project directly.

2. In Data Lab, locate and open the Email Notifier.ipynb notebook found under /Email Notifications folder and take a backup of the SMTP configurations.

   

3. In Data Lab, locate and open the installation notebook Email Notification Add-on Installer.ipynb found under /SPy Documentation/Advanced Scheduling/ folder.

4. Change the parameter overwrite_existing_files = False to True in the notebook code under the How to Handle Existing Files section.
   This will overwrite all files under /Email Notifications folder. Please note that any previous modifications or configurations in these files will be lost.

5. Change the parameter remove_existing_versions = False to True in the notebook code under the How to handle existing versions of Scheduler in Add-on Tools section.

6. Run all the cells of the Email Notification Add-on Installer.ipynb notebook to install necessary packages and apply the fix.

7. Update the SMTP configurations from step 2 in the Email Notifier.ipynb notebook located under /Email Notifications folder.