GET VI

Owning Palette: HTTP Client VIs

Requires: Base Development System

Sends a Web request that returns headers and body data from a server, Web page, or Web service. This VI uses the GET HTTP method and does not submit any data to the server. You also can save the body data to an output file.

You can assign a client handle to add authentication credentials, HTTP headers, or a cookie to Web requests made by the GET VI. Use the OpenHandle VI to open a client handle and establish credentials. Use the AddHeader VI to add header lines to Web requests made by the GET VI.

Details  

Add to the block diagram

Find on the palette

	output file specifies a file to save body data returned by the server. If you do not specify an output file, the VI does not save the body data to a file.
	client handle specifies the client handle to associate with the Web request. Use client handles to wire together multiple HTTP Client VIs while preserving authentication credentials, HTTP headers, and cookies. Client handles are not required when making independent Web requests without persistent data such as headers or credentials.
	URL specifies the URL of the server, Web page, or Web service which this VI sends the Web request.
	error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
	timeout specifies the amount of time in milliseconds to wait for a response from the server before the Web request times out. The default value is 10000 ms. A value of -1 defers timeout monitoring to the operating system.
	client handle out returns the client handle associated with the Web request. Use client handles to wire together multiple HTTP Client VIs while preserving authentication credentials, HTTP headers, and cookies. Client handles are not required when making independent Web requests without persistent data such as headers or credentials.
	headers returns the header fields returned by the server. Refer to the World Wide Web Consortium website at www.w3.org for more information about header field definitions including available headers, descriptions, and syntax.
	body returns body data returned by the server.
	error out contains error information. This output provides standard error out functionality.

GET Details

Refer to the World Wide Web Consortium website at www.w3.org for more information about HTTP method definitions, including the GET method.

Using the GET VI with LabVIEW Web Services

Use this VI to interact with a LabVIEW Web service. First, you must create and publish a Web service, including the setup of a URL map to accept the GET method. You can then use the GET VI to connect to that Web service by specifying a URL that corresponds to the Web service.