When connection is established, JSON object restClientConfig is delivered in 200 OK response to the 'connect' method. This object defines behavior for all subsequent calls concerning error handling, parameters overwriting and set of transmitted fields forming. If restClientConfig was not delevered, default values are used.

The below table lists all fields of the restClientConfig object and how the WCS server interprets them.

Parameter

Description

Default value

clientExclude

The list of fields to exclude from sending to a client (comma separated)

empty

restExclude

The list of fields to exclude from sending to REST (comma separated)

empty

restOnError

Reaction to errors or 4xx statuses:

LOG

Just log

FAIL

React and send the error

LOG

restPolicy

Ability to redefine fields:

OVERWRITE, NOTIFY or DISABLE

OVERWRITE

Overwrite

NOTIFY

Do not overwrite

DISABLE

Do not send to REST

NOTIFY

restOverwrite

The list of fields to overwrite if the option restPolicy=OVERWRITE

(comma separated)

empty

This is restClientConfig example. This object contains only 'ConnectionStatusEvent' method. Other methods can be described same way:


"restClientConfig":
 {
         "ConnectionStatusEvent":
                 {
                         "restExclude":"",
                         "clientExclude":"",
                         "restOnError":"LOG",
                         "restPolicy":"NOTIFY",
                         "restOverwrite":""
                 }
 }

Example interpretation:

restClientConfig object can describe another calls configuration such as: call, OnCallEvent, CallStatusEvent, sendMessage, OnMessageEvent, MessageStatusEvent etc