Gestion des erreurs et des avertissements (XMLA)

Gestion des erreurs SOAP

Analysis Services retourne une erreur SOAP lorsque les situations suivantes se présentent :

• le message SOAP qui contient la méthode XMLA n'était pas correctement formé ou n'a pas pu être validé par l'instance Analysis Services ;

• une communication ou une autre erreur s'est produite impliquant le message SOAP qui contient la méthode XMLA ;

• la méthode XMLA ne s'est pas exécutée sur l'instance Analysis Services.

Les codes d'erreur SOAP pour XMLstartA commencent par « XMLForAnalysis », suivis d'un point et du code de résultat hexadécimal HRESULT. Par exemple, le code d'erreur « 0x80000005 » prend la forme « XMLForAnalysis.0x80000005 ». Pour plus d'informations sur le format d'erreur SOAP, consultez la rubrique consacrée aux erreurs Soap dans le document « Simple Object Access Protocol (SOAP) 1.1 » du W3C (en anglais).

Informations de code d'erreur

<?xml version="1.0"?>
   <SOAP-ENV:Envelope
   xmlns:SOAP-ENV="https://schemas.xmlsoap.org/soap/envelope/"
   SOAP-ENV:encodingStyle="https://schemas.xmlsoap.org/soap/encoding/">
      <SOAP-ENV:Fault>
         <faultcode>XMLAnalysisError.0x80000005</faultcode>
         <faultstring>The XML for Analysis provider encountered an error.</faultstring>
         <faultactor>XML for Analysis Provider</faultactor>
         <detail>
<Error
ErrorCode="2147483653"
Description="An unexpected error has occurred."
Source="XML for Analysis Provider"
HelpFile="" />
         </detail>
      </SOAP-ENV:Fault>
</SOAP-ENV:Envelope>

Gestion des erreurs et des avertissements

Analysis Services retourne la propriété Messages dans l'élément root d'une commande si les situations suivantes se présentent à la suite de l'exécution de cette commande :

• la méthode proprement dite n'a pas échoué, mais un échec s'est produit dans l'instance Analysis Services après que l'appel de méthode a abouti ;

• l'instance Analysis Services retourne un avertissement lorsque la commande aboutit.

La propriété Messages suit toutes les autres propriétés contenues dans l'élément root et peut contenir un ou plusieurs éléments Message. De leur côté, les éléments Message peut chacun contenir un élément error ou warning décrivant, respectivement, les erreurs ou les avertissements qui se sont produits pour la commande spécifiée.

Pour plus d'informations sur les erreurs et les avertissements contenus dans la propriété Messages, consultez Élément Messages (XMLA).

Gestion des erreurs pendant la sérialisation

Gestion des erreurs et des avertissements insérés

Analysis Services retourne un élément inséré error ou warning pour une commande si la méthode XMLA proprement dite n'a pas échoué, mais qu'une erreur spécifique à un élément de données contenu dans les résultats retournés par la méthode s'est produite dans l'instance Analysis Services après que l'appel de méthode XMLA a abouti.

Analysis Services fournit des éléments insérés error et warning si des problèmes spécifiques à une cellule ou à d'autres données contenues dans un élément root utilisant le type de données MDDataSet se sont produits, tels qu'une erreur de sécurité ou une erreur de mise en forme pour une cellule. Dans ces cas, Analysis Services retourne un élément error ou warning dans l'élément Cell ou row qui contient, respectivement, l'erreur ou l'avertissement.

L'exemple suivant illustre un jeu de résultats qui contient une erreur dans l'ensemble de lignes retourné par une méthode Execute utilisant la commande Statement.

<return>
   ...
   <root>
      ...
      <CellData>
      ...
         <Cell CellOrdinal="10">
            <Value>
               <Error>
                  <ErrorCode>2148497527</ErrorCode> 
                  <Description>Security Error.</Description> 
               </Error>
            </Value>
         </Cell>
      </CellData>
      ...
   </root>
   ...
</return>

Voir aussi

Référence

Concepts