Difference between revisions of "Smtp-call"

From GreenVulcano Wiki
Jump to: navigation, search
 
(8 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
==Description==
 
==Description==
  
{{GVESB}} plugin for sending emails.
+
{{GVESB}} plugin for sending emails throughthe SMTP protocol.
  
 
=={{VULCON}} / {{GVCONSOLE}} Configuration==
 
=={{VULCON}} / {{GVCONSOLE}} Configuration==
  
 
The smtp-call Element is used by [[Channel]], [[routed-call]]. Its attributes are:
 
The smtp-call Element is used by [[Channel]], [[routed-call]]. Its attributes are:
* ''type'': call.
+
{|class="gvtable"
* ''class'': it.greenvulcano.gvesb.virtual.smtp.SMTPCallOperation.
+
! Attribute !! Type !! Description
* ''name'': Operation name. Used in the [[Flow]] section to associate workflow nodes to VCL operations.
+
|-
* ''jndi-name'': JNDI name of the mail Session configured in the application server.
+
| type || fixed || This attribute must assume the value '''call'''.
* ''override-protocol-host'': Corresponds to the property mail.protocol.host and overwrites the value of property mail.host specified in the configuration of the mail Session.
+
|-
* ''override-protocol-user'': Corresponds to the property mail.protocol.user and overwrites the value of property mail.user specified in the configuration of the mail Session.
+
| class || fixed || This attribute must assume the value '''it.greenvulcano.gvesb.virtual.smtp.SMTPCallOperation'''.
* ''message-id-property'': GVBuffer defines the properties that will contain the MessageID of the message sent. Default to ''MessageID''.
+
|-
 +
| name || required || Operation name. Used in the [[Flow]] section to associate workflow nodes to VCL operations.
 +
|-
 +
| jndi-name || required || JNDI name of the mail Session configured in the application server.
 +
|-
 +
| override-protocol-host || optional || Corresponds to the property mail.protocol.host and overwrites the value of property mail.host specified in the configuration of the mail Session.
 +
|-
 +
| override-protocol-user || optional || Corresponds to the property mail.protocol.user and overwrites the value of property mail.user specified in the configuration of the mail Session.
 +
|-
 +
| message-id-property || optional || Defines the properties that will contain the MessageID of the message sent. Default to ''MessageID''.
 +
|}
  
It has the following subelements:
+
It has the following sub-elements:
* Description,
+
* [[Description]]
* [[JNDIHelper]],
+
* [[JNDIHelper]]
* [[mail-properties]],
+
* [[mail-properties]]
* mail-message (see bellow)
+
* [[mail-message]]
 
 
===mail-message===
 
 
 
This subelement defines the properties of the message. It is used by ''smtp-call'' and its attributes are:
 
* ''sender-display-name'': defines the display name of sender.
 
* ''subject'': The subject of the email. <br/> You can enter gvBuffer values using the following syntax:
 
** for standard fields
 
** ${system}
 
** ${service}
 
** ${id}
 
** ${object}
 
** ${retCode}
 
** for properties
 
** ${property['nome']}
 
* ''content-type'': Email content-type. <br/> The attribute's admitted values are:
 
** text-plain
 
** text-html
 
* ''high-priority'': The priority of the mail. <br/> The attribute's admitted values are:
 
** true
 
** false
 
 
 
Its subelements are:
 
* destinations,
 
* [[message-body]],
 
* [[attachments]],
 
* Description
 
 
 
====destinations====
 
 
 
This ''mail-message'' subelement contains the list of mail recipients.
 
 
 
It has the following attributes:
 
* Description
 
* ''to'': Contains the list of recipients of the email. Is overwritten by the value of the GVBuffer property GV_SMTP_TO.
 
* ''cc'': Contains the list of recipients in knowledge of the mail. Is overwritten by the value of the GVBuffer property GV_SMTP_CC.
 
* ''bcc'': Contains the list of recipients in hidden knowledge of the mail. Is overwritten by the value of the GVBuffer property GV_SMTP_BCC.
 
 
 
Every attribute (''to'', ''cc'' and ''bcc'') has the subelements:
 
* Description
 
* mail-address(es): containing the email address of a recipient. The ''address'' value is setted in its attribute:
 
** address
 

Latest revision as of 13:47, 16 May 2014

Description

GreenVulcano® ESB plugin for sending emails throughthe SMTP protocol.

VulCon / GV Console Configuration

The smtp-call Element is used by Channel, routed-call. Its attributes are:

Attribute Type Description
type fixed This attribute must assume the value call.
class fixed This attribute must assume the value it.greenvulcano.gvesb.virtual.smtp.SMTPCallOperation.
name required Operation name. Used in the Flow section to associate workflow nodes to VCL operations.
jndi-name required JNDI name of the mail Session configured in the application server.
override-protocol-host optional Corresponds to the property mail.protocol.host and overwrites the value of property mail.host specified in the configuration of the mail Session.
override-protocol-user optional Corresponds to the property mail.protocol.user and overwrites the value of property mail.user specified in the configuration of the mail Session.
message-id-property optional Defines the properties that will contain the MessageID of the message sent. Default to MessageID.

It has the following sub-elements: