Funzioni spss.GetLastErrorLevel e spss.GetLastErrorMessage (Python)

spss.GetLastErrorLevel( ). Restituisce un numero corrispondente a un errore nella precedente funzione di Python Integration Package for IBM® SPSS® Statistics.

  • Per la funzione spss.Submit , restituisce il livello massimo di errore IBM SPSS Statistics per la sintassi del comando inoltrato. IBM SPSS Statistics I livelli di errore sono compresi tra 1 e 5. Un livello di errore 3 o superiore causa un'eccezione in Python.
  • Per altre funzioni, restituisce un codice di errore con un valore maggiore di 5.
  • I codici di errore da 6 a 99 provengono dall'API XD IBM SPSS Statistics .
  • I codici di errore da 1000 a 1064 provengono dal pacchetto di integrazione Python .

IBM SPSS Statistics livelli di errore (codici di ritorno), relativi significati e comportamenti associati sono riportati nella seguente tabella.

Tabella 1. IBM SPSS Statistics livelli di errore
Valore Definizione Comportamento
0 Nessuna Esecuzioni di comandi
1 Commento Esecuzioni di comandi
2 Avvertenza Esecuzioni di comandi
3 Errore grave Il comando non viene eseguito, vengono elaborati i comandi successivi
4 Errore irreversibile Il comando non viene eseguito, i comandi successivi non vengono elaborati e il processo corrente termina
5 Errore catastrofico Il comando non viene eseguito, i comandi successivi non vengono elaborati e il processore IBM SPSS Statistics termina

spss.GetLastErrorMessage( ). Restituisce un messaggio di testo corrispondente a un errore nella precedente funzione del pacchetto di integrazione Python per IBM SPSS Statistics.

  • Per la funzione spss.Submit , restituisce il testo associato all'errore di livello più alto per la sintassi del comando inoltrato.
  • Per altre funzioni nel pacchetto di integrazione Python , restituisce il testo del messaggio di errore dall'API XD di IBM SPSS Statistics o da Python.

Esempio

DATA LIST FREE/var1 var2.
BEGIN DATA
1 2 3 4
END DATA.
BEGIN PROGRAM.
try:
  spss.Submit("""
COMPUTE newvar=var1*10.
COMPUTE badvar=nonvar/4.
FREQUENCIES VARIABLES=ALL.
""")
except:
  errorLevel=str(spss.GetLastErrorLevel())
  errorMsg=spss.GetLastErrorMessage()
  print("Error level " + errorLevel + ": " + errorMsg)
  print("At least one command did not run.")
END PROGRAM.
  • Il primo comando COMPUTE e il comando FREQUENCIES verranno eseguiti senza errori, generando i valori di errore 0.
  • Il secondo comando COMPUTE genererà un errore di livello 3, attivando la gestione dell'eccezione nella clausola except .