GET VI

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.


icon

Inputs/Outputs

  • cpath.png output file —

    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.

  • cdlrn.png client handle —

    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.

  • cstr.png url —

    URL specifies the URL of the server, Web page, or Web service which this VI sends the Web request.

  • cerrcodeclst.png error in (no error) —

    error in describes error conditions that occur before this node runs. This input provides standard error in functionality.

  • ci32.png timeout (10000) —

    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.

  • idlrn.png client handle out —

    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.

  • istr.png headers —

    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.

  • istr.png body —

    body returns body data returned by the server.

  • ierrcodeclst.png error out —

    error out contains error information. This output provides standard error out functionality.

    • 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.