Skip Headers
Oracle® Fusion Middleware Services Reference Guide for Oracle Universal Content Management
11g Release 1 (11.1.1)

Part Number E11011-03
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

9 Extended User Attributes Services

The following sections describe the services available for the Extended User Attributes component:

9.1 About Extended User Attributes Services

A typical Extended User Attributes service entry is similar to the following:

ADD_EXTENDED_USER_ATTRIBUTES
UserService 0 null null null !csUnableToAddExtendedAttr(dName)
3:checkSubAdmin:UserAdmin:0:null
3:loadUserAndCheckEditAllowedWithExtendedAttributes::4:null
3:setLocalValues:alwaysSave,1,doAdminFields,1:0:null
3:removeCachedUser::0:null
3:setConditionVars:IsModifyExisting,1,IsAddingAttributes,1:0:null
3:modifyExtendedUserAttributes:IuserExtendedAttribute:8:null
3:checkRefreshUsers::0:null

Each element of a service action is separated by a colon (:).

Important:

All services have at least one required parameter. The IdcService parameter takes the name of the service as its argument. If other parameters are required, they are noted in the description of the service.

See "Customizing Services" for details about a service's attributes and actions.

9.2 Extended User Attributes Services

The following Extended User Attributes component services are installed when the Oracle Content Server instance is installed:

The following services are extended to provide support for the Extended User Attributes component:

9.2.1 ADD_EXTENDED_USER_ATTRIBUTES

Service adds extended attributes to a user. The user does not have to exist before using the service. If this service is asked to add extended attributes which already exist for the user, the service modifies the previous entries.

Location: IdcHomeDir/components/ExtendedUserAttributes/resources/extendeduserattributes_services.htm

Additional Required Service Parameters

  • dName: The user name.

  • ExtUserAttribInfo Resultset: A result set containing extended user attribution information.

Optional Service Parameters

  • CheckUserMustExist: If set to true, a limited check is performed to verify that the user exists before extended attributes are added. This check only works for local users; it is not recommended to set this value for typical service calls.

Example

The following example from add_user_attr.txt illustrates the use of this service:

# Add a security group and an account to the user's extended attributes
# with different applications
@Properties LocalData
IdcService=ADD_EXTENDED_USER_ATTRIBUTES
dName=jsmith
@end
@ResultSet ExtUserAttribInfo
3
dUserName
dApplication
AttributeInfo
jsmith
appl
account,abc/def,15
jsmith
app2
role,contributor,15
@end

9.2.2 EDIT_EXTENDED_USER_ATTRIBUTES

Service edits extended user attributes for a user. The user does not have to exist before using the service. All previously extended attributes are replaced by the new extended attributes provided.

Location:

IdcHomeDir/components/ExtendedUserAttributes/resources/extendeduserattributes_services.htm

Additional Required Service Parameters

  • dName: The user name.

  • ExtUserAttribInfo ResultSet: A result set containing extended user attribution information.

Optional Service Parameters

  • CheckUserMustExist: If set to true, a limited check is performed to verify that the user exists before extended attributes are added. This check only works for local users; it is not recommended to set this value for typical service calls.

Example

The following example from edit_user_attr.txt illustrates the use of this service:

# Change the user to have all permissions with #all
@Properties LocalData
IdcService=EDIT_EXTENDED_USER_ATTRIBUTES
dName=jsmith
@end
@ResultSet ExtUserAttribInfo
3
dUserName
dApplication
AttributeInfo
jsmith
appl
account,\#all,15
@end

9.2.3 DELETE_EXTENDED_USER_ATTRIBUTES

Service deletes specific extended user attributes for a user.

Location:

IdcHomeDir/components/ExtendedUserAttributes/resources/extendeduserattributes_services.htm

Additional Required Service Parameters

  • dName: The user name.

  • ExtUserAttribInfo ResultSet: A result set containing extended user attribution information.

  • allowMissingAttributes: If set to true, the service suppresses errors when trying to delete attributes that do not exist (the default is false).

