3.7.5.40 Mail

Mail-obj

LabTalk Object Type:

External Object

Origin provides a DLL named OMail.DLL that allows you to create a Mail command object, which is used to provide basic email functionality. You can create a command object named mail using the following LabTalk script:

Dll -a mail omail;

The script command will associate the omail DLL with the mail Labtalk object.

Origin's mail object contains three subobjects: SMTP, POP and SIMPLESENDER.

SMTP

SMTP provides the functionality of an SMTP client, used for sending mail. It requires an SMTP server whose address must be supplied.

Properties

Mail.SMTP.Text$ #= empty$;

Mail.SMTP.attachment$ #= empty$;

Note that for Mail.SMTP.To$, Mail.SMTP.Cc$ and Mail.SMTP.Bcc$, address field first is tested if it is a valid file name (file should exist and have read permission). If so, then it is considered to be e-mail address.

Methods

Examples

mail.SMTP.Server$ = "mydomain.com";
mail.SMTP.From$ = "myself@mydomain.com";
mail.SMTP.To$ = "yourself@anotherdomain.com";
mail.SMTP.Cc$ = "C:\ccMailList.txt";
mail.SMTP.Timeout=10;
mail.SMTP.Subject$ = "This is some subject";
mail.SMTP.Header$ = "C:\Header.txt";
mail.SMTP.Text$ #= empty$;   // to empty the vector
mail.SMTP.Text1$ = "This is the message body, line 1";
mail.SMTP.Text2$ = "This is the message body, line 2";
mail.SMTP.Text3$ = "This is the message body, line 3";
mail.SMTP.Text4$ = "This is the message body, line 4";
mail.SMTP.Footer$ = "C:\Footer.txt";
mail.SMTP.Signature$ = "C:\Signature.txt";
mail.SMTP.Attachment$ #= empty$;   // to empty the vector
mail.SMTP.Attachment1$ = "c:\mapath\somefile.opj";
mail.SMTP.Attachment2$ = "d:\anotherpath\anotherfile.txt";
mail.SMTP.Attachment3$ = "e:\abc\def.txt";
if ( mail.SMTP.Send( ) )
{
	type -b "Sending failed!";
}
else
{
	type -b "Sending successful.";
}

POP

POP provides the functionality of a POP3 client, used for retrieving email from a POP3 server. A POP3 server name, username, and password must be supplied.

Note that the subobject is called POP instead of POP3 because MOCA supports enumerated subobjects such that POP3 might be confusing for the 3rd POP object.

Properties

Methods

Examples

mail.POP.Server$ = "somePOP3server.com";
mail.POP.UserName$ = "myself";
mail.POP.Password$ = "mypassword";
mail.POP.Timeout = 15;
mail.POP.Port = 110;
mail.POP.Path$ = "c:\mymail";
mail.POP.LeaveMessage = 1;
mail.POP.Retrieve(1)=;
type ">>>> After getting mail:";
mail.POP.=;	// dump into the script window the POP object

SIMPLESENDER

It is used for sending mail using an outlook (or other MS-compatible) client. It, therefore, requires a mail client to be properly installed and configured to work. Furthermore, SIMPLESENDER does not support advanced features such as Cc, Bcc and multiple sending, which are present only in SMTP.

Properties

Mail.simplesender.Text$ #= empty$;

SIMPLESENDER.Attachment$ #= empty$;

Methods

Examples

mail.SIMPLESENDER.Subject$ = "email message subject";
mail.SIMPLESENDER.Text$ #= empty$;   // to empty the vector
mail.SIMPLESENDER.Text1$ = "This is the message body, line 1";
mail.SIMPLESENDER.Text2$ = "This is the message body, line 2";
mail.SIMPLESENDER.Text3$ = "This is the message body, line 3";
mail.SIMPLESENDER.Text4$ = "This is the message body, line 4";
mail.SIMPLESENDER.To$ = " yourself@anotherdomain.com";
mail.SIMPLESENDER.Attachment$ #= empty$;   // empty the attachment list
mail.SIMPLESENDER.Attachment1$ = "c:\mapath\somefile.opj";
mail.SIMPLESENDER.Attachment2$ = "d:\anotherpath\anotherfile.txt";
mail.SIMPLESENDER.Attachment3$ = "e:\abc\def.txt";
mail.SIMPLESENDER.Send();

Other Methods and Properties

Methods

Examples

type = mail.checkAddress(%A);

For detailed examples on the mail object, see the example of Email Processing.