[[index][::Go back to Oozie Documentation Index::]] ----- ---+!! Oozie Email Action Extension %TOC% #EmailAction ---++++ 3.2.4 Email action The =email= action allows sending emails in Oozie from a workflow application. An email action must provide =to= addresses, =cc= addresses (optional), a =subject= and a =body=. Multiple reciepents of an email can be provided as comma separated addresses. The email action is executed synchronously, and the workflow job will wait until the specified emails are sent before continuing to the next action. All values specified in the =email= action can be parameterized (templatized) using EL expressions. *Syntax:* ... [COMMA-SEPARATED-TO-ADDRESSES] [COMMA-SEPARATED-CC-ADDRESSES] [SUBJECT] [BODY] ... The =to= and =cc= commands are used to specify reciepents who should get the mail. Multiple email reciepents can be provided using comma-separated values. Providing a =to= command is necessary, while the =cc= may optionally be used along. The =subject= and =body= commands are used to specify the plain-text subject and body of the mail. *Configuration* The =email= action requires some SMTP server configuration to be present (in oozie-site.xml). The following are the values it looks for: =oozie.email.smtp.host= - The host where the email action may find the SMTP server (localhost by default). =oozie.email.smtp.port= - The port to connect to for the SMTP server (25 by default). =oozie.email.from.address= - The from address to be used for mailing all emails (oozie@localhost by default). =oozie.email.smtp.auth= - Boolean property that toggles if authentication is to be done or not. (false by default). =oozie.email.smtp.username= - If authentication is enabled, the username to login as (empty by default). =oozie.email.smtp.password= - If authentication is enabled, the username's password (empty by default). *Example:* ... bob@initech.com,the.other.bob@initech.com will@initech.com Email notifications for ${wf:id()} The wf ${wf:id()} successfully completed. ... In the above example, an email is sent to 'bob', 'the.other.bob' and 'will' (cc) with the subject and body both containing the workflow ID after substitution. ---+++ AE.A Appendix A, Email XML-Schema . . [[index][::Go back to Oozie Documentation Index::]]