feat: email templates

docs/dcc-options.md

@@ -13,6 +13,7 @@ Currently used scopes include:
 
 * DC
 * DC_CATALOG
+* DC_EMAIL
 
 ## DC Scope
 
@@ -31,11 +32,11 @@ By default, a maximum of 100 observations can be edited in the browser at one ti
 On SASjs Server and SAS9 Server types, at the end of each DC SAS request, a record is added to the [MPE_REQUESTS](/tables/mpe_requests) table.  In some situations this can cause table locks.  To prevent this issue from occuring, the `DC_REQUEST_LOGS` option can be set to `NO` (Default is `YES`).
 
 ### DC_RESTRICT_EDITRECORD
-Setting YES will prevent the EDIT RECORD dialog appearing in the EDIT screen by removing the "Edit Row" option in the right click menu, and the "ADD RECORD" button in the bottom left.  
+Setting YES will prevent the EDIT RECORD dialog appearing in the EDIT screen by removing the "Edit Row" option in the right click menu, and the "ADD RECORD" button in the bottom left.
 
 Anything other than YES will mean that the modal _is_ available.
 
-Default=NO 
+Default=NO
 
 ### DC_RESTRICT_VIEWER
 Set to YES to restrict the list of libraries and tables in VIEWER to only those explicitly set to VIEW in the MPE_SECURITY table.  The default is NO (users can see all tables they already have permission to see).
@@ -53,7 +54,7 @@ Default=SYSTEM.
 
 !!! note
     If you have clients in different geographies loading excel in local formats, you can also address this issue by ensuring the locale of the windows _user_ profile is not set to the default (eg `English (United States)`).  When leaving the DC_LOCALE as SYSTEM, the locale settings in SAS are not added or modified.
-    
+
 ## DC_CATALOG Scope
 
 ### DC_IGNORELIBS
@@ -66,4 +67,36 @@ When running the [Refresh Data Catalog](/admin-services/#refresh-data-catalog) s
 
 Number of rows to return for each HISTORY page.  Default - 100.  Increasing this will increase for all users.  Using very large numbers here can result in a sluggish page load time.  If you need large amounts of HISTORY data, it is generally better to extract it directly from the [MPE_REVIEW](/tables/mpe_review/) table.
 
+## DC_EMAIL Scope
 
+This section allows more fine grained control over the email configuration.  Be sure that `DC_EMAIL_ALERTS` is set to `YES` (above) for these to activate.
+
+![](img/mpe_config_dc_email.png)
+
+Embedded macro variables are resolved at runtime.
+
+### APPROVED_TEMPLATE
+
+Sent when a change is approved.  Available variables:
+
+ - ALERT_LIB: Library of table being edited
+ - ALERT_DS: table being edited
+ - FROM_USER: the user who made the approval
+
+### REJECTED_TEMPLATE
+
+Sent when a change is rejected.  Available variables:
+
+ - ALERT_LIB: Library of table being edited
+ - ALERT_DS: table being edited
+ - FROM_USER: the user who made the rejection
+ - REVIEW_REASON_TXT: The text provided by the user who made the rejection
+
+ ### SUBMITTED_TEMPLATE
+
+Sent when a change is submitted.  Available variables:
+
+ - ALERT_LIB: Library of table being edited
+ - ALERT_DS: table being edited
+ - FROM_USER: the user who made the submission
+ - SUBMITTED_TXT: The text provided by the user who made the submission.