Home >	Contents >	Index >

Template Tags TOC   |    Alpha TOC   |    Tag Family TOC   |    Purpose TOC   |    Annotated TOC   |    Index

dir:create

Creates new objects.

Syntax

<dir:create 
      [name="ENTRY_name"]>
      [default="default property"]
  <[dir:argument name="ARG_name]" [value="ARG_value"]/>
</dir:create>

Parameters

name (optional)

Unique identifier for the name of the entry to create. The value is relative to the baseDN property.

default (optional)

Set of attribute name/value pairs to be set on the entry. The prefered method is to specify the defaultPeopleAttrs.ini property, see the example for details.

dir:argument name (optional)

Name of the attribute to create for this entry.

dir:argument value (required)

Value of the named attribute.

Description

This tag creates a new object.The name of the object is implied from its attributes, specified as arguments.

Error Numbers

The possible values of errno include:

Value	Description
-15002	Name being created already exists.
-15004	Implementation doesn't support this operation
-15005	Unexpected naming exceptions from JNDI provider.
-15006	A required property missing, or class name specified for factory classes is in error.
-15007	Unexpected schema violation errors from JNDI provider.
-15008	General error in the syntax of an IName.
-15009	Unexpected invalid attribute exceptions from JNDI provider
-15010	Unexpected invalid attribute id exceptions from JNDI provider.
-15011	Unexpected invalid attribute value exceptions from JNDI provider.
-15012	User does not have permission to perform the operation.
-15014	Unexpected JNDI read error.
-15015	Unexpected JNDI write error.
-15016	JNDI attribute already in use.
-15023	Unexpected JNDI connection errors.
-15024	Required attribute missing.
-15025	Unknown error.
-15026	Missing required create attribute.
-15027	User create SQL failure.
-15036	Missing or invalid child argument tags for tag.

Example

This example contains the following custom .ini properties not found on your system:

• th.AttributeFirstName

• th.AttributeSN

• th.AttributeManager

• th.AttributeTitle

• th.AttributePhone

  <dir:create name='<%= ics.GetVar("name") %>'
              defaults='<%=ics.GetProperty("defaultPeopleAttrs",  
              "dir.ini", true)%>'>
  <dir:argument name='<%=ics.GetProperty("username",
               "dir.ini", true)%>' 
               value='<%=ics.GetVar("User1ID")%>'/>
  <dir:argument name='<%=ics.GetProperty("password",
                "dir.ini", true)%>' 
                value='<%=ics.GetVar("User1PW")%>'/>
  <dir:argument name='<%=ics.GetProperty("th.AttributeFirstName",              
                 "dir.ini", true)%>'
                  value='<%=ics.GetVar("User1FirstName")%>'/>
  <dir:argument name='<%=ics.GetProperty("cn",
               "dir.ini", true)%>'            
               value='<%=ics.GetVar("User1FirstName")+"
               "+ics.GetVar("User1LastName")%>'/>
  <dir:argument name='<%=ics.GetProperty("th.AttributeSN", "dir.ini",  
                true)%>'
                value='<%=ics.GetVar("User1LastName")%>'/>
  <dir:argument name='<%=ics.GetProperty("th.AttributeManager", 
                "dir.ini", true)%>'
                 value='<%=ics.GetVar("Manager1")%>'/>
  <dir:argument name='<%=ics.GetProperty("th.AttributeTitle", "dir.ini",  
                true)%>'?value='<%=ics.GetVar("Title1")%>'/>
  <dir:argument name='<%=ics.GetProperty("th.AttributePhone", "dir.ini", 
                true)%>'
                value='<%=ics.GetVar("User1phone")%>'/>
  </dir:create>
                <ics:if condition='<%=ics.GetErrno()==0%>'>
                <ics:then>
                <p><b> Successful Creating User=<ics:getvar
                                          name='name'/> </b></p>
                </ics:then>
                <ics:else>
                <p><b>Could not create user, <ics:getvar
                      name='name'/>, error=i<ics:geterrno/></p></b>
                </ics:else>
                </ics:if>
  

		Home >	Contents >	Index >
	Oracle JSP Tag Reference Copyright (c) 2013, 2016, Oracle and/or its affiliates. All rights reserved.