Skip to main content

TURL_Version (function reference)

By October 1, 2021October 13th, 2021Online Help, Troi URL plug-in
Troi URL Plug-in for FileMaker Pro


Use this function to see which version of the plug-in is loaded. This function is also used to register the plug-in.

SyntaxFunction badge

TURL_Version ( switches )


switches determine the behaviour of the function


switches can be one of these:

-GetVersionString the version string is returned (default)
-GetVersionNumber returns the version number of the plug-in
-ShowFlashDialog shows the Flash Dialog of the plug-in (returns 0)
-GetPluginInstallPath returns the path where the plug-in is installed
-GetRegistrationState get the registration state of the plug-in: 0 = not registered ; 1 = registered
-UnregisterPlugin sets the registration state of the plug-in to unregistered

If you leave the parameter empty the version string is returned.

Returned Result

Data type returned



The function returns ? if this plug-in is not loaded. If the plug-in is loaded the result depends on the input parameter. It is either a:

If you asked for the version string it will return for example “Troi URL Plug-in 5.0”.

If you asked for the version number it returns the version number of the plug-in x1000. For example version 4.5 will return number 4500.

This will show the flash dialog and then return the error code 0.

Originated in

Troi URL Plug-in 1.2


FileMaker Pro 16 to 19


IMPORTANT Always use this function to determine if the plug-in is loaded. If the plug-in is not loaded use of external functions may result in data loss, as FileMaker will return a question mark to any external function that is not loaded.


TURL_Version ( "" )

will for example return “Troi URL Plug-in 7.0”.

Example 2

TURL_Version ( "-GetVersionNumber" )

will return 2030 for version 2.0.3.

TURL_Version ( "-GetVersionNumber" )

will return 7530 for (a future) version 7.5.3

So if you want to test for a feature introduced with version 4.5, test if the result is equal or greater than 4500.

Related functionFunction badge


Related topics

Troi URL Plug-in online help (overview)

Online Help Page for Troi URL Plug-in for 16 to 19 –> TURL_Version (urlp9001) 2021-1013 16:39:54