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 | ||||||
restPolicy | Ability to redefine fields: OVERWRITE, NOTIFY or DISABLE
| 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