Online Manual Welcome Setup Overview Composing Details Managing Data List Management Scripting After Each Send   COM Integration   Include SubMailing   Scheduling More Help Mailer Home Download Mailer . Version History What's new in the latest version Contact Support We are here to help you via email. We will do our best to get back to you right away. Explore M5 Mailer Take the bulk out of email! TM Use your own data Personal email merge Send individual email HTML and/or text Handy email templates Explore M5 Subscriber Web-based list management made simple! Simple subscribe tool Opt-in confirmed Track reads and clicks Custom matching look Free for up to         5000 contacts

Mailer Gold and Application Integration

The Gold version of Mailer can be integrated easily with other applications through .NET or through the command line. Mailer provides a very simple COM interface for launching mailings, and also provides a simple command line syntax for running mailings.

Mailings run from COM or from the command line run silently and in the background. In other words, no Mailer interface comes up on the screen.

In both cases, you need to create your mailing first with Mailer using the normal method.

COM Support

The COM interface to Mailer is very simple:

Object: m5engine.M5SimpleMailer
Method: DoMailing(<merge file path>)

VBS code sample:

Set Mailer = CreateObject("m5engine.M5SimpleMailer")
Mailer.DoMailing
    "E:\Projects\Mailer_Mach5\test\new_text_express.m5m"

During the mailing, Mailer logs its output to a specific folder, which is the default Mailer log folder with a special filename:

<LOG FOLDER>\<merge_filename>_silent_<timestamp>_results.csv

Mailer also supports a more powerful COM interface:

Object: m5engine.M5SimpleMailer
Method: DoMailingEx(<merge file path>, BSTR <UserName>, BSTR <PassWord>, BSTR <HostName>, int <AuthType>)

VBS code sample:

Set Mailer = CreateObject("m5engine.M5SimpleMailer")
Mailer.DoMailing
    "E:\Projects\Mailer_Mach5\test\new_text_express.m5m", "Mike", "Mach5", 2

The following functions change and inspect simple mailer attributes. For example if you need enable SSL support, you call SetAttribute(“UseSSL”, “true”);

UseSSL is a single attribute supported now.

HRESULT SetAttribute(BSTR Attribute, BSTR Value);

HRESULT GetAttribute(BSTR Attribute, BSTR *pValue);

Command line Operation

Mailer can be invoked from the command line, optionally in Silent mode. Use the "/s" command line switch to start a mailing in silent mode. Mailer executes the mailing using the simple M5SimpleMailer COM object described above, but with convenient command line accessibility.

The /L <log-file-name> turns on detailed SMTP traffic logging to a log file.

Command line sample:

   m5mailer.exe /s "E:\Projects\Mailer_Mach5\test\new_text_express.m5m"

Creating Dynamic Mailings with DOM

Note that m5m files are XML formatted. That means that you can use DOM to modify the mailings if you wish. You can have your application create the mailing in its entirety, including scripting, list restrictions, and nearly everything else.

However, for security reasons, there is at present no way to use DOM to create or modify the database connection strings that Mailer creates to tie the mailing to the data source. Nonetheless, if you create a set of mailings using Mailer to different databases, you can still use DOM to replace the database connection string appropriately and as needed. Just make a mailing using a connection, copy the connection string out, and paste it into your application to substitute in to your mailing using the DOM interface.

In this way, you can still dynamically control what database your mailing connects to, but you need to use Mailer to create these connections first.

You can put an unencoded connection string into Mailer's XML file directly. Here's an example:

<!-- Project Database -->

<database type="4" csv_delimiter=" " first_row_header="1" xl_table_as_range="0" xl_track_range="0">

<connection_string>Provider=MSDASQL.1;Data Source=test;Extended Properties="DSN=test;DBQ=D:\Projects\Mach5\test_mailing.mdb;DriverId=25;FIL=MS Access;MaxBufferSize=2048;PageTimeout=5;"</connection_string>

<source_string><![CDATA[2_text]]></source_string>

......

M5 Mailer stores connection strings encoded if you make a connection using the interface, to hide any passwords in the connection string.

Home   |   Site map   |   Analyzer   |   Mailer   |   PopMonger   |   Resources   |   Customers and Partners  |   Contact
Mach5 and M5 are registered trademarks of Mach5 Development, LLC.