错误处理

如果使用 Web Services 方法时出错,则返回 SOAP Fault。 SOAP Fault 是返回 Web Services 异常信息的标准方式。

Fault 消息包含标准化的 <Message> 和 <Code> 元素,但最具信息性的是 <Detail> 元素。 <Detail> 元素包含 <ErrorCode> 和 <ErrorMessage> 元素。 <ErrorCode> 元素返回特定于 CA Service Desk Manager 或 知识管理 产品的枚举错误代码。 <ErrorMessage> 包含一个描述错误的英文字符串。 <ErrorMessage> 元素更适合向开发者提供帮助,应该向用户显示更适当的信息。

例如,以下示例显示了向 CA Service Desk Manager 的 getObjectValues() 方法提供错误参数时生成的 SOAP Fault:

<soap:Fault>
<faultcode>soap:Client</faultcode> 
<faultstring>Error on fetch with attribute list:persistent_id,first_name,last_nameParamErrorHere<faultstring> 
<detail>
<ErrorCode>1001</ErrorCode> 
<ErrorMessage> Error on fetch with attribute list: persistent_id,first_name,last_nameParamErrorHere </ErrorMessage> 
</detail>
</soap:Fault>

如果您正在使用通过 Microsoft .NET 受控代码构建的客户端,则失败的 Web Services 方法调用会引发“SOAPException”异常! 所有错误将取消调用的操作。

在某些情况下,错误可能由 servlet 容器写入,因此将显示在 servlet 容器日志中。 在其他情况下,错误信息可能会写入 CA Service Desk Manager 日志中。 这些日志位于以下子目录:

注意:建议您持续监视这些日志,因为服务器可能记录它本身的错误而未将这些错误报告给 CA Service Desk Manager Web 服务。