Package com.redwood.scheduler.api.model
Interface OperatorMessage
-
- All Superinterfaces:
OperatorMessageComp
,Root
,SchedulerEntity
,SchedulerEntityComp
public interface OperatorMessage extends OperatorMessageComp, Root
A message created by the application or the system to inform the operator A message can be informational or it can require an answer. When a job requires an answer from the operator its status will be CONSOLE.
-
-
Field Summary
Fields Modifier and Type Field Description static String
OBJECT_TYPE
String that will be returned fromSchedulerEntity.getObjectType()
for "OperatorMessage" objects.static String
SEC_PRIV_DELETE
This privilege can be granted at a group level.static String
SEC_PRIV_REPLY
This privilege can be granted at a group level.static String
SEC_PRIV_VIEW
This privilege can be granted at a group level.static String
SEC_RANK_ALL
This rank is made of the following privileges: view , reply , deletestatic String
SEC_RANK_NONE
This rank has no privileges assigned to it.static String
SEC_RANK_OPERATOR
This rank is made of the following privileges: view , replystatic String
SEC_RANK_VIEW
This rank is made of the following privileges: viewstatic QueryObjectType<OperatorMessage>
TYPE
Type that can be used inSchedulerSession.executeObjectQuery(QueryObjectType, String, Object...)
.-
Fields inherited from interface com.redwood.scheduler.api.model.SchedulerEntity
ACTION_AUDIT, ACTION_EXPORT, ACTION_READ, BEHAVIOR_DEPRECATED, BEHAVIOR_NONE, BEHAVIOR_SYSTEM
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description RequiredPermission
checkDeletePrivilege()
Check whether or not the delete action can be performed on this object.RequiredPermission
checkReplyPrivilege()
Check whether or not the reply action can be performed on this object.RequiredPermission
checkViewPrivilege()
Check whether or not the view action can be performed on this object.OperatorMessageDatum
createOperatorMessageDatum()
Create a newOperatorMessageDatum
linked to this object.RWIterable<Alert>
getAlerts()
Get anRWIterable
over an ordered collection ofAlerts
.String
getFullText()
Get the value for FullText.IsolationGroup
getIsolationGroup()
Get the IsolationGroup.Map<String,String>
getMapOfReplies()
Get a map of possible values that are applicable for this message.Long
getNumAdditionalLines()
Get the value for NumAdditionalLines.RWIterable<OperatorMessageDatum>
getOperatorMessageData()
Get anRWIterable
over a collection ofOperatorMessageData
, the collection will be ordered by Name.OperatorMessageDatum
getOperatorMessageDatumByName(String name)
Get the OperatorMessageDatum by OperatorMessageName.Partition
getPartition()
Get the Partition.Subject
getRepliedBySubject()
Get the RepliedBySubject.String
getReply()
Get the value for Reply.String
getReplyExpression()
Get the value for ReplyExpression.ReplyStatus
getReplyStatus()
Get the value for ReplyStatus.DateTimeZone
getReplyTime()
Get the value for ReplyTime.SchedulerEntity
getSenderObject()
Get the value for SenderObject.ObjectDefinition
getSenderObjectDefinition()
Get the SenderObjectDefinition.String
getSenderObjectDescription()
Get the value for SenderObjectDescription.String
getTitleText()
Get the value for TitleText.void
setFullText(String newFullText)
Set the value for FullText.void
setIsolationGroup(IsolationGroup newIsolationGroup)
Set the value for IsolationGroup.void
setPartition(Partition newPartition)
Set the value for Partition.void
setReply(String newReply)
Set the value for Reply.void
setReplyExpression(String newReplyExpression)
Set the value for ReplyExpression.void
setSenderObject(SchedulerEntity newSenderObject)
Set the value for SenderObject.void
setSenderObjectDefinition(ObjectDefinition newSenderObjectDefinition)
Set the value for SenderObjectDefinition.-
Methods inherited from interface com.redwood.scheduler.api.model.Root
getCreationTime, getLastModificationTime, getLastModifierSubject
-
Methods inherited from interface com.redwood.scheduler.api.model.SchedulerEntity
canPerform, createSubjectObjectPrivilegeGrant, deleteObject, getAuditTrail, getAuditTrailSize, getBehavior, getEffectiveBehavior, getErrorNameEN, getErrorNameKey, getLLPVersion, getLOV, getLOVSupport, getObjectType, getParentSchedulerEntities, getRuntime, getSubjectObjectPrivilegeGrantBySubject, getSubjectObjectPrivilegeGrants, getUniqueId, getUrl, getUrl, isCreated, isDeletable, isDeleted, isModifiable, isModified, isSelectVersioned, processRelatedObjects, processRelatedObjects, processRelatedObjects, refreshObject, resetObject, resetObject, resetValuesToDefault, selectForRead
-
-
-
-
Field Detail
-
OBJECT_TYPE
static final String OBJECT_TYPE
String that will be returned fromSchedulerEntity.getObjectType()
for "OperatorMessage" objects.- See Also:
- Constant Field Values
-
TYPE
static final QueryObjectType<OperatorMessage> TYPE
Type that can be used inSchedulerSession.executeObjectQuery(QueryObjectType, String, Object...)
.
-
SEC_PRIV_VIEW
static final String SEC_PRIV_VIEW
This privilege can be granted at a group level. This privilege can be granted at an instance level.- See Also:
- Constant Field Values
-
SEC_PRIV_REPLY
static final String SEC_PRIV_REPLY
This privilege can be granted at a group level. This privilege can be granted at an instance level.- See Also:
- Constant Field Values
-
SEC_PRIV_DELETE
static final String SEC_PRIV_DELETE
This privilege can be granted at a group level. This privilege can be granted at an instance level.- See Also:
- Constant Field Values
-
SEC_RANK_NONE
static final String SEC_RANK_NONE
This rank has no privileges assigned to it.- See Also:
- Constant Field Values
-
SEC_RANK_VIEW
static final String SEC_RANK_VIEW
This rank is made of the following privileges: view- See Also:
- Constant Field Values
-
SEC_RANK_OPERATOR
static final String SEC_RANK_OPERATOR
This rank is made of the following privileges: view , reply- See Also:
- Constant Field Values
-
SEC_RANK_ALL
static final String SEC_RANK_ALL
This rank is made of the following privileges: view , reply , delete- See Also:
- Constant Field Values
-
-
Method Detail
-
getFullText
String getFullText()
Get the value for FullText. (The full text of the operator message.) This value is mandatory, and therefore will not benull
if this object has been retrieved from the database.- Returns:
- the field
- Throws:
com.redwood.scheduler.api.exception.ObjectNotAttachedToSessionException
- This will be thrown if this method is called while the object is not attached to a session.
-
getTitleText
String getTitleText()
Get the value for TitleText. (The first line of the translated operator message, or the entire message if it cannot be translated.) This value is mandatory, and therefore will not benull
if this object has been retrieved from the database.- Returns:
- the field
- Throws:
com.redwood.scheduler.api.exception.ObjectNotAttachedToSessionException
- This will be thrown if this method is called while the object is not attached to a session.
-
getNumAdditionalLines
Long getNumAdditionalLines()
Get the value for NumAdditionalLines. (The number of additional lines to this message.) This value is mandatory, and therefore will not benull
if this object has been retrieved from the database.- Returns:
- the field
- Throws:
com.redwood.scheduler.api.exception.ObjectNotAttachedToSessionException
- This will be thrown if this method is called while the object is not attached to a session.
-
getReplyExpression
String getReplyExpression()
Get the value for ReplyExpression. (Aregular expression
to which the reply should match, or null of no reply is expected)- Returns:
- the field
- Throws:
com.redwood.scheduler.api.exception.ObjectNotAttachedToSessionException
- This will be thrown if this method is called while the object is not attached to a session.
-
getReply
String getReply()
Get the value for Reply. (The reply to the operator message)- Returns:
- the field
- Throws:
com.redwood.scheduler.api.exception.ObjectNotAttachedToSessionException
- This will be thrown if this method is called while the object is not attached to a session.
-
getReplyStatus
ReplyStatus getReplyStatus()
Get the value for ReplyStatus. (Query the status of this operator message with respect to a reply.) This value is mandatory, and therefore will not benull
if this object has been retrieved from the database.- Returns:
- the field
- Throws:
com.redwood.scheduler.api.exception.ObjectNotAttachedToSessionException
- This will be thrown if this method is called while the object is not attached to a session.
-
getReplyTime
DateTimeZone getReplyTime()
Get the value for ReplyTime. (When was this message replied to?)- Returns:
- the field
- Throws:
com.redwood.scheduler.api.exception.ObjectNotAttachedToSessionException
- This will be thrown if this method is called while the object is not attached to a session.
-
getSenderObject
SchedulerEntity getSenderObject()
Get the value for SenderObject. (Get the SchedulerEntity that sent this operator message, or null if no sender was specified, or the sender has been deleted)- Returns:
- the field
- Throws:
com.redwood.scheduler.api.exception.ObjectNotAttachedToSessionException
- This will be thrown if this method is called while the object is not attached to a session.
-
getSenderObjectDescription
String getSenderObjectDescription()
Get the value for SenderObjectDescription. (Text representation of the SenderObject that sent this operator message)- Returns:
- the field
- Throws:
com.redwood.scheduler.api.exception.ObjectNotAttachedToSessionException
- This will be thrown if this method is called while the object is not attached to a session.
-
setFullText
void setFullText(String newFullText)
Set the value for FullText. (The full text of the operator message.) This value is mandatory.- Parameters:
newFullText
- the new value for FullText. If this isnull
, then the object cannot be persisted.- Throws:
com.redwood.scheduler.api.exception.ObjectNotAttachedToSessionException
- This will be thrown if this method is called while the object is not attached to a session.
-
setReplyExpression
void setReplyExpression(String newReplyExpression)
Set the value for ReplyExpression. (Aregular expression
to which the reply should match, or null of no reply is expected) This value is optional.- Parameters:
newReplyExpression
- the new value for ReplyExpression.- Throws:
com.redwood.scheduler.api.exception.ObjectNotAttachedToSessionException
- This will be thrown if this method is called while the object is not attached to a session.
-
setReply
void setReply(String newReply)
Set the value for Reply. (The reply to the operator message) This value is optional.- Parameters:
newReply
- the new value for Reply.- Throws:
com.redwood.scheduler.api.exception.ObjectNotAttachedToSessionException
- This will be thrown if this method is called while the object is not attached to a session.
-
setSenderObject
void setSenderObject(SchedulerEntity newSenderObject)
Set the value for SenderObject. (Get the SchedulerEntity that sent this operator message, or null if no sender was specified, or the sender has been deleted) This value is optional.- Parameters:
newSenderObject
- the new value for SenderObject.- Throws:
com.redwood.scheduler.api.exception.ObjectNotAttachedToSessionException
- This will be thrown if this method is called while the object is not attached to a session.
-
getMapOfReplies
Map<String,String> getMapOfReplies()
Get a map of possible values that are applicable for this message. If a list cannot be generated from the regular expression, it returns null. The key in the map is the value that must be set as the reply, the value is the string to be displayed to the user (which is already translated if it can be translated)- Returns:
- The map with the possible values, null if a map could not be generated.
-
getIsolationGroup
IsolationGroup getIsolationGroup()
Get the IsolationGroup.- Returns:
- IsolationGroup
- Throws:
com.redwood.scheduler.api.exception.ObjectDeletedException
- If this method is called when the object has been marked for deletion.com.redwood.scheduler.api.exception.ObjectNotAttachedToSessionException
- If this method is called when the object has been removed from it's session.
-
getSenderObjectDefinition
ObjectDefinition getSenderObjectDefinition()
Get the SenderObjectDefinition.- Returns:
- SenderObjectDefinition
- Throws:
com.redwood.scheduler.api.exception.ObjectDeletedException
- If this method is called when the object has been marked for deletion.com.redwood.scheduler.api.exception.ObjectNotAttachedToSessionException
- If this method is called when the object has been removed from it's session.
-
getPartition
Partition getPartition()
Get the Partition.- Returns:
- Partition
- Throws:
com.redwood.scheduler.api.exception.ObjectDeletedException
- If this method is called when the object has been marked for deletion.com.redwood.scheduler.api.exception.ObjectNotAttachedToSessionException
- If this method is called when the object has been removed from it's session.
-
getRepliedBySubject
Subject getRepliedBySubject()
Get the RepliedBySubject.- Returns:
- RepliedBySubject
- Throws:
com.redwood.scheduler.api.exception.ObjectDeletedException
- If this method is called when the object has been marked for deletion.com.redwood.scheduler.api.exception.ObjectNotAttachedToSessionException
- If this method is called when the object has been removed from it's session.
-
setIsolationGroup
void setIsolationGroup(IsolationGroup newIsolationGroup)
Set the value for IsolationGroup. This value is mandatory.- Parameters:
newIsolationGroup
- is the object to set IsolationGroup to. To which isolation group does this message effectively belong. If this isnull
, then the object cannot be persisted.
-
setSenderObjectDefinition
void setSenderObjectDefinition(ObjectDefinition newSenderObjectDefinition)
Set the value for SenderObjectDefinition. This value is optional.- Parameters:
newSenderObjectDefinition
- is the object to set SenderObjectDefinition to. What type of object raised this operator message?
-
setPartition
void setPartition(Partition newPartition)
Set the value for Partition. This value is optional.- Parameters:
newPartition
- is the object to set Partition to. To which isolation group does this message effectively belong.
-
getAlerts
RWIterable<Alert> getAlerts()
Get anRWIterable
over an ordered collection ofAlerts
. If the collection is empty, an empty iterator will be returned, that is, this method will never returnnull
. What type of object raised this alert?- Specified by:
getAlerts
in interfaceOperatorMessageComp
- Returns:
- An
RWIterable
over an ordered collection ofAlert
objects .
-
getOperatorMessageData
RWIterable<OperatorMessageDatum> getOperatorMessageData()
Get anRWIterable
over a collection ofOperatorMessageData
, the collection will be ordered by Name. If the collection is empty, an empty iterator will be returned, that is, this method will never returnnull
. Email alert gateway headers.- Specified by:
getOperatorMessageData
in interfaceOperatorMessageComp
- Returns:
- An
RWIterable
over a collection ofOperatorMessageDatum
objects , the collection will be ordered by Name.
-
createOperatorMessageDatum
OperatorMessageDatum createOperatorMessageDatum()
Create a newOperatorMessageDatum
linked to this object.- Returns:
- a new
OperatorMessageDatum
.
-
getOperatorMessageDatumByName
OperatorMessageDatum getOperatorMessageDatumByName(String name)
Get the OperatorMessageDatum by OperatorMessageName.- Parameters:
name
-- Returns:
- the OperatorMessageDatum, or
null
if it could not be found
-
checkViewPrivilege
RequiredPermission checkViewPrivilege()
Check whether or not the view action can be performed on this object.- Returns:
- a
RequiredPermission
instance indicating whether the current user has the privilege. To check this, use isAllowed() on the returned permission.
-
checkReplyPrivilege
RequiredPermission checkReplyPrivilege()
Check whether or not the reply action can be performed on this object.- Returns:
- a
RequiredPermission
instance indicating whether the current user has the privilege. To check this, use isAllowed() on the returned permission.
-
checkDeletePrivilege
RequiredPermission checkDeletePrivilege()
Check whether or not the delete action can be performed on this object.- Returns:
- a
RequiredPermission
instance indicating whether the current user has the privilege. To check this, use isAllowed() on the returned permission.
-
-