Gestione di errori e avvisi (XMLA)

La gestione degli errori è necessaria quando una chiamata al metodo Discover o Execute di XML for Analysis (XMLA) non viene eseguita, viene eseguita correttamente, ma genera errori o avvisi oppure viene eseguita correttamente, ma restituisce risultati contenenti errori.

Errore Report
Chiamata al metodo XMLA non eseguita MicrosoftSQL Server Analysis Services restituisce un messaggio di errore SOAP contenente i dettagli dell'errore.

Per altre informazioni, vedere la sezione Gestione degli errori SOAP.
Errori o avvisi in una chiamata al metodo eseguita correttamente Analysis Servicesinclude rispettivamente un elemento error o warning per ogni errore o avviso nella proprietà Messages dell'elemento radice che contiene i risultati della chiamata al metodo.

Per altre informazioni, vedere la sezione Gestione di errori e avvisi.
Errori nel risultato di una chiamata al metodo eseguita correttamente Analysis Services include un elemento error o warning inline per l'errore o l'avviso, rispettivamente, all'interno dell'elemento Cell o row appropriato dei risultati della chiamata al metodo.

Per altre informazioni, vedere la sezione Gestione di errori e avvisi inline.

Gestione degli errori SOAP

Analysis Services restituisce un errore SOAP quando si verificano le situazioni seguenti:

  • Il messaggio SOAP che contiene il metodo XMLA non è in formato corretto o non è stato convalidato dall'istanza di Analysis Services.

  • Si è verificato un errore di comunicazione o di altro tipo relativo al messaggio SOAP che contiene il metodo XMLA.

  • Il metodo XMLA non è stato eseguito nell'istanza di Analysis Services.

Il codice di errore SOAP per XMLstartA inizia con "XMLForAnalysis", seguito da un punto e dal codice esadecimale restituito HRESULT. Un codice di errore "0x80000005" viene formattato come "XMLForAnalysis.0x80000005". Per ulteriori informazioni sul formato degli errori SOAP, vedere l'argomento relativo nel documento Simple Object Access Protocol (SOAP) 1.1 del World Wide Web Consortium (W3C).

Informazioni sul codice di errore

Nella tabella seguente vengono elencate le informazioni sul codice di errore XMLA contenute nella sezione dei dettagli della risposta SOAP. Le colonne rappresentano gli attributi di un errore nella sezione dei dettagli di un errore SOAP.

Nome colonna Type Descrizione Null consentito1
ErrorCode UnsignedInt Codice restituito che indica l'esito positivo o negativo del metodo. Il valore esadecimale deve essere convertito in un valore UnsignedInt. No
WarningCode UnsignedInt Codice restituito che indica una condizione di avviso. Il valore esadecimale deve essere convertito in un valore UnsignedInt.
Descrizione Stringa Testo o descrizione dell'errore o dell'avviso restituiti dal componente che ha generato l'errore.
Origine Stringa Nome del componente che ha generato l'errore o l'avviso.
Helpfile Stringa Percorso o URL del file o dell'argomento della Guida in cui è descritto l'errore o l'avviso.

1 Indica se i dati sono obbligatori e devono essere restituiti o se i dati sono facoltativi e se è consentita una stringa Null se la colonna non è applicabile.

Di seguito viene riportato un esempio di errore SOAP che si è verificato quando una chiamata al metodo non è riuscita:

<?xml version="1.0"?>  
   <SOAP-ENV:Envelope  
   xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"  
   SOAP-ENV:encodingStyle="http://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>  

Gestione di errori e avvisi

Analysis Services restituisce la proprietà Messages nell'elemento radice per un comando se si verificano le situazioni seguenti dopo l'esecuzione del comando:

  • Il metodo non ha provocato alcun errore, ma si è verificato un errore nell'istanza di Analysis Services dopo che la chiamata al metodo è stata eseguita correttamente.

  • L'istanza di Analysis Services restituisce un avviso quando il comando viene eseguito correttamente.

La proprietà Messages segue tutte le altre proprietà contenute nell'elemento radice e può contenere uno o più elementi Message. A sua volta, ogni elemento Message può contenere un singolo elemento error o warning che descrive rispettivamente eventuali errori o avvisi che si sono verificati per il comando specificato.

Per altre informazioni sugli errori e sugli avvisi contenuti nella proprietà Messages, vedere Elemento Messages (XMLA).

Gestione di errori durante la serializzazione

Se si verifica un errore dopo che l'istanza ha già iniziato la serializzazione dell'output di un comando eseguito correttamente, restituisce un elemento Exception in uno spazio dei nomi diverso al momento Analysis Services Analysis Services dell'errore. L'istanza Analysis Services chiude quindi tutti gli elementi aperti in modo che il documento XML inviato al client sia un valido. L'istanza restituisce anche un elemento Messages che contiene la descrizione dell'errore.

Gestione di errori e avvisi inline

Analysis Servicesrestituisce un errore inline o un avviso per un comando se il metodo XMLA non ha avuto esito negativo, ma un errore specifico di un elemento dati nei risultati restituiti dal metodo si è verificato nell'istanza dopo che la chiamata al metodo XMLA ha avuto Analysis Services esito positivo.

Analysis Servicesfornisce elementi di errore e avviso inline se si verificano problemi specifici di una cella o di altri dati contenuti in un elemento radice che usano il tipo di dati MDDataSet, ad esempio un errore di sicurezza o un errore di formattazione per una cella. In questi casi, restituisce un elemento error o warning nell'elemento Cell o row che contiene rispettivamente l'errore o Analysis Services l'avviso.

L'esempio seguente illustra un set di risultati che contiene un errore nel set di righe restituito da un metodo Execute usando il comando Statement.

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

Vedere anche

Sviluppo con XMLA in Analysis Services