Veatöötlus
In English |
SOAP veateade
Kui serveris tekib päringu töötlemisel veaolukord (Exception), siis tagastab Krediidiinfo SOAP server alati SOAP veateate (Fault Element).
SOAP veateate näidis:
<?xml version="1.0" encoding="UTF-8"?> <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"> <SOAP-ENV:Body> <SOAP-ENV:Fault> <faultcode>SOAP-ENV:Server</faultcode> <faultstring>certificate not found</faultstring> <faultactor/> <detail> <errorcode>-10011</errorcode> <line_no>33</line_no> </detail> </SOAP-ENV:Fault> </SOAP-ENV:Body> </SOAP-ENV:Envelope>
Kasutaja teavitamine vigadest
Märgendis faultstring on veateade inimesele loetaval kujul ning märgendis detail/errorcode on veakood.
Kui SOAP veateates on olemas detail/errorcode siis tekkis viga Krediidiinfo serveris. Kui detail/errorcode puudub, siis on enamasti tegemist Krediidiinfo serverist mittesõltuvates põhjustes.
Kui SOAP veateade on saadetud Krediidiinfo serveri poolt, siis tuleb lõppkasutajale alati kuvada nii veakood (errorcode) kui ka -teade (faultstring)!
Soovitav on kuvada teade järgmiselt:
Krediidiinfo AS veebiteenuse (<nimi>) päring ebaõnnestus! [errorcode] faultstring Abi saamiseks võtke ühendust Krediidiinfoga telefonil 6659600.
<nimi> asemele panna veebiteenuse nimetus (KiDocExchange, KiReport vms). Enamasti on need vea põhjused Krediidiinfo poolt lahendatavad (näiteks puuduvad õigused mingi päringu tegemiseks vms).