|LabVIEW 2015 Help|
|LabVIEW 2016 Help|
|LabVIEW 2017 Help|
|LabVIEW 2018 Help|
|LabVIEW 2019 Help|
Owning Palette: HTTP Client VIs
Requires: Base Development System
Sends a Web request that submits multiple sets of data or files to a server, Web page, or Web service. This VI uses the POST HTTP method and multipart/form-data MIME type.
The POSTMultipart VI submits multiple sets of data, represented by an array of postdata clusters. Use the postdata control descriptions to configure the submitted data as one of the four available combinations. For example, the VI can accept a buffer data string from the client and send that data as a file to the server.
|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.|
|data is the array of clusters specifying the data attributes and values to submit to the server. The POSTMultipart VI determines which data format to accept from the client and which format to send the data to the server based upon the controls specified within data.
|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.|
The POSTMultipart VI can submit either buffer data, such as a string, or a file from the client. The VI can then instruct the server to save the accepted data as either server-side buffer data or a file. The POSTMultipart VI determines which data format to accept from the client and which format to send the data to the server based upon the controls specified within each postdata cluster. The following screenshot shows four clusters, each configured as one of four available client-side/server-side combinations.