Skip to main content

FAQ Part 1: General plug-in questions

By December 1, 2017July 26th, 2023FAQ

Answers to questions that are applicable to every plug-in.

Getting started

What are FileMaker plug-ins?

FileMaker Pro Plug-Ins provide additional functionality to enhance FileMaker Pro. Plug-ins can add new external functions, making it possible to do things which can not be done with FileMaker Pro alone.

What can you do with FileMaker plug-ins?

FileMaker Plug-ins can add functionality in a lot of areas. With plug-ins it is for example possible to read a file from disk, communicate with a serial port, show special dialogs, encrypt data and much more!

Which operating systems are supported by FileMaker plug-ins?

Plug-ins can be created for each operating system (or platform) on which FileMaker Pro runs.
FileMaker 20(23) runs on macOS Monterey 12.0 or later and on Windows 10 Enterprise and Pro Editions (22H2, 64-bit only) or later.
Please be aware that not all plug-ins are available on every platform. Developers need to create and test a plug-in for a specific platform. Also it is possible that a specific function can not be created on a specific platform.

How do I start using FileMaker plug-ins?

The best way to start is to download the demo from our web site and take a close look at the included example files.

Which version of FileMaker do I need to be able to use plug-ins?

FileMaker 4.0 introduced a limited way to create plug-ins with the External function API. Plug-in functions for this API look like this:
External ( "function name" , "parameter" )
FileMaker Pro 7 introduced a richer way to build plug-ins, this so called FileMaker 7 Native API allowed for more paramaters and Unicode. Plug-in functions for this API look like this:
Function_name ( parameter1 ; parameter2 ; etc... )
Starting with FileMaker 16 plug-ins can also add script steps. You can select these script steps in the script steps pane in Script Workspace, or you can begin typing the script step name, then choose the script step from the list that appears.
To see with which version of FileMaker Pro a plug-in will work please refer to the specific plug-in web page. For more information on compatibility with FileMaker Pro 20(23) see the Troi FMP 2023 compatibility page.
With FileMaker Pro Advanced 18 and earlier you are able to make standalone runtimes which can also use plug-ins.

Do Troi plug-ins work with files hosted with FileMaker Server?

Yes, they all work with files hosted by FileMaker Server. For this the plug-in needs to be installed at the FileMaker Pro client.

Do your plug-ins work with Server Based Computing systems like Citrix?

We expect our plug-ins to function normally on Citrix and similar systems. Several users have reported good results. However some plug-ins may use system resources, like a serial port or an IP address and/or port, that can not be shared.
See also Sending remote events with Activator.
We ourselves have not tested plug-ins on Citrix and if you have information on this please let us know.

Do you have test results from users regarding plug-ins and Citrix (or similar)?

Yes, Andy Knasinski tested Troi Coding, Troi Dialog, Troi File, Troi Number and Troi Text, and each worked as normal. He also tried Troi Serial on Citrix. He wrote: “When running multiple sessions on the same COM port it came up and said “port in use” as I would have expected.”
Thanks Andy!

Installing

On which machines do I need to install the plug-ins?

You need to install it for each FileMaker Pro client which is going to make use of the functionality of the plug-in. The files can be single user or shared with others.

Where on the disk do I install plug-ins?

With FileMaker 12 and later you can store plug-ins in a container field and install them from within FileMaker Pro. In our downloads for FileMaker 12 and later you will find an EasyInstallTroiPlugins.fmp12 example file that shows this.
Plug-ins are installed in this location:

  • Windows:
    C:\users\user_name\AppData\Local\FileMaker\FileMaker Pro\20.0\Extensions\
    (or equivalent for other FileMaker versions)
  • macOS:
    Macintosh HD/Users/user_name/Library/Application Support/FileMaker/FileMaker Pro/20.0/Extensions
    (or equivalent for other FileMaker versions)

Do I need to install Troi plug-ins on the server computer that is running FileMaker Server?

You only need to install a plug-in on FileMaker Server when you want to use it in server-side or web-side scripts. To register a plug-in for use on FileMaker Server you need a special server/web license.
When you want to use a plug-in client-side, including with files hosted by FileMaker Server, you need to install it on the FileMaker client and register it with a regular (single or multiple) user license.

