When you launch a simulation, many variants of a message can be generated. So to help you validate all the variants, it is stongly suggested to create regions to validate your message in order to test parts of the message instead of the entire message at once. It is much easier to check a specific region that the entire message, which usually produces too many variants to validate.

You can also add parameters to the message that will identify sections that do apply to a contact by showing a related indicator. That way, sections of the message that contain met conditions will be more easily found.

PrerequisiteThis feature is not available by default; it is only available upon request.
Access Path > Messages > EMail > Select a message

 How To

Create a region

A region lets you group conditions together in order to validate the different variants of a specific region.

  1. Start by adding a Region layout block.

    The areas where you can add content are shown when you drag an element in the message.
  2. Give it a name by clicking on the edit icon shown in this area.
    If you simulate the sending of an HTML email, define the following parameters:
    ParameterDescription
    Region nameThe name will show in the simulation results.
    Must be a simple text (example : Content region).
    Cannot include variables.
    Opening tagAn Html tag allowing you to quickly see the region in the simulation results.
    • Recommendation: Use a colored background within a DIV or SPAN.
    • Optional: Add "id='region-anchor' " to your tag so that the document scrolls to this region when it is selected (quite useful to validate footers).
    Closing tagA closing tag corresponding to the opening tag.
    [[#Region("Content region"){]]
    …
    [[}]]
    or
    [[#Region("Content region", "<div id='region-anchor' style='background-color: #FFDDDD;'>", "</div>"){]]
    …
    [[}]]
  3. Click on Save and close.

Create a condition with a marker

To identify positive conditions (those that are true for the contact).

  1. In the condition area, click on the condition icon.
  2. In the left menu, click on the  edit icon to the right of your condition.
  3. In the Display condition window, enter a label that will allow you to clearly recognize your condition.
  4. Click on Apply, then Save and close.

If you simulate the sending of an HTML email, define the following parameters:

ParameterDescription
ExpressionStandard
MarkerName of marker.
Must be a simple text (exemple : is masculine).
Cannot include variables.
[[ if (Contact.f_City == "Quebec", "lives in Quebec") {]]
…
[[}]]
[[ if (Contact.f_Sex == "M", "is masculine") {]]
…
[[}]]
[[ if (Contact.f_Sex == "F", "is feminine") {]]
…
[[}]]

Cancel the message to be sent to this contact (in HTML mode only)

Allows you to cancel the message for the current contact. Lets you target complex cases of personalization that cannot be validated with groups. For example, a message with promotional offers but no offers displays in message.

ParameterDescription
Code (optional, by default 100)Code of error type
  • Generic = 100,
  • MissingData = 101
  • InvalidData = 102
  • NoContent = 103
Error codeClient's message.
Must be a simple text (example : Invalid ID).
Cannot include variables.
context.cancelExecution(“Invalid ID”);
context.cancelExecution(101, “No representative”);
context.cancelExecution(102, “Invalid postal code”);
context.cancelExecution(103, “No promotion”);
<!-- Illegal use -->
context.cancelExecution(103, “Invalid sex ” + Contact.f_sex);