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: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:class=servoy sSummery}{colgroup}{column:width=80px}{column}{column}{column}{colgroup}{tr:style=height: 30px;}{th:colspan=2}Server Property Summary{th}{tr}{tbody}{tr}{td}{td}{td}[#mail.development.override.address]
{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.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.socketFactory.class]
{td}{tr}{tbody}{tbody}{tr}{td}{td}{td}[#mail.smtp.socketFactory.fallback]
{td}{tr}{tbody}{tbody}{tr}{td}{td}{td}[#mail.smtp.socketFactory.port]
{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:class=servoy sSummery}{colgroup}{column:width=80px}{column}{column}{column}{colgroup}{tr:style=height: 30px;}{th:colspan=2}Method Summary{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, from, subject, msgText, cc, bcc, 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:class=servoy sDetail}{colgroup}{column:width=100%}{column}{colgroup}{tr:style=height: 30px;}{th:colspan=1}Server Property Details{th}{tr}{tbody:id=7B456937-66C7-4206-837B-59D678A10C74}{tr:id=name}{td}h6.mail.development.override.address{td}{tr}{tr:id=des}{td}{sub-section:7B456937-66C7-4206-837B-59D678A10C74_des|text=|trigger=button}{sub-section}{sub-section:7B456937-66C7-4206-837B-59D678A10C74_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=prs}{td}*Parameters*\\{sub-section:7B456937-66C7-4206-837B-59D678A10C74_prs|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:7B456937-66C7-4206-837B-59D678A10C74_prs|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=ret}{td}*Returns*\\{sub-section:7B456937-66C7-4206-837B-59D678A10C74_ret|text=|trigger=button}{sub-section}{sub-section:7B456937-66C7-4206-837B-59D678A10C74_ret|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:7B456937-66C7-4206-837B-59D678A10C74_see|text=|trigger=button}{sub-section}{sub-section:7B456937-66C7-4206-837B-59D678A10C74_see|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:7B456937-66C7-4206-837B-59D678A10C74_see|text=|trigger=button}{sub-section}{sub-section:7B456937-66C7-4206-837B-59D678A10C74_link|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=sam}{td}*Sample*\\{sub-section:7B456937-66C7-4206-837B-59D678A10C74_sam|text=|trigger=button}{sub-section}{sub-section:7B456937-66C7-4206-837B-59D678A10C74_sam|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=95EF0F2D-CBEE-463F-91F7-DE277B456743}{tr:id=name}{td}h6.mail.mime.charset{td}{tr}{tr:id=des}{td}{sub-section:95EF0F2D-CBEE-463F-91F7-DE277B456743_des|text=|trigger=button}{sub-section}{sub-section:95EF0F2D-CBEE-463F-91F7-DE277B456743_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=prs}{td}*Parameters*\\{sub-section:95EF0F2D-CBEE-463F-91F7-DE277B456743_prs|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:95EF0F2D-CBEE-463F-91F7-DE277B456743_prs|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=ret}{td}*Returns*\\{sub-section:95EF0F2D-CBEE-463F-91F7-DE277B456743_ret|text=|trigger=button}{sub-section}{sub-section:95EF0F2D-CBEE-463F-91F7-DE277B456743_ret|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:95EF0F2D-CBEE-463F-91F7-DE277B456743_see|text=|trigger=button}{sub-section}{sub-section:95EF0F2D-CBEE-463F-91F7-DE277B456743_see|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:95EF0F2D-CBEE-463F-91F7-DE277B456743_see|text=|trigger=button}{sub-section}{sub-section:95EF0F2D-CBEE-463F-91F7-DE277B456743_link|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=sam}{td}*Sample*\\{sub-section:95EF0F2D-CBEE-463F-91F7-DE277B456743_sam|text=|trigger=button}{sub-section}{sub-section:95EF0F2D-CBEE-463F-91F7-DE277B456743_sam|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=AF7C5068-A026-4FC3-82E0-2A41C2755228}{tr:id=name}{td}h6.mail.pop3.apop.enable{td}{tr}{tr:id=des}{td}{sub-section:AF7C5068-A026-4FC3-82E0-2A41C2755228_des|text=|trigger=button}{sub-section}{sub-section:AF7C5068-A026-4FC3-82E0-2A41C2755228_des|trigger=none|class=sIndent}Whether or not to use APOP for authentication (true/false){sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=prs}{td}*Parameters*\\{sub-section:AF7C5068-A026-4FC3-82E0-2A41C2755228_prs|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:AF7C5068-A026-4FC3-82E0-2A41C2755228_prs|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=ret}{td}*Returns*\\{sub-section:AF7C5068-A026-4FC3-82E0-2A41C2755228_ret|text=|trigger=button}{sub-section}{sub-section:AF7C5068-A026-4FC3-82E0-2A41C2755228_ret|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:AF7C5068-A026-4FC3-82E0-2A41C2755228_see|text=|trigger=button}{sub-section}{sub-section:AF7C5068-A026-4FC3-82E0-2A41C2755228_see|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:AF7C5068-A026-4FC3-82E0-2A41C2755228_see|text=|trigger=button}{sub-section}{sub-section:AF7C5068-A026-4FC3-82E0-2A41C2755228_link|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=sam}{td}*Sample*\\{sub-section:AF7C5068-A026-4FC3-82E0-2A41C2755228_sam|text=|trigger=button}{sub-section}{sub-section:AF7C5068-A026-4FC3-82E0-2A41C2755228_sam|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=04ACA5E9-335F-4F50-B07E-57E1BC8D8867}{tr:id=name}{td}h6.mail.pop3.host{td}{tr}{tr:id=des}{td}{sub-section:04ACA5E9-335F-4F50-B07E-57E1BC8D8867_des|text=|trigger=button}{sub-section}{sub-section:04ACA5E9-335F-4F50-B07E-57E1BC8D8867_des|trigger=none|class=sIndent}The name of POP3 server to recieve mails from{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=prs}{td}*Parameters*\\{sub-section:04ACA5E9-335F-4F50-B07E-57E1BC8D8867_prs|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:04ACA5E9-335F-4F50-B07E-57E1BC8D8867_prs|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=ret}{td}*Returns*\\{sub-section:04ACA5E9-335F-4F50-B07E-57E1BC8D8867_ret|text=|trigger=button}{sub-section}{sub-section:04ACA5E9-335F-4F50-B07E-57E1BC8D8867_ret|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:04ACA5E9-335F-4F50-B07E-57E1BC8D8867_see|text=|trigger=button}{sub-section}{sub-section:04ACA5E9-335F-4F50-B07E-57E1BC8D8867_see|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:04ACA5E9-335F-4F50-B07E-57E1BC8D8867_see|text=|trigger=button}{sub-section}{sub-section:04ACA5E9-335F-4F50-B07E-57E1BC8D8867_link|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=sam}{td}*Sample*\\{sub-section:04ACA5E9-335F-4F50-B07E-57E1BC8D8867_sam|text=|trigger=button}{sub-section}{sub-section:04ACA5E9-335F-4F50-B07E-57E1BC8D8867_sam|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=DD454E75-8351-4C30-8522-8805BEA3CF26}{tr:id=name}{td}h6.mail.smtp.auth{td}{tr}{tr:id=des}{td}{sub-section:DD454E75-8351-4C30-8522-8805BEA3CF26_des|text=|trigger=button}{sub-section}{sub-section:DD454E75-8351-4C30-8522-8805BEA3CF26_des|trigger=none|class=sIndent}Use authentication (true/false){sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=prs}{td}*Parameters*\\{sub-section:DD454E75-8351-4C30-8522-8805BEA3CF26_prs|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:DD454E75-8351-4C30-8522-8805BEA3CF26_prs|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=ret}{td}*Returns*\\{sub-section:DD454E75-8351-4C30-8522-8805BEA3CF26_ret|text=|trigger=button}{sub-section}{sub-section:DD454E75-8351-4C30-8522-8805BEA3CF26_ret|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:DD454E75-8351-4C30-8522-8805BEA3CF26_see|text=|trigger=button}{sub-section}{sub-section:DD454E75-8351-4C30-8522-8805BEA3CF26_see|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:DD454E75-8351-4C30-8522-8805BEA3CF26_see|text=|trigger=button}{sub-section}{sub-section:DD454E75-8351-4C30-8522-8805BEA3CF26_link|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=sam}{td}*Sample*\\{sub-section:DD454E75-8351-4C30-8522-8805BEA3CF26_sam|text=|trigger=button}{sub-section}{sub-section:DD454E75-8351-4C30-8522-8805BEA3CF26_sam|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=8EEF57DF-5C8F-42F3-91D3-29CCCEF9497D}{tr:id=name}{td}h6.mail.smtp.connectiontimeout{td}{tr}{tr:id=des}{td}{sub-section:8EEF57DF-5C8F-42F3-91D3-29CCCEF9497D_des|text=|trigger=button}{sub-section}{sub-section:8EEF57DF-5C8F-42F3-91D3-29CCCEF9497D_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=prs}{td}*Parameters*\\{sub-section:8EEF57DF-5C8F-42F3-91D3-29CCCEF9497D_prs|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:8EEF57DF-5C8F-42F3-91D3-29CCCEF9497D_prs|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=ret}{td}*Returns*\\{sub-section:8EEF57DF-5C8F-42F3-91D3-29CCCEF9497D_ret|text=|trigger=button}{sub-section}{sub-section:8EEF57DF-5C8F-42F3-91D3-29CCCEF9497D_ret|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:8EEF57DF-5C8F-42F3-91D3-29CCCEF9497D_see|text=|trigger=button}{sub-section}{sub-section:8EEF57DF-5C8F-42F3-91D3-29CCCEF9497D_see|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:8EEF57DF-5C8F-42F3-91D3-29CCCEF9497D_see|text=|trigger=button}{sub-section}{sub-section:8EEF57DF-5C8F-42F3-91D3-29CCCEF9497D_link|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=sam}{td}*Sample*\\{sub-section:8EEF57DF-5C8F-42F3-91D3-29CCCEF9497D_sam|text=|trigger=button}{sub-section}{sub-section:8EEF57DF-5C8F-42F3-91D3-29CCCEF9497D_sam|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=C429A111-C5F2-45E0-8E59-607257881ECA}{tr:id=name}{td}h6.mail.smtp.host{td}{tr}{tr:id=des}{td}{sub-section:C429A111-C5F2-45E0-8E59-607257881ECA_des|text=|trigger=button}{sub-section}{sub-section:C429A111-C5F2-45E0-8E59-607257881ECA_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=prs}{td}*Parameters*\\{sub-section:C429A111-C5F2-45E0-8E59-607257881ECA_prs|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:C429A111-C5F2-45E0-8E59-607257881ECA_prs|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=ret}{td}*Returns*\\{sub-section:C429A111-C5F2-45E0-8E59-607257881ECA_ret|text=|trigger=button}{sub-section}{sub-section:C429A111-C5F2-45E0-8E59-607257881ECA_ret|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:C429A111-C5F2-45E0-8E59-607257881ECA_see|text=|trigger=button}{sub-section}{sub-section:C429A111-C5F2-45E0-8E59-607257881ECA_see|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:C429A111-C5F2-45E0-8E59-607257881ECA_see|text=|trigger=button}{sub-section}{sub-section:C429A111-C5F2-45E0-8E59-607257881ECA_link|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=sam}{td}*Sample*\\{sub-section:C429A111-C5F2-45E0-8E59-607257881ECA_sam|text=|trigger=button}{sub-section}{sub-section:C429A111-C5F2-45E0-8E59-607257881ECA_sam|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=6A9990D8-325D-4525-B40C-2A11A16A342C}{tr:id=name}{td}h6.mail.smtp.password{td}{tr}{tr:id=des}{td}{sub-section:6A9990D8-325D-4525-B40C-2A11A16A342C_des|text=|trigger=button}{sub-section}{sub-section:6A9990D8-325D-4525-B40C-2A11A16A342C_des|trigger=none|class=sIndent}Specify password if using authentication{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=prs}{td}*Parameters*\\{sub-section:6A9990D8-325D-4525-B40C-2A11A16A342C_prs|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:6A9990D8-325D-4525-B40C-2A11A16A342C_prs|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=ret}{td}*Returns*\\{sub-section:6A9990D8-325D-4525-B40C-2A11A16A342C_ret|text=|trigger=button}{sub-section}{sub-section:6A9990D8-325D-4525-B40C-2A11A16A342C_ret|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:6A9990D8-325D-4525-B40C-2A11A16A342C_see|text=|trigger=button}{sub-section}{sub-section:6A9990D8-325D-4525-B40C-2A11A16A342C_see|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:6A9990D8-325D-4525-B40C-2A11A16A342C_see|text=|trigger=button}{sub-section}{sub-section:6A9990D8-325D-4525-B40C-2A11A16A342C_link|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=sam}{td}*Sample*\\{sub-section:6A9990D8-325D-4525-B40C-2A11A16A342C_sam|text=|trigger=button}{sub-section}{sub-section:6A9990D8-325D-4525-B40C-2A11A16A342C_sam|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=55A0A465-709F-46D4-81F4-65A994E45763}{tr:id=name}{td}h6.mail.smtp.socketFactory.class{td}{tr}{tr:id=des}{td}{sub-section:55A0A465-709F-46D4-81F4-65A994E45763_des|text=|trigger=button}{sub-section}{sub-section:55A0A465-709F-46D4-81F4-65A994E45763_des|trigger=none|class=sIndent}If set, specifies the name of a class that implements the javax.net.SocketFactory interface. This class will be used to create SMTP sockets. Use "javax.net.ssl.SSLSocketFactory" for SSL{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=prs}{td}*Parameters*\\{sub-section:55A0A465-709F-46D4-81F4-65A994E45763_prs|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:55A0A465-709F-46D4-81F4-65A994E45763_prs|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=ret}{td}*Returns*\\{sub-section:55A0A465-709F-46D4-81F4-65A994E45763_ret|text=|trigger=button}{sub-section}{sub-section:55A0A465-709F-46D4-81F4-65A994E45763_ret|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:55A0A465-709F-46D4-81F4-65A994E45763_see|text=|trigger=button}{sub-section}{sub-section:55A0A465-709F-46D4-81F4-65A994E45763_see|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:55A0A465-709F-46D4-81F4-65A994E45763_see|text=|trigger=button}{sub-section}{sub-section:55A0A465-709F-46D4-81F4-65A994E45763_link|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=sam}{td}*Sample*\\{sub-section:55A0A465-709F-46D4-81F4-65A994E45763_sam|text=|trigger=button}{sub-section}{sub-section:55A0A465-709F-46D4-81F4-65A994E45763_sam|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=7920B782-5F83-4E2B-BCF1-B24E90CB786C}{tr:id=name}{td}h6.mail.smtp.socketFactory.fallback{td}{tr}{tr:id=des}{td}{sub-section:7920B782-5F83-4E2B-BCF1-B24E90CB786C_des|text=|trigger=button}{sub-section}{sub-section:7920B782-5F83-4E2B-BCF1-B24E90CB786C_des|trigger=none|class=sIndent}If set to true, failure to create a socket using the specified socket factory class will cause the socket to be created using the java.net.Socket class. Defaults to true.{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=prs}{td}*Parameters*\\{sub-section:7920B782-5F83-4E2B-BCF1-B24E90CB786C_prs|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:7920B782-5F83-4E2B-BCF1-B24E90CB786C_prs|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=ret}{td}*Returns*\\{sub-section:7920B782-5F83-4E2B-BCF1-B24E90CB786C_ret|text=|trigger=button}{sub-section}{sub-section:7920B782-5F83-4E2B-BCF1-B24E90CB786C_ret|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:7920B782-5F83-4E2B-BCF1-B24E90CB786C_see|text=|trigger=button}{sub-section}{sub-section:7920B782-5F83-4E2B-BCF1-B24E90CB786C_see|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:7920B782-5F83-4E2B-BCF1-B24E90CB786C_see|text=|trigger=button}{sub-section}{sub-section:7920B782-5F83-4E2B-BCF1-B24E90CB786C_link|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=sam}{td}*Sample*\\{sub-section:7920B782-5F83-4E2B-BCF1-B24E90CB786C_sam|text=|trigger=button}{sub-section}{sub-section:7920B782-5F83-4E2B-BCF1-B24E90CB786C_sam|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=1E001A69-A532-409E-804A-1A63E10065B5}{tr:id=name}{td}h6.mail.smtp.socketFactory.port{td}{tr}{tr:id=des}{td}{sub-section:1E001A69-A532-409E-804A-1A63E10065B5_des|text=|trigger=button}{sub-section}{sub-section:1E001A69-A532-409E-804A-1A63E10065B5_des|trigger=none|class=sIndent}Specifies the port to connect to when using the specified socket factory. If not set, the default port will be used.{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=prs}{td}*Parameters*\\{sub-section:1E001A69-A532-409E-804A-1A63E10065B5_prs|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:1E001A69-A532-409E-804A-1A63E10065B5_prs|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=ret}{td}*Returns*\\{sub-section:1E001A69-A532-409E-804A-1A63E10065B5_ret|text=|trigger=button}{sub-section}{sub-section:1E001A69-A532-409E-804A-1A63E10065B5_ret|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:1E001A69-A532-409E-804A-1A63E10065B5_see|text=|trigger=button}{sub-section}{sub-section:1E001A69-A532-409E-804A-1A63E10065B5_see|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:1E001A69-A532-409E-804A-1A63E10065B5_see|text=|trigger=button}{sub-section}{sub-section:1E001A69-A532-409E-804A-1A63E10065B5_link|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=sam}{td}*Sample*\\{sub-section:1E001A69-A532-409E-804A-1A63E10065B5_sam|text=|trigger=button}{sub-section}{sub-section:1E001A69-A532-409E-804A-1A63E10065B5_sam|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=121F21B6-BF84-4988-86BB-441D07FD1869}{tr:id=name}{td}h6.mail.smtp.timeout{td}{tr}{tr:id=des}{td}{sub-section:121F21B6-BF84-4988-86BB-441D07FD1869_des|text=|trigger=button}{sub-section}{sub-section:121F21B6-BF84-4988-86BB-441D07FD1869_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=prs}{td}*Parameters*\\{sub-section:121F21B6-BF84-4988-86BB-441D07FD1869_prs|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:121F21B6-BF84-4988-86BB-441D07FD1869_prs|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=ret}{td}*Returns*\\{sub-section:121F21B6-BF84-4988-86BB-441D07FD1869_ret|text=|trigger=button}{sub-section}{sub-section:121F21B6-BF84-4988-86BB-441D07FD1869_ret|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:121F21B6-BF84-4988-86BB-441D07FD1869_see|text=|trigger=button}{sub-section}{sub-section:121F21B6-BF84-4988-86BB-441D07FD1869_see|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:121F21B6-BF84-4988-86BB-441D07FD1869_see|text=|trigger=button}{sub-section}{sub-section:121F21B6-BF84-4988-86BB-441D07FD1869_link|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=sam}{td}*Sample*\\{sub-section:121F21B6-BF84-4988-86BB-441D07FD1869_sam|text=|trigger=button}{sub-section}{sub-section:121F21B6-BF84-4988-86BB-441D07FD1869_sam|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=48E3A9CF-840E-4A97-83FA-655CBF176D8A}{tr:id=name}{td}h6.mail.smtp.username{td}{tr}{tr:id=des}{td}{sub-section:48E3A9CF-840E-4A97-83FA-655CBF176D8A_des|text=|trigger=button}{sub-section}{sub-section:48E3A9CF-840E-4A97-83FA-655CBF176D8A_des|trigger=none|class=sIndent}Specify username if using authentication{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=prs}{td}*Parameters*\\{sub-section:48E3A9CF-840E-4A97-83FA-655CBF176D8A_prs|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:48E3A9CF-840E-4A97-83FA-655CBF176D8A_prs|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=ret}{td}*Returns*\\{sub-section:48E3A9CF-840E-4A97-83FA-655CBF176D8A_ret|text=|trigger=button}{sub-section}{sub-section:48E3A9CF-840E-4A97-83FA-655CBF176D8A_ret|trigger=none|class=sIndent}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:48E3A9CF-840E-4A97-83FA-655CBF176D8A_see|text=|trigger=button}{sub-section}{sub-section:48E3A9CF-840E-4A97-83FA-655CBF176D8A_see|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:48E3A9CF-840E-4A97-83FA-655CBF176D8A_see|text=|trigger=button}{sub-section}{sub-section:48E3A9CF-840E-4A97-83FA-655CBF176D8A_link|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=sam}{td}*Sample*\\{sub-section:48E3A9CF-840E-4A97-83FA-655CBF176D8A_sam|text=|trigger=button}{sub-section}{sub-section:48E3A9CF-840E-4A97-83FA-655CBF176D8A_sam|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{table}\\ 

{table:class=servoy sDetail}{colgroup}{column:width=100%}{column}{colgroup}{tr:style=height: 30px;}{th:colspan=1}Method Details{th}{tr}{tbody:id=60611301-10F2-4C2D-941B-CAFB295EAC51}{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:60611301-10F2-4C2D-941B-CAFB295EAC51_des|text=|trigger=button}{sub-section}{sub-section:60611301-10F2-4C2D-941B-CAFB295EAC51_des|trigger=none|class=sIndent}Creates a binary attachment object.{sub-section}{td}{tr}{tr:id=prs}{td}*Parameters*\\{sub-section:60611301-10F2-4C2D-941B-CAFB295EAC51_prs|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:60611301-10F2-4C2D-941B-CAFB295EAC51_prs|trigger=none}filename
binarydata
\[mimeType\]
{sub-section}{div}{td}{tr}{tr:id=ret}{td}*Returns*\\{sub-section:60611301-10F2-4C2D-941B-CAFB295EAC51_ret|text=|trigger=button}{sub-section}{sub-section:60611301-10F2-4C2D-941B-CAFB295EAC51_ret|trigger=none|class=sIndent}[Attachment]{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:60611301-10F2-4C2D-941B-CAFB295EAC51_see|text=|trigger=button}{sub-section}{sub-section:60611301-10F2-4C2D-941B-CAFB295EAC51_see|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:60611301-10F2-4C2D-941B-CAFB295EAC51_see|text=|trigger=button}{sub-section}{sub-section:60611301-10F2-4C2D-941B-CAFB295EAC51_link|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{tr:id=sam}{td}*Sample*\\{sub-section:60611301-10F2-4C2D-941B-CAFB295EAC51_sam|text=|trigger=button}{sub-section}{sub-section:60611301-10F2-4C2D-941B-CAFB295EAC51_sam|class=sIndent|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}{td}{tr}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=8EE4FB97-83AA-4D61-8CFF-DE1B306C7BEA}{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:8EE4FB97-83AA-4D61-8CFF-DE1B306C7BEA_des|text=|trigger=button}{sub-section}{sub-section:8EE4FB97-83AA-4D61-8CFF-DE1B306C7BEA_des|trigger=none|class=sIndent}Creates a text based attachment object.{sub-section}{td}{tr}{tr:id=prs}{td}*Parameters*\\{sub-section:8EE4FB97-83AA-4D61-8CFF-DE1B306C7BEA_prs|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:8EE4FB97-83AA-4D61-8CFF-DE1B306C7BEA_prs|trigger=none}filename
textdata
\[mimeType\]
{sub-section}{div}{td}{tr}{tr:id=ret}{td}*Returns*\\{sub-section:8EE4FB97-83AA-4D61-8CFF-DE1B306C7BEA_ret|text=|trigger=button}{sub-section}{sub-section:8EE4FB97-83AA-4D61-8CFF-DE1B306C7BEA_ret|trigger=none|class=sIndent}[Attachment]{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:8EE4FB97-83AA-4D61-8CFF-DE1B306C7BEA_see|text=|trigger=button}{sub-section}{sub-section:8EE4FB97-83AA-4D61-8CFF-DE1B306C7BEA_see|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:8EE4FB97-83AA-4D61-8CFF-DE1B306C7BEA_see|text=|trigger=button}{sub-section}{sub-section:8EE4FB97-83AA-4D61-8CFF-DE1B306C7BEA_link|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{tr:id=sam}{td}*Sample*\\{sub-section:8EE4FB97-83AA-4D61-8CFF-DE1B306C7BEA_sam|text=|trigger=button}{sub-section}{sub-section:8EE4FB97-83AA-4D61-8CFF-DE1B306C7BEA_sam|class=sIndent|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}{td}{tr}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=04FD83E2-4086-4599-8C7C-46A060EDE056}{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:04FD83E2-4086-4599-8C7C-46A060EDE056_des|text=|trigger=button}{sub-section}{sub-section:04FD83E2-4086-4599-8C7C-46A060EDE056_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=prs}{td}*Parameters*\\{sub-section:04FD83E2-4086-4599-8C7C-46A060EDE056_prs|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:04FD83E2-4086-4599-8C7C-46A060EDE056_prs|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{tr:id=ret}{td}*Returns*\\{sub-section:04FD83E2-4086-4599-8C7C-46A060EDE056_ret|text=|trigger=button}{sub-section}{sub-section:04FD83E2-4086-4599-8C7C-46A060EDE056_ret|trigger=none|class=sIndent}[String]{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:04FD83E2-4086-4599-8C7C-46A060EDE056_see|text=|trigger=button}{sub-section}{sub-section:04FD83E2-4086-4599-8C7C-46A060EDE056_see|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:04FD83E2-4086-4599-8C7C-46A060EDE056_see|text=|trigger=button}{sub-section}{sub-section:04FD83E2-4086-4599-8C7C-46A060EDE056_link|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{tr:id=sam}{td}*Sample*\\{sub-section:04FD83E2-4086-4599-8C7C-46A060EDE056_sam|text=|trigger=button}{sub-section}{sub-section:04FD83E2-4086-4599-8C7C-46A060EDE056_sam|class=sIndent|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}{td}{tr}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=ADCB5B6A-35E4-4C93-822D-C7A8BDE368EC}{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:ADCB5B6A-35E4-4C93-822D-C7A8BDE368EC_des|text=|trigger=button}{sub-section}{sub-section:ADCB5B6A-35E4-4C93-822D-C7A8BDE368EC_des|trigger=none|class=sIndent}Helper method, returns MailMessage object from binary or 7bits string.{sub-section}{td}{tr}{tr:id=prs}{td}*Parameters*\\{sub-section:ADCB5B6A-35E4-4C93-822D-C7A8BDE368EC_prs|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:ADCB5B6A-35E4-4C93-822D-C7A8BDE368EC_prs|trigger=none}binaryblob/string
{sub-section}{div}{td}{tr}{tr:id=ret}{td}*Returns*\\{sub-section:ADCB5B6A-35E4-4C93-822D-C7A8BDE368EC_ret|text=|trigger=button}{sub-section}{sub-section:ADCB5B6A-35E4-4C93-822D-C7A8BDE368EC_ret|trigger=none|class=sIndent}[MailMessage]{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:ADCB5B6A-35E4-4C93-822D-C7A8BDE368EC_see|text=|trigger=button}{sub-section}{sub-section:ADCB5B6A-35E4-4C93-822D-C7A8BDE368EC_see|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:ADCB5B6A-35E4-4C93-822D-C7A8BDE368EC_see|text=|trigger=button}{sub-section}{sub-section:ADCB5B6A-35E4-4C93-822D-C7A8BDE368EC_link|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{tr:id=sam}{td}*Sample*\\{sub-section:ADCB5B6A-35E4-4C93-822D-C7A8BDE368EC_sam|text=|trigger=button}{sub-section}{sub-section:ADCB5B6A-35E4-4C93-822D-C7A8BDE368EC_sam|class=sIndent|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}{td}{tr}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=22048709-B53D-4E46-8761-030E73E12B20}{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:22048709-B53D-4E46-8761-030E73E12B20_des|text=|trigger=button}{sub-section}{sub-section:22048709-B53D-4E46-8761-030E73E12B20_des|trigger=none|class=sIndent}Helper method to only get the plain addresses.{sub-section}{td}{tr}{tr:id=prs}{td}*Parameters*\\{sub-section:22048709-B53D-4E46-8761-030E73E12B20_prs|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:22048709-B53D-4E46-8761-030E73E12B20_prs|trigger=none}addressesString
{sub-section}{div}{td}{tr}{tr:id=ret}{td}*Returns*\\{sub-section:22048709-B53D-4E46-8761-030E73E12B20_ret|text=|trigger=button}{sub-section}{sub-section:22048709-B53D-4E46-8761-030E73E12B20_ret|trigger=none|class=sIndent}[String]\[]{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:22048709-B53D-4E46-8761-030E73E12B20_see|text=|trigger=button}{sub-section}{sub-section:22048709-B53D-4E46-8761-030E73E12B20_see|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:22048709-B53D-4E46-8761-030E73E12B20_see|text=|trigger=button}{sub-section}{sub-section:22048709-B53D-4E46-8761-030E73E12B20_link|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{tr:id=sam}{td}*Sample*\\{sub-section:22048709-B53D-4E46-8761-030E73E12B20_sam|text=|trigger=button}{sub-section}{sub-section:22048709-B53D-4E46-8761-030E73E12B20_sam|class=sIndent|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}{td}{tr}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=FEB0A5FA-C4A4-44B8-ACB6-C96000026571}{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:FEB0A5FA-C4A4-44B8-ACB6-C96000026571_des|text=|trigger=button}{sub-section}{sub-section:FEB0A5FA-C4A4-44B8-ACB6-C96000026571_des|trigger=none|class=sIndent}Receive mails from pop3 account.{sub-section}{td}{tr}{tr:id=prs}{td}*Parameters*\\{sub-section:FEB0A5FA-C4A4-44B8-ACB6-C96000026571_prs|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:FEB0A5FA-C4A4-44B8-ACB6-C96000026571_prs|trigger=none}userName
password
leaveMsgsOnServer
\[receiveMode\]
\[onlyreceiveMsgWithSentDate\]
\[overridePreferencePOP3Host/properties array\]
{sub-section}{div}{td}{tr}{tr:id=ret}{td}*Returns*\\{sub-section:FEB0A5FA-C4A4-44B8-ACB6-C96000026571_ret|text=|trigger=button}{sub-section}{sub-section:FEB0A5FA-C4A4-44B8-ACB6-C96000026571_ret|trigger=none|class=sIndent}[MailMessage]\[]{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:FEB0A5FA-C4A4-44B8-ACB6-C96000026571_see|text=|trigger=button}{sub-section}{sub-section:FEB0A5FA-C4A4-44B8-ACB6-C96000026571_see|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:FEB0A5FA-C4A4-44B8-ACB6-C96000026571_see|text=|trigger=button}{sub-section}{sub-section:FEB0A5FA-C4A4-44B8-ACB6-C96000026571_link|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{tr:id=sam}{td}*Sample*\\{sub-section:FEB0A5FA-C4A4-44B8-ACB6-C96000026571_sam|text=|trigger=button}{sub-section}{sub-section:FEB0A5FA-C4A4-44B8-ACB6-C96000026571_sam|class=sIndent|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}{td}{tr}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{tbody:id=A8725D22-D9B7-47CA-A3B1-03691CA2E55E}{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, from, subject, msgText, cc, bcc, attachment/attachments array, overridePreferenceSMTPHost/properties array){span}{td}{tr}{tr:id=des}{td}{sub-section:A8725D22-D9B7-47CA-A3B1-03691CA2E55E_des|text=|trigger=button}{sub-section}{sub-section:A8725D22-D9B7-47CA-A3B1-03691CA2E55E_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}{tr:id=prs}{td}*Parameters*\\{sub-section:A8725D22-D9B7-47CA-A3B1-03691CA2E55E_prs|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:A8725D22-D9B7-47CA-A3B1-03691CA2E55E_prs|trigger=none}to
from
subject
msgText
\[cc\]
\[bcc\]
\[attachment/attachments array\]
\[overridePreferenceSMTPHost/properties array\]
{sub-section}{div}{td}{tr}{tr:id=ret}{td}*Returns*\\{sub-section:A8725D22-D9B7-47CA-A3B1-03691CA2E55E_ret|text=|trigger=button}{sub-section}{sub-section:A8725D22-D9B7-47CA-A3B1-03691CA2E55E_ret|trigger=none|class=sIndent}[Boolean]{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:A8725D22-D9B7-47CA-A3B1-03691CA2E55E_see|text=|trigger=button}{sub-section}{sub-section:A8725D22-D9B7-47CA-A3B1-03691CA2E55E_see|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:A8725D22-D9B7-47CA-A3B1-03691CA2E55E_see|text=|trigger=button}{sub-section}{sub-section:A8725D22-D9B7-47CA-A3B1-03691CA2E55E_link|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{tr:id=sam}{td}*Sample*\\{sub-section:A8725D22-D9B7-47CA-A3B1-03691CA2E55E_sam|text=|trigger=button}{sub-section}{sub-section:A8725D22-D9B7-47CA-A3B1-03691CA2E55E_sam|class=sIndent|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}{td}{tr}{tr:class=lastDetailRow}{td}{td}{tr}{tbody}{table}