This is an Apps Script code that sends email reminders about upcoming workouts from a Google Sheet that contains a training schedule. The code sets up the constants for the sheet name, header row and column names, and email settings. It then creates a Spreadsheet class that represents the training schedule, with methods for getting the email content. Finally, it creates an EmailSender class that sends the email using a template file and the MailApp service. The main() function brings everything together by creating instances of the Spreadsheet and EmailSender classes and sending the email if email reminders are turned on and there is an upcoming workout scheduled.
There're two working versions of this code. Code.js uses classes and it's the one that I use, and Code with functions.js it's easier to understand.
This code requires a Google Spreadsheet to work. You can get a sample sheet here. The sheet named "Training Schedule", should have a header row that contains the column names for the data, data for upcoming workouts scheduled in the future, the name should match the SHEET_NAME constant defined in the code, and a named range called "PlanSelected" that contains the name of the training plan.
It uses FORMULAARRAY or Dynamic Arrays. Notice how the first row (in yellow) is the only one with formulas. Also, notice how one has the LET formula to make these formulas understandable.
Finally, there's a named range for the PlanSelected which is then retrieved by the code and used in filling the email.
This code uses an email template file called email.html to build the email. You can customize the template file to fit your needs.
To use this code, and set up the Google Apps Script with triggers to run once a day, follow these steps:
- Create a new Google Sheet or use the sample sheet and go to File > Make a Copy.
- Open the sheet and go to Extensions > Apps Script.
- Copy and paste the code from
Code.gsinto the script editor, similarly withemail.html. - Set the constants in the code to match the settings in your Google Sheet.
- Turn on email reminders by setting the
EMAIL_ONconstant totrue. - Set the number of days ahead to send the email by changing the value of the
DAYS_AHEAD_TO_SENDconstant. - Save the project with a name of your choice.
Before running this script, please set the following constants:
SHEET_NAME: the name of the sheet containing the training schedule.HEADER_ROW: the row number where the header row starts in the training schedule sheet.COLUMNS: an object containing the column names and index numbers for the date, week, date, workout, exercise, and link columns in the training schedule sheet.EMAIL_ON: a boolean value indicating whether to send the email notification or not.DAYS_AHEAD_TO_SEND: the number of days ahead of the date to send the email.EMAIL_TEMPLATE_FILE: the name of the HTML template file to use for the email. Default isemail.
To use this code, follow the steps below:
- Open the Google Sheet.
- Enter the training schedule data in the correct format.
- Run the
mainfunction to send the email reminder.
- Run the
mainfunction to test the code. - Click on Triggers > + Add Trigger button in the bottom right corner.
- In the "Run" dropdown menu, select the "main" function.
- In the "Events" dropdown menu, select "Time-driven".
- In the "Select type of time based trigger" dropdown menu, select "Day timer".
- Choose a time of day to run the script, considering the timezone.
- Click on "Save".
The script will now run once a day at the selected time. You can check the execution log to verify that the script is running correctly. To view the execution log, click on "View" > "Logs" in the script editor menu.
This code was developed by Juan Lazarde in 2023.