Customization Basics

For each type of email sent by SAP Anywhere there is a corresponding template. Each template has a default. All new accounts will be created with a default set which can be modified at any time.

To modify a template, navigate via 'Settings' → 'Communication'. Each email type has a corresponding template for all languages enabled for the SAP Anywhere account. It is recommended to disable any emails whilst editing to avoid sending incomplete edits.

Make any changes required to the template and updates will be immediately made live upon save. The editor has a Preview option to display how the final version will appear.

Each template will be surrounded by an optional Header and Footer. Both have their own templates for externally and internally bound emails.

The editor allows all standard HTML tags and also FREEMARKER logic. Note that email clients may not support all HTML features and it is possible they will alter the final display. Ensure any changes to the templates are tested within the email clients you expect your customers to be using.

Header and Footer

An option Header and Footer may be added to all email types. External (to customers etc) and internal (to SAP Anywhere users) templates may be individually assigned to each template.

Header and Footer templates exist for all languages enabled in the SAP Anywhere account.

When an email is generated it will be combined with the chosen header and footer and then sent as the body of a single email to the recipient.

Fields and Logic

The email templates allow metadata fields to be inserted into the emails using a short code. Each email type has a defined set of available short codes. Use the menu on the left for type-available fields. Several global fields are also available to the email Header and Footer.

Short codes are compiled at email generation or upon preview.

For table iteration and conditional formatting, object operations are supported using FREEMARKER syntax. The editing window will highlight any detected syntax errors. Pay close attention to the email previews to diagnose any non-detected errors.

Note that email clients may interpret the generated HTML with different rules and will often strip malformed tags without warning. Ensure all generated code is checked for syntax and display errors before making an email live.

Preview and Recipients

Preview allows the option to generate either: 1) A code-output of the email body for general diagnostics. 2) An HTML version of the entire email (including Header and Footer) displayed in a web browser. Select the relevant objects (e.g. Customer or Order) to use contextual real data in the preview.

Due to multiple system-wide dependencies during email generation, certain fields may not be available for real-data contextual output. These will remain blank during preview. For accurate results please test the emails in a production environment.

Note that email clients may render the HTML differently so full testing will be required to ensure compatibility across both browser and application based email clients.

Additional recipients may be added to each email template. These will be added as BCC (blind carbon copy) whenever that email type is sent.