Interface UserModifier
-
- All Superinterfaces:
IntermediateStorageProvider
,Modifier<User>
,UndeletableModifier<User>
public interface UserModifier extends UndeletableModifier<User>, IntermediateStorageProvider
- Since:
- 11.2
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description UserModifier
addLanguageSkills(java.util.Locale... languages)
Add the passed language skills to the user.UserModifier
addRoutingTags(RoutingTag... routingTags)
Add the passed routing tags to the user.User.CategoryMode
getAutoRoutingCategoryMode()
Get the currentCategoryMode
for the automatic routing of this user which is held in thisUserModifier
.java.lang.String
getEmailAddress()
Get the current user email address in the form local-part@domain (see https://tools.ietf.org/html/rfc5322#section-3.4.1) which is held in thisUserModifier
.java.util.Set<java.util.Locale>
getLanguageSkills()
Get the current language skills which are held in thisUserModifier
.java.util.Locale
getLocale()
Get the currentLocale
representing the display language of this user which is held in thisUserModifier
.Location
getLocation()
Get the currentLocation
which is held in thisUserModifier
.User.CategoryMode
getManualRoutingCategoryMode()
Get the currentCategoryMode
for the manual routing of this user which is held in thisUserModifier
.int
getMaxChats()
Get the current maximum number of chats that should be routed to this user which is held in thisUserModifier
.int
getMaxMails()
Get the current maximum number of mails that should be routed to this user which is held in thisUserModifier
.java.lang.String
getName()
Get the current user name which is held in thisUserModifier
.java.lang.String
getPassword()
Get the current user password which is held in thisUserModifier
.java.util.Set<RoutingTag>
getRoutingTags()
Get the current routing tags which are held in thisUserModifier
.java.lang.String
getSignature()
Get the current signature which is held in thisUserModifier
.java.lang.String
getUsername()
Get the current user username which is held in thisUserModifier
.boolean
isAgent()
Get the current agent flag which is held in thisUserModifier
.boolean
isClearanceRequired()
Get the current clearance required value which is held in thisUserModifier
.boolean
isLocked()
Get the current locked flag which is held in thisUserModifier
.UserModifier
removeLanguageSkills(java.util.Locale... languages)
Remove the passed language skills of the user.UserModifier
removeRoutingTags(RoutingTag... routingTags)
Remove the passed routing tags of the user.UserModifier
setAgent(boolean agent)
Change the agent flag.UserModifier
setAutoRoutingCategoryMode(User.CategoryMode autoRoutingCategoryMode)
Change theCategoryMode
for the automatic routing of this user.UserModifier
setClearanceRequired(boolean clearanceRequired)
Change the clearance required value.UserModifier
setEmailAddress(java.lang.String emailAddress)
Change the email address of the associatedUser
.UserModifier
setLocale(java.util.Locale locale)
Change theLocale
representing the display language of this user.UserModifier
setLocation(Location location)
Set the location.UserModifier
setLocked(boolean locked)
Change the locked flag.UserModifier
setManualRoutingCategoryMode(User.CategoryMode manualRoutingCategoryMode)
Change theCategoryMode
for the manual routing of this user.UserModifier
setMaxChats(int maxChats)
Change the maximum number of chats that should be routed to this user.UserModifier
setMaxMails(int maxMails)
Change the maximum number of mails that should be routed to this user.UserModifier
setName(java.lang.String name)
Change the name of the associatedUser
.UserModifier
setPassword(java.lang.String password)
Change the password of the associatedUser
.UserModifier
setSignature(java.lang.String signature)
Change the signature of the associatedUser
.UserModifier
setUsername(java.lang.String username)
Change the username of the associatedUser
.boolean
validateAgent(boolean agent)
Validate the given agent flag.boolean
validateAutoRoutingCategoryMode(User.CategoryMode autoRoutingCategoryMode)
Validate theCategoryMode
for the automatic routing of this user.boolean
validateClearanceRequired(boolean clearanceRequired)
Validate the given clearance required value.boolean
validateEmailAddress(java.lang.String emailAddress)
Validate the given email address.boolean
validateLocale(java.util.Locale locale)
Validate theLocale
representing the display language of this user.boolean
validateLocation(Location location)
Validate the given location.boolean
validateManualRoutingCategoryMode(User.CategoryMode manualRoutingCategoryMode)
Validate theCategoryMode
for the manual routing of this user.boolean
validateMaxChats(int maxChats)
Validate the given maximum number of chats that should be routed to this user.boolean
validateMaxMails(int maxMails)
Validate the given maximum number of mails that should be routed to this user.boolean
validateName(java.lang.String name)
Validate the given name.boolean
validatePassword(java.lang.String password)
Validate the given password.boolean
validateSignature(java.lang.String signature)
Validate the given signature.boolean
validateUsername(java.lang.String username)
Validate the given username.-
Methods inherited from interface com.novomind.ecom.api.iagent.provider.IntermediateStorageProvider
getIntermediateStorage
-
Methods inherited from interface com.novomind.ecom.api.imail.routing.persistence.Modifier
delete, get, write
-
Methods inherited from interface com.novomind.ecom.api.imail.routing.persistence.UndeletableModifier
undelete
-
-
-
-
Method Detail
-
getName
java.lang.String getName()
Get the current user name which is held in thisUserModifier
.- Returns:
- the name as String
- Since:
- 11.2
-
setName
UserModifier setName(java.lang.String name) throws ValidationException
Change the name of the associated
User
.The change is applied after the
Modifier.write()
method is called.- Parameters:
name
- the new name as String- Returns:
- the
UserModifier
- Throws:
ValidationException
- if the new name is invalid- Since:
- 11.2
-
validateName
boolean validateName(java.lang.String name) throws ValidationException
Validate the given name.- Parameters:
name
- the name to validate as String- Returns:
- true if the name is valid
- Throws:
ValidationException
- if the name is invalid- Since:
- 11.2
-
getUsername
java.lang.String getUsername()
Get the current user username which is held in thisUserModifier
.- Returns:
- the username as String
- Since:
- 11.2
-
setUsername
UserModifier setUsername(java.lang.String username) throws ValidationException
Change the username of the associated
User
. The username needs to be unique in the novomind iAGENT system. Please note that the username can only be changed if theUser
is not logged in.The change is applied after the
Modifier.write()
method is called.- Parameters:
username
- the new username as String- Returns:
- the
UserModifier
- Throws:
ValidationException
- if the new username is invalid or the user is logged in- Since:
- 11.2
-
validateUsername
boolean validateUsername(java.lang.String username) throws ValidationException
Validate the given username. The username needs to be unique in the novomind iAGENT system. Please note that the username can only be changed if theUser
is not logged in.- Parameters:
username
- the username to validate as String- Returns:
- true if the username is valid
- Throws:
ValidationException
- if the username is invalid or the user is logged in- Since:
- 11.2
-
getPassword
java.lang.String getPassword()
Get the current user password which is held in thisUserModifier
. There is no fallback to the underlaying user. If the password hasn't been changed in thisUserModifier
this method returns null.- Returns:
- the password as String
- Since:
- 11.2
-
setPassword
UserModifier setPassword(java.lang.String password) throws ValidationException
Change the password of the associated
User
.The change is applied after the
Modifier.write()
method is called.- Parameters:
password
- the new password as String- Returns:
- the
UserModifier
- Throws:
ValidationException
- if the new password is invalid- Since:
- 11.2
-
validatePassword
boolean validatePassword(java.lang.String password) throws ValidationException
Validate the given password.- Parameters:
password
- the password to validate as String- Returns:
- true if the password is valid
- Throws:
ValidationException
- if the password is invalid- Since:
- 11.2
-
getEmailAddress
java.lang.String getEmailAddress()
Get the current user email address in the form local-part@domain (see https://tools.ietf.org/html/rfc5322#section-3.4.1) which is held in thisUserModifier
.- Returns:
- the email address as String in the form local-part@domain (see https://tools.ietf.org/html/rfc5322#section-3.4.1)
- Since:
- 11.2
-
setEmailAddress
UserModifier setEmailAddress(java.lang.String emailAddress) throws ValidationException
Change the email address of the associated
User
. The email address needs to be unique in the novomind iAGENT system. Please note that the email address can only be changed if theUser
is not logged in.The change is applied after the
Modifier.write()
method is called.- Parameters:
emailAddress
- the new email address as String in the form local-part@domain (see https://tools.ietf.org/html/rfc5322#section-3.4.1)- Returns:
- the
UserModifier
- Throws:
ValidationException
- if the new email address is invalid or the user is logged in- Since:
- 11.2
-
validateEmailAddress
boolean validateEmailAddress(java.lang.String emailAddress) throws ValidationException
Validate the given email address. The email address needs to be unique in the novomind iAGENT system. Please note that the email address can only be changed if theUser
is not logged in.- Parameters:
emailAddress
- the email address to validate as String in the form local-part@domain (see https://tools.ietf.org/html/rfc5322#section-3.4.1)- Returns:
- true if the email address is valid
- Throws:
ValidationException
- if the email address is invalid or the user is logged in- Since:
- 11.2
-
isClearanceRequired
boolean isClearanceRequired()
Get the current clearance required value which is held in thisUserModifier
.- Returns:
- true if a clearance is required, otherwise false
- Since:
- 12.2
-
setClearanceRequired
UserModifier setClearanceRequired(boolean clearanceRequired) throws ValidationException
Change the clearance required value.
The change is applied after the
Modifier.write()
method is called.- Parameters:
clearanceRequired
- the new clearance required value- Returns:
- the
UserModifier
- Throws:
ValidationException
- if the change is invalid- Since:
- 12.2
-
validateClearanceRequired
boolean validateClearanceRequired(boolean clearanceRequired) throws ValidationException
Validate the given clearance required value.- Parameters:
clearanceRequired
- the new clearance required value- Returns:
- true if the change is valid
- Throws:
ValidationException
- if the change is invalid- Since:
- 12.2
-
getMaxMails
int getMaxMails()
Get the current maximum number of mails that should be routed to this user which is held in thisUserModifier
.- Returns:
- the maximum number of mails that should be routed to this user
- Since:
- 12.2
-
setMaxMails
UserModifier setMaxMails(int maxMails) throws ValidationException
Change the maximum number of mails that should be routed to this user.
The change is applied after the
Modifier.write()
method is called.- Parameters:
maxMails
- the new maximum number of mails that should be routed to this user- Returns:
- the
UserModifier
- Throws:
ValidationException
- if the change is invalid- Since:
- 12.2
-
validateMaxMails
boolean validateMaxMails(int maxMails) throws ValidationException
Validate the given maximum number of mails that should be routed to this user.- Parameters:
maxMails
- the new maximum number of mails that should be routed to this user- Returns:
- true if the change is valid
- Throws:
ValidationException
- if the change is invalid- Since:
- 12.2
-
getMaxChats
int getMaxChats()
Get the current maximum number of chats that should be routed to this user which is held in thisUserModifier
.- Returns:
- the maximum number of chats that should be routed to this user
- Since:
- 12.2
-
setMaxChats
UserModifier setMaxChats(int maxChats) throws ValidationException
Change the maximum number of chats that should be routed to this user.
The change is applied after the
Modifier.write()
method is called.- Parameters:
maxChats
- the new maximum number of chats that should be routed to this user- Returns:
- the
UserModifier
- Throws:
ValidationException
- if the change is invalid- Since:
- 12.2
-
validateMaxChats
boolean validateMaxChats(int maxChats) throws ValidationException
Validate the given maximum number of chats that should be routed to this user.- Parameters:
maxChats
- the new maximum number of chats that should be routed to this user- Returns:
- true if the change is valid
- Throws:
ValidationException
- if the change is invalid- Since:
- 12.2
-
getAutoRoutingCategoryMode
User.CategoryMode getAutoRoutingCategoryMode()
Get the currentCategoryMode
for the automatic routing of this user which is held in thisUserModifier
.- Returns:
- the
CategoryMode
for the automatic routing - Since:
- 12.2
-
setAutoRoutingCategoryMode
UserModifier setAutoRoutingCategoryMode(User.CategoryMode autoRoutingCategoryMode) throws ValidationException
Change the
CategoryMode
for the automatic routing of this user.The change is applied after the
Modifier.write()
method is called.- Parameters:
autoRoutingCategoryMode
- the newCategoryMode
for the automatic routing of this user- Returns:
- the
UserModifier
- Throws:
ValidationException
- if the change is invalid- Since:
- 12.2
-
validateAutoRoutingCategoryMode
boolean validateAutoRoutingCategoryMode(User.CategoryMode autoRoutingCategoryMode) throws ValidationException
Validate theCategoryMode
for the automatic routing of this user.- Parameters:
autoRoutingCategoryMode
- the newCategoryMode
for the automatic routing of this user- Returns:
- true if the change is valid
- Throws:
ValidationException
- if the change is invalid- Since:
- 12.2
-
getManualRoutingCategoryMode
User.CategoryMode getManualRoutingCategoryMode()
Get the currentCategoryMode
for the manual routing of this user which is held in thisUserModifier
.- Returns:
- the
CategoryMode
for the manual routing - Since:
- 12.2
-
setManualRoutingCategoryMode
UserModifier setManualRoutingCategoryMode(User.CategoryMode manualRoutingCategoryMode) throws ValidationException
Change the
CategoryMode
for the manual routing of this user.The change is applied after the
Modifier.write()
method is called.- Parameters:
manualRoutingCategoryMode
- the newCategoryMode
for the manual routing of this user- Returns:
- the
UserModifier
- Throws:
ValidationException
- if the change is invalid- Since:
- 12.2
-
validateManualRoutingCategoryMode
boolean validateManualRoutingCategoryMode(User.CategoryMode manualRoutingCategoryMode) throws ValidationException
Validate theCategoryMode
for the manual routing of this user.- Parameters:
manualRoutingCategoryMode
- the newCategoryMode
for the manual routing of this user- Returns:
- true if the change is valid
- Throws:
ValidationException
- if the change is invalid- Since:
- 12.2
-
getLocale
java.util.Locale getLocale()
Get the currentLocale
representing the display language of this user which is held in thisUserModifier
. Please note that only the language attribute of the givenLocale
is used.- Returns:
- the display language as
Locale
- Since:
- 12.20
-
setLocale
UserModifier setLocale(java.util.Locale locale) throws ValidationException
Change the
Locale
representing the display language of this user. Please note that only the language attribute of the givenLocale
is used.The change is applied after the
Modifier.write()
method is called.- Parameters:
locale
- the newLocale
representing the display language of this user- Returns:
- the
UserModifier
- Throws:
ValidationException
- if the change is invalid- Since:
- 12.20
-
validateLocale
boolean validateLocale(java.util.Locale locale) throws ValidationException
Validate theLocale
representing the display language of this user. Please note that only the language attribute of the givenLocale
is used.- Parameters:
locale
- the newLocale
representing the display language of this user- Returns:
- the
UserModifier
- Throws:
ValidationException
- if the change is invalid- Since:
- 12.20
-
isAgent
boolean isAgent()
Get the current agent flag which is held in thisUserModifier
.- Returns:
- true if the user is an agent, otherwise false
- Since:
- 12.20
-
setAgent
UserModifier setAgent(boolean agent) throws ValidationException
Change the agent flag. Please note that the agent flag can only be changed if the
User
is not logged in.The change is applied after the
Modifier.write()
method is called.- Parameters:
agent
- the new agent flag- Returns:
- the
UserModifier
- Throws:
ValidationException
- if the change is invalid or the user is logged in- Since:
- 12.20
-
validateAgent
boolean validateAgent(boolean agent) throws ValidationException
Validate the given agent flag. Please note that the agent flag can only be changed if theUser
is not logged in.- Parameters:
agent
- the new agent flag- Returns:
- true if the change is valid
- Throws:
ValidationException
- if the change is invalid or the user is logged in- Since:
- 12.20
-
getLocation
Location getLocation()
Get the currentLocation
which is held in thisUserModifier
.- Returns:
- the location
- Since:
- 12.27
-
setLocation
UserModifier setLocation(Location location) throws ValidationException
Set the location.The change is applied after the
Modifier.write()
method is called.- Parameters:
location
- the new location- Returns:
- the
UserModifier
- Throws:
ValidationException
- if the location is invalid- Since:
- 12.27
-
validateLocation
boolean validateLocation(Location location) throws ValidationException
Validate the given location.- Parameters:
location
- the new location- Returns:
- true if the location is valid
- Throws:
ValidationException
- if the location is invalid- Since:
- 12.27
-
isLocked
boolean isLocked()
Get the current locked flag which is held in thisUserModifier
.- Returns:
- true if the user is locked, otherwise false
- Since:
- 12.27
-
setLocked
UserModifier setLocked(boolean locked)
Change the locked flag.
The change is applied after the
Modifier.write()
method is called.- Parameters:
locked
- the new locked flag- Returns:
- the
UserModifier
- Since:
- 12.27
-
getSignature
java.lang.String getSignature()
Get the current signature which is held in thisUserModifier
.- Returns:
- the signature as String
- Since:
- 12.27
-
setSignature
UserModifier setSignature(java.lang.String signature) throws ValidationException
Change the signature of the associated
User
.The change is applied after the
Modifier.write()
method is called.- Parameters:
signature
- the new signature as String- Returns:
- the
UserModifier
- Throws:
ValidationException
- if the new signature is invalid- Since:
- 12.27
-
validateSignature
boolean validateSignature(java.lang.String signature) throws ValidationException
Validate the given signature.- Parameters:
signature
- the signature to validate as String- Returns:
- true if the signature is valid
- Throws:
ValidationException
- if the signature is invalid- Since:
- 12.27
-
getLanguageSkills
java.util.Set<java.util.Locale> getLanguageSkills()
Get the current language skills which are held in thisUserModifier
. Please note that only the language attribute of the givenLocale
is used.- Returns:
- the language skills as a Set of
Locale
- Since:
- 12.27
-
addLanguageSkills
UserModifier addLanguageSkills(java.util.Locale... languages) throws ValidationException
Add the passed language skills to the user. Please note that only the language attribute of the given
Locale
is used.The change is applied after the
Modifier.write()
method is called.- Parameters:
languages
- the language skills that should be added- Returns:
- the
UserModifier
- Throws:
ValidationException
- if a language is null or not valid- Since:
- 12.27
-
removeLanguageSkills
UserModifier removeLanguageSkills(java.util.Locale... languages) throws ValidationException
Remove the passed language skills of the user. Please note that only the language attribute of the given
Locale
is used.The change is applied after the
Modifier.write()
method is called.- Parameters:
languages
- the language skills that should be removed- Returns:
- the
UserModifier
- Throws:
ValidationException
- if a language is null or not valid- Since:
- 12.27
-
getRoutingTags
java.util.Set<RoutingTag> getRoutingTags()
Get the current routing tags which are held in thisUserModifier
.- Returns:
- the routing tags as a Set of
RoutingTag
- Since:
- 12.27
-
addRoutingTags
UserModifier addRoutingTags(RoutingTag... routingTags) throws ValidationException
Add the passed routing tags to the user.
The change is applied after the
Modifier.write()
method is called.- Parameters:
routingTags
- the routing tags that should be added- Returns:
- the
UserModifier
- Throws:
ValidationException
- if a routing tag is null- Since:
- 12.27
-
removeRoutingTags
UserModifier removeRoutingTags(RoutingTag... routingTags) throws ValidationException
Remove the passed routing tags of the user.
The change is applied after the
Modifier.write()
method is called.- Parameters:
routingTags
- the routing tags that should be removed- Returns:
- the
UserModifier
- Throws:
ValidationException
- if a routing tag is null- Since:
- 12.27
-
-