| Tag Link | [Include_URL] | Category | Include |
|---|---|---|---|
| Type | Substitution | Source Available | No |
| Support | Preferred | Version | 3.0 |
| Change | Unchanged | Data Source | Any |
| Output Type | Bytes | Security | Tag |
| Implementation | LCAPI | Sets | Lasso 8.5, Lasso 8.0, Lasso 7.0, Lasso 6.0, Lasso 5.0, Lasso 3.x |
[Include_URL] includes a Web page, image, or other resource from a remote HTTP or HTTPS server. The downloaded data can be displayed in the current format file, processed, or served.
The URL parameter is required. It should be a valid URL and may contain GET parameters. The remote page will be fetched and the response will be returned as the result of the tag.
All other parameters are optional and change the information that is sent to and received from the remote server.
[Include_URL: 'http://www.example.com']
[Include_URL: 'http://www.example.com',
[Include_URL: 'http://www.example.com',
[Include_URL: 'http://www.example.com',
[Include_URL: 'http://www.example.com',
[Include_URL: 'https://www.example.com',
[Include_URL: 'http://www.example.com',
[Include_URL: 'http://www.example.com',
| Required Parameters | |
|---|---|
| URL | The URL which is to be included. |
| Optional Parameters | |
| -POSTParams | An optional array of pairs which will be passed as the POST parameters with the URL request. Or, a string that will be posted to the remote server. |
| -GETParams | An optional array of pairs which will be passed as the GET parameters with the URL request. |
| -SendMIMEHeaders | An optional array of pairs which will be sent as additonal MIME headers along with the URL request. |
| -RetrieveMIMEHeaders | The optional name of a variable in which to store retrieved MIME headers. |
| -Username | An optional username with which to authenticate the URL request. |
| -Password | An optional password with which to authenticate the URL request. |
| -NoData | If specified then the URL request is sent, but no results are returned. |
| Encoding Keyword | Specifies the encoding for the tag's return value. Tags are encoded using |
| -VerifyPeer | If specified the tag performs a more rigorous check of the remote servers SSL certificate when the HTTP protocol is used. |
| -SSLCert | The file path to your certificate. No Lasso security will be checked for this file path. The default certificate format is "PEM" and can be changed with |
| -SSLCertType | The format of the SSL certificate specified by |
| -SSLKey | The file path to your private SSL key. No Lasso security will be checked for this file path. The default key format is "PEM" and can be changed with |
| -SSLKeyType | The format of the private key referenced by |
| -SSLKeyPasswd | The required password for the |
| -Timeout | This integer should contain the maximum time in seconds that you allow the connection to the server to take. This only limits the connection phase, once it has connected, this option is of no more use. Set to zero to disable connection timeout (it will then only timeout on the system's internal timeouts). |
| -ConnectTimeout | This integer should contain the maximum time in seconds that you allow the connection to the server to take. This only limits the connection phase, once it has connected, this option is of no more use. Set to zero to disable connection timeout (it will then only timeout on the system's internal timeouts). Note: It seems that any connection timeouts on OS X will wait for only half the time specified. |
The
The SSL and timeout parameters were added in Lasso Professional 8.1.
To create a proxy for Web requests:
Pass an [Action_Param] to the [Include_URL] tag and return the results of that tag in place of the current format file. The following example simply returns the URL specified in a URL parameter to the format file.
[Include_URL: (Action_Param: 'URL')]