1. Oracle Web Services On Demand Troubleshooting Guide
  2. What's New In This Release

2Overview of Error Code Information

Overview of Error Code Information

This chapter provides information on the structure and content of error codes. It includes the following topics:

About Web Services On Demand Troubleshooting Guide

Oracle Web Services On Demand Guide Troubleshooting Guide describes possible causes and provides solutions to errors that can occur when using Oracle CRM On Demand Web services. When processing various Web service requests in Oracle CRM On Demand, it is possible that errors might be returned. The errors listed in this guide include common errors that might occur when using Oracle CRM On Demand Web services. This list is not exhaustive, and it does not cover all existing Oracle CRM On Demand Web services errors. The errors and error codes provided in this document are subject to change. This guide specifically discusses certain causes and solutions, however, not all possible causes and solutions are described within this guide.

Format of Error Codes

An error code returned by Oracle CRM On Demand has the following format:

SBL-MessageFacility-ErrorNumber

where:

  • MessageFacility represents the message facility that is returning the error. A message facility is the area in Oracle CRM On Demand Web services where the error occurs.

  • ErrorNumber is an integer between 1 and 49,999 that identifies the error. For example: 04127.

The SOAP fault element returned in the SOAP response contains the child elements shown in the following table according to the specification for World Wide Web Consortium (W3C) SOAP version 1.1. For sample SOAP responses, see SOAP Fault Response <ErrorCode> and <Error Message> Elements and SOAP Fault Response Containing the <siebelf:siebdetail> Element.

Table Child Elements of the <soap:Fault> Element

Element Description

<faultcode>

A code for identifying the fault, for example, whether the fault was caused by an error on the server side or client side.

<faultstring>

An explanation of the fault.

<detail>

Application-specific error details. This element contains different child elements depending on the level of details available for the error. It has one of the following:

  • The <ErrorCode> and <ErrorMessage> child elements

  • The <siebelf:siebdetail> element

The following table describes the child elements of the <detail> element with <ErrorCode> and <ErrorMessage> subelements.

Table Child Elements of the <detail> Element with <ErrorCode> and <Error Message> subelements

Element Description

<ErrorCode>

The error code, which follows the Oracle CRM On Demand error-code format.

<ErrorMessage>

The text of the error message.

    SOAP Fault Response <ErrorCode> and <Error Message> Elements

    The following is an example of a SOAP fault response containing <ErrorCode> and <ErrorMessage> elements:

    <?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <soap:Fault>
         <faultcode>soap:Server</faultcode>
         <faultstring>Server</faultstring>
         <detail>
            <ErrorCode>SBL-ODU-01006</ErrorCode>
            <ErrorMessage>The server is temporarily unavailable. Please try again later.</ErrorMessage>
         </detail>
      </soap:Fault>
   </soap:Body>
</soap:Envelope>

    The <siebelf:siebdetail> element is returned in the <detail> element of the SOAP fault and contains the log file name and the error stack elements, as described in the following table.

    Table Child Elements of the <siebelf:siebdetail> Element

    Element Description

    <siebelf:logfilename>

    The log file on the server where the error is logged.

    <siebelf:errorstack>

    The error stack, containing one or more <error> child elements. It represents the chain of errors that occurred.

    <siebelf:error>

    The specific error information that is contained in the following child elements: <errorcode>, <errorsymbol> and <errormsg>.

    <siebelf:errorcode>

    The error code for the error, which follows Oracle CRM On Demand error-code format.

    <siebelf:errorsymbol>

    The language-independent identifier for an error message.

    <siebelf:errormsg>

    The text of the error message.

      SOAP Fault Response Containing the <siebelf:siebdetail> Element

      The following is an example of a SOAP Fault Response containing the <siebelf:siebdetail> element:

      <?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>Error while processing argument urn:crmondemand/ws/ecbs/contact/:ListOfContact for operation ContactInsert(SBL-EAI-04316)</faultstring>
         <detail>
            <siebelf:siebdetail xmlns:siebelf="http://www.siebel.com/ws/fault">
               <siebelf:logfilename>siebel.log</siebelf:logfilename>
               <siebelf:errorstack>
                  <siebelf:error>
                     <siebelf:errorcode>(SBL-EAI-04316)</siebelf:errorcode>
                     <siebelf:errorsymbol />
                     <siebelf:errormsg>Error while processing argument urn:crmondemand/ws/ecbs/contact/:ListOfContact for operation ContactInsert(SBL-EAI-04316)</siebelf:errormsg>
                  </siebelf:error>
                  <siebelf:error>
                     <siebelf:errorcode>(SBL-EAI-04127)</siebelf:errorcode>
                     <siebelf:errorsymbol> IDS_EAI_ERR_INTOBJHIER_ELEM_UNKN</siebelf:errorsymbol>
                      <siebelf:errormsg> Element with XML tag 'ContactFirstNamee' is not found in the definition of EAI Integration Component 'Contact'(SBL-EAI-04127)</siebelf:errormsg>
                  </siebelf:error>
               </siebelf:errorstack>
            </siebelf:siebdetail>
         </detail>
      </SOAP-ENV:Fault>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

        Error Information

        The errors in this guide are arranged alphabetically and by error code. You can retrieve the error code from the SOAP fault of the SOAP response. For more information, see the previous table.

        The following information is provided for each error code:

        • An error symbol if applicable. For more information on error symbols, see Format of Error Codes.

        • The generic error message.

        • Possible causes and solutions with examples.

          • A specific error message. It shows the wording that is returned by the sample, invalid SOAP request.

          • An incorrect SOAP request if applicable.

          • The SOAP request corrected according to the provided solution.

        Resolving Problems in Oracle CRM On Demand Web Services

        This topic describes how to resolve problems that you can encounter when using Oracle CRM On Demand Web services.

        To resolve problems

        1. Identify the error code.

        2. Find and review the possible causes of the error code in this guide.

          For information, see Error Codes: Causes and Solutions

        3. Modify the SOAP request by implementing the suggested solution.