# Troi URL Plug-in release notes Below you can find the version history, with an overview of what has been changed in the current and previous versions of Troi URL Plug-in. ### Troi URL Plug-in versions for FileMaker Pro 9, 8 and 7 Version 2.0.3 (for FileMaker 7, 8 and 9) (August 4th, 2008) Added new switch "-AlwaysSendUserPassword" to the TURL_Get and TURL_Post functions. This will make the plug-in to directly send the username and password even when that might not be necessary. (Mac OS X) Improved the TURL_Post function: added switch "-Encoding=ISO_8859_1" to be able to specify the ISO latin 1 data for the POST data encoding. (Windows) Improved the TURL_Post function: Changed the default encoding from "-Encoding=ASCII_Mac" to "-Encoding=UTF8". This encoding is now used for the POST data if you don't specify an "-Encoding=..." switch. (Mac OS X) Improved the TURL_Post function: improved the encoding with switch "-Encoding=UTF8". (Windows) Improved the TURL_Post function: added workaround, where from some servers and in some circumstances the HttpSendRequest would be issued three times. (Windows) Added new switch "-AllowAnyRootCertificate", which can be added to HTTPS TURL_Get and TURL_Post functions. When you get the error code $$12045 you can add this switch to allow root certificates from unrecognized certification authorities. Note that this is less secure. (Windows) Fixed a problem with certificates from unrecognized certification authorities, when using HTTPS in the TURL_Get and TURL_Post functions. The plug-in now returns an error code, most likely $$12045 (Certificate authority is invalid) instead of an empty result. (Mac OS X) Fixed a problem where the plug-in would not load on Mac OS X 10.3.9. (Mac OS X) Fixed a problem where the plug-in could return error code $$-9876 (eventLoopQuitErr), when calling the TURL_Get or TURL_Post function just after opening a new FileMaker window. Set the user agent for the browser to "Troi URL Plug-In 2.0" Updated the FillForm.fp7, to include a script with a long timeout. Updated the User Guide and Overview.fp7 file. Version 2.0.2 (for FileMaker 7, 8 and 8.5) (November 7th, 2006) (Windows) Fixed a problem where after installing Internet Explorer 7 (Release Candidate 1) the plug-in would return an error of $$87. (Windows) When using the TURL_Post function with the -NotEncoded switch: the plug-in now no longer adds "Content-Type: application/x-www-form-urlencoded" to the headers. (Mac OS X) Added "-DontAutoRedirect" switch for the TURL_Get and TURL_Post function. (Mac OS X) Added "-AllowAnyRootCertificate" switch which can be added to HTTPS TURL_Get and TURL_Post functions. This switch will allow root certificates from unrecognized certification authorities. Note that this is less secure. Added user interface for explicitly setting a proxy in the example file "FillForm.fp7". Corrected wrong field for the -NotEncoded switch on the layout of the example file "FillForm.fp7". Fixed a problem in the example files "GetPage.fp7" and "GetImages.fp7". The button "Set proxy server" now executes the correct script. (Windows) Changed the error code returned when a timeout occurs: instead of $$12002 the plug-in now returns $$-4230, as on Mac OS X. Changed name of user guide to be more clear for which plug-in it refers to. Version 2.0.1 (for FileMaker 7, 8 and 8.5) (August 22nd, 2006) Added the new function TURL_GetLastProperties, which returns information about the last image downloaded. You can ask for image type, width and height. Also fixed a bug in the windows version (Windows) Fixed bug in TURL_GetLastProperties. Improved the GetImages.fp7 example file. Added a consistency check for missing resources. The plug-in will now notice missing resources for example after being incorrectly zipped or tarred. Version 2.0b2 (for FileMaker 7, 8 and 8.5) (August 2nd, 2006) Fixed a bug where after disabling and re-enabling the plug-in not all the functions of the plug-in would be available. (Windows) Fixed a problem with not using implicit ports, like www.test.com:8080 (Mac OS X) Fixed a problem where the plug-in would not work after using the AutoUpdate feature of FileMaker Server. Version 2.0b1 (for FileMaker 7, 8 and 8.5) (July 21st, 2006) First public beta for FileMaker Pro 8.5. On Mac the plug-in is now an Universal plug-in which runs on PowerPC-based and on Intel-based Macs. Added "-ExtraImageCheck" switch to the TURL_Get and TURL_Post functions. This will make the plug-in do extra checking on the returned data if the data might be a image after all even if the images on the web site doesn't have a .png or .gif extension. Added new function: TURL_GetLastProperties, to retrieve the last image properties: image type, image height and width. Added switch -ReturnDataAfterError to TURL_Get and TURL_Post functions. This will return the error code followed by the data. Useful for debugging when partial data is returned. (Mac OS X) the "-Portnumber =xxx" switch now also works in TURL_Post. The plug-in now recovers better from some errors in the TURL_Get and TURL_Post functions. Made the plug-in functions also visible in Custom Functions. Improved file type checking for images, especially GIFs, in the TURL_Get and TURL_Post functions. Improved error handling in the TURL_Get and TURL_Post functions. Added sanity checks to the TURL_Get and TURL_Post functions. The plug-in now checks if returned images are corrupt or invalid. If this is the case error $$-4247 is returned. This can prevent FileMaker from hanging on the invalid image. (Mac OS X) Fixed a bug in the TURL_Get and TURL_Post functions, where with some long URLs would return with error code $$-2131. Version 1.8.3.1 (for FileMaker 7 and 8) (July 31st, 2006) Fixed a bug where after disabling and reenabling the plug-in not all the functions of the plug-in would be available. Version 1.8.3 (for FileMaker 7 and 8) (July 20th, 2006) Made the plug-in's functions also visible in Custom Functions. (Mac OS X) the "-Portnumber =xxx" switch now also works in TURL_Post. The plug-in now recovers better from some errors in the TURL_Get and TURL_Post functions. (Mac OS X) Fixed a bug in the TURL_Get and TURL_Post functions, where with some long URLs would return with error code $$-2131. TURL_Post: Added forgotten "theData" parameter in external list in the calculation dialog box. it now shows correctly as: "TURL_Post( switches ; theURL ; theData )". Updated the FillForm.fp7 example file, to reflect changes to external web pages. Cleaned up code in several places and prepared for Universal version. Also prepared registration handling for next release. Version 1.8.2 (for FileMaker 7 and 8) (February 6th, 2006) Added new function: TURL_SetProxy. This gives you an explicit way to set a proxy server. Added switch to TURL_Post: "-NotEncoded". This switch will send the post data without any encoding for "www-form-urlencoded". (Mac OS X) Fixed a memory leak in TURL_Get and TURL_Post, which could return error code $$24 and eventually lead to a crash. (Windows) Improved proxy handling code on Windows. Version 1.8.1 (for FileMaker 7 and 8) (October 15th, 2005) (Mac OS X) Cookies and Custom-Headers are now set properly. (Windows) Cookies and Custom-Headers can now be set on Windows too. Improved handling of HTTP errors and JPEGs. Added user guide and updated Overview.fp7. Added support to get GIF images from the web into a container field. Version 1.8 BETA (for FileMaker 7) (August 30th, 2005) Converted to new Function API of FileMaker Pro 7. Added support to get JPEG images from the web into a container field. NOTE Most functions now fully support Unicode, however there are some exceptions. Please read the FileMaker Pro 8 conversion note for more information on this and conversion to Troi URL Plug-in 1.8. Go to the FileMaker 8 Conversion Note ### Troi URL Plug-in versions for FileMaker Pro 6 ## 1.2 (August 10th, 2004) (Mac OS) Added support for customizing the header sent to web servers on Mac OS and Mac OS X, through the new TURL-SetCustomHeader function. This allows you to set the content-type too: for example "Content-type: text/html" or "Content-type: text/xml". Added DRAFT layout for this in the GetPage.fp5 file. Added -ExtraCRLFafterData switch to the TURL-Post function. This allows you to add CRLF at the end of the data.
IMPORTANT Changed behavior: On Windows the TURL-Post function would add an extra CRLF at the end of the data it sends to the web server. This caused problems with some web servers. Starting with this version of the plug-in this extra CRLF is no longer added. Please use the -ExtraCRLFafterData switch if you need the CRLF at the end.
(Mac OS) Improved correct display of dialog messages, like when the plug-in has stopped working. Also moved resources to a range not affected by the FileMaker application. When you specify a too long timeout value in the TURL-Post and the TURL-Get function, the plug-in now returns $$-4239, indicating the timeout is too big. Added documentation on checkboxes and radiobuttons in the TURL-Post function. Improved the FillForm.fp5 example file, to use the custom headers if necessary. (Mac OS) fixed a bug, when a web page is not available on the web server. Instead of an empty page the error code 404 is now returned. Fixed an error in the TURL-Get and TURL-Post function where the switch "-TimeoutSecs=301" (or bigger) would result in an inaccurate error code kErrPortNrOutOfRange ($$-4228) instead of kErrTimeOutOutOfRange ($$-4239). ## 1.1 (April 1st, 2003) (Mac OS) Added support for cookies on Mac OS and Mac OS X, through the new TURL-SetCookies function. On Windows cookies are handled automatically. (Windows) Changed implementation. Troi URL Plug-in now supports HTTPS and cookies on Windows. (Mac OS X) Fixed a bug which could crash FileMaker, if the URL did not exist and the progresss dialog was shown. (Windows) Fixed a problem where the plug-in would not return all data for a password protected web page. ## 1.0.1 (November 11th, 2002) NOTE The Mac OS Plug-in has not changed. Version 1.0.1 of the Mac OS plug-in is the same as the 1.0 version. We changed the version number to keep in sync with the Windows version. (Windows) Fixed a problem where the plug-in would always return with a timeout error code $$-4230 for certain URLs. The web servers of these URLs used chuncked encoding. We improved support for this encoding. Furthermore the extra length bytes at certain points in the returned HTML are now removed. (Windows) When an authorisation error occurs the plug-in now returns $$-30776 (URLAuthenticationError) , instead of showing the error page from the browser itself. (Windows) When a timeout occurs the plug-in now always returns error code $$-4230, instead of $$-3259 in some cases. Added "For Solution developers" folder, with information about distributing this plug-in. ## 1.0 (October 28th, 2002) Added support for Proxy servers on Windows. Added TURL-ToHTTP, which can encode text in to HTTP format. Added TURL-SetUserAgent, which can customize the text of the User Agent, so the plug-in can pretend to be a browser. Added TURL-SetProgressText, which can customize the text of the progress dialog box (Mac OS only). On Mac OS and Mac OS X long GET and POST operations now can be cancelled with an ESC or a Command-Period. Changed the default timeout to 15 seconds. If there is no protocol at the beginning of an URL, the plug-in now adds "http://" before it. ## 0.9b2 (September 23rd, 2002) Added TURL-SetPassword and TURL-SetUserName function. Added -NoDialog switch to TURL-Get and TURL-Post functions. (progress dialog is Mac only at the moment). Added "All URL Example.fp5" file. Added DRAFT of User Guide. Fixed a bug with too long URLs (>1000 characters), which could crash FileMaker, instead of return an error. Now URLs up to 64000 char long are supported. Should be enough. ## 0.9b1 (Augustus 13th, 2002) First public beta release