Network Deployment (Distributed operating systems), v8.0 > Reference > Commands (wsadmin scripting)


IdMgrDataModel command group

Use the Jython or Jacl scripting language to manage the federated repository schema using wsadmin. Use the commands and parameters in the IdMgrDataModel group to manage the property extension repository. The commands are available in connected or local mode using the –conntype NONE option.

The IdMgrDataModel command group for the AdminTask object includes the following commands:



addIdMgrPropertyToEntityTypes

Use the addIdMgrPropertyToEntityTypes command to add a new property to one or more existing entity types with specified parameters.


Required parameters

-name

Name of the new property that is added to one or more existing entity types.

(String, required)

-dataType

Use this parameter to specify the data type of the property. (String, required)

The default supported data types are:

  • String

  • Int

  • Boolean

  • Long

  • Double

  • Base64binary

  • AnySimpleType

  • AnyURI

  • Byte

  • DateTime

  • Date

  • Short

  • Token

  • IdentifierType

aug2011

To extend a property of the type Object, use AnySimpleType data type.

-entityTypeNames

This parameter specifies the name of one or more existing entity types to which the new property is added. Use a semicolon (;) as the delimiter to specify multiple entity types.

We can use a valid namespace prefix (nsPrefix) to refer to the entity type names in a specific namespace. The default namespace prefix is wim. Use a colon (:) to specify the namespace prefix. For example, you can use: your_ext:Person_Account

  • your_ext is the namespace prefix, which is mapped to the http://www.yourco.com/yourext namespace URI.

  • Person_Account is the entity type name.

(String, required)


Optional parameters

-securityDomainName

Name that uniquely identifies the security domain. If not specified, uses the global federated repository. (String, optional)

-nsURI

Namespace to which the new property is added.

We must map each namespace URI (nsURI) value to a unique namespace prefix (nsPrefix) value the first time that you use the namespace URI. The new property is added to the default namespace if you do not specify a nsURI value. The default namespace is http://www.ibm.com/websphere/wim, which is mapped, by default, to the wim nsPrefix value.

(String, optional)

-nsPrefix

Use this parameter to specify the prefix for the namespace.

We must specify a namespace prefix (nsPrefix) value, if you specify a new namespace URI (nsURI) value, so that the new nsURI value is mapped to this nsPrefix value. The default nsPrefix value is wim, which is mapped, by default, to the http://www.ibm.com/websphere/wim nsURI value.

(String, optional)

-isMultiValued

Use this parameter to specify whether the new property accepts more than one value. The default value is false.

(Boolean, optional)

-repositoryIds

Use this parameter to specify the repository or repositories to which the new property is added.

Use a semicolon (;) as the delimiter to specify multiple repository identities. All of the configured repositories are included, if this parameter is not specified.

To add the new property into the property extension repository, specify LA as the value of this parameter.

To add the new property to the entity types for all the specified repositories, specify a list of repository identities and do not include LA in the list.

To extend the property to the property extension repository for particular LDAP repositories, specify a list that includes LA. The new extended property is then marked as not supported for the other LDAP repositories that are included in this list.

(String, optional)

-requiredEntityTypeNames

Use this parameter to specify one or more entity types for which the new property is required.

Use a semicolon (;) as the delimiter to specify multiple entity types.

We can use a valid namespace prefix (nsPrefix) to refer to the entity type names in a specific namespace. The default namespace prefix is wim. Use a colon (:) to specify the namespace prefix. For example, you can use: your_ext:Person_Account

  • your_ext is the namespace prefix, which is mapped to the http://www.yourco.com/yourext namespace URI.

  • Person_Account is the entity type name.

For example, if you are adding the contactNumber property to the PersonAccount and Group entity types and you require that all PersonAccount entity types have a contactNumber value, then specify: 

{-name contactNumber -entityTypeNames PersonAccount;Group  -requiredEntityTypeNames PersonAccount}

(String, optional)

-applicationId

Use this parameter to indicate the ID of the application for which the property is extended.

We can use the #rxml_atidmgrDataModel__cmd2 command to retrieve the extended properties for a specific application ID, if you specify a value for the applicationId parameter.

(String, optional)

Examples


Batch example...


Interactive example...



listIdMgrPropertyExtensions

Use the listIdMgrPropertyExtensions command to list the properties extended for entity types.


Required parameters None.


Optional parameters

-securityDomainName

Name that uniquely identifies the security domain. If not specified, uses the global federated repository. (String, optional)

-applicationId

Use this parameter to indicate the ID of the application for which the extended properties are listed.

If not specified, all the extended properties are listed.

(String, optional)


Return value

This parameter returns a hash map that contains the property name as the key. The value of each key is another hash map, which contains the same keys as the input parameters of the addIdMgrPropertyToEntityTypes command. For multivalued parameters, the value of the key is a List object.

Examples


Batch example...:


Interactive example...

This command lists the extended properties that are present in the wimxmlextension.xml file only.
Use the wsadmin scripting AdminTask object for scripted administration


Related


Commands using wsadmin.sh
IdMgrDBSetup command group

+

Search Tips   |   Advanced Search