Optional Service Parameters

  • CheckUserMustExist: If set to true, a limited check is performed to verify that the user exists before extended attributes are added. This check only works for local users; it is not recommended to set this value for typical service calls.

Example

# Delete the #all account from extended attributes for jsmith
@Properties LocalData
IdcService=DELETE_EXTENDED_USER_ATTRIBUTES
dName=jsmith
@end
@ResultSet ExtUserAttribInfo
3
dUserName
dApplication
AttributeInfo
jsmith
appl
account,\#all,15
@end

9.2.4 DELETE_EXTENDED_ATTRIBUTES_BY_APPLICATION

Service deletes all extended attributes for a particular role/account for a specified application.

Location:

IdcHomeDir/components/ExtendedUserAttributes/resources/extendeduserattributes_services.htm

Additional Required Service Parameters

  • dAttributeType: The type of attribute to delete.

  • dAttributeName: The name of the attribute to delete.

  • dApplication: The application from which to delete the attribute.

Example

The following example from delete_attr_by_app.txt illustrates the use of this service:

# Delete the xyz account from extended attributes for appl
@Properties LocalData
IdcService=DELETE_EXTENDED_ATTRIBUTES_BY_APPLICATION
dAttributeName=xyz
dAttributeType=account
dApplication=appl
@end

9.2.5 DELETE_ALL_EXTENDED_ATTRIBUTES_FOR_USER

Service deletes all extended attributes for a user.

Additional Required Service Parameters

  • dName: The user name.

Optional Service Parameters

  • CheckUserMustExist: If set to true, a limited check is performed to verify that the user exists before extended attributes are added. This check only works for local users; it is not recommended to set this value for typical service calls.

Example

The following example from delete_user_attr_all.txt illustrates the use of this service:

# Add roles
@Properties LocalData
IdcService=DELETE_ALL_EXTENDED_ATTRIBUTES_FOR_USER
dName=jsmith
@end

9.2.6 DELETE_ALL_EXTENDED_ATTRIBUTES_FOR_APPLICATION

Service deletes all extended users attributes for an application.

Location:

IdcHomeDir/components/ExtendedUserAttributes/resources/extendeduserattributes_services.htm

Additional Required Service Parameters

  • dApplication: The application.

Example

The following example from del_all_attr_app.txt illustrates the use of this service:

# Delete all extended attribute information for appl
@Properties LocalData
IdcService=DELETE_ALL_EXTENDED_ATTRIBUTES_FOR_APPLICATION
dApplication=appl
@end

9.2.7 QUERY_EXTENDED_USER_ATTRIBUTES

Service places all of a user's extended attributes into a result set in the binder. All of the data is put into the ExtUserAttribInfo ResultSet.

Location:

IdcHomeDir/components/ExtendedUserAttributes/resources/extendeduserattributes_services.htm

Additional Required Service Parameters

  • dName: The user name.

Optional Service Parameters

  • dApplication: The application name for the attribute.

  • dAttributeType: The type of attribute.

  • dAttributeName: The name of the attribute.

Example

Adding one or more of the optional parameters enables greater flexibility in narrowing the query. The following example from query_user_attr_ext.txt illustrates the use of this service:

# Query the extended attributes of a user
@Properties LocalData
IdcService=QUERY_EXTENDED_USER_ATTRIBUTES
dName=jsmith
@end

9.2.8 QUERY_EXTENDED_ATTRIBUTE_MAPPINGS

Service places all mapped extended attributes from a particular attribute into a result set in the binder. All of the data is put into the ExtUserAttribInfo ResultSet.

Location:

IdcHomeDir/components/ExtendedUserAttributes/resources/extendeduserattributes_services.htm

Additional Required Service Parameters

  • dMappedAttributeName: The name of the attribute to be mapped.

