com.sap.security.api
Interface IUserMaint

All Superinterfaces:

IPrincipal, IPrincipalMaint, IUser, java.security.Principal, java.io.Serializable

public interface IUserMaint

extends IUser, IPrincipalMaint

This interface extends IUser. It provides methods to change the user's attributes, to commit these changes to the user store or to roll them back (i.e. discard them) if appropriate. It is intended for administration of user profiles (including self-administration). It does not cover account, password and authorization management. The set-methods with boolean return values return true if the new value is different from the previous value. Calling set-methods with a value of null effectively removes an attribute.

Version:

1.0

Fields inherited from interface com.sap.security.api.IUser

DEFAULT_ACCESSIBILITY_LEVEL, SCREENREADER_ACCESSIBILITY_LEVEL, VERSIONSTRING

Fields inherited from interface com.sap.security.api.IPrincipal

BYTE_TYPE, DEFAULT_NAMESPACE, DEFAULT_RELATION_NAMESPACE, DESCRIPTION, DISPLAYNAME, PRINCIPAL_CREATION_DATE, PRINCIPAL_MODIFY_DATE, PRINCIPAL_RELATION_MEMBER_ATTRIBUTE, PRINCIPAL_RELATION_PARENT_ATTRIBUTE, STRING_TYPE, TRANSIENT_NAMESPACE, UNIQUE_NAME

Method Summary

void	addToGroup(java.lang.String uniqueIdOfGroup) Deprecated. use IGroupFactory.addUserToGroup(String,String) instead
void	addToRole(java.lang.String uniqueIdOfRole) Deprecated. use IRoleFactory.addUserToRole(String, String) instead
void	removeFromGroup(java.lang.String uniqueIdOfGroup) Deprecated. use IGroupFactory.removeUserFromGroup(String, String) instead
void	removeFromRole(java.lang.String uniqueIdOfRole) Deprecated. use IRoleFactory.removeUserFromRole(String, String) instead
void	setAccessibilityLevel(int accessibilityLevel) Set the user's accessibility level used for Screen Reader Support
boolean	setCellPhone(java.lang.String cellphone) Sets the user's default cellphone number.
boolean	setCity(java.lang.String city) Sets the user's city.
boolean	setCompany(java.lang.String companyid) Sets the unique ID of the user's company.
boolean	setCountry(java.lang.String country) Sets the ISO-3166 two-letter uppercase code of the country where the user lives.
boolean	setCurrency(java.lang.String currency) Sets the three letter uppercase code of the user's currency, e.g.
boolean	setDepartment(java.lang.String department) Sets the user's department.
boolean	setDisplayName(java.lang.String displayName) Sets the user's display name.
boolean	setEmail(java.lang.String email) Sets the user's default email address.
boolean	setFax(java.lang.String fax) Sets the user's default fax number.
boolean	setFirstName(java.lang.String firstname) Sets the user's first name.
boolean	setJobTitle(java.lang.String jobtitle) Sets the user's job title, e.g.
boolean	setLastName(java.lang.String lastname) Sets the user's last name.
boolean	setLocale(java.util.Locale locale) Sets the user's Locale; this determines e.g.
boolean	setSalutation(java.lang.String salutation) Sets the user's salutation.
boolean	setState(java.lang.String state) Sets the user's state or region.
boolean	setStreet(java.lang.String street) Sets the user's street.
boolean	setTelephone(java.lang.String telephone) Sets the user's default telephone number.
boolean	setTimeZone(java.util.TimeZone timezone) Sets the user's time zone.
boolean	setTitle(java.lang.String title) Sets the user's academic title or title of nobility.
boolean	setZip(java.lang.String zip) Sets the zip code of the user's city.

Methods inherited from interface com.sap.security.api.IUser

checkPermission, getAccessibilityLevel, getCellPhone, getCity, getCompany, getCountry, getCurrency, getDepartment, getEmail, getFax, getFirstName, getJobTitle, getLastName, getLocale, getParentGroups, getRoles, getSalutation, getState, getStreet, getTelephone, getTimeZone, getTitle, getTransientAttribute, getUid, getUniqueName, getUserAccounts, getUserAccountUniqueIDs, getUserFactory, getZip, hasPermission, isCompanyUser, isMemberOfGroup, isMemberOfRole, setTransientAttribute

Methods inherited from interface java.security.Principal

equals, getName, hashCode, toString

Methods inherited from interface com.sap.security.api.IPrincipal

created, equals, getAttribute, getAttributeNames, getAttributeNamespaces, getAttributeType, getBinaryAttribute, getDisplayName, getParents, getUniqueID, hashCode, isExistenceChecked, isMutable, lastModified, refresh

Methods inherited from interface com.sap.security.api.IPrincipalMaint

commit, isModified, rollback, save, setAttribute, setBinaryAttribute

Method Detail

setTitle

public boolean setTitle(java.lang.String title)

Sets the user's academic title or title of nobility.

Parameters:

title - String containing the user's title

setSalutation

public boolean setSalutation(java.lang.String salutation)

Sets the user's salutation. This may include academic titles.

Parameters:

salutation - String containing the user's salutation

setJobTitle

public boolean setJobTitle(java.lang.String jobtitle)

Sets the user's job title, e.g. Developer, Development Architect, Development Manager etc.

