Troi URL Plug-in™ 3.0

Troi URL Plug-in is copyright 2002-2012 of Troi Automatisering. All rights reserved (October 9th, 2012).
 
Thank you for your interest in the Troi URL Plug-in. With this FileMaker^® Pro plug-in you can fill in web forms and retrieve data and images from any HTTP URL, all from a FileMaker script.

This cross-platform plug-in is compatible with FileMaker Pro 10 to FileMaker Pro 12. Now you can create powerful databases that get information from and post to the web by using this plug-in!

NOTE With the Web Viewer introduced with FileMaker Pro 8.5 it is also possible to get data from web sites. However the Troi URL Plug-in can do much more:

• use the POST method to send data
• get images into containers
• set custom headers
• set cookies
• get data without showing the page on a layout (no render time)
• new: easily authorize an account for twitter and post tweets from FileMaker.
• and more...

INSTALLATION INSTRUCTIONS

NEW Starting with FileMaker Pro 12 a plug-in can be installed directly from a container field! So if you are using FileMaker Pro 12 installation is very easy: just open the "All URL Examples.fmp12" example file and the startup script will install the plug-in for you. See also the example file EasyInstallTroiPlugins.fmp12 (which is included in our .fmp12 formatted download package) which contains the actual plug-in and install script.

To install the plug-in for FileMaker Pro 10 and 11 follow these instructions:

• For Mac OS X: put the file "Troi_URL.fmplugin" from the folder "Mac OS Plug-in" into the "Extensions" folder in the FileMaker Pro 11 folder (or the FileMaker Pro 10 folder). If you have installed previous versions of this plug-in, you must remove them.
• For Windows: put the file "Troi_URL.fmx" from the directory "Windows Plug-in" into the "Extensions" subdirectory in the FileMaker Pro 11 directory (or FileMaker Pro 10 directory). If you have installed previous versions of this plug-in, you must remove them.

You may want to install other plug-ins before proceeding. Then (re)start FileMaker Pro. The Troi URL Plug-in will display a dialog box, indicating that it is loading and showing the registration status. You can now open the file "All URL Examples.fp7" (or "All URL Examples.fmp12") to see how to use the plug-in's functions.
There is also a Function Overview and a User Guide.

Who wrote it?

Troi URL Plug-in was designed and implemented by Peter Baanen of Troi Automatisering. You can visit the Troi web site at: http://www.troi.com for additional information.

Troi may also be reached by postal mail at:

Troi Automatisering
Boliviastraat 11
2408 MX Alphen aan den Rijn
The Netherlands

Email: info@troi.com

Note that due to spam we have to filter incoming email. It might happen that non-spam email is filtered out too. If you have sent an email and you don't get an answer, try to send another email, slightly differently formulated and include the word "FileMaker" in the body text.

Where can I get the latest version and more information?

The latest versions of our software are available for downloading at our web site:
http://www.troi.com
You can also download the OSErrrs database, which lists all Operating System error codes for Macintosh and Windows, some of which the plug-in may return. The web site is also your source for late breaking information, company information, FileMaker tips and more.

System requirements

System requirements Mac

Mac OS X 10.5.7 or higher (Leopard), Mac OS X 10.6.x (Snow Leopard), Mac OS X 10.7 (Lion), OS X 10.8 (Mountain Lion)

System requirements Windows

Windows XP Professional, Home Edition (SP 3) on Intel-compatible computer, Pentium III 700MHz or higher
Windows Vista on Intel-compatible computer, Pentium III 800MHz or higher
Windows 7 on Intel-compatible computer 1 GHz or faster
QuickTime 7 or later for some image related functions

FileMaker requirements

FileMaker Pro 10 or FileMaker Pro Advanced 10 or higher.
FileMaker Pro 11 or FileMaker Pro Advanced 11 or higher.
FileMaker Pro 12 or FileMaker Pro Advanced 12 or higher.

