>> Home > M5 Mailer: Take the Bulk out of email blasts Mailer Home | My Mach5 | Download | Support | Buy Mailer  
 
Online Manual

Welcome
Setup
Overview
Composing Details
Managing Data
List Management
Scripting
After Each Send  
COM Integration  
Include SubMailing  
Scheduling
More Help

Mailer Home


Untitled Document

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

 

Mach5 Mailer Help Docs -- Index

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 is a registered trademark of Mach5 Development.