Parameters:

jobtitle - String containing the user's jobtitle

setDepartment

public boolean setDepartment(java.lang.String department)

Sets the user's department.

Parameters:

department - String containing the user's department

setDisplayName

public boolean setDisplayName(java.lang.String displayName)

Sets the user's display name.

Specified by:

setDisplayName in interface IPrincipalMaint

Parameters:

displayName - String containing the user's displayName

setFirstName

public boolean setFirstName(java.lang.String firstname)

Sets the user's first name. This may include one or more middle names.

Parameters:

firstname - String containing the user's firstname

setLastName

public boolean setLastName(java.lang.String lastname)

Sets the user's last name. This may include second names.

Parameters:

lastname - String containing the user's lastname

setStreet

public boolean setStreet(java.lang.String street)

Sets the user's street. This may include house numbers, street numbers etc.

Parameters:

street - String containing the user's street

setCity

public boolean setCity(java.lang.String city)

Sets the user's city.

Parameters:

city - String containing the user's city

setZip

public boolean setZip(java.lang.String zip)

Sets the zip code of the user's city.

Parameters:

zip - String containing the user's zip

setState

public boolean setState(java.lang.String state)

Sets the user's state or region.

Parameters:

state - String containing the user's state

setCountry

public boolean setCountry(java.lang.String country)

Sets the ISO-3166 two-letter uppercase code of the country where the user lives.

NOTE that this is independent from the country available via getCountry() of the user's Locale, since expatriate users may not have their Locale's country set to the country where they actually reside.

Parameters:

country - String containing the user's country

setLocale

public boolean setLocale(java.util.Locale locale)

Sets the user's Locale; this determines e.g. the language in which text is displayed to the user's and the style that numbers are formated.

Parameters:

locale - String containing the user's locale object

setTimeZone

public boolean setTimeZone(java.util.TimeZone timezone)

Sets the user's time zone.

Parameters:

timezone - String containing the user's timezone

setCurrency

public boolean setCurrency(java.lang.String currency)

Sets the three letter uppercase code of the user's currency, e.g. DEM, EUR or USD.

Parameters:

currency - String containing the user's currency

setTelephone

public boolean setTelephone(java.lang.String telephone)

Sets the user's default telephone number.

Parameters:

telephone - String containing the user's telephone

setCellPhone

public boolean setCellPhone(java.lang.String cellphone)

Sets the user's default cellphone number.

Parameters:

cellphone - String containing the user's cellphone

setFax

public boolean setFax(java.lang.String fax)

Sets the user's default fax number.

Parameters:

fax - String containing the user's fax

setEmail

public boolean setEmail(java.lang.String email)

Sets the user's default email address.

Parameters:

email - String containing the user's email

setCompany

public boolean setCompany(java.lang.String companyid)

Sets the unique ID of the user's company.

Parameters:

companyid - String containing the user's companyid

setAccessibilityLevel

public void setAccessibilityLevel(int accessibilityLevel)
                           throws UMException

Set the user's accessibility level used for Screen Reader Support

Parameters:

accessibilityLevel - String containing the user's accessibility level Valid values are following constants IUser.DEFAULT_ACCESSIBILITY_LEVEL or IUser.SCREENREADER_ACCESSIBILITY_LEVEL

addToGroup

public void addToGroup(java.lang.String uniqueIdOfGroup)
                throws UMException

Deprecated. use IGroupFactory.addUserToGroup(String,String) instead

Assign this principal to a group identified by uniqueIdOfGroup. Implicitly a commit is done if you call this method because the membership of groups is stored in the group's object. Be aware that adding this user to a group is done independently of committing this IUserMaint changes to the user store or to roll them back.

Parameters:

uniqueIdOfGroup - id of the group

Throws:

UMException -

removeFromGroup

public void removeFromGroup(java.lang.String uniqueIdOfGroup)
                     throws UMException

Deprecated. use IGroupFactory.removeUserFromGroup(String, String) instead

Unassign this principal from a group identified by uniqueIdOfGroup. Implicitly a commit is done if you call this method because the membership of groups is stored in the group's object data store. Be aware that removing this user from a group is done independently of committing this IUserMaint changes to the user store or to roll them back.

Parameters:

uniqueIdOfGroup - id of the group

Throws:

UMException -

addToRole

public void addToRole(java.lang.String uniqueIdOfRole)
               throws UMException

Deprecated. use IRoleFactory.addUserToRole(String, String) instead

Assign this principal to a role identified by uniqueIdOfRole. Implicitly a commit is done if you call this method because the membership of roles is stored in the role's object. Be aware that adding this user to a role is done independently of committing this IUserMaint changes to the user store or to roll them back.

Parameters:

uniqueIdOfRole - uniqueId of a role

Throws:

UMException -

removeFromRole

public void removeFromRole(java.lang.String uniqueIdOfRole)
                    throws UMException

Deprecated. use IRoleFactory.removeUserFromRole(String, String) instead

Unassign this principal from a role identified by uniqueIdOfRole. Implicitly a commit is done if you call this method because the membership of roles is stored in the role's object. Be aware that removing this user from a role is done independently of committing this IUserMaint changes to the user store or to roll them back.

Parameters:

uniqueIdOfRole - uniqueId of a role

Throws:

UMException -