Email Designer Editor

Overview

Use the Email Designer editor to add content to a template.

Administration: Email Designer Editor

ClosedEmail Designer Editor

To edit a template, click the template’s name in the Email Templates page. The Email Designer editor opens.

Email Design Editor

ClosedAdmin Action Bar (1)

The Admin Action Bar will always contain (at minimum) the following four buttons:

  • Preview
  • Deploy
  • Save
  • Close

If the site’s SuperUser is modifying a template, an XSL button will also be present in the Admin Action Bar. All other users that access the Email Designer editor, including FullAccess users with “SuperUser privileges,” will not see the XSL button.

If the template is a multi-language template, a Language drop-down will also be present in the Admin Action Bar.

ClosedLanguage

The Language drop-down determines the Language View of the Template Flow, where content is added and edited. If the default language is selected, all administration tasks can be done, and content can be added in the default language. If another language is selected, Text Elements can have translations added to them, but no other administration tasks can be done.

See the topic Email Designer: Languages and Translation.htm for more information.

ClosedPreview

The Preview button takes the user to the Preview page where the template will be previewed in HTML using data from the Transaction that was most recently opened. On the Preview page the admin can choose to preview the template using data from a different Transaction.

To preview the output of a template:

  1. Click Save to save all changes to the template. Only saved changes will appear in the preview.

  1. Click Preview on the Admin Action Bar.

    The Preview page opens. The template will automatically be previewed in HTML using data from the Transaction that was most recently opened. The Subject of the email is the first line of the preview. All subsequent lines hold the email’s body.

    Preview template

To preview using data from a different Transaction:

  1. Select a Transaction ID from the Transaction ID drop-down, or enter a Transaction ID into the field. The ten Transactions that were most recently opened can be selected in the drop-down.

    For more information, see the topic Finding the Transaction ID.

  2. Click View.

ClosedXSL

ClosedDeploy

An Email Designer template can be deployed from within the Email Designer editor. The Deploy button deploys all saved changes in the template to Commerce so that they take effect the next time an email is sent on the user-side of the application.

ClosedSave

The Save button saves all changes made to the template since the template was opened or since the previous save. This allows for unwanted changes to be undone, as an admin can close the template without saving in order to lose any unwanted changes that were made since the last save.

Changes to an Email Designer template are not automatically saved.

ClosedClose

The Back button is now named Close. The Close button closes the Email Designer editor and returns the user to the Email Templates page. When the user clicks Close, a confirmation pop-up appears to warn that unsaved changes will be lost.

ClosedProperties Panel (2)

The Properties panel contains several panes.

ClosedElements Pane

ClosedProperties Pane

The Properties pane contains properties of the currently selected Element that can be modified. See each individual Element’s section for more information on what properties are shown in the Properties pane when each Element type is selected.

If more than one Element is selected, the Properties pane only shows the properties that all selected Elements have in common. 

By selecting more than one item, you can edit the properties of each item at the same time.  This ensures consistency in the property selections, and is more efficient than editing each item one at a time.

Properties Pane

If no Element is selected, the Properties pane shows the properties that relate to the template as a whole. To reveal these Template properties, click an empty space in the Admin Action Bar or in the Template Flow.

Template Property Description

Date Format

The format that determines how all date attributes appear in the output.

Currency Format

The format that determines how all currency attributes appear in the output.

Font

The default font.

Size

The default font size.
Changes made at the Template level will override any previous Font and/or Size customizations made at the Text Element level. Edit Text Elements individually to override changes made at the Template level.
Font and Size values selected at the Template level do not act as a default to newly added Text Elements.

ClosedDynamic Content Bar (3)

The buttons available in the Dynamic Content Bar will vary based on what is selected.

Button Name

Loop button

Loop

Condition button

Condition
Copy button

Copy
Paste button

Paste
Clear button

Clear Row, Column, or Cell
Merge cells button

Merge Cells
Split cell button

Split Cell

ClosedTemplate Flow (4)

This is the area where all the content is developed. Working in the Template Flow is covered below.

Using the Email Designer Editor

The Template Flow is the main editing area of the Email Designer editor. It contains the Subject and Body sections.

ClosedSubject

To customize the Subject section:

  1. Double-click within the Text Element in the Subject section.

    Subject section

    The Subject dialog box appears.

    Subject dialog

  2. If it is available, select a supported language from the drop-down.

    select a supported language from the drop-down

  3. Enter the desired text.
  4. Click OK.

Attribute values can also be added to the Subject. For more information on adding attribute values, see the topic Email Designer and Attributes.

ClosedBody

Elements are added to the Body section of the template via drag and drop.

To add an Element to the Template Flow:

  1. Click Elements in the Properties panel to expand the Elements pane.

  2. Click and drag the Element you wish to add to the template into the Body in the Template Flow.

    Click and drag the Element to add

Managing Elements in the Template Flow

ClosedMoving and Deleting Elements

Moving and Deleting Elements

Element Description

1

Hover over or select an Element to reveal the Delete ( Delete icon ) icon. Click the Delete icon to remove the Element from the template. A confirmation dialog box will appear to confirm that the Element should be deleted.

2

Rearrange Elements in the Template Flow by clicking and dragging the Elements to new locations.
To select multiple Elements, select the first Element and then hold down the Ctrl key while selecting other Elements. When more than one Element is selected, click Delete button in the Dynamic Content Bar to delete all selected Elements.

ClosedCopy and Paste

Within a template, Elements can be copied and pasted to different places within the Body section. All properties between the copied and pasted Element will be identical until otherwise modified.

Multiple Elements can be copied and pasted at once.

To copy and paste one or more Element(s):

  1. Select one or more Element(s) in the Template Flow.
  2. To select more than one item, click on the first item and press the Ctrl key while clicking the other item.
  3. Click the Copy button (Copy button) in the Dynamic Content Bar.
  4. Select a blank place in the Template Flow so that no Elements are selected.
  5. Click the Paste button (Paste button) in the Dynamic Content Bar.
Pasted Elements will always be placed at the bottom of the Body section when they are pasted.

Notes

  • Oracle CPQ 20B implements XML Translation Line Limits to prevent performance issues that could occur when generating XML for quotes with an extremely large number of transaction lines.

  • The operating system and the email client need the same fonts installed for the template to appear accurately on the page.

Related Topics

Related Topics Link IconSee Also