2 fault messages (soap layer), 3 error codes – Echelon i.LON SmartServer 2.0 User Manual

Page 22

Advertising
background image

i.LON SmartServer 2.0 Programmer’s Reference

2-8

<fault>

<faultcode

faultType="_error">6</faultcode>

<faultstring

xml:lang="en-US">Instance

doesn't

exist</faultstring>

</fault>
<UCPTname>Net/VirtCh/iLON

App</UCPTname>

</Item>
</iLonItem>
</SetResponse>

Example 3 (error occurs at the global level):

<SetResponse xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<UCPTfaultCount>1</UCPTfaultCount>
<fault>
<faultcode faultType="_error">3</faultcode>
<faultstring xml:lang="en-US">invalid xSelect expression</faultstring>
</fault>
</iLonItem>
</SetResponse>

Because the error occurs at the global level (the error does not occur with a specific item instance),
none of the items are processed.

2.5.3.2 Fault Messages (SOAP Layer)

The SOAP fault message is a standard way to report back unexpected SOAP behavior to the originator
of the message. This response message has a different format than the response message for a message
call that succeeds, and it adheres to a standard format for SOAP 1.1 fault messages. In Version 4.0, all
applications will stop processing when an error occurs. In addition, the applications will return with
the following message:

<?xml version="1.0" encoding="utf8" ?>
<SOAP-ENV:Envelope SOAP-ENV:encodingStyle=http://schemas.xmlsoap.org/soap/encoding/
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Body>
<SOAP-ENV:Fault>
<SOAP-ENV:faultcode>1</SOAP-ENV:faultcode>
<SOAP-ENV:faultstring>soap

fault</SOAP-ENV:faultstring>

<SOAP-ENV:detail>Details</<SOAP-ENV:detail>>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

2.5.3.3 Error Codes

The error codes used by the SmartServer applications are as follows:

Error Code

Error Description

Comment

0 No

Error

1

Unknown message call

2 Parameter

error

3 XML/Parser

Error

4 Tag

missing

5 <UCPT

name>

missing

6

<UCPT name> not found

7 <UCPT

name>

invalid

8

Can’t create

For example FB, Data point

9

Can’t delete

For example FB, Data point

10

Can’t set

For example FB, Data point

11 Format

Error

12 Command

failed

13

Given Data point has not the given Index

14

Data point Name not found

Advertising