Mail::Outlook - mail module to interface with Microsoft (R) Outlook (R).
# create the object use Mail::Outlook; my $outlook = new Mail::Outlook(); # start with a folder my $outlook = new Mail::Outlook('Inbox'); # use the Win32::OLE::Const definitions use Mail::Outlook; use Win32::OLE::Const 'Microsoft Outlook'; my $outlook = new Mail::Outlook(olInbox); # get/set the current folder my $folder = $outlook->folder(); my $folder = $outlook->folder('Inbox'); # get the first/last/next/previous message my $message = $folder->first(); $message = $folder->next(); $message = $folder->last(); $message = $folder->previous(); # read the attributes of the current message my $text = $message->From(); $text = $message->To(); $text = $message->Cc(); $text = $message->Bcc(); $text = $message->Subject(); $text = $message->Body(); my @list = $message->Attach(); # use Outlook to display the current message $message->display; # create a message for sending my $message = $outlook->create(); $message->To('you@example.com'); $message->Cc('Them <them@example.com>'); $message->Bcc('Us <us@example.com>; anybody@example.com'); $message->Subject('Blah Blah Blah'); $message->Body('Yadda Yadda Yadda'); $message->Attach(@lots_of_files); $message->Attach(@more_files); # attachments are appended $message->Attach($one_file); # so multiple calls are allowed $message->send; # Or use a hash my %hash = ( To => 'you@example.com', Cc => 'Them <them@example.com>', Bcc => 'Us <us@example.com>, anybody@example.com', Subject => 'Blah Blah Blah', Body => 'Yadda Yadda Yadda', ); my $message = $outlook->create(%hash); $message->display(%hash); $message->send(%hash);
This module was written to overcome the problem of sending mail messages, where Microsoft (R) Outlook (R) is the only mail application available. However, since it's inception the module has expanded to handle a range of Outlook mail functionality.
Note that when sending messages, the module uses the named owner of the Outbox MAPI Folder in order to access the correct objects. Thus the From field of a new message is predetermined, and therefore a read only property.
If using the 'Win32::OLE::Const' constants, only the following are supported:
olFolderInbox olFolderOutbox olFolderSentMail olFolderDrafts olFolderDeletedItems
A mail module to interface with mail message accessible via Microsoft (R) Outlook (R).
Create a new Outlook mail object. Returns the object on success or undef on failure. To see the last error use 'Win32::OLE->LastError();'.
Free unused Win32::OLE libraries
Get the list of all open mail folders in Outlook
Gets or sets the current folder object.
Return a list of the available accounts. Each element is a hash ref with two keys: address and account. "address" is the SMPT address, "account" is the Account object.
Creates a new message. Option hash table can be used. Returns the new message object or undef on failure.
This module is intended to be used on Win32 platforms only, with Microsoft (R) Outlook (R) installed.
Microsoft and Outlook are registered trademarks and the copyright 1995-2003 of Microsoft Corporation.
Win32::OLE Win32::OLE::Const
There are some minor items under "Issues" , but there are no known serious bugs at the time of this release.
However, if you spot a bug or are experiencing difficulties that are not explained within the POD documentation, please submit a bug to the RT system (see link below). However, it would help greatly if you are able to pinpoint problems or even supply a patch.
Fixes are dependent upon their severity and my availability. Should a fix not be forthcoming, please feel free to (politely) remind me by sending an email to barbie@cpan.org .
RT: http://rt.cpan.org/Public/Dist/Display.html?Name=Mail-Outlook
Barbie, <barbie@cpan.org> for Miss Barbell Productions, <http://www.missbarbell.co.uk>
Copyright E<copy> 2003-2013 Barbie for Miss Barbell Productions. Copyright E<copy> 2014-2016 Duncan Garland. This distribution is free software; you can redistribute it and/or modify it under the Artistic License v2.
To install Mail::Outlook, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Mail::Outlook
CPAN shell
perl -MCPAN -e shell install Mail::Outlook
For more information on module installation, please visit the detailed CPAN module installation guide.