org.ametys.cms.workflow

Class SendMailFunction

java.lang.Object

org.ametys.plugins.workflow.AbstractWorkflowComponent

org.ametys.cms.workflow.AbstractContentWorkflowComponent

org.ametys.cms.workflow.SendMailFunction

All Implemented Interfaces:

com.opensymphony.workflow.FunctionProvider, PluginAware, Initializable, Contextualizable, LogEnabled, Serviceable

Direct Known Subclasses:

SendMailFunction, SendMailToUserFunction

public class SendMailFunction
extends AbstractContentWorkflowComponent
implements com.opensymphony.workflow.FunctionProvider, Initializable, PluginAware, Contextualizable

OS workflow function to send mail after an action is triggered.

Field Summary

Fields

Modifier and Type	Field and Description
protected Context	_context The Avalon context.
protected CurrentUserProvider	_currentUserProvider The current user provider.
protected I18nUtils	_i18nUtils I18nUtils
protected String	_pluginName The plugin name.
protected RightManager	_rightManager The rights manager.
protected SourceResolver	_sourceResolver The source resolver.
protected UserManager	_userManager The users manager.
protected WorkflowProvider	_workflowProvider The workflow.
protected static String	BODY_KEY The mail body key.
protected static String	RIGHTS_KEY The rights key.
static String	SEND_MAIL Provide "false" to prevent the function sending the mail.
protected static String	SUBJECT_KEY The mail subject key.

Fields inherited from class org.ametys.cms.workflow.AbstractContentWorkflowComponent

_contentHelper, CONTENT_KEY

Fields inherited from class org.ametys.plugins.workflow.AbstractWorkflowComponent

_logger, _manager, CONTEXT_PARAMETERS_KEY, FAIL_CONDITIONS_KEY, RESULT_MAP_KEY, WORKFLOW_ERRORS_KEY, WORKFLOW_WARNS_KEY

Constructor Summary

Constructors

Constructor and Description
SendMailFunction()

Method Summary

Modifier and Type	Method and Description
protected String	_getContentUri(WorkflowAwareContent content) Get the content uri
Request	_getRequest() Retrieve the request from which this component is called.
protected String	_getRequestUri() Get the request URI.
protected Set<UserIdentity>	_getUsers(WorkflowAwareContent content, Set<String> rights) Get the user logins.
protected void	_sendMails(String subject, String body, Set<UserIdentity> users, String from) Send the notification emails.
void	contextualize(Context context)
void	execute(Map transientVars, Map args, com.opensymphony.module.propertyset.PropertySet ps)
protected List<String>	getBodyI18nParams(User user, WorkflowAwareContent content) Get the i18n parameters of mail body text
protected String	getMailBody(String bodyI18nKey, User user, WorkflowAwareContent content, Map transientVars) Get the text body of mail
protected String	getMailSubject(String subjectI18nKey, User user, WorkflowAwareContent content) Get the subject of mail
protected List<String>	getSubjectI18nParams(User user, WorkflowAwareContent content) Get the i18n parameters of mail subject
void	initialize()
void	setPluginInfo(String pluginName, String featureName, String id) Sets the plugin info relative to the current component. Note : The feature name may be null if the targeted component in declared at plugin level.

Methods inherited from class org.ametys.cms.workflow.AbstractContentWorkflowComponent

getContent, service

Methods inherited from class org.ametys.plugins.workflow.AbstractWorkflowComponent

addWorkflowError, addWorkflowWarning, enableLogging, getConditionFailures, getContextParameters, getResultsMap, getUser

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

SEND_MAIL

public static final String SEND_MAIL

Provide "false" to prevent the function sending the mail. Useful when making large automatic workflow operations (for instance, when bulk importing and proposing in one action).

See Also:

Constant Field Values

RIGHTS_KEY

protected static final String RIGHTS_KEY

The rights key.

See Also:

Constant Field Values

