@URLGetHeader (Formula Language)

Returns specific Hypertext Transfer Protocol (HTTP) header information from the Uniform Resource Locator (URL). A URL is a text string used for identifying and addressing a Web page.

Syntax

@URLGetHeader( urlstring; headerstring; webusername; webpassword; proxywebusername; proxywebpassword )

Parameters

urlstring

Text. The URL for the Web page you want to open, for example, http://www.acme.com/.

headerstring

Enter a header string to return the desired URL header value. The acceptable header strings are documented in the HTTP specification (available at locations on the Internet, such as http://www.w3.org/) and are subject to change based on updated versions of the specification.

webusername$

Text. Optional. Some Internet servers require you to obtain a user name and password before you can access their pages. This parameter allows you to enter the user name that you previously obtained from the authenticated Internet server.

webpassword$

Text. Optional. Some Internet servers require you to obtain a user name and password before you can access their pages. This parameter allows you to enter the password that you previously obtained from the authenticated Internet server.

proxywebusername$

Text. Optional. Some proxy servers require that you specify a user name in order to connect through them. This parameter allows you to enter the user name for the proxy server. See your administrator for the username required by the proxy.

proxywebpassword$

Text. Optional. Some proxy servers require that you specify a password in order to connect through them. This parameter allows you to enter the user name for the proxy server. See your administrator for the password required by the proxy.

Return value

headervaluestring

Text. Returns the header value that you requested. If a null value is returned, the header value that you requested was not found in the header of the Web page.

Usage

The @URLGetHeader function should only be used in the context of either the Server Web Navigator or Personal Web Navigator database.

Examples

  1. This example returns the last date that the www.acme.com Web page was modified.
    @URLGetHeader ("http://www.acme.com/"; "Last-modified")
  2. This example returns the name of the Web server software where the www.acme.com Web page resides.
    @URLGetHeader ("http://www.acme.com/"; "Server")