Mac Setup Manual

From myFMbutler wiki
Jump to: navigation, search

Main Page > AutoSender 3 > OSX > Setup

Contents

What does it do?

myFMbutler AutoSender is a messaging solution robot that allows you to automatically send e-mail messages from your FileMaker solutions, based on the status of a FileMaker field. AutoSender also supports automatic sending of faxes or SMS text messages through the use of a third party mail-to-fax or mail-to-SMS service.

What do I need?

FileMaker requirements

For JDBC

FileMaker Server 13 (or 9 Advanced, 10 Advanced, 11 Advanced, 12 Advanced), with ODBC/JDBC sharing enabled. For more details on how to enable xDBC connections, please consult the FileMaker Server manual.  AS xDBC Conf.png

For XML

FileMaker Server 13 (or 9, 10, 11, 12) with XML publishing enabled. For more details on how to enable XML publishing, please consult the FileMaker Server manual.  AS WPE Conf.png

Java requirements

Java virtual machine 1.5, or higher This is a standard part of Mac OS X 10.5 and 10.6.

Fax & SMS requirements

If you want to use the fax or SMS functionality, you will need to register with a fax or an SMS provider that offers mail-to-fax or mail-to-SMS services.

How do I make this work?

Installation

The AutoSender application can either be installed on the FileMaker Server machine itself (recommended), or on a different machine on the network.

Run the myFMbutler AutoSender 3 installer: a ‘myFMbutler AutoSender 3’ folder will be created in your Applications folder.

The daemon will launch automatically after a restart of your machine.

Configuring AutoSender Data Sources

After restarting your computer, open ‘myFMbutler AutoSender Config’. (it is installed in /Applications/myFMbutler AutoSender 3/)

Here you will maintain a list of data sources that you will use, and also manage AutoSender Preferences.

AutoSender comes with a number of sample databases and these are pre-configured - though not activated by default - in the Configuration application.

Tooltips in the AutoSender Config application will help to provide more information.

Before adding another configuration to AutoSender, be sure to consult the ‘How to integrate’ PDF for more details on how to prepare your solution for AutoSender.


Per data source, there are three types of information you need to provide:

  • Connection Info: tell AutoSender how to connect to the data source
  • SMTP server: which SMTP server will be used for this data source
  • Fields: link the field names from the data source to mail fields

Connection Info

Enter all necessary information about the server location, file and table occurrence name, and login info for the file. NOTE: these names are case sensitive

  • Active : normally this is checked only at the end of the configuration process, this enables AutoSender for this particular data source.
  • Protocol :
    • For xDBC connections, select JDBC either for
      • FileMaKer Server 12 or 13 Advanced
      • FileMaker Server 11 Advanced
      • FileMaker Server 9 or 10 Advanced
    • for XML connections, select either
      • http
      • https
  • Server : enter the IP address or DNS name of your FileMaker server (or enter 'localhost', if AutoSender runs on the same host as your FileMaker server.)
  • Port : the default ports are: (change only if you have good reasons to do so)
    • 2399 for JDBC
    • 80 for http (XML)
    • 443 for https (XML)
  • Data source : enter the database name
  • Occurrence/Layout : enter the name of the occurrence (JDBC) or layout (XML) that contains the mail fields
  • User name : name of the user that has JDBC or XML privileges to access the database
  • Password : name of the user that has JDBC or XML privileges to access the database

The "Test Connection" button: allows you to test the connection using the current settings.

SMTP Server

Enter your SMTP server information about the SMTP server.

  • Server : enter the IP address or DNS name of your SMTP server.
  • Port : the default SMTP port is 25. Other common ports are 465 (SSL), or 587.
  • User name : if the SMTP server requires authentication, enter the user name, otherwise leave this empty
  • Password : if the SMTP server requires authentication, enter the password, otherwise leave this empty
  • Use SSL : check if the SMTP server allows SMTP over SSL (this is usually over port 465)

 You can test the SMTP settings to make sure they are correct.

Fields

Link the field information that is used in your solution to the fields in this tab. An AutoSender data source consists of the following fields (all fields in bold are required, fields marked with an asterisk must be text fields):

id *

from (e-mail)

from (name)

reply to

to (e-mail)

to (name)

cc

bcc

subject

body

htmlBody

status *

attachment(s)


The name of these fields can be changed for your application, but you need to make sure all the required fields are present in your table / on your layout.

AutoSender Preferences

A number of options are available from the AutoSender Config ‘Preferences’ pane:

Checking mail

Allows you to select the frequency for AutoSender to check the active data sources. Also allows you to select a JDBC session lifetime (i.e. if you are using JDBC to connect to the data sources. 

Daemon (background application)

Here you can (re)start or stop the background application: clicking these buttons will launch an applet that requires authentication to run, as the AutoSender daemon runs as root.

You also have the option to automatically load AutoSender at startup. If you do, AutoSender will be launched at startup, even if no user is logged in.

Handling attachments

Allows you to select what to do if AutoSender is unable to find an attachment for a message: either send the message without an attachment, or report an error.

Optionally cache attachments to avoid re-fetching the same data over and over again. A custom location for the cached attachments can be selected. You can also select to delete the cached files automatically after a set period of time,or you can clear the cache manually.

IMPORTANT NOTE: if you clear the cache, all files in the selected folder will be removed, so make sure the Attachments folder is not used for other purposes.

Logging

Allows you to set the log level. The default level is ‘INFO’, .with ’FATAL ERRORS’ reporting the least information,and ‘CHATTY’ reporting the most. Logfiles rotate every time AutoSender is restarted or when the maximum log file size is reached. The maximum log file size can be set in the AutoSender config together with the maximum number of rotations.

If there are any problems using an SMTP server, optional SMTP debug info can be logged as well.

Click the ‘Open Logs Folder’ button to navigate to the AutoSender logs folder: Logs should automatically open in Console.app.

License Information

If AutoSender finds valid license information at startup, licensee information will be shown here.

NOTE:After saving changes to the Preferences, the daemon needs to be restarted before these changes become active.

Notifications

Here you can configure the SMTP settings for an administrator e-mail address to be notified in case AutoSender encounters a certain type of errors.


For more extensive information about integrating AutoSender in existing FileMaker solutions, please refer to the ‘How To Integrate’ section.

Personal tools