...
To be able to send any emails from Weave you must provide Weave with the details of a mail server that will be used to send the emails. This is done using the com.cohga.server.mail configuration options
...
<?xml version="1.0" encoding="UTF-8"?>
<config xmlns="urn:com.cohga.server.config#1.0" xmlns:mail="urn:com.cohga.server.mail#1.0">
<mail:smtp>
<host>mail.sforbes.net</host>
<username>sforbes</username>
<password>ENCEAUFJCUABCFXEMFQABFJEBZJAKFCXGME</password>
</mail:smtp>
</config>
The smtp config requires at least the host property, to provide the hostname or ip address of the mail server. It may also requires the username and password setting if the mail server requires authentication before it will send any email (the password can be encrypted using the encrpyt command and the osgi prompt).
Additionally any setting supported by the Java Mail API may also be specified, by removing the mail.smtp. prefix from the setting and including it in the smtp config.
The available Java Mail API setting are available here.
| Note |
|---|
There should only ever be one SMTP server configured for Weave.
Multiple components that support emailing will all use the same SMTP server to send their emails. |
Information on this can be found at Email Server.
Setting up email settings
...
| Code Block |
|---|
| xml |
|---|
| xml |
|---|
| title | Basic emails settings |
|---|
|
<?xml version="1.0" encoding="UTF-8"?>
<config xmlns="urn:com.cohga.server.config#1.0" xmlns:report="urn:com.cohga.server.report#1.0">
<report:email id="feedback">
<from>noreply@sforbes.net</from>
<to>feedback@sforbes.net</to>
</report:email>
</config>
|
...
| Code Block |
|---|
| xml |
|---|
| xml |
|---|
| title | From address from userid and hosts domain |
|---|
|
<from>${userid}@${domain}</from>
|
...
| Code Block |
|---|
| xml |
|---|
| xml |
|---|
| title | From address from userid with a fixed domain |
|---|
|
<from>${userid}@sforbes.net</from>
|
...
| Code Block |
|---|
| xml |
|---|
| xml |
|---|
| title | Setting subject and message |
|---|
|
<?xml version="1.0" encoding="UTF-8"?>
<config xmlns="urn:com.cohga.server.config#1.0" xmlns:report="urn:com.cohga.server.report#1.0">
<report:email id="feedback">
<from>noreply@sforbes.net</from>
<to>feedback@sforbes.net</to>
<subject>Feedback</subject>
<message>The following has been submitted as a feedback report</message>
</report:email>
</config>
|
...
| Code Block |
|---|
| xml |
|---|
| xml |
|---|
| title | Setting subject and message using i18n resources |
|---|
|
<?xml version="1.0" encoding="UTF-8"?>
<config xmlns="urn:com.cohga.server.config#1.0" xmlns:report="urn:com.cohga.server.report#1.0" xmlns:client="urn:com.cohga.html.client#1.0">
<client:resources>
<resource id="report.email.subject">Feedback</resource>
<resource id="report.email.message">The following has been submitted as a feedback report</resource>
</client:resources>
<client:resources lang="it">
<resource id="report.email.subject">Retroazione</resource>
<resource id="report.email.message">È stata presentata la seguente come un rapporto di feedback</resource>
</client:resources>
<report:email id="feedback">
<from>noreply@sforbes.net</from>
<to>feedback@sforbes.net</to>
</report:email>
</config>
|
...
| Code Block |
|---|
| xml |
|---|
| xml |
|---|
| title | Simple report action to email a report |
|---|
|
<item action="com.cohga.client.action.simplereport">
<email>feedback</email>
<format>html</format>
<report>br_map</report>
<label>Feedback</label>
<tooltip>
<title>Feedback</title>
<text>Send a feedback report using the current map</text>
</tooltip>
</item>
|
...
| Code Block |
|---|
| xml |
|---|
| xml |
|---|
| title | Specifying email properties directly in the report action |
|---|
|
<item action="com.cohga.client.action.simplereport">
<email>
<from>${userid}@sforbes.net</from>
<to>feedback@sforbes.net</from>
</email>
<format>html</format>
<report>br_map</report>
<label>Feedback</label>
<tooltip>
<title>Feedback</title>
<text>Send a feedback report using the current map</text>
</tooltip>
</item>
|
...
| Code Block |
|---|
| xml |
|---|
| xml |
|---|
| title | Extending email properties |
|---|
|
<item action="com.cohga.client.action.simplereport">
<email id="feedback">
<from>${userid}@sforbes.net</from>
<to>feedback@sforbes.net</from>
</email>
<format>html</format>
<report>br_map</report>
<label>Feedback</label>
<tooltip>
<title>Feedback</title>
<text>Send a feedback report using the current map</text>
</tooltip>
</item>
|
...