Forms: HTTP Datasource
An HTTP Datasource defines a web site, a web service or some other target that allows XML, HTTP or text data to be collected from it, or exported to it, over HTTP. Data is collected from an HTTP Datasource using an HTTP Collector, and exported to an HTTP Datasource using an HTTP Exporter.
Form: HTTP Datasource Details
The HTTP Datasource form contains a number of tabs:
| Field | Description |
|---|---|
| Details | The main details required for HTTP Datasource configuration. |
| HTTP Datasource Instance Details | HTTP Datasource Instances define the connection details to an HTTP target. The details for each instance are configured in the HTTP Datasource Instance Details form. |
| Description | A free text field for you to enter a description of the HTTP Datasource. |
Form Icons
The form provides the standard form icons.
Tab: HTTP Datasource Details
The following fields are configured on the Details tab:
| Field | Description |
|---|---|
| Name | Name of the HTTP Datasource. |
| Enabled | Tick when the configuration is complete and the HTTP datasource is ready to be used. |
| Connection Type | Choose from one of:
|
| Anonymous Export Allowed | You should tick this flag if either:
|
| Use User Credentials on Export | When this flag is ticked, the current logged-in user's own PhixFlow username and password will be used to connect to the target http datasource when an exporter is used interactively. Note that this means that the username/password must exist on the target system. There are two other configuration items that affect http datasource behaviour:
|
| Use User Credentials on Export | When this flag is ticked, the current logged-in user's own PhixFlow username and password will be used to connect to the target http datasource when an exporter is used interactively. Note that this means that the username/password must exist on the target system. There are two other configuration items that affect http datasource behaviour:
|
| The following options are only available when Connection Type = https | |
| Check Certificate | Tick if you want to validate the web site's security certificate. This will check that the web site's certificate matches the web site address, is signed by a valid certification authority, and has not expired. |
| SSL Protocol | If you are not familiar with SSL Protocol settings, leave this field blank. The SSL Protocol selects a list of actual protocols that are supported, and enables a sub-set of that list. If this field is blank, PhixFlow will select a default value which will work in almost all cases. Valid settings depend on the version of Java that PhixFlow is running under. These are the allowed values for Oracle's Java 8: TLS, TLSv1, TLSv1.1, TLSv1.2 |
| SSL Protocols Enabled | If you are not familiar with SSL Protocol settings, leave this field blank. This field specifies the SSL Protocols that should be enabled (as a comma-separated list). E.g. SSLv3,TLSv1,TLSv1.1,TLSv1.2 If this field is blank, the SSL Protocol (above) determines the Protocols that are enabled. |
Forms: HTTP Datasource Instance
HTTP Datasource Instances define the connection details to an HTTP target. A number of instances can be defined to allow for several connections under a single HTTP Datasource. At least one HTTP Datasource Instance must be defined for each HTTP Datasource.
Form: Datasource Instance Details
The following fields are configured on the Details tab:
| Field | Description |
|---|---|
| Name | Name of the HTTP datasource instance. This must be unique, although one instance may be named "Default". Typically, if a datasource has only one instance then it usually named "Default". |
| URL | URL of the HTTP target for this instance, without the leading http:// prefix. E.g. rss.slashdot.org/Slashdot/slashdot This field is made available as the _url internal variable in the Collector or Exporter Url Expression. |
| Anonymous Username | The anonymous username configured to access the HTTP datasource instance. |
| Password | The password for the anonymous username configured to access the HTTP datasource instance. |
The following fields are configured through separate tabs on the form:
| Field | Description |
|---|---|
| Description | Description of the HTTP datasource instance. |
See Also
Use User Credentials on ExportWhen this flag is ticked, the current logged-in user's own PhixFlow username and password will be used to connect to the target http datasource when an exporter is used interactively. Note that this means that the username/password must exist on the target system. There are two other configuration items that affect http datasource behaviour:
- Privilege 'Allow anonymous updates on datasources'. Only a user with this privilege can modify the 'Anonymous export allowed' flag on an httpdatasource.
- System Configuration parameter 'Allow anonymous export by default'. This causes the 'Anonymous export allowed' to be true by default on all new http datasources.