Skip to end of metadata
Go to start of metadata

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:

  • These options are defined for ConnectionStatusEvent method: restExclude, clientExclude, restOnError, restPolicy, restOverwrite.
  • When the method is called, all fields will be delivered to the web server because restExclude="".
  • When the method is called, all fields will be delivered to the client because clientExclude="".
  • If error occures when accessing to the web server, this error will be logged but will not be delivered to the client. In this case, the client receives normal ConnectionStatusEvent event.
  • Even if the web server returns new parameters, these parameters will not be overwritten because restPolicy="NOTIFY".
  • restOverwrite field will not work because restPolicy="NOTIFY".

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