Show TOC

Procedure documentationDefining a Pattern for User E-Mail Addresses Locate this document in the navigation structure


You can configure the user management engine (UME) to only allow e-mail addresses entered in user profiles that match a pattern that you define. For example, this enables you to ensure that users only enter e-mail addresses from a specific domain or you can support an in-house e-mail system with a single-label domain.

When you enter an e-mail address in a user profile with the Web Dynpro identity management application, the UME performs a check on the e-mail address. The e-mail address must match the pattern defined. If the e-mail address does not match the pattern, you receive an error message.

Note Note

  • The check for valid e-mail addresses only applies to the identity management application of SAP NetWeaver Application Server (AS) Java. It does not apply to other interfaces such as APIs or other applications.

    For more information, see Identity Management.

  • The check only applies to e-mail addresses in the user profile. It does not apply to the default administrator, workflow, or system e-mail addresses.

End of the note.

Recommendation Recommendation

If your back end performs any additional checks on the e-mail address when changing the user profile, make sure the pattern matches the checks made by the back-end system.

End of the recommendation.


Configure the required UME property, ume.users.email_pattern.

For more information about editing UME properties, see Editing UME Properties.

The default value is as follows:


This ensures the e-mail entered fits the pattern of an Internet e-mail address:


The following characters have special functions:

  • Question mark (?) stands for any single character.

  • Asterisk (*) stands for 0, 1, or more characters.

  • Use backslash (\) to escape wildcard characters.


Francesca Bertolini wants to ensure that users only enter company e-mail addresses, so she sets the UME property as follows:


Hussein Atel’s company uses an in-house mail system. He wants to ensure that users only enter single-label domains, so he sets the UME property as follows: