Argomento precedente: Sicurezza dei servizi WebArgomento successivo: Errori di blocco


Gestione degli errori in SOAP

Se si verifica un errore nell'utilizzo di un metodo dei servizi Web, viene restituito un errore SOAP. L'errore SOAP è il metodo standard per la restituzione delle informazioni di eccezione per i servizi Web.

Il messaggio di errore contiene gli elementi standardizzati <Message> e <Code> ma quello che fornisce le maggiori informazioni è l'elemento <Detail>. L'elemento <Detail> contiene a sua volta gli elementi <ErrorCode> e <ErrorMessage>. L'elemento <ErrorCode> restituisce un codice di errore numerale specifico del prodotto CA SDM o Gestione della conoscenza. L'elemento <ErrorMessage> contiene una stringa in lingua inglese che descrive gli errori. Gli elementi <ErrorMessage> aiutano i sviluppatori nelle loro attività e gli utenti con messaggi sempre adeguati.

Ad esempio, di seguito viene illustrato un errore SOAP quando al metodo getObjectValues() di CA SDM viene passato un parametro non valido:

<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> Errore caricamento con elenco attributi: persistent_id,first_name,last_nameParamErrorHere </ErrorMessage> 
</detail>
</soap:Fault>

Se si utilizza un client creato con il codice gestito di Microsoft .NET, una chiamata non valida al metodo dei servizi Web genera un'eccezione "SOAPException". Tutti gli errori annullano l'operazione richiamata.

In alcuni casi, gli errori possono essere scritti dall'esecutore di servlet e pertanto visualizzati nei registri di tale esecutore. In altri casi, le informazioni sugli errori vengono scritte nei registri CA SDM. Questi registri si trovano nelle sottodirectory seguenti:

Nota: si consiglia di monitorare costantemente questi registri poiché il server potrebbe registrare gli errori senza comunicarlo ai servizi Web CA SDM.