Optional Service Parameters

  • dApplication: The application name for the attribute.

  • dAttributeType: The type of attribute.

  • dAttributeName: The name of the attribute.

Example

Adding one or more of the optional parameters enables greater flexibility in narrowing the query. The following example from query_attr_map_ext.txt illustrates the use of this service:

<?hda version="11gR1-dev" jcharset=Cp1252 encoding=iso-8859-1?>

# Query the attributes mapped from role 'guest'
@Properties LocalData
IdcService=QUERY_EXTENDED_ATTRIBUTE_MAPPINGS
dMappedAttributeName=guest
@end

9.2.9 EC_SET_PROPERTY

Service sets an extended configuration property. It can be used to either add a new property or modify an existing property.

Location:

IdcHomeDir/components/ExtendedUserAttributes/resources/extendeduserattributes_services.htm

Additional Required Service Parameters

  • dECPropType: The type of property.

  • dECPropKey: A key (generally relating to dECPropType).

  • dECPropValue: The property value.

Optional Service Parameters

  • dECPropSubKey: (Recommended) A second key; for example, the key can be a feature of what is defined by dECPropType and dEDPropKey.

Example

The following example from set_property.txt illustrates the use of this service:

# Set an extended configuration property
@Properties LocalData
IdcService=EC_SET_PROPERTY
dECPropType=account
dECPropKey=#abc
dECPropSubKey=URL
dECPropValue=http://www.example.com
@end

9.2.10 EC_DELETE_PROPERTY

Service deletes an extended configuration property. It is important that the exact key be specified for deletion. This service does not automatically delete all subkeys under a key.

Location:

IdcHomeDir/components/ExtendedUserAttributes/resources/extendeduserattributes_services.htm

Additional Required Service Parameters

  • dECPropType: The type of property.

  • dECPropKey: A key (generally relating to dECPropType).

Optional Service Parameters

  • dECPropSubKey: (Recommended) A second key; for example, the key can be a feature of what is defined by dECPropType and dEDPropKey.

Example

The following example from del_property.txt illustrates the use of this service:

# Delete an extended configuration property
@Properties LocalData
IdcService=EC_DELETE_PROPERTY
dECPropType=account
dECPropKey=#abc
dECPropSubKey=URL
@end

9.2.11 EC_GET_PROPERTY

Service returns a specified extended configuration property in the ResultSet PROPERTY_LIST. It is important that the exact key be specified; if you want to search based on just the key (not subkey) use EC_GET_PROPERTY_BY_KEY.

Location:

IdcHomeDir/components/ExtendedUserAttributes/resources/extendeduserattributes_services.htm

Additional Required Service Parameters

  • dECPropType: The type of property.

  • dECPropKey: A key (generally relating to dECPropType).

Optional Service Parameters

  • dECPropSubKey: (Recommended) A second key; for example, the key can be a feature of what is defined by dECPropType and dEDPropKey.

Example

The following example from get_property.txt illustrates the use of this service:

# Retrieve an extended configuration property
@Properties LocalData
IdcService=EC_GET_PROPERTY
dECPropType=account
dECPropKey=#abc
dECPropSubKey=URL
@end

9.2.12 EC_GET_PROPERTY_BY_KEY

Service returns a specified extended configuration property in the ResultSet PROPERTY_LIST.

Location:

IdcHomeDir/components/ExtendedUserAttributes/resources/extendeduserattributes_services.htm

Additional Required Service Parameters

  • dECPropType: The type of property.

  • dECPropKey: A key (generally relating to dECPropType).

Example

The following example from get_property_by_key.txt illustrates the use of this service:

# Retrieve an extended configuration property by key - gets all
# accounts of key #abc (regardless of subkey)
@Properties LocalData
IdcService=EC_GET_PROPERTY_BY_KEY
dECPropType=account
dECPropKey=#abc
@end

9.2.13 SET_DEFAULT_ATTRIBUTES