SUBJECT_KEY

protected static final String SUBJECT_KEY

The mail subject key.

See Also:

Constant Field Values

BODY_KEY

protected static final String BODY_KEY

The mail body key.

See Also:

Constant Field Values

_currentUserProvider

protected CurrentUserProvider _currentUserProvider

The current user provider.

_rightManager

protected RightManager _rightManager

The rights manager.

_userManager

protected UserManager _userManager

The users manager.

_sourceResolver

protected SourceResolver _sourceResolver

The source resolver.

_workflowProvider

protected WorkflowProvider _workflowProvider

The workflow.

_context

protected Context _context

The Avalon context.

_pluginName

protected String _pluginName

The plugin name.

_i18nUtils

protected I18nUtils _i18nUtils

I18nUtils

Constructor Detail

SendMailFunction

public SendMailFunction()

Method Detail

initialize

public void initialize()
                throws Exception

Specified by:

initialize in interface Initializable

Throws:

Exception

contextualize

public void contextualize(Context context)
                   throws ContextException

Specified by:

contextualize in interface Contextualizable

Throws:

ContextException

setPluginInfo

public void setPluginInfo(String pluginName,
                          String featureName,
                          String id)

Description copied from interface: PluginAware

Sets the plugin info relative to the current component.
Note : The feature name may be null if the targeted component in declared at plugin level.

Specified by:

setPluginInfo in interface PluginAware

Parameters:

pluginName - Unique identifier for the plugin hosting the extension

featureName - Unique feature identifier (unique for a given pluginName)

id - Unique identifier of this component

execute

public void execute(Map transientVars,
                    Map args,
                    com.opensymphony.module.propertyset.PropertySet ps)
             throws com.opensymphony.workflow.WorkflowException

Specified by:

execute in interface com.opensymphony.workflow.FunctionProvider

Throws:

com.opensymphony.workflow.WorkflowException

getMailSubject

protected String getMailSubject(String subjectI18nKey,
                                User user,
                                WorkflowAwareContent content)

Get the subject of mail

Parameters:

subjectI18nKey - the i18n key to use for subject

user - the caller

content - the content

Returns:

the subject

getMailBody

protected String getMailBody(String bodyI18nKey,
                             User user,
                             WorkflowAwareContent content,
                             Map transientVars)

Get the text body of mail

Parameters:

bodyI18nKey - the i18n key to use for body

user - the caller

content - the content

transientVars - the transient variables

Returns:

the text body

_sendMails

protected void _sendMails(String subject,
                          String body,
                          Set<UserIdentity> users,
                          String from)

Send the notification emails.

Parameters:

subject - the e-mail subject.

body - the e-mail body.

users - users to send the mail to.

from - the address sending the e-mail.

getSubjectI18nParams

protected List<String> getSubjectI18nParams(User user,
                                            WorkflowAwareContent content)

Get the i18n parameters of mail subject

Parameters:

user - the caller

content - the content

Returns:

the i18n parameters

getBodyI18nParams

protected List<String> getBodyI18nParams(User user,
                                         WorkflowAwareContent content)

Get the i18n parameters of mail body text

Parameters:

user - the caller

content - the content

Returns:

the i18n parameters

_getContentUri

protected String _getContentUri(WorkflowAwareContent content)

Get the content uri

Parameters:

content - the content

Returns:

the content uri

_getRequestUri

protected String _getRequestUri()

Get the request URI.

Returns:

the full request URI.

_getRequest

public Request _getRequest()

Retrieve the request from which this component is called.

Returns:

the request or null.

_getUsers

protected Set<UserIdentity> _getUsers(WorkflowAwareContent content,
                                      Set<String> rights)
                               throws com.opensymphony.workflow.WorkflowException

Get the user logins.

Parameters:

content - the content.

rights - the set of rights to check.

Returns:

the users.

Throws:

com.opensymphony.workflow.WorkflowException - If an error occurred