Petals-BC-Mail 4.0.0+

Version 4 by Christophe DENEUX
on Mar 13, 2018 12:41.

<< Changes from 3 to 4

compared with

Version 5 by Christophe DENEUX
on Mar 13, 2018 12:43.

Changes from 5 to 6 >>

Key

This line was removed.

This word was removed. This word was added.

This line was added.

Changes (2)

View Page History

...

{code}

h3. Usage

{warning:title=warning} InOnly message exchange patterns are allowed.{warning}

If the email content is a markup language, it's recommended to use CDATA section or to escape illegal XML character:

Example of IN message with CDATA section:
{code:lang=xml}
<mail xmlns="http://petals.ow2.org/components/mail/version-3.0">
<body><![CDATA[<element>my content</element>]]></body>
</mail>
{code}

Example of IN message with escaped illegal XML character:
{code:lang=xml}
<mail xmlns="http://petals.ow2.org/components/mail/version-3.0">
<body><element>my content</element></body>
</mail>
{code}

h3. Configuration

...

h4. Service Unit descriptor

{code:lang=xml}
<?xml version="1.0" encoding="UTF-8"?>
<jbi:jbi version="1.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:jbi="http://java.sun.com/xml/ns/jbi"
xmlns:mail="http://petals.ow2.org/components/mail/version-3.0"
xmlns:petalsCDK="http://petals.ow2.org/components/extensions/version-4.0"
xmlns:generatedNs="http://test">

<jbi:services binding-component="true">
<jbi:provides
interface-name="generatedNs:SendMail"
service-name="generatedNs:SendMailService"
endpoint-name="SendMailServiceEndpoint">


<petalsCDK:wsdl>sendMail.wsdl</petalsCDK:wsdl>


<mail:scheme>smtp</mail:scheme>
<mail:host>smtp.host.com</mail:host>
<mail:port>25</mail:port>
<mail:user>user</mail:user>
<mail:password>password</mail:password>
<mail:from>from email address</mail:from>
<mail:reply>reply email address</mail:reply>
<mail:to>recipient address</mail:to>
<mail:subject>mail subject</mail:subject>
<mail:send-mode>content-and-attachments</mail:send-mode>
<mail:content-type>text/plain</mail:content-type>
</jbi:provides>
</jbi:services>
</jbi:jbi>
{code}

{include:0 CDK SU Provide Configuration}

{center}{*}Configuration of a Service Unit to provide a service (Mail)*{center}
{table-plus:columnAttributes=,,style="text-align:center;",style="text-align:center;"}
|| Parameter || Description || Default || Required ||
| scheme | the connection protocol (smtp) | \- | Yes |
| username | the username used for authentication | \- | No |
| password | the password used for authentication. Can be null or empty | \- | No |
| host | the host used for connection | \- | Yes |
| port | the port used for connection | 25 | No |
| to | email address of the recipient | \- | Yes |
| from | email address of the sender | \- | Yes |
| reply | email address for the reply | \- | No |
| subject | the subject of the mail | petals-bc-mail | No |
| helohost | HELO host for SMTP | \- | No |
| send-mode | Send either the source, the attachments or both of the payload | content-and-attachments | No |
| content-type | The mail mime type | text/plain | no |
{table-plus}

{include:0 CDK SU Interceptor configuration}

h4. Service Unit content

The Service Unit has to contain the following elements, packaged in an archive :

* The META-INF/jbi.xml descriptor file, has described above,
* An optional wsdl file describing the related service

{noformat}
su-mail.zip
+ META-INF
- jbi.xml
- service.xml

{noformat}

h2. Usage

If the email content is a markup language, it's recommended to use CDATA section or to escape illegal XML character:
Example of IN message with CDATA section:
{code:lang=xml}
[...]
<body><![CDATA[<element>my content</element>]]></body>
[...]
{code}

Example of IN message with escaped illegal XML character:
{code:lang=xml}
[...]
<body><element>my content</element></body>
[...]
{code}

{warning:title=warning} InOnly message exchange patterns are allowed.{warning}

h1. Invoking service on incoming email

...

Wiki

All versions of Petals ESB

Helpful links

Petals-BC-Mail 4.0.0+

Changes (2)