View Source

{hidden}
DO NOT EDIT THE CONTENT OF THIS PAGE DIRECTLY, UNLESS YOU KNOW WHAT YOU'RE DOING.
		THE STRUCTURE OF THE CONTENT IS VITAL IN BEING ABLE TO EXTRACT CHANGES FROM THE PAGE AND MERGE THEM BACK INTO SERVOY SOURCE{hidden}
{sub-section:description|text=}*Using GMail*
To connect to GMail the following settings supplied in the properties Array:
{code}
var userName = 'xxx';
var passWord = 'yyy';
var properties = new Array();
properties[0] = 'mail.smtp.host=smtp.gmail.com';
properties[1] = 'mail.smtp.auth=true';
properties[2] = 'mail.smtp.username=' + userName;
properties[3] = 'mail.smtp.password=' + passWord;
properties[4] = 'mail.smtp.port=587';
properties[5] = 'mail.smtp.starttls.enable=true';
{code}{sub-section}\\ 

{table:id=|class=servoy sReturnTypes}{tr:style=height: 30px;}{th}Return Types{th}{tr}{tr}{td}{span:class=sWordList}[Attachment]{span}{span:class=sWordList}[MailMessage]{span}{td}{tr}{table}\\ 

{table:id=|class=servoy sSummery}{colgroup}{column:padding=0px|width=80px}{column}{column}{column}{colgroup}{tr:style=height: 30px;}{th:colspan=2}Server Property Summery{th}{tr}{tbody}{tr}{td}{td}{td}[#mail.development.override.address]
{td}{tr}{tbody}{tbody}{tr}{td}{td}{td}[#mail.from]
{td}{tr}{tbody}{tbody}{tr}{td}{td}{td}[#mail.mime.charset]
{td}{tr}{tbody}{tbody}{tr}{td}{td}{td}[#mail.pop3.apop.enable]
{td}{tr}{tbody}{tbody}{tr}{td}{td}{td}[#mail.pop3.host]
{td}{tr}{tbody}{tbody}{tr}{td}{td}{td}[#mail.server.allowUnauthenticatedRMIAccess]
{td}{tr}{tbody}{tbody}{tr}{td}{td}{td}[#mail.smtp.auth]
{td}{tr}{tbody}{tbody}{tr}{td}{td}{td}[#mail.smtp.connectiontimeout]
{td}{tr}{tbody}{tbody}{tr}{td}{td}{td}[#mail.smtp.host]
{td}{tr}{tbody}{tbody}{tr}{td}{td}{td}[#mail.smtp.password]
{td}{tr}{tbody}{tbody}{tr}{td}{td}{td}[#mail.smtp.port]
{td}{tr}{tbody}{tbody}{tr}{td}{td}{td}[#mail.smtp.ssl.enable]
{td}{tr}{tbody}{tbody}{tr}{td}{td}{td}[#mail.smtp.timeout]
{td}{tr}{tbody}{tbody}{tr}{td}{td}{td}[#mail.smtp.username]
{td}{tr}{tbody}{table}\\ 

{table:id=|class=servoy sSummery}{colgroup}{column:padding=0px|width=80px}{column}{column}{column}{colgroup}{tr:style=height: 30px;}{th:colspan=2}Method Summery{th}{tr}{tbody}{tr}{td}[Attachment]{td}{td}[#createBinaryAttachment]\(filename, binarydata, \[mimeType\])
Creates a binary attachment object.{td}{tr}{tbody}{tbody}{tr}{td}[Attachment]{td}{td}[#createTextAttachment]\(filename, textdata, \[mimeType\])
Creates a text based attachment object.{td}{tr}{tbody}{tbody}{tr}{td}[String]{td}{td}[#getLastSendMailExceptionMsg]\()
Get the exception that occurred in the last sendMail attempt (null if no exception occurred).{td}{tr}{tbody}{tbody}{tr}{td}[MailMessage]{td}{td}[#getMailMessage]\(binaryblob/string)
Helper method, returns MailMessage object from binary or 7bits string.{td}{tr}{tbody}{tbody}{tr}{td}[String]\[]{td}{td}[#getPlainMailAddresses]\(addressesString)
Helper method to only get the plain addresses.{td}{tr}{tbody}{tbody}{tr}{td}[MailMessage]\[]{td}{td}[#receiveMail]\(userName, password, leaveMsgsOnServer, \[receiveMode\], \[onlyreceiveMsgWithSentDate\], \[overridePreferencePOP3Host/properties array\])
Receive mails from pop3 account.{td}{tr}{tbody}{tbody}{tr}{td}[Boolean]{td}{td}[#sendMail]\(\[to[,to2,toN\], \[from[,reply\], subject, msgText, \[cc,cc2,ccN\], \[bcc,bcc2,bccN\], \[attachment/attachments array\], \[overridePreferenceSMTPHost/properties array\])
Send a mail, if you make the msgText start with <html> the message will be sent in html (and you can use all html formatting).{td}{tr}{tbody}{table}\\ 

{table:id=serverProperty|class=servoy sDetail}{colgroup}{column:padding=0px|width=100%}{column}{colgroup}{tr:style=height: 30px;}{th:colspan=1}Server Property Details{th}{tr}{tbody:id=mail.development.override.address|class=node}{tr:id=name}{td}h6.mail.development.override.address{td}{tr}{tr:id=des}{td}{sub-section:mail.development.override.address_des|text=|trigger=button}{sub-section}{sub-section:mail.development.override.address_des|trigger=none|class=sIndent}Specify an email address to which all email will be send instead of the specified To, Cc and Bcc addresses.
The specified to, Cc and Bcc addresses will be added to the Subject.{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=snc}{td}*Since*\\{sub-section:mail.development.override.address_snc|text=|trigger=button}{sub-section}{sub-section:mail.development.override.address_snc|trigger=none|class=sIndent} Replace with version info{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=prs}{td}*Parameters*\\{sub-section:mail.development.override.address_prs|text=|trigger=button}{sub-section}{sub-section:mail.development.override.address_prs|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=ret}{td}*Returns*\\{sub-section:mail.development.override.address_ret|text=|trigger=button}{sub-section}{sub-section:mail.development.override.address_ret|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:mail.development.override.address_see|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:mail.development.override.address_see|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:mail.development.override.address_link|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:mail.development.override.address_link|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=sam}{td}*Sample*\\{sub-section:mail.development.override.address_sam|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:mail.development.override.address_sam|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=mail.from|class=node}{tr:id=name}{td}h6.mail.from{td}{tr}{tr:id=des}{td}{sub-section:mail.from_des|text=|trigger=button}{sub-section}{sub-section:mail.from_des|trigger=none|class=sIndent}Default 'from' address if none is specified{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=snc}{td}*Since*\\{sub-section:mail.from_snc|text=|trigger=button}{sub-section}{sub-section:mail.from_snc|trigger=none|class=sIndent} Replace with version info{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=prs}{td}*Parameters*\\{sub-section:mail.from_prs|text=|trigger=button}{sub-section}{sub-section:mail.from_prs|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=ret}{td}*Returns*\\{sub-section:mail.from_ret|text=|trigger=button}{sub-section}{sub-section:mail.from_ret|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:mail.from_see|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:mail.from_see|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:mail.from_link|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:mail.from_link|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=sam}{td}*Sample*\\{sub-section:mail.from_sam|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:mail.from_sam|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=mail.mime.charset|class=node}{tr:id=name}{td}h6.mail.mime.charset{td}{tr}{tr:id=des}{td}{sub-section:mail.mime.charset_des|text=|trigger=button}{sub-section}{sub-section:mail.mime.charset_des|trigger=none|class=sIndent}Specify the name of the charset to use for mail encoding (leave emtpy for system default), see http://java.sun.com/j2se/1.4.2/docs/api/java/nio/charset/Charset.html forinfo which charset names are usable{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=snc}{td}*Since*\\{sub-section:mail.mime.charset_snc|text=|trigger=button}{sub-section}{sub-section:mail.mime.charset_snc|trigger=none|class=sIndent} Replace with version info{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=prs}{td}*Parameters*\\{sub-section:mail.mime.charset_prs|text=|trigger=button}{sub-section}{sub-section:mail.mime.charset_prs|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=ret}{td}*Returns*\\{sub-section:mail.mime.charset_ret|text=|trigger=button}{sub-section}{sub-section:mail.mime.charset_ret|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:mail.mime.charset_see|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:mail.mime.charset_see|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:mail.mime.charset_link|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:mail.mime.charset_link|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=sam}{td}*Sample*\\{sub-section:mail.mime.charset_sam|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:mail.mime.charset_sam|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=mail.pop3.apop.enable|class=node}{tr:id=name}{td}h6.mail.pop3.apop.enable{td}{tr}{tr:id=des}{td}{sub-section:mail.pop3.apop.enable_des|text=|trigger=button}{sub-section}{sub-section:mail.pop3.apop.enable_des|trigger=none|class=sIndent}Whether or not to use APOP for authentication (true/false), defaults to false.{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=snc}{td}*Since*\\{sub-section:mail.pop3.apop.enable_snc|text=|trigger=button}{sub-section}{sub-section:mail.pop3.apop.enable_snc|trigger=none|class=sIndent} Replace with version info{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=prs}{td}*Parameters*\\{sub-section:mail.pop3.apop.enable_prs|text=|trigger=button}{sub-section}{sub-section:mail.pop3.apop.enable_prs|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=ret}{td}*Returns*\\{sub-section:mail.pop3.apop.enable_ret|text=|trigger=button}{sub-section}{sub-section:mail.pop3.apop.enable_ret|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:mail.pop3.apop.enable_see|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:mail.pop3.apop.enable_see|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:mail.pop3.apop.enable_link|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:mail.pop3.apop.enable_link|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=sam}{td}*Sample*\\{sub-section:mail.pop3.apop.enable_sam|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:mail.pop3.apop.enable_sam|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=mail.pop3.host|class=node}{tr:id=name}{td}h6.mail.pop3.host{td}{tr}{tr:id=des}{td}{sub-section:mail.pop3.host_des|text=|trigger=button}{sub-section}{sub-section:mail.pop3.host_des|trigger=none|class=sIndent}The name of POP3 server to recieve mails from{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=snc}{td}*Since*\\{sub-section:mail.pop3.host_snc|text=|trigger=button}{sub-section}{sub-section:mail.pop3.host_snc|trigger=none|class=sIndent} Replace with version info{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=prs}{td}*Parameters*\\{sub-section:mail.pop3.host_prs|text=|trigger=button}{sub-section}{sub-section:mail.pop3.host_prs|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=ret}{td}*Returns*\\{sub-section:mail.pop3.host_ret|text=|trigger=button}{sub-section}{sub-section:mail.pop3.host_ret|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:mail.pop3.host_see|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:mail.pop3.host_see|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:mail.pop3.host_link|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:mail.pop3.host_link|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=sam}{td}*Sample*\\{sub-section:mail.pop3.host_sam|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:mail.pop3.host_sam|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=mail.server.allowUnauthenticatedRMIAccess|class=node}{tr:id=name}{td}h6.mail.server.allowUnauthenticatedRMIAccess{td}{tr}{tr:id=des}{td}{sub-section:mail.server.allowUnauthenticatedRMIAccess_des|text=|trigger=button}{sub-section}{sub-section:mail.server.allowUnauthenticatedRMIAccess_des|trigger=none|class=sIndent}Allow mailserver access for unauthenticated smart (rmi) client (true/false), defaults to false{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=snc}{td}*Since*\\{sub-section:mail.server.allowUnauthenticatedRMIAccess_snc|text=|trigger=button}{sub-section}{sub-section:mail.server.allowUnauthenticatedRMIAccess_snc|trigger=none|class=sIndent} Replace with version info{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=prs}{td}*Parameters*\\{sub-section:mail.server.allowUnauthenticatedRMIAccess_prs|text=|trigger=button}{sub-section}{sub-section:mail.server.allowUnauthenticatedRMIAccess_prs|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=ret}{td}*Returns*\\{sub-section:mail.server.allowUnauthenticatedRMIAccess_ret|text=|trigger=button}{sub-section}{sub-section:mail.server.allowUnauthenticatedRMIAccess_ret|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:mail.server.allowUnauthenticatedRMIAccess_see|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:mail.server.allowUnauthenticatedRMIAccess_see|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:mail.server.allowUnauthenticatedRMIAccess_link|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:mail.server.allowUnauthenticatedRMIAccess_link|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=sam}{td}*Sample*\\{sub-section:mail.server.allowUnauthenticatedRMIAccess_sam|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:mail.server.allowUnauthenticatedRMIAccess_sam|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=mail.smtp.auth|class=node}{tr:id=name}{td}h6.mail.smtp.auth{td}{tr}{tr:id=des}{td}{sub-section:mail.smtp.auth_des|text=|trigger=button}{sub-section}{sub-section:mail.smtp.auth_des|trigger=none|class=sIndent}Use authentication (true/false), defaults to false.{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=snc}{td}*Since*\\{sub-section:mail.smtp.auth_snc|text=|trigger=button}{sub-section}{sub-section:mail.smtp.auth_snc|trigger=none|class=sIndent} Replace with version info{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=prs}{td}*Parameters*\\{sub-section:mail.smtp.auth_prs|text=|trigger=button}{sub-section}{sub-section:mail.smtp.auth_prs|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=ret}{td}*Returns*\\{sub-section:mail.smtp.auth_ret|text=|trigger=button}{sub-section}{sub-section:mail.smtp.auth_ret|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:mail.smtp.auth_see|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:mail.smtp.auth_see|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:mail.smtp.auth_link|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:mail.smtp.auth_link|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=sam}{td}*Sample*\\{sub-section:mail.smtp.auth_sam|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:mail.smtp.auth_sam|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=mail.smtp.connectiontimeout|class=node}{tr:id=name}{td}h6.mail.smtp.connectiontimeout{td}{tr}{tr:id=des}{td}{sub-section:mail.smtp.connectiontimeout_des|text=|trigger=button}{sub-section}{sub-section:mail.smtp.connectiontimeout_des|trigger=none|class=sIndent}Socket connection timeout value in milliseconds. Default is infinite timeout.{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=snc}{td}*Since*\\{sub-section:mail.smtp.connectiontimeout_snc|text=|trigger=button}{sub-section}{sub-section:mail.smtp.connectiontimeout_snc|trigger=none|class=sIndent} Replace with version info{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=prs}{td}*Parameters*\\{sub-section:mail.smtp.connectiontimeout_prs|text=|trigger=button}{sub-section}{sub-section:mail.smtp.connectiontimeout_prs|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=ret}{td}*Returns*\\{sub-section:mail.smtp.connectiontimeout_ret|text=|trigger=button}{sub-section}{sub-section:mail.smtp.connectiontimeout_ret|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:mail.smtp.connectiontimeout_see|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:mail.smtp.connectiontimeout_see|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:mail.smtp.connectiontimeout_link|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:mail.smtp.connectiontimeout_link|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=sam}{td}*Sample*\\{sub-section:mail.smtp.connectiontimeout_sam|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:mail.smtp.connectiontimeout_sam|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=mail.smtp.host|class=node}{tr:id=name}{td}h6.mail.smtp.host{td}{tr}{tr:id=des}{td}{sub-section:mail.smtp.host_des|text=|trigger=button}{sub-section}{sub-section:mail.smtp.host_des|trigger=none|class=sIndent}The name of SMTP server to deliver the mails to{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=snc}{td}*Since*\\{sub-section:mail.smtp.host_snc|text=|trigger=button}{sub-section}{sub-section:mail.smtp.host_snc|trigger=none|class=sIndent} Replace with version info{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=prs}{td}*Parameters*\\{sub-section:mail.smtp.host_prs|text=|trigger=button}{sub-section}{sub-section:mail.smtp.host_prs|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=ret}{td}*Returns*\\{sub-section:mail.smtp.host_ret|text=|trigger=button}{sub-section}{sub-section:mail.smtp.host_ret|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:mail.smtp.host_see|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:mail.smtp.host_see|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:mail.smtp.host_link|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:mail.smtp.host_link|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=sam}{td}*Sample*\\{sub-section:mail.smtp.host_sam|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:mail.smtp.host_sam|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=mail.smtp.password|class=node}{tr:id=name}{td}h6.mail.smtp.password{td}{tr}{tr:id=des}{td}{sub-section:mail.smtp.password_des|text=|trigger=button}{sub-section}{sub-section:mail.smtp.password_des|trigger=none|class=sIndent}Specify password if using authentication{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=snc}{td}*Since*\\{sub-section:mail.smtp.password_snc|text=|trigger=button}{sub-section}{sub-section:mail.smtp.password_snc|trigger=none|class=sIndent} Replace with version info{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=prs}{td}*Parameters*\\{sub-section:mail.smtp.password_prs|text=|trigger=button}{sub-section}{sub-section:mail.smtp.password_prs|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=ret}{td}*Returns*\\{sub-section:mail.smtp.password_ret|text=|trigger=button}{sub-section}{sub-section:mail.smtp.password_ret|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:mail.smtp.password_see|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:mail.smtp.password_see|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:mail.smtp.password_link|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:mail.smtp.password_link|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=sam}{td}*Sample*\\{sub-section:mail.smtp.password_sam|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:mail.smtp.password_sam|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=mail.smtp.port|class=node}{tr:id=name}{td}h6.mail.smtp.port{td}{tr}{tr:id=des}{td}{sub-section:mail.smtp.port_des|text=|trigger=button}{sub-section}{sub-section:mail.smtp.port_des|trigger=none|class=sIndent}The port of SMTP server to deliver the mails to{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=snc}{td}*Since*\\{sub-section:mail.smtp.port_snc|text=|trigger=button}{sub-section}{sub-section:mail.smtp.port_snc|trigger=none|class=sIndent} Replace with version info{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=prs}{td}*Parameters*\\{sub-section:mail.smtp.port_prs|text=|trigger=button}{sub-section}{sub-section:mail.smtp.port_prs|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=ret}{td}*Returns*\\{sub-section:mail.smtp.port_ret|text=|trigger=button}{sub-section}{sub-section:mail.smtp.port_ret|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:mail.smtp.port_see|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:mail.smtp.port_see|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:mail.smtp.port_link|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:mail.smtp.port_link|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=sam}{td}*Sample*\\{sub-section:mail.smtp.port_sam|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:mail.smtp.port_sam|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=mail.smtp.ssl.enable|class=node}{tr:id=name}{td}h6.mail.smtp.ssl.enable{td}{tr}{tr:id=des}{td}{sub-section:mail.smtp.ssl.enable_des|text=|trigger=button}{sub-section}{sub-section:mail.smtp.ssl.enable_des|trigger=none|class=sIndent}Use SSL (true/false), defaults to false .{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=snc}{td}*Since*\\{sub-section:mail.smtp.ssl.enable_snc|text=|trigger=button}{sub-section}{sub-section:mail.smtp.ssl.enable_snc|trigger=none|class=sIndent} Replace with version info{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=prs}{td}*Parameters*\\{sub-section:mail.smtp.ssl.enable_prs|text=|trigger=button}{sub-section}{sub-section:mail.smtp.ssl.enable_prs|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=ret}{td}*Returns*\\{sub-section:mail.smtp.ssl.enable_ret|text=|trigger=button}{sub-section}{sub-section:mail.smtp.ssl.enable_ret|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:mail.smtp.ssl.enable_see|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:mail.smtp.ssl.enable_see|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:mail.smtp.ssl.enable_link|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:mail.smtp.ssl.enable_link|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=sam}{td}*Sample*\\{sub-section:mail.smtp.ssl.enable_sam|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:mail.smtp.ssl.enable_sam|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=mail.smtp.timeout|class=node}{tr:id=name}{td}h6.mail.smtp.timeout{td}{tr}{tr:id=des}{td}{sub-section:mail.smtp.timeout_des|text=|trigger=button}{sub-section}{sub-section:mail.smtp.timeout_des|trigger=none|class=sIndent}Socket I/O timeout value in milliseconds. Default is infinite timeout.{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=snc}{td}*Since*\\{sub-section:mail.smtp.timeout_snc|text=|trigger=button}{sub-section}{sub-section:mail.smtp.timeout_snc|trigger=none|class=sIndent} Replace with version info{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=prs}{td}*Parameters*\\{sub-section:mail.smtp.timeout_prs|text=|trigger=button}{sub-section}{sub-section:mail.smtp.timeout_prs|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=ret}{td}*Returns*\\{sub-section:mail.smtp.timeout_ret|text=|trigger=button}{sub-section}{sub-section:mail.smtp.timeout_ret|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:mail.smtp.timeout_see|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:mail.smtp.timeout_see|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:mail.smtp.timeout_link|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:mail.smtp.timeout_link|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=sam}{td}*Sample*\\{sub-section:mail.smtp.timeout_sam|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:mail.smtp.timeout_sam|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=mail.smtp.username|class=node}{tr:id=name}{td}h6.mail.smtp.username{td}{tr}{tr:id=des}{td}{sub-section:mail.smtp.username_des|text=|trigger=button}{sub-section}{sub-section:mail.smtp.username_des|trigger=none|class=sIndent}Specify username if using authentication{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=snc}{td}*Since*\\{sub-section:mail.smtp.username_snc|text=|trigger=button}{sub-section}{sub-section:mail.smtp.username_snc|trigger=none|class=sIndent} Replace with version info{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=prs}{td}*Parameters*\\{sub-section:mail.smtp.username_prs|text=|trigger=button}{sub-section}{sub-section:mail.smtp.username_prs|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=ret}{td}*Returns*\\{sub-section:mail.smtp.username_ret|text=|trigger=button}{sub-section}{sub-section:mail.smtp.username_ret|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:mail.smtp.username_see|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:mail.smtp.username_see|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:mail.smtp.username_link|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:mail.smtp.username_link|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=sam}{td}*Sample*\\{sub-section:mail.smtp.username_sam|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:mail.smtp.username_sam|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{table}\\ 

{table:id=function|class=servoy sDetail}{colgroup}{column:padding=0px|width=100%}{column}{colgroup}{tr:style=height: 30px;}{th:colspan=1}Method Details{th}{tr}{tbody:id=createBinaryAttachment|class=node}{tr:id=name}{td}h6.createBinaryAttachment{td}{tr}{tr:id=sig}{td}{span:style=float: left; margin-right: 5px;}[Attachment]{span}{span:id=iets|style=float: left; font-weight: bold;}createBinaryAttachment{span}{span:id=iets|style=float: left;}\(filename, binarydata, \[mimeType\]){span}{td}{tr}{tr:id=des}{td}{sub-section:createBinaryAttachment_des|text=|trigger=button}{sub-section}{sub-section:createBinaryAttachment_des|trigger=none|class=sIndent}Creates a binary attachment object.{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=snc}{td}*Since*\\{sub-section:createBinaryAttachment_snc|text=|trigger=button}{sub-section}{sub-section:createBinaryAttachment_snc|trigger=none|class=sIndent} Replace with version info{sub-section}{td}{tr}{builder-show}{tr:id=prs}{td}*Parameters*\\{sub-section:createBinaryAttachment_prs|text=|trigger=button}{sub-section}{sub-section:createBinaryAttachment_prs|trigger=none|class=sIndent}filename
binarydata
\[mimeType\]
{sub-section}{td}{tr}{tr:id=ret}{td}*Returns*\\{sub-section:createBinaryAttachment_ret|text=|trigger=button}{sub-section}{sub-section:createBinaryAttachment_ret|trigger=none|class=sIndent}[Attachment]{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:createBinaryAttachment_see|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:createBinaryAttachment_see|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:createBinaryAttachment_link|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:createBinaryAttachment_link|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{tr:id=sam}{td}*Sample*\\{sub-section:createBinaryAttachment_sam|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:createBinaryAttachment_sam|trigger=none}{code:language=javascript}
var attachment1 = plugins.mail.createBinaryAttachment('logo1.gif',plugins.file.readFile('c:/temp/a_logo.gif'));
var attachment2 = plugins.mail.createBinaryAttachment('logo2.gif',plugins.file.readFile('c:/temp/another_logo.gif'));
var success = plugins.mail.sendMail('[email protected]', 'John Cobb <[email protected]>', 'subject', 'msgText',null,null,new Array(attachment1,attachment2));
if (!success) 
{
	plugins.dialogs.showWarningDialog('Alert','Failed to send mail','OK');
}
{code}{sub-section}{div}{td}{tr}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=createTextAttachment|class=node}{tr:id=name}{td}h6.createTextAttachment{td}{tr}{tr:id=sig}{td}{span:style=float: left; margin-right: 5px;}[Attachment]{span}{span:id=iets|style=float: left; font-weight: bold;}createTextAttachment{span}{span:id=iets|style=float: left;}\(filename, textdata, \[mimeType\]){span}{td}{tr}{tr:id=des}{td}{sub-section:createTextAttachment_des|text=|trigger=button}{sub-section}{sub-section:createTextAttachment_des|trigger=none|class=sIndent}Creates a text based attachment object.{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=snc}{td}*Since*\\{sub-section:createTextAttachment_snc|text=|trigger=button}{sub-section}{sub-section:createTextAttachment_snc|trigger=none|class=sIndent} Replace with version info{sub-section}{td}{tr}{builder-show}{tr:id=prs}{td}*Parameters*\\{sub-section:createTextAttachment_prs|text=|trigger=button}{sub-section}{sub-section:createTextAttachment_prs|trigger=none|class=sIndent}filename
textdata
\[mimeType\]
{sub-section}{td}{tr}{tr:id=ret}{td}*Returns*\\{sub-section:createTextAttachment_ret|text=|trigger=button}{sub-section}{sub-section:createTextAttachment_ret|trigger=none|class=sIndent}[Attachment]{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:createTextAttachment_see|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:createTextAttachment_see|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:createTextAttachment_link|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:createTextAttachment_link|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{tr:id=sam}{td}*Sample*\\{sub-section:createTextAttachment_sam|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:createTextAttachment_sam|trigger=none}{code:language=javascript}
var attachment = plugins.mail.createTextAttachment('readme.html','<html>bla bla bla', 'text/html');
var success = plugins.mail.sendMail('[email protected]', 'John Cobb <[email protected]>', 'subject', 'msgText',null,null,attachment);
if (!success) 
{
	plugins.dialogs.showWarningDialog('Alert','Failed to send mail','OK');
}
{code}{sub-section}{div}{td}{tr}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=getLastSendMailExceptionMsg|class=node}{tr:id=name}{td}h6.getLastSendMailExceptionMsg{td}{tr}{tr:id=sig}{td}{span:style=float: left; margin-right: 5px;}[String]{span}{span:id=iets|style=float: left; font-weight: bold;}getLastSendMailExceptionMsg{span}{span:id=iets|style=float: left;}\(){span}{td}{tr}{tr:id=des}{td}{sub-section:getLastSendMailExceptionMsg_des|text=|trigger=button}{sub-section}{sub-section:getLastSendMailExceptionMsg_des|trigger=none|class=sIndent}Get the exception that occurred in the last sendMail attempt (null if no exception occurred).{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=snc}{td}*Since*\\{sub-section:getLastSendMailExceptionMsg_snc|text=|trigger=button}{sub-section}{sub-section:getLastSendMailExceptionMsg_snc|trigger=none|class=sIndent} Replace with version info{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=prs}{td}*Parameters*\\{sub-section:getLastSendMailExceptionMsg_prs|text=|trigger=button}{sub-section}{sub-section:getLastSendMailExceptionMsg_prs|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{tr:id=ret}{td}*Returns*\\{sub-section:getLastSendMailExceptionMsg_ret|text=|trigger=button}{sub-section}{sub-section:getLastSendMailExceptionMsg_ret|trigger=none|class=sIndent}[String]{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:getLastSendMailExceptionMsg_see|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:getLastSendMailExceptionMsg_see|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:getLastSendMailExceptionMsg_link|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:getLastSendMailExceptionMsg_link|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{tr:id=sam}{td}*Sample*\\{sub-section:getLastSendMailExceptionMsg_sam|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:getLastSendMailExceptionMsg_sam|trigger=none}{code:language=javascript}
var success = plugins.mail.sendMail('[email protected],[email protected]', 'John Cobb <[email protected]>', 'subject', 'my message',null,'[email protected]');
if (!success) 
{
	plugins.dialogs.showWarningDialog('Alert',plugins.mail.getLastSendMailExceptionMsg(),'OK');
}
{code}{sub-section}{div}{td}{tr}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=getMailMessage|class=node}{tr:id=name}{td}h6.getMailMessage{td}{tr}{tr:id=sig}{td}{span:style=float: left; margin-right: 5px;}[MailMessage]{span}{span:id=iets|style=float: left; font-weight: bold;}getMailMessage{span}{span:id=iets|style=float: left;}\(binaryblob/string){span}{td}{tr}{tr:id=des}{td}{sub-section:getMailMessage_des|text=|trigger=button}{sub-section}{sub-section:getMailMessage_des|trigger=none|class=sIndent}Helper method, returns MailMessage object from binary or 7bits string.{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=snc}{td}*Since*\\{sub-section:getMailMessage_snc|text=|trigger=button}{sub-section}{sub-section:getMailMessage_snc|trigger=none|class=sIndent} Replace with version info{sub-section}{td}{tr}{builder-show}{tr:id=prs}{td}*Parameters*\\{sub-section:getMailMessage_prs|text=|trigger=button}{sub-section}{sub-section:getMailMessage_prs|trigger=none|class=sIndent}binaryblob/string
{sub-section}{td}{tr}{tr:id=ret}{td}*Returns*\\{sub-section:getMailMessage_ret|text=|trigger=button}{sub-section}{sub-section:getMailMessage_ret|trigger=none|class=sIndent}[MailMessage]{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:getMailMessage_see|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:getMailMessage_see|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:getMailMessage_link|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:getMailMessage_link|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{tr:id=sam}{td}*Sample*\\{sub-section:getMailMessage_sam|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:getMailMessage_sam|trigger=none}{code:language=javascript}
var msg = plugins.mail.getMailMessage(myColumn);
if (msg != null) //if is null error occurred!
{
	application.output(msg.getFromAddresses())
}
{code}{sub-section}{div}{td}{tr}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=getPlainMailAddresses|class=node}{tr:id=name}{td}h6.getPlainMailAddresses{td}{tr}{tr:id=sig}{td}{span:style=float: left; margin-right: 5px;}[String]\[]{span}{span:id=iets|style=float: left; font-weight: bold;}getPlainMailAddresses{span}{span:id=iets|style=float: left;}\(addressesString){span}{td}{tr}{tr:id=des}{td}{sub-section:getPlainMailAddresses_des|text=|trigger=button}{sub-section}{sub-section:getPlainMailAddresses_des|trigger=none|class=sIndent}Helper method to only get the plain addresses.{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=snc}{td}*Since*\\{sub-section:getPlainMailAddresses_snc|text=|trigger=button}{sub-section}{sub-section:getPlainMailAddresses_snc|trigger=none|class=sIndent} Replace with version info{sub-section}{td}{tr}{builder-show}{tr:id=prs}{td}*Parameters*\\{sub-section:getPlainMailAddresses_prs|text=|trigger=button}{sub-section}{sub-section:getPlainMailAddresses_prs|trigger=none|class=sIndent}addressesString
{sub-section}{td}{tr}{tr:id=ret}{td}*Returns*\\{sub-section:getPlainMailAddresses_ret|text=|trigger=button}{sub-section}{sub-section:getPlainMailAddresses_ret|trigger=none|class=sIndent}[String]\[]{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:getPlainMailAddresses_see|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:getPlainMailAddresses_see|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:getPlainMailAddresses_link|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:getPlainMailAddresses_link|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{tr:id=sam}{td}*Sample*\\{sub-section:getPlainMailAddresses_sam|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:getPlainMailAddresses_sam|trigger=none}{code:language=javascript}
var plainArray = plugins.mail.getPlainMailAddresses('John Cobb <[email protected]>;Pete Cobb<[email protected]>');
application.output(plainArray[0]) //will return '[email protected]'
{code}{sub-section}{div}{td}{tr}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=receiveMail|class=node}{tr:id=name}{td}h6.receiveMail{td}{tr}{tr:id=sig}{td}{span:style=float: left; margin-right: 5px;}[MailMessage]\[]{span}{span:id=iets|style=float: left; font-weight: bold;}receiveMail{span}{span:id=iets|style=float: left;}\(userName, password, leaveMsgsOnServer, \[receiveMode\], \[onlyreceiveMsgWithSentDate\], \[overridePreferencePOP3Host/properties array\]){span}{td}{tr}{tr:id=des}{td}{sub-section:receiveMail_des|text=|trigger=button}{sub-section}{sub-section:receiveMail_des|trigger=none|class=sIndent}Receive mails from pop3 account.{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=snc}{td}*Since*\\{sub-section:receiveMail_snc|text=|trigger=button}{sub-section}{sub-section:receiveMail_snc|trigger=none|class=sIndent} Replace with version info{sub-section}{td}{tr}{builder-show}{tr:id=prs}{td}*Parameters*\\{sub-section:receiveMail_prs|text=|trigger=button}{sub-section}{sub-section:receiveMail_prs|trigger=none|class=sIndent}userName
password
leaveMsgsOnServer
\[receiveMode\]
\[onlyreceiveMsgWithSentDate\]
\[overridePreferencePOP3Host/properties array\]
{sub-section}{td}{tr}{tr:id=ret}{td}*Returns*\\{sub-section:receiveMail_ret|text=|trigger=button}{sub-section}{sub-section:receiveMail_ret|trigger=none|class=sIndent}[MailMessage]\[]{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:receiveMail_see|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:receiveMail_see|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:receiveMail_link|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:receiveMail_link|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{tr:id=sam}{td}*Sample*\\{sub-section:receiveMail_sam|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:receiveMail_sam|trigger=none}{code:language=javascript}
var msgs = plugins.mail.receiveMail('me', 'test', true);
if (msgs != null) //if is null error occurred!
{
	for (var i = 0 ; i < msgs.length ; i++)
	{
		var msg = msgs[i]
		application.output(msg.getFromAddresses())
		application.output(msg.getRecipientAddresses())
		application.output(msg.getReplyAddresses())
		application.output(msg.getReceivedDate())
		application.output(msg.getSentDate())
		application.output(msg.getHeaders())
		application.output(msg.getSubject())
		application.output(msg.getHtmlMsg())
		application.output(msg.getPlainMsg())
		var attachments = msg.getAttachments()
		if (attachments != null) 
		{
			for (var j = 0 ; j < attachments.length ; j++)
			{
				var attachment = attachments[j]
				application.output(attachment.getName())
				var attachmentDataByteArray = attachment.getData()
				//write attachmentDataByteArray to a file...
			}
		}
	}
}

//it is also possible to first receive the headers and later receive a full message with particular 'sentdate'
//var receiveMode = 1;//0=FULL,1=HEADERS_ONLY,2=NO_ATTACHMENTS
//var msgs = plugins.mail.receiveMail('me', 'test', true ,receiveMode);

//when first did receive the headers(=all_field+subject,no body and no attachemnt), get a msg with a specific sentdate
//var msgs = plugins.mail.receiveMail('me', 'test', true , 1 , theSentDateObjectFormPreviousHeaderLoading);

//it is possbile to set all kind of pop3 properties
//var properties = new Array()
//properties[0] = 'mail.pop3.host=myserver.com'
//properties specification can be found at:http://java.sun.com/products/javamail/javadocs/com/sun/mail/pop3/package-summary.html
//var msgs = plugins.mail.receiveMail('me', 'test', true , 0 , null, properties);
{code}{sub-section}{div}{td}{tr}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=sendMail|class=node}{tr:id=name}{td}h6.sendMail{td}{tr}{tr:id=sig}{td}{span:style=float: left; margin-right: 5px;}[Boolean]{span}{span:id=iets|style=float: left; font-weight: bold;}sendMail{span}{span:id=iets|style=float: left;}\(\[to[,to2,toN\], \[from[,reply\], subject, msgText, \[cc,cc2,ccN\], \[bcc,bcc2,bccN\], \[attachment/attachments array\], \[overridePreferenceSMTPHost/properties array\]){span}{td}{tr}{tr:id=des}{td}{sub-section:sendMail_des|text=|trigger=button}{sub-section}{sub-section:sendMail_des|trigger=none|class=sIndent}Send a mail, if you make the msgText start with <html> the message will be sent in html (and you can use all html formatting).{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=snc}{td}*Since*\\{sub-section:sendMail_snc|text=|trigger=button}{sub-section}{sub-section:sendMail_snc|trigger=none|class=sIndent} Replace with version info{sub-section}{td}{tr}{builder-show}{tr:id=prs}{td}*Parameters*\\{sub-section:sendMail_prs|text=|trigger=button}{sub-section}{sub-section:sendMail_prs|trigger=none|class=sIndent}\[to\[,to2,toN\]
\[from\[,reply\]
subject
msgText
\[cc,cc2,ccN\]
\[bcc,bcc2,bccN\]
\[attachment/attachments array\]
\[overridePreferenceSMTPHost/properties array\]
{sub-section}{td}{tr}{tr:id=ret}{td}*Returns*\\{sub-section:sendMail_ret|text=|trigger=button}{sub-section}{sub-section:sendMail_ret|trigger=none|class=sIndent}[Boolean]{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:sendMail_see|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:sendMail_see|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:sendMail_link|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:sendMail_link|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{tr:id=sam}{td}*Sample*\\{sub-section:sendMail_sam|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:sendMail_sam|trigger=none}{code:language=javascript}
var attachment1 = plugins.mail.createBinaryAttachment('embedded',plugins.file.readFile('c:/temp/a_logo.gif'));
var msgText = 'plain msg<html>styled html msg<img src="%%embedded%%"></html>';
var success = plugins.mail.sendMail('[email protected],[email protected]', 'John Cobb <[email protected]>', 'subject', msgText,null,'[email protected]',[attachment1]);
if (!success) 
{
	plugins.dialogs.showWarningDialog('Alert','Failed to send mail','OK');
}

//it is possbile to set all kind of smtp properties
//var properties = new Array()
//properties[0] = 'mail.smtp.host=myserver.com'
//properties specification can be found at:http://java.sun.com/products/javamail/javadocs/com/sun/mail/smtp/package-summary.html
//var msgs = plugins.mail.sendMail('[email protected],[email protected]', 'John Cobb <[email protected]>', 'subject', msgText,null,'[email protected]',null, properties);
{code}{sub-section}{div}{td}{tr}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{table}