Gerenciando serviços web › Tratamento de erros do SOAP

Tratamento de erros do SOAP

Se ocorrer um erro com um método de serviços web, será retornada uma SOAP Fault. SOAP Fault é o meio padrão de retornar as informações de exceção para os serviços web.

A mensagem de Falha contém elementos <Message> e <Code> padronizados, mas o mais informativo é o elemento <Detail>. O elemento <Detail> contém elementos <ErrorCode> e <ErrorMessage>. O elemento <ErrorCode> retorna um código de erro enumerado específico do produto CA SDM ou Gerenciamento de conhecimento. O elemento <ErrorMessage> contém uma sequência de caracteres em inglês que descreve os erros. Os elementos <ErrorMessage> são mais adequados para ajudar o desenvolvedor, e mensagens mais apropriadas devem aparecer para os usuários.

Por exemplo, a seguir, há uma ilustração de uma SOAP Fault para quando um parâmetro incorreto for fornecido ao método getObjectValues() do CA SDM:

<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>

Se você estiver utilizando um cliente criado com o código gerenciado Microsoft .NET, uma chamada de método de serviços web com falha lançará uma exceção "SOAPException". Todos os erros cancelam a operação chamada.

Em alguns casos, o contêiner de servlet pode gravar erros e, portanto, exibir nos logs de contêiner de servlet. Em outros casos, informações de erros podem ser gravadas nos logs do CA SDM. Estes logs estão localizados nos seguintes subdiretórios:

• No subdiretório /bopcfg/www/CATALINA_BASE/logs da instalação do CA SDM
• No subdiretório /log da instalação do CA SDM e para todos os logs que tiverem o prefixo “stdlog”.

Observação: recomendamos monitorar constantemente esses logs, uma vez que o servidor pode registrar seus próprios erros sem relatá-los aos serviços web do CA SDM.