Show TOC

Procedure documentationImporting User Management Data Locate this document in the navigation structure


Use the user management engine (UME) to import users, groups, and roles from a text file. This enables you to create or modify these UME principals. You can either create the text file manually or generate the file with the export function of the UME of SAP NetWeaver Application Server (AS) Java.


  • You have write access to the data source of the UME for the data you want to import.

  • You are assigned a role that includes the relevant combination of actions.

    • To use the import tool, you must be assigned a role with the UME action Batch_Admin.

    • To import users, groups, or roles, you must have permission to create users, groups, or roles respectively.

      If you use companies and you want to import user data for all companies, you must have permission to manage users in all companies.

    • To make assignments to user, groups, or roles, you must also have permission to modify the users, groups, and roles you are assigning.

  • You have created the text file with the import data.

    • To create a list automatically, use the export function of the UME.

      For more information, see Exporting User Management Data.

    • To create a list manually, use the UME principal import format and a text editor.

      Note Note

      • You cannot import a file that is larger than 1 MB.

      • There is limited support for the import of portal role assignments.

      End of the note.

    For more information, see Import Format for UME Principals.


  1. Start the import function.

    • For a portal, choose   User Administration   Import  .

    • For all others, start identity management and choose Import.

      For more information, see Identity Management.

  2. Enter the path to the text file with your import data.

  3. Determine if you want to overwrite existing data.

    The UME uses the user, group, or role ID to uniquely identify the records in the import data and to match the imported data with any existing users, groups, or roles.

    To enable this option, select the Overwrite Existing Data checkbox.

    Caution Caution

    If you select Overwrite Existing Data, the system overwrites all existing field values for the target principal with field values from the import data. The system does not keep a record of previous values.

    End of the caution.
  4. Choose the Upload pushbutton.


After you import the data, the Batch Import Protocol table appears. If the import function encounters an invalid line, the function does not create the corresponding principal, makes an entry in the Batch Import Protocol table, and continues the batch process. The import function processes all valid records and creates the corresponding principals. Correct invalid records and upload them again. Choose a protocol entry for details. The following table lists the possible protocol results:

Protocol Results of Batch Import




New object was created.


Object exists and was not overwritten since overwriting is disabled.


Creation of new object failed.


User performing the import has no permission


An existing object was updated since overwriting was allowed.


An update to an existing object failed although overwriting was allowed.