Reference > Script steps reference > Fields script steps > Insert From URL
 
Insert From URL
Purpose 
Enters the content from a URL into a field.
See also 
Format 
Insert from URL [Verify SSL Certificates; Select; With dialog: On/Off; <table::field>; <resource URL>]
Options 
Verify SSL Certificates verifies the SSL certificate of the server specified in the URL. If the certificate cannot be verified, users can choose to connect anyway or cancel to skip this script step. If the certificate cannot be verified and the Set Error Capture script step is set to On, Insert From URL behaves as if the server were unavailable.
Select entire contents replaces the contents of a field. If you do not select this option, Insert From URL inserts the content from the URL at the insertion point or at the end of the field's data.
With dialog specifies whether to display the “Insert from URL” Options dialog box when the script step is performed.
Go to target field specifies the field to insert the URL content into.
Specify URL allows you to type the URL or to create your URL from a calculation.
Automatically encode URL replaces special characters with the corresponding encoded values required for URLs. For example, a space character is replaced with %20. When this option is deselected, the URL remains as it is entered.
Compatibility 
 
Where the script step runs 
Supported 
FileMaker Pro 
Yes 
FileMaker Server 
Yes 
FileMaker Go 
Yes 
Custom Web Publishing 
Yes 
FileMaker WebDirect 
Yes 
Runtime solution 
Yes 
Originated in 
FileMaker Pro 12.0
Description 
Insert From URL supports http, https, httppost, httpspost, ftp, ftps, and file protocols. FileMaker Pro downloads the resource that is specified by the URL to the target field.
For a list of picture and audio/video formats supported in container fields, see Using data in container fields.
Important  For better performance in FileMaker WebDirect, be sure that Select entire contents is selected.
Notes
Insert From URL supports UTF-8 only.
In FileMaker WebDirect:
If the With dialog option is On, this script step runs as if Automatically encode URL is selected.
If Select entire contents is deselected, and Insert From URL inserts content into a text field, the contents from the URL are appended to the text field. Multiple fetches can result in unpredictable results and slower performance.
httppost and httpspost are custom schemes defined by FileMaker Pro that enable you to send HTTP POST data. See About importing data using an HTTP request.
If the specified field doesn’t exist on the layout where the script is being performed, Insert From URL returns an error code, which can be captured with the Get(LastError) function.
Example 1 
Accesses a website and inserts a PDF into the Sales Report container field.
Insert from URL [With dialog: Off; Customers::Sales Report; “//www.filemaker.com/sales_report.pdf”]
Example 2 
Inserts a map showing the customer's address in the Address Map container field.
Insert from URL [With dialog: Off; Customers::Address Map; "http://maps.google.com/maps/api/staticmap?center=" & Customers::Address & "&zoom=14&markers=" & Customers::Address & "&size=256x256&sensor=false"]
Example 3 
Inserts the HTML code for //www.apple.com.
Insert from URL [With dialog: Off; Customers::HTML Website Code; "//www.apple.com"]
Related topics 
Script steps reference (alphabetical list)
Script steps reference (category list)