 |
Put URL |
Sends data to the server or transfers a file to the server, using the PUT method.
Syntax
Put URL [ Select ; Result ; Switches ; URL ; Put data ]
Options
| Select entire contents | replaces the entire contents of a field with the result. If not checked the result replaces the currently selected portion of the field |
| Result | the raw data returned (or an error code) |
| Switches | this determines the behavior of the plug-in |
| URL | the url of the server |
| Put data | the data to be sent with the PUT method. This can also be a file or image in a container field |
Switches
Switches can be one or more of these:
| -TimeoutTicks=x | specify the connect timeout time in x ticks (1/60th of a second) |
| -ReturnHeader | include the header in the returned text (at the beginning) |
| -ReturnDataAfterError | return the error code followed by the data |
| -Portnumber=y | specify the port number to use |
| -DontAutoRedirect | the plug-in will not go to a redirected page but return the original page |
| -AllowAnyRootCertificate | (for HTTPS) allow root certificates from unrecognized certification authorities. Note that this is less secure |
| -AlwaysSendUserPassword | will directly send the username + password, even when this might not be necessary |
| -DontTryWithUserPassword | don’t send username + password when the web server requests authorization |
Returned Result
Data type returned
Text
Result
If successful it returns the data of the URL. If unsuccessful it returns an error code starting with $$ and the error code. Returned error codes can be:
| $$-1 | user cancelled | |
| $$-4230 | the connection timed out | |
| $$-3242 | this protocol is not supported (use only http and https) | |
| $$-30776 | authentication error, you need to supply a correct user name and password | |
| $$-92 | servername part of the url is too long | |
| $$-2110 | path part of the url is too long |
Other errors may be returned, specifically errors in the range 300 to 599, which are HTTP Status Codes.
Originated in
Troi URL Plug-in 5.0
Compatibility
FileMaker Pro 16 to 19
Considerations
Not every web server supports the PUT method.
Note that theData is UTF8 Encoded by default.
Secure connections (HTTPS) using SSL are also supported.
If you don’t specify a timeout, a default timeout of 15 seconds is used.
The length of the URL is limited, by both the plug-in and receiving web servers. A lot of web servers don’t support URLs longer than 2048 characters. Note that the plug-in has higher limits of 32867 characters for the URL.
Example
Put URL [ Select ; Result ; "-Unused" ; "http://www.example.com/data/user123/mydata.txt" ;
"color=blue" ]This will send the data “color=blue” to be put at the location /data/user123/mydata.txt on the web server.
Example 2
We assume that in your FileMaker file the following fields are defined:
MyContainer Container
ImageName TextThe field MyContainer can contain a file or an image. ImageName should contain the name of the image, for example “img123.jpg”.
Add the following script steps:
Set Variable [ $thebaseURL ; "http://www.photos.com/images/" ]
Put URL [ Select ; ResultText ; "-noDialog" ; $thebaseURL & ImageName ; MyContainer ]This will transfer the imagefile in the container to the web server, to be put in the specified location on the web server: “http://www.photos.com/images/img123.jpg”. Note that web servers might not support the PUT method or refuse this PUT request.
Related script step
| Post URL |
Related function
| TURL_Put |
Related topics
Troi URL Plug-in online help (overview)
