Importing User Management Data

Prerequisites

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.
For more information, see:
- Managing Users, Groups, and Roles
- Standard UME Actions
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
  - You cannot import a file that is larger than 1 MB.
  - There is limited support for the import of portal role assignments.
For more information, see Import Format for UME Principals .

Context

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.

Procedure

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 .
Enter the path to the text file with your import data.
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
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.
Choose the Upload pushbutton.

Results

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:

Entry	Description
`CREATED`	New object was created.
`EXISTS`	Object exists and was not overwritten since overwriting is disabled.
`FAILED`	Creation of new object failed.
`NO PERMISSION`	User performing the import has no permission
`UPDATED`	An existing object was updated since overwriting was allowed.
`UPDATE FAILED`	An update to an existing object failed although overwriting was allowed.