I've correctly installed the plug-in, but nothing seems different. How do I make the plug-in work?

To make a plug-in do its work you need to add calls to the External functions or External script steps of that plug-in. For some plug-ins this needs to be done in a script and for others in defining a calculation in the Specify Calculation dialog box. See the documentation and examples that come with the download of the plug-in for information on specific plug-in functions.

Hosting

Can I use FileMaker Client to host files that make use of plug-ins?

Yes, but also here you need to install the plug-in on each FileMaker Pro client which is going to make use of the functionality of the plug-in.

I host my database on a Macintosh but have client users on Windows through a network. Will the users on the Windows PCs be able to take advantage of the plug-ins?

Yes, provided you have installed a Windows version of the plug-in on the clients. The reverse situation also works.

FileMaker Runtimes

Is there a special place that plug-ins need to be to be able to work with a bound runtime?

Yes, the plug-ins need to be placed in a subfolder in the directory of the bound runtime. You might need to create this subfolder: create a folder with the name “Extensions”.

When using the binder from the Developer Utilities found in FileMaker Pro Advanced are the plug-ins really bound?

No, the plug-ins are not bound together with your solution. You still have to add the plug-ins to the appropriate folder.

I have a Developer License for your plug-ins. Can I register the plug-in from within the runtime and get rid of the registration file?

Yes, this is required when you distribute a registered plug-in to your end-users. All the versions of our plug-ins have a ‘built-in’ registration function. See the folder “For Solution Developers” in the download for more information on this.

Licenses

Registration

I can't seem to get my registration file to work. What am I doing wrong?

After payment we will send you a registration string that works cross platform.
Pay attention to this:

  • The names of the files are different for macOS and Windows. On macOS name the registration file “Troi Payment Certificate.txt”. On Windows name it “TroiPay.txt”. (Do not include the quotes in the file names).
  • Place the registration file in the same directory as your FileMaker Pro application. Do NOT put it in the same folder as the plug-in or the ‘Extensions’ subfolder in the FileMaker application folder.
  • If you have more than one copy of the FileMaker Pro application on your computer put a copy of the registration file in each folder.

For more troubleshooting tips please see the Registration support page.

FileMaker Pro 14-20(23)

Do you have 64-bit compatible versions of the Troi plug-ins?

Yes, all our current plug-ins are 64-bit compatible. See the Troi 64-bit compatibility page for a list.

Can 32-bit plug-ins run on FileMaker 14-20(23)?

No, FileMaker 14 to 20(23) are 64-bit processes, for which plug-ins need to be compiled for 64-bit.
Note: it is possible to run FileMaker Pro 14 legacy in 32-bit mode. For this you need to open the FileMaker Pro app in 32-bit mode on macOS (see ‘Get Info’ of the FileMaker app). On Windows you need to install the (separate) 32-bit FileMaker Pro application. You can use this to run older plug-ins that are not compiled yet for 64-bit. Older plug-ins may not be fully compatible with FileMaker 14 though.

FileMaker Go

Is it possible to load Troi plug-ins on FileMaker Go?

No, our current plug-ins are created for FileMaker Pro and can not run with FileMaker Go on an iPhone or iPad.

Can FileMaker Go access functions of your plug-ins when they are running on FileMaker Server?

To access functions of a plug-in from FileMaker Go you can use the “Perform Script on Server” script step (available from FileMaker 13), with the plug-in running on FileMaker Server.
Note that the script will always run in the context of the FileMaker server computer. This means that the plug-in will only have access to files, data etc. on the FileMaker server computer.
If the plug-in function returns a result, like for example the characters of a file or a thumbnail, the script running needs to store this result in a (new) record so that FileMaker Go users can access this result.

More information

Is there a list of error codes that a plug-in might return?

Yes, see Troi OSErrrs, a FileMaker file with all known macOS and Windows error codes, as well as error codes specific to Troi plug-ins.

Is there a list of available External Functions and their syntax?

In each plug-in download you will find a database called Reference.fmp12 that lists all external functions and script steps this plug-in adds and their syntax. You will also find this info on the Online Help pages on our web site.

Other questions?

If your question is not answered here, please look in the documentation that comes with the plug-in or in one of the specific plug-in FAQs. If you have suggestions please email a FAQ suggestion.