Product Logo

SMTPit Pro

Next Generation Email plug-in


Configure the plug-in

Now the plug-in is installed, you can optionally set the default preferences in the “SMTPit Pro Server Config” database that was included in the download.

Note
The default preferences in the Configuration Database are only used if you do not set a preference in your scripts using the plug-in's functions. In other words, any preference you set in your scripts using the plug-in functions will be used *instead* of these values. Also note, the Configuration Database is not required in order to use the SMTPit Pro SE plug-in.
Figure 1 Configuration Database for FileMaker 11 or below

Move Configuration Database to FileMaker Server

Before you can use the Configuration Database, you must upload it to your Server using the FileMaker Server Admin Console, or copy it into your "Databases" folder inside the "Data" folder on the FileMaker Server. If it is not already, enable the database within the FileMaker Server Admin Console.

Open Configuration Database

Once the database is on the FileMaker Server and enabled, you can open it either from a normal FileMaker Pro client computer or through Instant Web Publishing if it is enabled.

FileMaker Pro client

To open it from any FileMaker Pro client computer, choose the "Open Remote..." command from the "File" menu. If your FileMaker Server is set to "List only the databases each user is authorized to access", then use the username "Admin" with no password to see the database in the "Open Remote File" dialog (see note below). If you are using FileMaker 11 or below, you will also need to install the client version of SMTPit Pro on your FileMaker Pro client computer if you have not already done so.

Instant Web Publishing

To open the database through Instant Web Publishing, connect to the default Instant Web Publishing page (http://your.server.machine/fmi/iwp/) and select the "SMTPit Pro Server Config" link. Log in with the username "Admin" with no password (see note below).

Load Preferences (Only applies to FileMaker 12 and above)

FileMaker Pro client

If you already have preferences set for the SMTPit Pro SE plug-in and want to load them into the Configuration Database for viewing or editing, you will need to create a Server Scheduled Script.

Beginning in FileMaker Server 12, we no longer have a way to invoke the Server plug-in from inside the FileMaker Pro client. Because of this, we have to manually load the preferences from the SMTPit Pro SE plug-in into the Configuration Database, which is done via a Server Scheduled Script in the FileMaker Server Admin Console.

To create a Server Scheduled Script, open the FileMaker Server Admin Console.
  1. Select "Schedules" from the list on the left.
  2. Select "Create a Schedule" from the drop down list and click "Perform Action."
  3. Select the "Run Script" radio button, click Next, then select FileMaker Script and click Next.
  4. Select the database and set the Account Name and Password (if it exists).
  5. Now select the "Load Preferences" script, click Next two times, set the "Frequency" drop down list to "Once Only", and click Next.
  6. Set the "Schedule Name" to something such as "Load SMTPit Pro SE Preferences", and finish the remaining steps of the Schedule Assistant dialog.
  7. Finally, right click on the Schedule that was just created, and select "Run a Schedule Now."

The Log portal at the bottom of the screen will display results indicating if the preferences were loaded successfully or if an error occurred.

Instant Web Publishing

The SMTPit Pro SE plug-in preferences are loaded automatically into the Configuration Database when you open it in Instant Web Publishing.

Edit and Save Preferences

FileMaker 11 or below - FileMaker Pro client or Instant Web Publishing

With the configuration database opened through the FileMaker Pro client or Instant Web Publishing, you can configure the preferences for the plug-in on the server. When you close the database, make sure to use the "Close" button if you want to save any changes you made.

FileMaker 12 or above - FileMaker Pro client

With the configuration database opened through the FileMaker Pro client, you can configure the preferences for the plug-in on the server. To save your changes, you must use a Server Scheduled Script just like when loading the preferences.
  1. First, open the FileMaker Server Admin Console, and select "Schedules" from the list on the left.
  2. Select "Create a Schedule" from the drop down list and click "Perform Action."
  3. Select the "Run Script" radio button, click Next, then select FileMaker Script and click Next.
  4. Next, select the database and set the Account Name and Password (if it exists).
  5. Now select the "Save Preferences" script, click Next two times, set the "Frequency" drop down list to "Once Only", and click Next.
  6. Set the "Schedule Name" to something such as "Save SMTPit Pro SE Preferences", and finish the remaining steps of the Schedule Assistant dialog.
  7. Finally, right click on the Schedule that was just created, and select "Run a Schedule Now."

    1. The Log portal at the bottom of the screen will display results indicating if the preferences were saved successfully or if an error occurred.

      FileMaker 12 or above - Instant Web Publishing

      With the configuration database opened through Instant Web Publishing, you can configure the preferences for the plug-in on the server. To save your changes, make sure to click the "Save Preferences" button. The Log portal at the bottom of the screen will display results indicating if the preferences were saved successfully or if an error occurred.
Note to Multiple-Machine Deployment Users
If you have your FileMaker Server (FMS) and the FileMaker Server Web Publishing Engine (WPE) installed on two separate servers, you may have to use the Configuration Database twice. This is true if you want to use the plug-in in both the FMS (for use in Server Scheduled Scripts) and the WPE (for use in Custom and Instant Web Publishing).

If you do need to Configure it twice, open the Configuration Database in FileMaker Pro as described above, define your preferences, and then run a Server Scheduled Script to save the Preferences. Next, open the Configuration Database via Instant Web Publishing as described above to save the preferences.

Notes

  • If you manually copy the database to your Server, make sure the file permissions are set correctly for you to be able to edit the database.
  • It is highly recommended that you adjust the Accounts & Privileges to at least add a password to the Admin account. Otherwise, anyone with access to your FileMaker Server will be able to open this database and adjust the preferences for the plug-in on your server.