FileMaker 7 or higher, Java Virtual Machine (JVM) 1.5 or higher, Windows or Mac OS X 10.4. Rosetta on Intel Macs not supported.
To install the plug-in, copy the plug-in to the correct directory:
FileMaker Pro: FileMaker / Extensions
Web Publishing Engine: FileMaker Server/Web Publishing/publishing-engine/wpc/Plugins *
Custom Web Publishing: FileMaker Server/Web Publishing/publishing-engine/cwpc/Plugins *
Mac FileMaker Server Scheduled Scripts: /Library/FileMaker Server/Database Server/Extensions *
Windows FileMaker Server Scheduled Scripts: C:\Program Files\FileMaker\FileMaker Server\Database Server\Extensions *
* (Requires Enterprise license)
Create the "Plugins" folder if it doesn't exits. Make sure to restart FileMaker Pro / Server / WPE. Enable the plug-in in FileMaker Server Admin console for scheduled scripts on the server. For users running 64-bit versions of Windows and FileMaker Server 12.02 and later, use the 64 bit version of the plug-in in the custom web publishing location only. The 64 bit plug-in is marked with .fmx64
Uninstalling the plug-in
Uninstall the plug-in by quitting FileMaker Pro or stopping FileMaker Server and removing the plug-in file from your Extensions directory.
Demo mode and registering the plug-in
Plug-ins will run in a fully featured demo mode until they are registered. While running in demo mode, the product will run for 2 hours every time you launch FileMaker / FileMaker Server / FileMaker Web Publishing Engine until restarted. Enter the license information in FileMaker Preferences, or by using a script and calling
Set Variable [ $register Value: CCRegister ( licenseKey, registeredTo)
Returns: a 1 on success or a 0 on failure.
When something unexpected happens, the plug-in will pop up a dialog showing what the error message is. This makes it easy to see what went wrong. However, in some cases, you (the developer) may prefer to show your own message to the user, or possibly not show a message at all. In that case, you can call
CCSetErrorCapture with a parameter of true. That will suppress the error dialog from appearing to the user.
Whether or not you suppress the error dialogs, a plugin function will return the word
ERROR if something goes wrong. It's a good idea to put your plugin functions in an 'If' statement so that you don't execute a bunch of script steps after something has gone wrong. If you'd like for your script to get the error message, you can get that by calling the
CCLastErrror function. For example:
Set Variable [ $result = MyPluginFunction("x" ; "y" ; "z") ] If [ $result = "ERROR" ] Show Custom Dialog [ "An error occurred: " & CCLastError ] End If
If a plug-in is not installed correctly, calls to a plug-in function will return "?"
For more information on how to correctly install and work with plug-ins, check out the Plugins 101 documentation.