Port Guide: Classic SMTPit to SMTPit Pro
This document is for users who have developed databases using the Classic version of SMTPit and wish to upgrade to SMTPit Pro, which has new functions. By updating your databases to the new functions, you will be able to take full advantage of the new plug-in.
As of v5.1.0, Backward Compatibility has been removed from the plug-in.
Notes:- SMTPit Pro has a “Backward Compatibility” option in its Configuration Dialog (accessible through the FileMaker(R) Pro Preferences dialog). Using this option should allow you to use your old databases with SMTPit Pro without any scripting changes. However, in some cases Backward Compatibility may not work and it is recommended that all users upgrade their scripts to the new functions. By setting the “Backward Compatibility” option to “Both”, you will be able to upgrade your scripts as you get to them, allowing you to have a mix of Old- and New-style functions. For more information about backward compatibility, see the “How do I turn on the Old Style Functions in the Pro plug-ins” FAQ article. The Backward Compatibility option may be removed in future versions of the plug-in at some point depending on changes in FileMaker and the plug-in itself.
The backward compatibility option does not work under all versions of FileMaker.
Mac
Works: FileMaker 7–13
Does not Work: FileMaker 14 (32-bit and 64-bit), FileMaker Pro 11.0v1 (update to 11.0v4)
Windows
Works: FileMaker 7–13, FileMaker 14 32-bit
Does not Work: FileMaker 14 64-bit
- To determine what parameters are in your existing Old Style functions, see the SMTPit External Function Reference section of the Classic SMTPit Guide.
Example
Assume you have a calculation like the following that uses the Old Style Send function.
External(“SMTP-Send”, “Dialog=Yes, Transcript=Yes”)
First, we need to find the “SMTP-Send” function in the left column of the list at the end of this page. Then look at the right column to find the New Style equivalent is the “SMTPit_Send” function. Find that function in the Function Reference to see how it is used.
SMTPit_Send ( GetTranscript ; ShowResultDialog )
Next, we need to determine what parameters we are using in the Old Style function. To do so, find the Old Style function in the SMTPit External Function Reference section of the Classic SMTPit Guide. Looking at the Function Reference, we see the function looks like:
External(“SMTP-Send”, “Dialog=Yes, Transcript=Yes”)
The Classic Plug-in Function Browser tells us the “Dialog=Yes” argument of our Old Style Function will popup a dialog after the send informing us if the email was sent. Looking at the New Style Function Reference we see the New Style function’s ShowResultDialog parameter does the same thing, so we would set it to True. Looking back at the Old Style Function we also have the “Transcript=Yes” argument which returns interaction between the plug-in and the mail server. Now look back at the New Style function Reference and see the New Style function also has this feature by using the GetTranscript parameter, so set it to True as well. The New Style function would now look like:
SMTPit_Send( True ; True )
Conversion Chart
Below you will find an alphabetical list of old-style functions with their new-style equivalents.
| Classic SMTPit to SMTPit Pro | |
|---|---|
| Classic SMTPit | SMTPit Pro |
| SMTP-AssignAll | SMTPit_QuickSet |
| SMTP-AttachAppend | SMTPit_SetAttachment |
| SMTP-AttachAssign | SMTPit_SetAttachment |
| SMTP-AuthTypeAssign | SMTPit_SetAuthentication |
| SMTP-BCCAppend | SMTPit_SetBCC |
| SMTP-BCCAssign | SMTPit_SetBCC |
| SMTP-BodyAppend | SMTPit_SetBody |
| SMTP-BodyAssign | SMTPit_SetBody |
| SMTP-CCAppend | SMTPit_SetCC |
| SMTP-CCAssign | SMTPit_SetCC |
| SMTP-ClearAll | SMTPit_Clear |
| SMTP-Connect | SMTPit_Connect |
| SMTP-Disconnect | SMTPit_Disconnect |
| SMTP-DlgAttachAppend | SMTPit_SetAttachmentWithDialog |
| SMTP-DlgAttachAssign | SMTPit_SetAttachmentWithDialog |
| SMTP-DlgHTMLImageAppend | SMTPit_SetInlineImageWithDialog |
| SMTP-DlgHTMLImageAssign | SMTPit_SetInlineImageWithDialog |
| SMTP-EmailHeaderAppend | SMTPit_AddEmailHeader |
| SMTP-FileBodyAppend | SMTPit_SetBodyWithFile |
| SMTP-FileBodyAssign | SMTPit_SetBodyWithFile |
| SMTP-FileNameAcquire | SMTPit_File_SelectFileWithDialog |
| SMTP-FolderAcquire | SMTPit_File_SelectFolderWithDialog |
| SMTP-FooterAppend | SMTPit_SetBodyFooter |
| SMTP-FooterAssign | SMTPit_SetBodyFooter |
| SMTP-FromAssign | SMTPit_SetFrom |
| SMTP-HeaderAppend | SMTPit_SetBodyHeader |
| SMTP-HeaderAssign | SMTPit_SetBodyHeader |
| SMTP-HideStatus | SMTPit_StatusWindow |
| SMTP-HostAssign | SMTPit_SetHost |
| SMTP-HTMLBodyAppend | SMTPit_SetBody |
| SMTP-HTMLBodyAssign | SMTPit_SetBody |
| SMTP-HTMLFileBodyAppend | SMTPit_SetBodyWithFile |
| SMTP-HTMLFileBodyAssign | SMTPit_SetBodyWithFile |
| SMTP-HTMLFooterAppend | SMTPit_SetBodyFooter |
| SMTP-HTMLFooterAssign | SMTPit_SetBodyFooter |
| SMTP-HTMLHeaderAppend | SMTPit_SetBodyHeader |
| SMTP-HTMLHeaderAssign | SMTPit_SetBodyHeader |
| SMTP-HTMLImageAppend | SMTPit_SetInlineImage |
| SMTP-HTMLImageAssign | SMTPit_SetInlineImage |
| SMTP-MoveStatus | SMTPit_StatusWindow |
| SMTP-PasswordAssign | SMTPit_SetAuthentication |
| SMTP-PathToDBAcquire | SMTPit_File_GetPath |
| SMTP-PathToFMAcquire | SMTPit_File_GetPath |
| SMTP-PortAssign | SMTPit_SetHost |
| SMTP-PriorityAssign | SMTPit_SetPriority |
| SMTP-Register | SMTPit_Register |
| SMTP-Send | SMTPit_Send |
| SMTP-ShowStatus | SMTPit_StatusWindow |
| SMTP-SubjectAppend | SMTPit_SetSubject |
| SMTP-SubjectAssign | SMTPit_SetSubject |
| SMTP-ToAppend | SMTPit_SetTo |
| SMTP-ToAssign | SMTPit_SetTo |
| SMTP-UsernameAssign | SMTPit_SetAuthentication |
| SMTP-Version | SMTPit_Version |
| - | SMTPit_File_Copy |
| - | SMTPit_File_Delete |
| - | SMTPit_File_Exists |
| - | SMTPit_File_Export |
| - | SMTPit_File_Move |
| - | SMTPit_File_Rename |
| - | SMTPit_File_Size |
| - | SMTPit_GetSendValue |
| - | SMTPit_SendWithDialog |
| - | SMTPit_SetCharSet |
| - | SMTPit_SetReplyTo |
| - | SMTPit_StyledTextToHTML |