Mailit 4 FAQ
Is Mailit 4 plug-ins compatible to FileMaker Server? I.e. can I use Mailit 4 with IWP (instant web publishing) and SSS (Server Side Scripting)?
Yes, Mailit 4 is fully compatible to IWP (Instant Web Publishing) and SSS (Server Side Scripting).
How do I install the plug-in on FileMaker Server?
In order to run the plug-in under FileMaker Server SSS (Server Side Scripting), available since FileMaker Server 9, you should make sure the plug-in is installed in to the proper Server location:
FileMaker Server 8
Windows: \Program Files\FileMaker\FileMaker Server\Extensions\Plugins\
Mac OS: /Library/FileMaker Server/Extensions/Plugins/
FileMaker Server 9
Windows: \Program Files\FileMaker\FileMaker Server\Extensions\
Mac OS: /Library/FileMaker Server/Extensions/
FileMaker Server 10
Windows: \Program Files\FileMaker\FileMaker Server\Database Server\Extensions\
Mac OS: /Library/FileMaker Server/Database Server/Extensions/
Please notice, that you should ''Enable the FileMaker Server to use plug-ins', before you can enable each particular plug-in, as it is illustrated on the
In order to run the plug-in under FileMaker Server IWP (Instant Web Publishing), the plug-in should be installed to:
C:\Program Files\FileMaker\FileMaker Server\Web Publishing\publishing-engine\wpc\Plugins
/Library/FileMaker Server/Web Publishing/publishing-engine/wpc/Plugins
Please notice, that plug-in installed in to IWP 'Plugins' folder will not get shown in the FileMaker Server Console. FileMaker Server SSS and FileMaker Server IWP are two different modules, that will look for the plug-in in two different locations. And FileMaker Server Console will only show the plug-in installed in FileMaker Server (SSS) 'Extensions' folder.
You can find more detailed information on the plug-in installation at:
What is the difference betweem mailit on filemeker server and mailit installed in local (PC user)?
When plug-in is installed on the Server side, it is only accessible to the FileMaker Server, and inaccessible to any FileMaker Pro Workstations, that are connection to the FileMaker Server. In other words, FileMaker Server does not share any plug-in functionality with connected FileMaker Pro Workstations.
Therefore, if you only need the plug-in to be executed on the Server side, such as scheduled 'Server Side Scripting' or 'Instant Web Publishing', you could install the plug-in strictly on the Server side. Otherwise, if you need the plug-in to be executed also on the Workstations, you should install the plug-in on each Workstation, that will be using the plug-in functions. Please notice, that FileMaker Server includes an 'AutoUpdate' facilities, that allows automated plug-in updates distribution to any connected FileMaker Pro Workstations.
How can I set up a mailing which includes a unique PDF attachment?
You can generate a PDF and attach it immediately (automatically) to the new message. To do this, you should put a 'Save Records as PDF' script step in front of the 'Emai_SmtpAddAttachment' function call(s), and modify (or add another) 'Emai_SmtpAddAttachment' function call, to add attachment directly from the disk, from a temporary location.
Set Variable [$pdf; Value: Get (TemporaryPath) & "layout.pdf"] Save Records As PDF [$pdf; Records Being Browsed] Emai_SmtpAddAttachment( Emai_ImportFile(); "attachment"; Emai_GetFileName($pdf); "once"; "" )
This technique is illustrated at the 'Layout Sending PDF' example file, available at the download package.
How can I set up my personal substitute patterns in addition to 'First' and 'Last' name in the 'Simple Mass Mail' example file?
Since plug-in update v4.0.5.b47, download package contains an updated 'Simple Mass Mail' example solution, which now has a 'Tags' section, where you can define your own tags and fields correspondence.
How do I register the plug-in installed on the FileMaker Server?
In order to register the plug-in installed on the Server side, you should use the 'Emai_RegisterSession' plug-in function, that should be triggered on the Server side either using the SSS (Server Side Scripting) technique, or over IWP. Please notice that 'Emai_RegisterSession' plug-in function will only register the running FileMaker Server session. In order to register the plug-in permanently, please use the 'Emai_RegisterServer' plug-in function, available since update v4.0.6.b54.
I can not find the 'Mailit.log' file at the FileMaker Extensions folder. What should I do?
First of all please make sure the plug-in is properly installed and enabled.
In case if you are using Windows Vista or Windows 7, 'Mailit.log' file can be also located at:
C:\Users\<User Name>\AppData\Local\VirtualStore\Program Files\FileMaker\<Your FileMaker Pro Folder>\Extensions
In case if you are distributing the plug-in over FileMaker Server AutoUpdate feature, 'Mailit.log' file can be also located at:
I have updated the plug-in version, however plug-in preferences dialog still indicate the old plug-in version. What should I do?
C:\Documents and Settings\<User Name>\Local Settings\Application Data\FileMaker\Extensions
In case if you are using an 'AutoUpdate' FileMaker Server feature, a copy of the plug-in file can be stored at:
Windows 2000, XP: $HOME > Local Settings > Application Data > FileMaker > FileMaker Pro > [Version] > Extensions
Sometimes when receiving messages, I can find a 'Winmail.dat' attachment which I did not send. Where does this file come from?
Windows Vista, 7: $HOME > AppData > Local > FileMaker > FileMaker Pro > [Version] > Extensions
Mac OS: $HOME > Library > Application Support > FileMaker > Extensions
'Winmail.dat' file is a transport encapsulation format, that can be created either by Microsoft Outlook, or while the message is passing through Microsoft Exchange Server. As far as this format is not RFC compliant, very few messengers can decode it. For more details on the 'Winmail.dat' topic we can suggest the following article for review:
In order to decode this file, we can suggest the following (free) service:
How can I send inline images?
HTML messages can also contain embedded files such as inline images. The following describes procedure in the Simple Mass Mail example file.
Select an attachment in the attachment portal. Define it as 'inline' in the pop-up menu (beside the actual attachment file). Click the 'CID' button, which will generate a Content ID for this image to be embedded and places it in the clipboard. i.e.:
In the HTML code place the following line where the image should be appear:
In general other file formats (like sound) can be embedded into emails the same way. However, JPEG and GIF are the only file formats that are supported by most receiving email clients
Suggested check points:
1. Make sure you have generated a Content ID for the image
How can I send layout messages that consist of more then one page?
2. Make sure you chose a proper file type ('inline')
3. Make sure you use correct inline reference syntax (for example: <img src="cid:myimage@abc123">
4. Make sure you use lower case 'cid' prefix
5. Make sure that image file name contains only US characters, and does not contain spaces
In order to send multiple pages layout message you should compose an HTML message with a set of inline attachments, where each attachment is a layout image imported using the 'Emai_ImportJpegClipboard' function, representing each particular page. This technique is illustrated at the 'Layout Sending Multiple Pages' example file, available at the download package.
Why are CSS Styles - which I use in my HTML message - not shown in every mail client?
CSS styles support depends of particular email client application. Unfortunately there is no official list of the email applications which support CSS styles, however we can suggest you the following site:
How can I set up your example solution to work with GMail (Google Mail)?
Mailit 4 plug-in can be used together with Google Mail service, but this requires a certain settings to be used, which you can find at:
SMTP & POP3
SMTP & IMAP
How can I use your 'Personal Mail' example solution in a work group (shared FileMaker database)?
Unfortunately there is no group-ware solution available yet, which could illustrate a shared mailing system using Mailit 4 plug-in. However many of our clients are customizing the 'Personal Mail' solution, available in download package, in order to use it in a workgroup as a shared mailing system.
How can I import the message from my email client to your example solution?
We can suggest you to review the following applications, that are dedicated to transferring emails in to FileMaker database format:
Entourage Email Archive X
Mail to FileMaker Importer
I can receive messages but can not send. What could be the problem?
The route to this SMTP host may be down, or blocked by your ISP. Please make sure you can access your SMTP and POP3 host using common mail client, like AppleMail or OutlookExpress from the computers, where you experience problems with connection. Please contact your IT person or ISP to resolve this kind of problem.
I can send messages using my regular email application and my SMTP server. However, I cannot send using Mailit?
Suggested check points:
1. Antivirus. Some antivirus software packages do not allow network activity for applications, which have not been allowed explicitly. We suggest you to disable any antivirus software during your tests.
2. Personal Firewall software. Most of the Personal Firewall software packages do not allow network activity for applications, which have not been allowed explicitly. We suggest you to disable any personal firewall software during your tests.
We strongly suggest you to make sure, that 'Windows Firewall' is not blocking the FileMaker application connections. To do this, please open your 'Control Panel', double-click the 'Windows Firewall' icon (if you are using 'Category View', you should first open 'Security Center' at your 'Control Panel'), and disable Firewall by clicking 'Off' radio-button (please confirm your choice by clicking 'Ok' button).
An example from our customer, related to the McAfee Virus Scan Enterprise:
1. Right click the McAfee shield icon in the systray (lower right-hand corner of screen) and select "VirusScan Console".
How do I display an HTML e-mail received to show in a WEB viewer in FM 8.5 and later?
2. Right-click Access Protection and select Properties. Under Port Blocking, select "Prevent mass mailing worms from sending email" and choose Edit.
3. Add the text "FileMaker Pro.exe" to the Excluded Processes list.
For this purpose you should utilize the 'Emai_ExportHtml' plug-in function, to export the message HTML code, or better complete message object in to a temporary location. By default, 'Emai_ExportHtml' function will export the object in to the system temporary folder, and return the full path to the saved folder, that should be then passed to the WEB viewer. For details, please review the 'Simple Receiving' example solution set, that illustrates this technique.
How can I download only certain messages (From, To, Subject, etc)?
We suggest you the following steps, which should help you to customize one of the example solutions, available for Mailit 4 plug-in:
1. Pick the example solution, which fits your needs, and edit the mail retrieving script
Sometimes my HTML code get's cutted, which results in to incorrect HTML render, why is that?
2. Locate the 'Emai_PopRetrieveMessage' function call.
3. In front of the 'Emai_PopRetrieveMessage' function call insert the 'Emai_PopGetMessageInfo' function call, using the same parameter as 'Emai_PopRetrieveMessage' function call.
4. After the 'Emai_PopGetMessageInfo' add the 'Emai_PopGetMessageField' function call, to retrieve the corresponding field of the message (From, To, Cc, Subject, etc)
5. Use the condition operator ('If / End If') to retrieve those messages,
which fit your criteria.
This problem is related to the message formatting and mail server(s) the message is going though. According to the RFC 2822 the length of one line should not exceed 998 characters. Some mail servers take the responsibility to reformat the message, if it does not meet the requirements of the RFC 2822, which may cause the problems. To resolve the issue we recommend you to format the code of your message in a way to avoid the lines longer then 998 characters. For example instead of writing:
... [990 characters] ... text         ... [and so on]...
you should write:
... [990 characters] ... text
... [and so on]...
This will not affect the resulting HTML rendered view, as far as line breaks other then special HTML tags (like <BR>) are not considered by HTML rendering engines.
How can I specify the charset for the outgoing message?
The plug-in is choosing the encoding for the message automatically, based on the characters present at the message. For example, if the plug-in chooses the 'windows-1250' encoding, this should mean that your message contains character(s), which belong to one of the languages designated at:
So, in order to get a message with 'Western' or 'US' characters encoding, you should use (only) the corresponding characters in your message.
Please notice, that if you use a combination of characters in your message, which can not be put in 8 bit encoding, the plug-in will use the Unicode encoding for this message.
Can I send messages in background, and continue working with another database?
It is not possible to send the messages in background, as it is possible to do in a regular email client application, like Microsoft Outlook. The point is that FileMaker is taking part in the message sending process by feeding the updated message parts, and processing sending result. So even if you will disable Mailit 4 status dialog, FileMaker will remain busy, until the scripts execution is complete.