HTTP data point definitions

The HTTP interface is used to send and receive data from and to an HTTP server. The HTTP data point definition table defines all HTTP data points that are used within the project.

File location

<WorkspaceDirectory>\DataFiles\xio.HTTP.DatapointDefinitions.dat

 

Col#

Parameter 

Description

Scope

Unit

Mandatory / default value

Col#

Parameter 

Description

Scope

Unit

Mandatory / default value

1

Name

The name of the data point. In combination with the Path, it must be unique.

string

none

mandatory

2

Path

The structure that is used to represent the data point. In combination with the Name, it must be unique.

string

none

empty

3

Data type

The type of the data point. 

BOOL, STR, BYTE, CHAR, INT8, UINT8, INT16, UINT16, INT32, UINT32, INT64, UINT64, FLOAT, DOUBLE, DATE, TIME

none

STR

4

Access mode

The access rights of the data point. Allowed values are R (read-only), W (write-only), RW (read and writable).

R, W, RW

none

R

5

Polling Url

The URL which is used to retrieve the data point value. The server polls by HTTP GET requests to this URL. If empty, polling is not available.

string

none

empty

6

Polling interval

The polling interval in milliseconds.

50 – 65535

ms

5000

7

Polling Resource

The resource that is used for polling. It has to match the name that is used in the HTTP resource definition.

Reference to HTTP resource definition

none

empty

8

Polling Parameters

A comma-separated list of parameters that are used to replace the placeholders within the polling resource ({0}, {1}, ...).

string

none

empty

9

Update Url

The URL which is used to update the data point values. The server issues HTTP PUT, POST or GET requests to this URL. If empty, updating of the values is not possible.

string

none

empty

10

Update Method

The web update request method. 

POST, PUT, GET

none

POST

11

Update Resource

The resource that is used for updating. It has to match the name that is used in the HTTP resource definition.

Reference to HTTP resource definition

none

empty

12

Update Parameters

A comma-separated list of parameters that are used to replace the placeholders within the update resource ({0}, {1}, ...).

string

none

empty

13

Persistent

If enabled, the last known data point value is restored after server start up.

true/false

none

false

14

Synchronize 

If enabled, the value is synchronized with the backup server if used.

true/false

none

true

15

Authentication User

Username for Basic or Digest HTTP authentication if required by the HTTP server. If empty, no HTTP authentication is used.

string

none

empty

16

Authentication Password

Password for Basic or Digest HTTP authentication if required by the HTTP server. If empty, no HTTP authentication is used.

string

none

empty

17

Additional HTTP Headers

A list of additional HTTP headers which is included in each HTTP request, e.g. for authentication purposes. Additional headers must have the following form: "<key1>: <value1>\r\n<key2>: <value2>\r\n<key3>: <value3>..."

string

none

empty

18

Authentication Method

The authentication method if required by the HTTP server. BasicDirect directly sends the basic authentication hash without doing the initial authentication handshake. If Bearer is used, an Authentication Config is required.

None, Basic, BasicDirect, Digest, Bearer

none

None

19

Authentication Config

If bearer authentication is used, the bearer definition name must be specified here. It has to match the name that is used in the HTTP bearer authentication.

Reference to HTTP bearer authentication

none

empty

20

Polling Method

The web polling request method. 

POST, PUT, GET

none

GET

21

Polling Request Resource

IF PUT or POST is used as polling method, the resource that is used for polling must be defined here. It has to match the name that is used in the HTTP resource definition.

Reference to HTTP resource definition

none

empty

22

Polling Request Parameters

A comma-separated list of parameters that are used to replace the placeholders within the polling request resource ({0}, {1}, ...).

string

none

empty

Â