Frequently Asked Questions
Can I use the plug-in with Gmail, Google Mail, or Google Apps?
Yes! POP3it Pro can receive email from Gmail, Google Mail, or Google Apps. The settings below will allow you to work with your account.
Host: pop.gmail.comPermalink | Top
Authentication Type: Plain
Username: your full Gmail email address (firstname.lastname@example.org or username@your_domain.com)
Password: your Gmail password
TLS/SSL Type: Before Connect
TCP/IP Port: 995
Am I required to use the built-in Accounts?
Using the accounts is required, but if you prefer to not use them, you can implement the following to basically ignore them. This method is similar to how the Classic POP3it plug-in worked, so if you used that plug-in and want to use POP3it Pro in the same way, this is the best way to do so.
Your script will first need to create an Account, and you can name it whatever you like. This is done using the POP3it_Adv_AddAccount function. The script then needs to set the Account details using the POP3it_Adv_SetAccountOption function. The Set Field/Variable calculation in your script would look like the following.
POP3it_Adv_AddAccount( “The_Server” ) & “¶” &
POP3it_Adv_SetAccountOption( “The_Server”; “Host” ; DB::Host) & “¶” &
POP3it_Adv_SetAccountOption( “The_Server”; “Port” ; DB::Port) & “¶” &
POP3it_Adv_SetAccountOption( “The_Server”; “Username” ; DB::Username ) & “¶” &
POP3it_Adv_SetAccountOption( “The_Server”; “Password” ; DB::Password )
You could also add other Account Options not shown above using this method. Look at the POP3it_Adv_SetAccountOption function reference found in the Functions section for a list of all the available options you can set.
If you added this calculation to the start of your POP3it Pro scripts, you could then dynamically change Servers as needed based on fields, variables, or other criteria. Your scripts would always make the plug-in connect to the same account, but you would simply be changing the account details as needed.NotePermalink | Top
Calling the AddAccount function multiple times with the same account name will not hurt anything. If the account already exists, the function will simply return something like “Account already exists”. This is not a problem.
How do I turn on the Old Style Functions in the Pro plug-ins?
As of v5.1.0, Backward Compatibility has been removed from the plug-in.
If you want to upgrade from a Classic plug-in to a Pro plug-in, but not rewrite your scripts right away (from the old classic syntax), you can turn on the Backward Compatibility option. We highly suggest updating your scripts to the Pro functions as this option is just meant to be a temporary solution until scripts can be updated. This option may be removed in the future depending on changes in future versions of FileMaker and the plug-in. See the Porting Guide for more information on updating your scripts.Note
The backward compatibility option does not work under all versions of FileMaker.
Works: FileMaker 7–13
Does not Work: FileMaker 14 and higher (32-bit and 64-bit), FileMaker Pro 11.0v1 (update to 11.0v4)
Works: FileMaker 7–13, FileMaker 14 32-bit
Does not Work: FileMaker 14 64-bit
To turn this option on via the configuration dialog, open FileMaker and go to the FileMaker Menu (on Mac) or Edit (on Windows), Preferences, Plug-ins tab, double-click the plug-in name, and select the Advanced tab. Finally, select “Enable Old Style Functions”. Next, click OK on all the dialogs, and then restart FileMaker. Your scripts that were written for the old plug-in will now continue to work with the Pro plug-in.
You can also set the backward compatibility option via script using the “POP3it_Configure” function. The “UseOldFunctions” preference controls whether the Old Style functions are enabled, and by default it is disabled. This preference is a boolean value, so it has a value of 0 by default.
In order to enable backward compatibility (e.g. turn on the old style functions), use the Configure function to set the “OldStyleFunctions” preference to 1. For example:
POP3it_Configure( “Set”; “UseOldFunctions”; 1 )
Calling this function is the equivalent of setting the backward compatibility option in the configuration dialog. You will still need to restart FileMaker before the Old Style functions will appear in FileMaker.
You can also retrieve the current value of the preferences using the “Get” option and the name of the preference. For example:
Permalink | Top
POP3it_Configure( “Get”; “UseOldFunctions” )
Can I use my own table and or field names with the CheckAccount function?
Yes, you can specify alternative tables/field names to be used with the CheckAccount function.
You first need to open the Account Configuration Dialog by calling the POP3it_ConfigureAccount function. Once you have the Account Configuration Dialog open, select the account, and then click the Auto Check tab. Put a check box in the “Enable Auto Check” box, and then click the “Table Settings” button in the Auto Check Action box.
You will now be looking at the “Specify Auto Check Table Settings” dialog that will allow you to enter alternative table names for the Messages and Attachment tables. You can also enter field pairs of POP3it_original_field_name=new_field_name.
- If you do not actually want to use auto check (where it automatically downloads on an interval), you can set the table settings, save the changes, and then go back and uncheck the “Enable Auto Check” box. The Table Settings will still be used, but it will not automatically download email.
- The UIDL field in the Messages and Attachments alternative tables must be named the same.
Why does the plug-in not install in FileMaker on Windows?
If you have installed the plug-in and it does not show up in FileMaker Pro or if the plug-in will not enable properly, try the following steps.
Microsoft’s .Net Framework
Make sure you have the proper version of Microsoft’s .Net Framework installed on your computer. See the POP3it Pro installation page for more information.
Microsoft Visual C++ Redistributable Package
Make sure the proper Microsoft Visual C++ Redistributable Package is installed on your computer. See the POP3it Pro installation page for more information.
Restart Your ComputerSometimes it is necessary to restart before .NET and the Redistributable Package will work properly.
Install all Windows updatesUse Windows update to install all current updates for your computer. If your system is setup to automatically install Windows updates, you may want to manually force it to check for and install current updates to get the plug-in to work immediately.
Why is the Configuration Dialog disabled in 64-bit FileMaker Pro 14 on OSX?
When running v4.5.0 of the plug-in under 64-bit FileMaker Pro (FMP) 14 or higher on OSX, the user interface is not available (including the configuration dialog). The plug-in is still functional, but you will not be able to call any user interface functions or use the configuration dialog. When running the plug-in under 32-bit FMP 14 on OSX or under FMP 14 or higher on Windows, the user interface works as expected.
Note, this has been resolved with v5.0.0 and higher.
The following user interface functions are currently unavailable under 64-bit FMP 14 on OSX.
If you absolutely must use the user interface functions or configuration dialog under 64-bit FMP 14 on OSX, you will need to run FMP 14 in 32-bit mode instead of 64-bit. Running the plug-in under FMP 14 in 32-bit mode works like normal and includes all user interfaces. See the How to change FMP between 32-bit and 64-bit modes section below on how to change the mode FMP 14 is running in.
The following sections describe how to work with the plug-in under 64-bit FMP 14 on OSX without the configuration dialog.
How to Define Accounts
In order to create, edit, or delete accounts in the plug-in, you can do so using either of the following methods.
- Open FMP in 32-bit mode, define your accounts in the dialog by calling the POP3it_ConfigureAccount function, close FMP, and then open FMP in 64-bit mode. See the How to change FMP between 32-bit and 64-bit modes section below on how to change the mode FMP is running in.
- In 64-bit FMP, use the POP3it_Adv_SetAccountOption function in a script to set account values. For example, a script might look like the following.
Set Field [ db::result ; POP3it_AddAccount( “POP3_Server” ) & “¶” & POP3it_SetAccountOption( “POP3_Server”; “Host” ; Table::Host) & “¶” & POP3it_SetAccountOption( “POP3_Server”; “Port” ; Table::Port) & “¶” & POP3it_SetAccountOption( “POP3_Server”; “Username” ; Table::Username ) & “¶” & POP3it_SetAccountOption( “POP3_Server”; “Password” ; Table::Password ) ]This script would set the Host, Port, Username, and Password. Calling these functions is only necessary once, as the values will be saved to the account in the plug-in.
How to Register
Registering the plug-in under 64-bit FMP on OSX can be achieved using the POP3it_Register function. You can either make your own script to do this, or you can use this Registration Database to do so.
How to get a Demo Key
To test the plug-in in demo mode, you can either use it with or without a demo key.
- To use the plug-in without a demo key, simply use the plug-in until it times out. At this point, you can restart FMP to get more time to test the plug-in with. Alternatively, in FMP you can go to the FileMaker menu, Preferences, Plug-ins tab, and uncheck the box next to the plug-in and then check it again.
- To use the plug-in with a demo key, you will need to temporarily open FMP in 32-bit mode, obtain a demo key, close FMP, and then open FMP in 64-bit mode. See the How to change FMP between 32-bit and 64-bit modes section below on how to change the mode FMP is running in.
How to change FMP 14 between 32-bit and 64-bit modes
To run FMP 14 as a 32-bit application, close FMP 14, Open a Finder Window and browse to the FileMaker Pro 14 or FileMaker Pro 14 Advanced folder.
Next, find the FileMaker Pro or FileMaker Pro Advanced application file, select it, right-click on it and choose Get Info.
Finally, put a checkmark in the Open in 32-bit mode box, close the Get Info window, and open the FMP14 application.
To change FMP 14 from 32-bit mode to 64-bit mode, follow the above instructions and uncheck the Open in 32-bit mode box.Permalink | Top
Why are some of the external functions missing from Calculation Dialogs?
The advanced functions are used for the advanced method of downloading email with the plug-in. By default, these functions are hidden, but can be displayed by changing a setting.
To show the advanced functions, go to the Edit menu (on Windows) or the FileMaker menu (on Mac), Preferences, Plug-ins tab, double-click the plug-in. Next, select the Advanced tab, then put a check mark in the “Show Advanced Functions in the Calculation Dialog”, and click OK on all remaining dialogs. The advanced functions will now show up in the list of external functions.
You can also enable the “Show Advanced Functions in the Calculation Dialog” setting with the POP3it_Configure function.
POP3it_Configure ( “Set” ; “ShowAdvFunc” ; 1 )
Note, restarting FileMaker may be required before the functions appear.Permalink | Top