Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents
styledecimal

Note
titleVersion warning

The content below is for Apache Syncope <= 1.2 - for later versions the Reference Guide is available.

Introduction

You can create new (and modify existing) template messages to customize the body of notification messages. This can be achieved by creating and / or modifying the notification e-mail template files.

...

Besides standard expressions, you can use the following Syncope-specific variables:

  • user
    UserTO instance representing the subject of the current notification
  • syncopeConf
    Map<String, String> containing all defined configurations as <key, value> - see how to manage these items
  • recipients
    list of UserTO instances for all the actual recipients of the current notification e-mail
  • events
    list of String containing all the events that could have triggered the current notification

Apache Syncope >= 1.1.5

New Syncope-specific variable were added:

  • type
    type of event being notified
  • category
    category (String) of event being notified
  • subcategory
    subcategory (String) of event being notified
  • event
    event (String) that actually triggered the current notification 
  • condition
    condition (success or failure) under which this notification was sent

Notifications can be related to RESTful method invocation that actually changed an entity (user, role, resource, ...). In this case, additional variables are available:

  • before
    entity value (Object) before actual modification took place 
  • input
    RESTful method arguments (Object[])
  • output 
    entity value (Object) returned by RESTful method

Sample expressions

Code Block
languagejava
titleUsername
$user.getUsername()
Code Block
languagejava
titleAttribute value
$user.getAttributeMap().get("email").getValues().get(0)
Code Block
titleMemberships
#foreach($membership in $user.getMemberships())
  $membership.roleId
  $membership.roleName
  $membership.getAttributeMap().get("membershipAttr").getValues().get(0)
#end