Service sets some default attributes that will always be applied to a user. The type is defaults and the key is userattributes, so these do not need to be provided.

Location:

IdcHomeDir/components/ExtendedUserAttributes/resources/extendeduserattributes_services.htm

Additional Required Service Parameters

  • dDefAttribs: The default attributes in the form of a comma-separated entry consisting of three items.

Optional Service Parameters

  • dECPropSubKey: A second key; the default attributes will load for all users whether or not this key is specified.

  • IsSecureDefaultAttribute: When set to 1 and used with the databinder when using the default web services ( ) then it registers defaults that only apply to logged in users. (By default, default attributes apply to all users, including anonymous.)

Example

The following example from set_defs.txt illustrates the use of this service:

# Sets some default attributes for all users
@Properties LocalData
IdcService=SET_DEFAULT_ATTRIBUTES
dECPropSubKey=extprops
dDefAttribs=account,#abc,15
@end

9.2.14 DELETE_DEFAULT_ATTRIBUTES

Service deletes some default attributes that will always be applied to a user.

Location:

IdcHomeDir/components/ExtendedUserAttributes/resources/extendeduserattributes_services.htm

Optional Service Parameters

  • dECPropSubKey: A second key. If this parameter is not specified, the service will only remove the default attributes specified without a subkey; it will not remove other attributes.

  • IsSecureDefaultAttribute: If set to 1 and used with the databinder when using the default web services ( ) then it deletes defaults that only apply to logged in users. (By default, default attributes apply to all users, including anonymous.)

Example

The following example from del_defs.txt illustrates the use of this service:

# Deletes some default attributes for all users
@Properties LocalData
IdcService=DELETE_DEFAULT_ATTRIBUTES
dECPropSubKey=extprops
@end

9.2.15 GET_DEFAULT_ATTRIBUTES

This service returns the default attributes that are applied to all users in the ResultSet DEFAULT_ATTRIBUTES.

Location:

IdcHomeDir/components/ExtendedUserAttributes/resources/extendeduserattributes_services.htm

Optional Service Parameters

  • dECPropSubKey: If specified, it narrows the search for the default attributes to only the one matching that subkey.

  • IsSecureDefaultAttribute: If set to 1 and used with the databinder when using the default web services ( ) then it retrieves defaults that only apply to logged in users. (By default, default attributes apply to all users, including anonymous.)

Example

The following example from get_defs.txt illustrates the use of this service:

# Returns all default attributes for all users
@Properties LocalData
IdcService=GET_DEFAULT_ATTRIBUTES
@end

9.2.16 SET_EXTENDED_ATTRIBUTE_MAPPINGS

Service sets mappings from one user attribute to another user attribute. Only mappings from roles to other attributes is supported (mapping does not work when the source is an account).

Location:

IdcHomeDir/components/ExtendedUserAttributes/resources/extendeduserattributes_services.htm

Additional Required Service Parameters

  • ExtUserAttribInfo: A result set containing extended user attribute information.

Example

The following example from set_attr_mapping.txt illustrates the use of this service:

<?hda version="11gR1-dev" jcharset=Cp1252 encoding=iso-8859-1?>

# Add the 'contributor' role to all users with the
# 'guest' role, and then consequently give all users
# with the 'contributor' role read/write access to
# account 'abc'. (This does mean that users with 
# the 'guest' role ultimately end up with access to 'abc').
@Properties LocalData
IdcService=SET_EXTENDED_ATTRIBUTE_MAPPINGS
@end
@ResultSet ExtUserAttribInfo
3
dAttributeName
dApplication
guest
appl
role,contributor,15
contributor
app2
account,abc,3
@end

9.2.17 DELETED_EXTENDED_ATTRIBUTE_MAPPINGS

Service deletes mappings from one user attribute to another user attribute.

Location:

IdcHomeDir/components/ExtendedUserAttributes/resources/extendeduserattributes_services.htm