NOTE We have successfully tested it with FileMaker Pro 9 and FileMaker Pro Advanced 9, but we no longer provide active support for this version. Troi URL Plug-in will probably also run fine with earlier FileMaker versions 7 to 8.5, but we have not tested these earlier FileMaker versions and we do not provide support for this.
Also note that the example files may use features only available in FileMaker 9 and higher.

Troi URL Plug-in version 3 does NOT run on versions prior to FileMaker Pro 7.0. If you need to run on versions prior to FileMaker Pro 7: see our web site for the Troi URL Plug-in 1.3. The 1.3 version runs on FileMaker 6, 5.x and 4.x.

Also note that Troi URL Plug-in, with older FileMaker versions, will probably run on older operating systems for example Mac OS X 10.4 or Windows 2000, however, we do not support this.

FileMaker Server requirements

FileMaker Server 10 or FileMaker Server Advanced 10 or higher.
FileMaker Server 11 or FileMaker Server Advanced 11 or higher.
FileMaker Server 12 or FileMaker Server Advanced 12.

Using Troi URL Plug-in as server-side plug-in
It has always been possible to use FileMaker Server to serve databases that use functions of the Troi URL Plug-in (client-side): You need to have the plug-in installed at the client's computer. Now Troi URL Plug-in can also be used by FileMaker Server as a server-side plug-in or as a plug-in used by the web publishing engine. To use Troi Plug-ins as a server-side or web-side plug-in you need to purchase a special Server/Web license. See below for pricing.
For more information on server-side and web-side plug-ins please read the separate document: Installing and using Troi Plug-ins on FileMaker Server.

Troi URL Plug-in is a commercial product

You can try-before-you-buy. This means that you are free and invited to test the plug-in 30 days before you pay. You may also make copies of the original and complete package (including this Read Me file) and distribute it to customers, friends etc. However, you may not distribute a modified or licensed version.

Use Troi URL Plug-in at your own risk

Although Troi URL Plug-in was tested carefully, we can not be responsible for any damages resulting from using this software. Also please try it out on a test database. Your system may be using an extension (unknown to us) that interferes with the proper functioning of Troi URL Plug-in.

We like to hear feedback on the benefits and shortcomings of the plug-in. Please include the platform and operating system in your suggestions and comments.

What are the costs?

Troi URL Plug-in 3 has the following pricing:

Upgrades from previous versions

If you bought a license on or after October 1st, 2011 the upgrade is free! We will email all eligible customers a registration string. Contact us if you have not received yours.

If you bought a license before October 1st, 2011 you will need to upgrade to use the 3.0 version.

All Troi Plug-ins are available for Mac OS X and Windows. When ordering please indicate for which platform you are ordering.

How to pay?

Paying for a license is easy. We have several ways to pay. More information on this can be found on the order page on our web site: http://www.troi.com/software/order.html. You can pay online with a credit card via Kagi, who also accepts other forms of payments.

Protection and unlocking the application

Troi URL Plug-in has a protection scheme. After you pay Troi Automatisering will tell you how to indicate to Troi URL Plug-in that you have paid the license fee.

After you've supplied the payment data the following is changed:

• the not registered warning is replaced by your name.
• the flash screen that shows at the first time the plug-in is used is removed. Of course also the delay (which is longer after 30 days of use) will be removed.

Bug reports and Wish list

If you find a bug, please report this by e-mail: info@troi.com. If you have any comments or other functions that you think need to be added, please notify us! We have a lot of ideas for this plug-in, so be sure to check our web site for new plug-ins and improved versions.

And please pay for software you keep using, so that the wish list becomes reality.

Versions

You can find what has been changed in this and previous version of Troi URL Plug-in in the separate file: Release_notes.htm.

Finally if you still need to convert from FileMaker Pro 6 databases don't forget to read the FileMaker 6 Conversion Note, which explains how to convert from FileMaker Pro 6 databases.

Thanks for supporting our software!

Peter Baanen