Page History

Wiki Markup
{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}MethodServer Property Summary{th}{tr}{tbody}{tr}{td}[Attachment]{td}{td}[#createBinaryAttachment]\(filename, binarydata, mimeType)
Creates a binary attachment object.#mail.development.override.address]
{td}{tr}{tbody}{tbody}{tr}{td}[Attachment]{td}{td}[#createTextAttachment]\(filename, textdata, mimeType)
Creates a text based attachment object.#mail.mime.charset]
{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).#mail.pop3.apop.enable]
{td}{tr}{tbody}{tbody}{tr}{td}{td}{td}[#mail.pop3.host]
{td}{tr}{tbody}{tbody}{tr}{td}[MailMessage]{td}{td}[#getMailMessage]\(binaryblob/string)
Helper method, returns MailMessage object from binary or 7bits string.#mail.smtp.auth]
{td}{tr}{tbody}{tbody}{tr}{td}[String]\[]{td}{td}[#getPlainMailAddresses]\(addressesString)
Helper method to only get the plain addresses.#mail.smtp.connectiontimeout]
{td}{tr}{tbody}{tbody}{tr}{td}[MailMessage]\[]{td}{td}[#receiveMail]\(userName, password, leaveMsgsOnServer, receiveMode, onlyreceiveMsgWithSentDate, overridePreferencePOP3Host/properties array)
Receive mails from pop3 account.{td}{td}[#mail.smtp.host]
{td}{tr}{tbody}{tbody}{tr}{td}{td}{td}[#mail.smtp.password]
{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).#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=9EB457B260611301-E88E10F2-4F344C2D-ABD5941B-9220905B1F9CCAFB295EAC51}{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:9EB457B260611301-E88E10F2-4F344C2D-ABD5941B-9220905B1F9CCAFB295EAC51_des|text=|trigger=button}{sub-section}{sub-section:9EB457B260611301-E88E10F2-4F344C2D-ABD5941B-9220905B1F9CCAFB295EAC51_des|trigger=none|class=sIndent}Creates a binary attachment object.{sub-section}{td}{tr}{tr:id=prs}{td}*Parameters*\\{sub-section:9EB457B260611301-E88E10F2-4F344C2D-ABD5941B-9220905B1F9CCAFB295EAC51_prs|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:9EB457B260611301-E88E10F2-4F344C2D-ABD5941B-9220905B1F9CCAFB295EAC51_prs|trigger=none}filename
binarydata
\[mimeType\]
{sub-section}{div}{td}{tr}{tr:id=ret}{td}*Returns*\\{sub-section:9EB457B260611301-E88E10F2-4F344C2D-ABD5941B-9220905B1F9CCAFB295EAC51_ret|text=|trigger=button}{sub-section}{sub-section:9EB457B260611301-E88E10F2-4F344C2D-ABD5941B-9220905B1F9CCAFB295EAC51_ret|trigger=none|class=sIndent}[Attachment]{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:9EB457B260611301-E88E10F2-4F344C2D-ABD5941B-9220905B1F9CCAFB295EAC51_see|text=|trigger=button}{sub-section}{sub-section:9EB457B260611301-E88E10F2-4F344C2D-ABD5941B-9220905B1F9CCAFB295EAC51_see|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:9EB457B260611301-E88E10F2-4F344C2D-ABD5941B-9220905B1F9CCAFB295EAC51_see|text=|trigger=button}{sub-section}{sub-section:9EB457B260611301-E88E10F2-4F344C2D-ABD5941B-9220905B1F9CCAFB295EAC51_link|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{tr:id=sam}{td}*Sample*\\{sub-section:9EB457B260611301-E88E10F2-4F344C2D-ABD5941B-9220905B1F9CCAFB295EAC51_sam|text=|trigger=button}{sub-section}{sub-section:9EB457B260611301-E88E10F2-4F344C2D-ABD5941B-9220905B1F9CCAFB295EAC51_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=AC5865668EE4FB97-F10383AA-41784D61-B62A8CFF-83BF286ADF29DE1B306C7BEA}{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:AC5865668EE4FB97-F10383AA-41784D61-B62A8CFF-83BF286ADF29DE1B306C7BEA_des|text=|trigger=button}{sub-section}{sub-section:AC5865668EE4FB97-F10383AA-41784D61-B62A8CFF-83BF286ADF29DE1B306C7BEA_des|trigger=none|class=sIndent}Creates a text based attachment object.{sub-section}{td}{tr}{tr:id=prs}{td}*Parameters*\\{sub-section:AC5865668EE4FB97-F10383AA-41784D61-B62A8CFF-83BF286ADF29DE1B306C7BEA_prs|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:AC5865668EE4FB97-F10383AA-41784D61-B62A8CFF-83BF286ADF29DE1B306C7BEA_prs|trigger=none}filename
textdata
\[mimeType\]
{sub-section}{div}{td}{tr}{tr:id=ret}{td}*Returns*\\{sub-section:AC5865668EE4FB97-F10383AA-41784D61-B62A8CFF-83BF286ADF29DE1B306C7BEA_ret|text=|trigger=button}{sub-section}{sub-section:AC5865668EE4FB97-F10383AA-41784D61-B62A8CFF-83BF286ADF29DE1B306C7BEA_ret|trigger=none|class=sIndent}[Attachment]{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:AC5865668EE4FB97-F10383AA-41784D61-B62A8CFF-83BF286ADF29DE1B306C7BEA_see|text=|trigger=button}{sub-section}{sub-section:AC5865668EE4FB97-F10383AA-41784D61-B62A8CFF-83BF286ADF29DE1B306C7BEA_see|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:AC5865668EE4FB97-F10383AA-41784D61-B62A8CFF-83BF286ADF29DE1B306C7BEA_see|text=|trigger=button}{sub-section}{sub-section:AC5865668EE4FB97-F10383AA-41784D61-B62A8CFF-83BF286ADF29DE1B306C7BEA_link|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{tr:id=sam}{td}*Sample*\\{sub-section:AC5865668EE4FB97-F10383AA-41784D61-B62A8CFF-83BF286ADF29DE1B306C7BEA_sam|text=|trigger=button}{sub-section}{sub-section:AC5865668EE4FB97-F10383AA-41784D61-B62A8CFF-83BF286ADF29DE1B306C7BEA_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=0CE8955A04FD83E2-E0174086-4BEA4599-80A48C7C-F99D515C8F7346A060EDE056}{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:0CE8955A04FD83E2-E0174086-4BEA4599-80A48C7C-F99D515C8F7346A060EDE056_des|text=|trigger=button}{sub-section}{sub-section:0CE8955A04FD83E2-E0174086-4BEA4599-80A48C7C-F99D515C8F7346A060EDE056_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:0CE8955A04FD83E2-E0174086-4BEA4599-80A48C7C-F99D515C8F7346A060EDE056_prs|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:0CE8955A04FD83E2-E0174086-4BEA4599-80A48C7C-F99D515C8F7346A060EDE056_prs|trigger=none}{sub-section}{div}{td}{tr}{builder-show}{tr:id=ret}{td}*Returns*\\{sub-section:0CE8955A04FD83E2-E0174086-4BEA4599-80A48C7C-F99D515C8F7346A060EDE056_ret|text=|trigger=button}{sub-section}{sub-section:0CE8955A04FD83E2-E0174086-4BEA4599-80A48C7C-F99D515C8F7346A060EDE056_ret|trigger=none|class=sIndent}[String]{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:0CE8955A04FD83E2-E0174086-4BEA4599-80A48C7C-F99D515C8F7346A060EDE056_see|text=|trigger=button}{sub-section}{sub-section:0CE8955A04FD83E2-E0174086-4BEA4599-80A48C7C-F99D515C8F7346A060EDE056_see|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:0CE8955A04FD83E2-E0174086-4BEA4599-80A48C7C-F99D515C8F7346A060EDE056_see|text=|trigger=button}{sub-section}{sub-section:0CE8955A04FD83E2-E0174086-4BEA4599-80A48C7C-F99D515C8F7346A060EDE056_link|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{tr:id=sam}{td}*Sample*\\{sub-section:0CE8955A04FD83E2-E0174086-4BEA4599-80A48C7C-F99D515C8F7346A060EDE056_sam|text=|trigger=button}{sub-section}{sub-section:0CE8955A04FD83E2-E0174086-4BEA4599-80A48C7C-F99D515C8F7346A060EDE056_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=84ED7B2CADCB5B6A-7C7E35E4-4BA44C93-94BA822D-EE3772492E8FC7A8BDE368EC}{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:84ED7B2CADCB5B6A-7C7E35E4-4BA44C93-94BA822D-EE3772492E8FC7A8BDE368EC_des|text=|trigger=button}{sub-section}{sub-section:84ED7B2CADCB5B6A-7C7E35E4-4BA44C93-94BA822D-EE3772492E8FC7A8BDE368EC_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:84ED7B2CADCB5B6A-7C7E35E4-4BA44C93-94BA822D-EE3772492E8FC7A8BDE368EC_prs|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:84ED7B2CADCB5B6A-7C7E35E4-4BA44C93-94BA822D-EE3772492E8FC7A8BDE368EC_prs|trigger=none}binaryblob/string
{sub-section}{div}{td}{tr}{tr:id=ret}{td}*Returns*\\{sub-section:84ED7B2CADCB5B6A-7C7E35E4-4BA44C93-94BA822D-EE3772492E8FC7A8BDE368EC_ret|text=|trigger=button}{sub-section}{sub-section:84ED7B2CADCB5B6A-7C7E35E4-4BA44C93-94BA822D-EE3772492E8FC7A8BDE368EC_ret|trigger=none|class=sIndent}[MailMessage]{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:84ED7B2CADCB5B6A-7C7E35E4-4BA44C93-94BA822D-EE3772492E8FC7A8BDE368EC_see|text=|trigger=button}{sub-section}{sub-section:84ED7B2CADCB5B6A-7C7E35E4-4BA44C93-94BA822D-EE3772492E8FC7A8BDE368EC_see|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:84ED7B2CADCB5B6A-7C7E35E4-4BA44C93-94BA822D-EE3772492E8FC7A8BDE368EC_see|text=|trigger=button}{sub-section}{sub-section:84ED7B2CADCB5B6A-7C7E35E4-4BA44C93-94BA822D-EE3772492E8FC7A8BDE368EC_link|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{tr:id=sam}{td}*Sample*\\{sub-section:84ED7B2CADCB5B6A-7C7E35E4-4BA44C93-94BA822D-EE3772492E8FC7A8BDE368EC_sam|text=|trigger=button}{sub-section}{sub-section:84ED7B2CADCB5B6A-7C7E35E4-4BA44C93-94BA822D-EE3772492E8FC7A8BDE368EC_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=1CFB71A322048709-B53EB53D-45D74E46-AA888761-7B4DA458B1DA030E73E12B20}{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:1CFB71A322048709-B53EB53D-45D74E46-AA888761-7B4DA458B1DA030E73E12B20_des|text=|trigger=button}{sub-section}{sub-section:1CFB71A322048709-B53EB53D-45D74E46-AA888761-7B4DA458B1DA030E73E12B20_des|trigger=none|class=sIndent}Helper method to only get the plain addresses.{sub-section}{td}{tr}{tr:id=prs}{td}*Parameters*\\{sub-section:1CFB71A322048709-B53EB53D-45D74E46-AA888761-7B4DA458B1DA030E73E12B20_prs|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:1CFB71A322048709-B53EB53D-45D74E46-AA888761-7B4DA458B1DA030E73E12B20_prs|trigger=none}addressesString
{sub-section}{div}{td}{tr}{tr:id=ret}{td}*Returns*\\{sub-section:1CFB71A322048709-B53EB53D-45D74E46-AA888761-7B4DA458B1DA030E73E12B20_ret|text=|trigger=button}{sub-section}{sub-section:1CFB71A322048709-B53EB53D-45D74E46-AA888761-7B4DA458B1DA030E73E12B20_ret|trigger=none|class=sIndent}[String]\[]{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:1CFB71A322048709-B53EB53D-45D74E46-AA888761-7B4DA458B1DA030E73E12B20_see|text=|trigger=button}{sub-section}{sub-section:1CFB71A322048709-B53EB53D-45D74E46-AA888761-7B4DA458B1DA030E73E12B20_see|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:1CFB71A322048709-B53EB53D-45D74E46-AA888761-7B4DA458B1DA030E73E12B20_see|text=|trigger=button}{sub-section}{sub-section:1CFB71A322048709-B53EB53D-45D74E46-AA888761-7B4DA458B1DA030E73E12B20_link|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{tr:id=sam}{td}*Sample*\\{sub-section:1CFB71A322048709-B53EB53D-45D74E46-AA888761-7B4DA458B1DA030E73E12B20_sam|text=|trigger=button}{sub-section}{sub-section:1CFB71A322048709-B53EB53D-45D74E46-AA888761-7B4DA458B1DA030E73E12B20_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=E4DA07BBFEB0A5FA-A088C4A4-458E44B8-BD54ACB6-3AB6364BBF83C96000026571}{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:E4DA07BBFEB0A5FA-A088C4A4-458E44B8-BD54ACB6-3AB6364BBF83C96000026571_des|text=|trigger=button}{sub-section}{sub-section:E4DA07BBFEB0A5FA-A088C4A4-458E44B8-BD54ACB6-3AB6364BBF83C96000026571_des|trigger=none|class=sIndent}Receive mails from pop3 account.{sub-section}{td}{tr}{tr:id=prs}{td}*Parameters*\\{sub-section:E4DA07BBFEB0A5FA-A088C4A4-458E44B8-BD54ACB6-3AB6364BBF83C96000026571_prs|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:E4DA07BBFEB0A5FA-A088C4A4-458E44B8-BD54ACB6-3AB6364BBF83C96000026571_prs|trigger=none}userName
password
leaveMsgsOnServer
\[receiveMode\]
\[onlyreceiveMsgWithSentDate\]
\[overridePreferencePOP3Host/properties array\]
{sub-section}{div}{td}{tr}{tr:id=ret}{td}*Returns*\\{sub-section:E4DA07BBFEB0A5FA-A088C4A4-458E44B8-BD54ACB6-3AB6364BBF83C96000026571_ret|text=|trigger=button}{sub-section}{sub-section:E4DA07BBFEB0A5FA-A088C4A4-458E44B8-BD54ACB6-3AB6364BBF83C96000026571_ret|trigger=none|class=sIndent}[MailMessage]\[]{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:E4DA07BBFEB0A5FA-A088C4A4-458E44B8-BD54ACB6-3AB6364BBF83C96000026571_see|text=|trigger=button}{sub-section}{sub-section:E4DA07BBFEB0A5FA-A088C4A4-458E44B8-BD54ACB6-3AB6364BBF83C96000026571_see|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:E4DA07BBFEB0A5FA-A088C4A4-458E44B8-BD54ACB6-3AB6364BBF83C96000026571_see|text=|trigger=button}{sub-section}{sub-section:E4DA07BBFEB0A5FA-A088C4A4-458E44B8-BD54ACB6-3AB6364BBF83C96000026571_link|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{tr:id=sam}{td}*Sample*\\{sub-section:E4DA07BBFEB0A5FA-A088C4A4-458E44B8-BD54ACB6-3AB6364BBF83C96000026571_sam|text=|trigger=button}{sub-section}{sub-section:E4DA07BBFEB0A5FA-A088C4A4-458E44B8-BD54ACB6-3AB6364BBF83C96000026571_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=2EA9FC5FA8725D22-63E1D9B7-4F5947CA-AAB6A3B1-4FE9E1B4342C03691CA2E55E}{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:2EA9FC5FA8725D22-63E1D9B7-4F5947CA-AAB6A3B1-4FE9E1B4342C03691CA2E55E_des|text=|trigger=button}{sub-section}{sub-section:2EA9FC5FA8725D22-63E1D9B7-4F5947CA-AAB6A3B1-4FE9E1B4342C03691CA2E55E_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:2EA9FC5FA8725D22-63E1D9B7-4F5947CA-AAB6A3B1-4FE9E1B4342C03691CA2E55E_prs|text=|trigger=button}{sub-section}{div:class=sIndent}{sub-section:2EA9FC5FA8725D22-63E1D9B7-4F5947CA-AAB6A3B1-4FE9E1B4342C03691CA2E55E_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:2EA9FC5FA8725D22-63E1D9B7-4F5947CA-AAB6A3B1-4FE9E1B4342C03691CA2E55E_ret|text=|trigger=button}{sub-section}{sub-section:2EA9FC5FA8725D22-63E1D9B7-4F5947CA-AAB6A3B1-4FE9E1B4342C03691CA2E55E_ret|trigger=none|class=sIndent}[Boolean]{sub-section}{td}{tr}{builder-show:permission=edit}{tr:id=see}{td}*Also see*\\{sub-section:2EA9FC5FA8725D22-63E1D9B7-4F5947CA-AAB6A3B1-4FE9E1B4342C03691CA2E55E_see|text=|trigger=button}{sub-section}{sub-section:2EA9FC5FA8725D22-63E1D9B7-4F5947CA-AAB6A3B1-4FE9E1B4342C03691CA2E55E_see|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{builder-show:permission=edit}{tr:id=link}{td}*External links*\\{sub-section:2EA9FC5FA8725D22-63E1D9B7-4F5947CA-AAB6A3B1-4FE9E1B4342C03691CA2E55E_see|text=|trigger=button}{sub-section}{sub-section:2EA9FC5FA8725D22-63E1D9B7-4F5947CA-AAB6A3B1-4FE9E1B4342C03691CA2E55E_link|class=sIndent|trigger=none}{sub-section}{td}{tr}{builder-show}{tr:id=sam}{td}*Sample*\\{sub-section:2EA9FC5FA8725D22-63E1D9B7-4F5947CA-AAB6A3B1-4FE9E1B4342C03691CA2E55E_sam|text=|trigger=button}{sub-section}{sub-section:2EA9FC5FA8725D22-63E1D9B7-4F5947CA-AAB6A3B1-4FE9E1B4342C03691CA2E55E_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}
Child pages

Versions Compared

Old Version 9

New Version 10

Key
