Mail::Outlook::Message - extension to handle Microsoft (R) Outlook (R) mail messages.
See Mail::Outlook, as this is not meant to be used as a standalone module.
Handles the Message interaction with the Outlook API.
Create a new Outlook mail object. Returns the object on success or undef on failure. To see the last error use 'Win32::OLE->LastError();'.
Note that when displaying or sending a message, you MUST have completed the following fields:
To Subject Body
While the RFCs may let you send blank messages, it seems a rather pointless idea to me, and probably not what you intended. If you want to ignore this restriction, feel free to edit your copy of the source code and comment out or edit the appropriate line in _make_message().
Empty sub
Creates a new message. Option hash table can be used.
Creates a pre-populated New Message via Outlook. Returns 1 on success, 0 on failure.
Sends the message. Returns 1 on success, 0 on failure.
Excerpt from the MSDN:
"Saves the Outlook to the current folder or, if this is a new item, to the Outlook default folder for the item type."
In other words, if the message is a new one, it will be saved to the default folder (Drafts) in Outlook.
Returns 1 on success, 0 on failure.
Remove this message.
This can be used to specify the account from which this email will be sent.
$m->use_account( $account_object );
where $account_object has be retrieved using the all_accounts method of the Outlook object.
The following basic accessor methods are available:
SenderName To Cc Bcc Subject Body
All functions can be called to return the current value of the associated object variable, or be called with a parameter to set a new value for the object variable if you are creating a message.
Returns the current settings for the read only From field. Note that this is not an email address when used in connection with a new message. Returns a list containing the Name and Address of the user.
Returns the date/time the current message was sent. Note that this will return undef if the message has not been sent!
Returns the date/time the current message was received. Note that this will return undef if the message has not been sent!
Adds a header in the style of 'X-Header' to the headers of the message. Returns undef if header cannot be added.
NOTE: Currently unimplemented, due to unreliable treatment by Exchange server.
Add attachments when creating a message. Returns the attachments of the message if no arguments are passed to the method.
Due to some recent security patches within Outlook, Microsoft have disabled the automatic access to the Outlook OLE. As some spam and trojan scripts, as well as the usual executables, have been using the application for malicious uses, Microsoft have stepped in an attempt to block this. If these security patches have been applied, when the module accesses Outlook via the OLE, you will probably see one of the following messages, or something like them.
When the module attempts to retrieve the From address, a warning message box may appear. The text will be along the lines of:
A program is trying to access e-mail addresses you have stored in Outlook. Do you want to allow this? If this is unexpected, it may be a virus and you should choose "No". [ ] Allow access for [ --------- V] [Yes] [No] [Help]
The message informs you that an unknown application is accessing Outlook and asks whether you wish to allow this. Click 'Yes' to allow the script to access the Outlook Address Book. Or you can set a time period, during which the script can access the Outlook OLE.
On sending the message, you may also activate another warning message box. The text will be along the lines of:
A program is trying to automatically send e-mail on your behalf. Do you want to allow this? If this is unexpected, it may be a virus and you should choose "No". [Yes] [No] [Help]
Click 'Yes' to allow the script to automatically send the message via Outlook.
#=head1 FURTHER READING
#If you intend to supply a patch for a bug or new feature, please visit the #following URL (and associated pages) to ensure you are using the correct #objects and methods.
#http://msdn.microsoft.com/library/default.asp?url=/library/en-us/off2000/html/olobjApplication.asp
#This article contains some interesting background into creating mail #messages via Outlook, although it is VB-centric.
#http://www.exchangeadmin.com/Articles/Index.cfm?ArticleID=4657
#=head1 FUTURE ENHANCEMENTS
#A couple of items that I'd like to get working.
#* X-Header support #* Send without the popups (Outlook Redemption looks possible)
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 2003-2013 E<copy> 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.