Troi File Plug-in™ 6.1.1

Troi File Plug-in is copyright 1998-2012 of Troi Automatisering. All rights reserved (July 31st, 2012).
 
Thank you for your interest in Troi File Plug-in. This FileMaker^® Pro plug-in adds file and folder manipulation: save or read a field from or to a file. Other manipulations like deleting files and creating folders are also possible.

This cross-platform plug-in is compatible with FileMaker Pro 10 to FileMaker Pro 12. Finally you can do things you thought were still impossible to do with FileMaker Pro. Now you can create powerful databases by using this plug-in!

INSTALLATION INSTRUCTIONS

INSTALLING A (TROI) PLUG-IN FOR THE FIRST TIME.

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 File 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_File.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_File_Plugin.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. Troi File Plug-in will display a dialog box, indicating that it is loading and showing the registration status. You can now open the file "All File Examples.fp7" to see how to use the plug-in's functions.

What Troi File Plug-in can do for you

The file manipulation functions make it possible to save the contents of a (text)field or global to a file. You may calculate a path name or let the user indicate a location on your disk through a Save as dialog box. The reverse is also possible: have the user select a file and read it into a field. Additional functions let you query detailed information of a file: the size on disk, creation and modification dates etc. Other manipulations include creation, deletion, copying and moving of files, and the creation of folders.

Writing IPTC and EXIF metadata to JPEG files

Troi File plug-in can not only read but also write IPTC and Exif metadata. As this is a very powerful feature, please read the separate readme on writing IPTC + Exif metadata before using this feature.

Who wrote it?

Troi File 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/
Here you will also find 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 File 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 File Plug-in 6 does not run on versions prior to FileMaker Pro 7. If you need to run on versions prior to FileMaker Pro 7: see our web site for the Troi File Plug-in 2.8.2. The 2.8.2 version runs on FileMaker 6, 5.x and 4.x.

Also note that Troi File 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 File as server-side plug-in
It has always been possible to use FileMaker Server to serve databases that use functions of the Troi File Plug-in (client-side): You need to have the plug-in installed at the client's computer. Now Troi File 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 File 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 File Plug-in at your own risk

Although Troi File 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 File 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 File Plug-in 6 has the following pricing:

Upgrades from previous versions

Troi File Plug-in 6.1.1 registers with the 6.0 version of the registration code. If you bought a license on or after Sept 1st, 2011 the upgrade is FREE! Eligible users have been sent a the 6.0 registration string in March 2012. Contact us if you have not received yours yet.

If you bought a license before Sept 1st, 2011 you will need to buy an upgrade to use Troi File Plug-in 6.

All Troi Plug-ins are available for Macintosh 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 by credit card via Kagi, who also accepts PayPal, checks and cash.

Protection and unlocking the application

Troi File Plug-in has a protection scheme. After you pay Troi Automatisering will tell you how to indicate to Troi File 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.
• the plug-in no longer stops working after 42 minutes.

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 File 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.

Thanks for supporting our software!

Peter Baanen