Show TOC

Procedure documentationCustomizing a UME Data Source Configuration Locate this document in the navigation structure


The user management engine (UME) provides data source configuration files that define a configuration for standard scenarios. If none of these files cover the scenario that you require, you can modify the existing configuration files according to your requirements.

Caution Caution

This option is not recommended. You should only need to change the data source configuration files if you are using a directory service as data source and need to adapt the attribute mappings.

Before changing a configuration file, make absolutely sure that none of the preconfigured files meet your requirements. If at all possible, use one of the preconfigured files rather than creating your own.

Customizing data source configuration files is not a trivial undertaking. You should start a project with an experienced consultant or contract SAP consulting services. Although SAP Support supports systems, which use customized data source configuration files, SAP cannot support the customization process for the data source configuration file.

SAP cannot guarantee the compatibility of customized data source configuration files with future releases or service pack stacks. Upgrades may include changes to the shipped data source configuration files. When you perform an upgrade to your SAP NetWeaver Application Server (AS) Java installation, these changes are not reflected in your modified configuration files. You must add these changes to your modified files manually.

End of the caution.

Before you begin, you should review the concepts and structures behind the data source configuration.

For more information, see:

This section also provides examples of data source configuration scenarios.

For more information, see Examples of Data Source Configuration Files.


  • You have clearly defined where you want user management data to be read, searched, and written to.

  • You have installed the AS Java with the option to use the database of the AS Java for user management.


  1. Download the data source configuration file that most closely meets your requirements.

  2. Adapt the file as required.

  3. Verify the correctness of your data source configuration file using the document type definition (DTD) file, which you can find at the same location as the data source configuration files.

  4. Upload the data source configuration file under a different name.


You can now configure the UME to use the new data source configuration file.

For more information, see Configuring the UME to Use an LDAP Directory as Data Source.

Note Note

During an upgrade refer to SAP Note 938277 to determine what changes have been made to the default data source configuration files. Use this information to adjust your customized data source configuration file to the changes in the upgrade.

End of the note.