Additional Required Service Parameters

  • ExtUserAttribInfo: A result set containing extended user attribute information.

Optional Service Parameters

  • allowMissingAttributes: If set to true, the service suppresses errors when trying to delete attributes that do not exist. The default is false.

Example

The following example from del_attr_mapping.txt illustrates the use of this service:

<?hda version="11gR1-dev" jcharset=Cp1252 encoding=iso-8859-1?>

# Delete two attribute mappings
@Properties LocalData
IdcService=DELETE_EXTENDED_ATTRIBUTE_MAPPINGS
@end
@ResultSet ExtUserAttribInfo
3
dAttributeName
dApplication
AttributeInfo
guest
appl
role,contributor,15
contributor
app2
account,abc,3
@end

9.2.18 ADD_USER

The service has been altered to add extended user attributes at the same time the user is added. For additional information see Section 4.14.4, "ADD_USER."

Location:

IdcHomeDir/components/ExtendedUserAttributes/resources/extendeduserattributes_services.htm

Optional Service Parameter

  • ExtUserAttribInfo ResultSet: A result set containing extended user attribution information. If it is not included, no extended attributes are added.

Example

The following example from add_user.txt illustrates the use of this service:

# Add user with extended security data
@Properties LocalData
IdcService=ADD_USER
dName=jsmith
dUserAuthType=Local
dFullName=Jennifer Smith
dPassword=password
dEmail=email@example.com
@end
@ResultSet UserAttribInfo
2
dUserName
AttributeInfo
jsmith
role,guest,15
@end
@ResultSet ExtUserAttribInfo
3
dUserName
dApplication
AttributeInfo
jsmith
appl
account,abc,15
@end

9.2.19 EDIT_USER

This service has been altered to allow editing of extended user attributes at the same time. The old values are completely replaced by the new ones. For additional information, see Section 4.14.4, "ADD_USER."

Location:

IdcHomeDir/components/ExtendedUserAttributes/resources/extendeduserattributes_services.htm

Optional Service Parameters

  • ExtUserAttribInfo ResultSet: A result set containing extended user attribution information. If it is not included, the extended attributes are not replaced.

Example

The following example from edit_user.txt illustrates the use of this service:

# Edit user with extended security data
@Properties LocalData
IdcService=EDIT_USER
dName=jsmith
dUserAuthType=Local
dFullName=Justin Smith
dPassword=12345
dEmail=real@real.com
@end
@ResultSet UserAttribInfo
2
dUserName
AttributeInfo
jsmith
role,guest,15
@end
@ResultSet ExtUserAttribInfo
3
dUserName
dApplication
AttributeInfo
jsmith
appl
account,abc,7,account,xyz,15
@end

9.2.20 DELETE_USER

This service has been altered to delete a user's extended attributes if they exist. For additional information, see Section 4.14.10, "DELETE_USER."

Location:

IdcHomeDir/components/ExtendedUserAttributes/resources/extendeduserattributes_services.htm

Example

The following example from delete_user.txt illustrates the use of this service:

# Delete user with extended security data
@Properties LocalData
IdcService=DELETE_USER
dName=jsmith
@end

9.2.21 QUERY_USER_ATTRIBUTES

This service acts as usual however the attributes it returns are contingent on the value of the getAllAttributes parameter. If the parameter is passed as true, this service returns a merger of both regular and extended user attributes. For additional information, see Section 4.14.24, "QUERY_USER_ATTRIBUTES."

Location:

IdcHomeDir/components/ExtendedUserAttributes/resources/extendeduserattributes_services.htm

Example

The following example from query_user_attr.txt illustrates the use of this service:

# The normal QUERY_USER_ATTRIBUTES, except it gathers all
# attributes now
@Properties LocalData
IdcService=QUERY_USER_ATTRIBUTES
dName=jsmith
getAllAttributes=true
@end