HTTP(S) Poll input connector

These connectors enable the StreamServer to function as an HTTP client that polls an HTTP server.

Comments

• Use the HTTPS Poll connector if you want the StreamServer to function as an SSL client that communicates over an encrypted HTTPS channel. • You can use the custom startup argument -startallinconnectors to start connectors that are not connected to any Event.

The connector settings are described below.

Security configuration

The security configuration to add to the HTTPS Poll connector. See the Encryption and authentication documentation for more information about security configurations. The security configuration must be included in a resource set connected to the Platform.

HTTP method

The method to use when polling the HTTP server.

•

HEAD – Requests a HEAD header from the HTTP server. If the Last-Modified entity-header field has changed, the StreamServer will fetch and process the data. If there is no Last-Modified field in the header, the connector will switch to the GET method instead. If the Last-Modified field is not updated correctly this method will fail.

•	GET – Downloads the data once during each poll interval, and calculates a checksum to see if the data has been updated. The StreamServer will process the data only if the checksum has changed.

•	POST – Posts a file to the HTTP server, downloads the response and calculates a checksum. The StreamServer will process the data only if the checksum has changed.

URL

The URL to the HTTP server.

Content-type

This property depends on the HTTP method:

•	POST – The content type of the posted file.

•	HEAD and GET – The media types the client accepts in the response. For example text/*, text/xml, text/xml;level=1, */*. All formats will be accepted if this field is empty.

Post file name

The file to post when using HTTP method POST. The file must be included in a resource set connected to the Platform.

HTTP time-out

The maximum time (milliseconds) to wait before aborting a transfer.

HTTP version

The HTTP version to use.

SSL version

The SSL version to use with the HTTPS Poll connector. The server and the clients must use the same SSL version.

HTTP authentication

The type of authentication scheme (RFC 2617) to use for password authentication.

•	None - Do not use authentication.

•	Basic - Send authentication parameters as clear text. This is the only scheme supported in HTTP/1.0.

•	Digest - Send authentication parameters as a checksum over the network. Requires HTTP/1.1.

HTTP realm

The name of the realm to access. Used only if authentication is required.

User name

A user name to access the realm. Used only if authentication is required.

Password

A password to access the realm. Used only if authentication is required.

Cache file

The cache file that stores communication checksums between StreamServer start/stop.

Schedule

Opens the Scheduler Configuration dialog where you specify when and how often to poll the HTTP server. See Scheduling actions in the Design Center documentation for more information about scheduling.

Time-out

Specifies a time-out for the connector. The StreamServer uses job-end sequences in the input data to determine when all data in an input job is received. If there are no job-end sequences in the input data, the StreamServer will not know when to stop waiting for more input. To prevent this from happening, you can define a time-out for the input connector.