# <ugm:createUser> Tag

The <ugm:createUser> tag creates a new user.

> Note: All User Management tags send results to the same file. If you are checking for results, include this import statement at the top of the page: <%@ page import="com.bea.p13n.usermgmt.taglib.UserManagementTagConstants" %>

Security: In the WebLogic Administration Portal's Service Administration tool, you can determine which roles can perform this action.

After the user is created, use the <profile:createProfile> tag to create a user profile for the new user. If you use the doPostProcess attribute to perform post-user-creation processing (the default), a profile is created automatically.

## Syntax

<tagName attribute="value" />

## Attributes

atnProvider

Optional (String) - The name of the authentication provider to use. The default setting is the WebLogic Server DefaultAuthenticator. The authentication provider must provide write access. See Using Multiple Authentication Providers in Portal Development for more information.

doPostProcess

Optional (Boolean) - Works in conjunction with the fireEvent, login, and saveAnonymous attributes. If this attribute and the fireEvent, login, and saveAnonymous attributes are set to true, all three events--including the creation of a user profile--occur after the user is created. If the doPostProcess attribute is set to false, the individual settings on the other three attributes are used.

fireEvent

Optional (Boolean) - If set to true, a UserRegistrationEvent is dispatched to the event service during the post-user-creation process. Defaults to true. If this attribute is set to false, doPostProcess is ignored.

login

Optional (Boolean) - If set to true, the user is logged in during the post-user-creation process. Defaults to true. If true, a user profile is created automatically for the user at login. If this attribute is set to false, doPostProcess is ignored, and you must either create a profile for the user or have a profile created for the user automatically when the user next logs in.

saveAnonymous

Optional (Boolean) - If set to true, any properties the user may have set during the session before registering are added to the new user's properties during the post-user-creation process. Defaults to true. If this attribute is set to false, doPostProcess is ignored.

password

Required (String) - The password for the new user. Example: "<%=password%>"

username

Required (String) - The name of the new user. Example: "<%=username%>"

result

Required (String) - The name of an Integer variable to which the result of the create user operation is assigned.

Possible values:

- Success: UserManagementTagConstants.CREATE_USER_OK.
- Error encountered: UserManagementTagConstants.CREATE_USER_FAILED.
- A user with the specified username already exists: UserManagementTagConstants.USER_EXISTS.

## Example

This example shows how to use <ugm:createUser> to create a new user.

    <ugm:createUser userName="<%=username%>" password="<%=password%>" result="result"/>

Related Topics

<ugm:createGroup> Tag