Isom.Sys.ErrorHistory

 ISOM/L-Bibliothek für Serviceautoren: <br />Isom.Sys.ErrorHistory

ISOM/L-Bibliothek
für Serviceautoren

Version 9.10.1.0 vom 25 November 2013

Namensraum Isom.Sys.ErrorHistory

Beschreibung

Isom.Sys.ErrorHistory liefert Zugriff auf die Fehlergeschichte


Funktionen

Isom.Sys.ErrorHistory.CatchLastErrors

Ruft die Liste von Fehlern ab, die während der Ausführung der vorherigen Anweisung oder des vorherigen Blocks aufgetreten sind.

Isom.Sys.ErrorList Isom.Sys.ErrorHistory.CatchLastErrors  (  ) 

Ruft die Liste von Fehlern ab, die während der Ausführung der vorherigen Anweisung oder des vorherigen Blocks aufgetreten sind.

Die abgerufenen Fehler werden gelöscht, d.h. die abgerufenen Fehler können kein zweites Mal mit GetLastErrors() oder CatchLastErrors() abgerufen werden. Falls die abgerufenen Fehler nicht gelöscht werden sollen, muss die Funktion GetLastErrors() benutzt werden.

CatchLastErrors() löscht keine Einträge aus der Liste jemals aufgetretener Fehler, die mit GetAllErrors() abgerufen werden kann.

Die vorherige Anweisung, ebenso wie jede Anweisung in einem Block, kann dabei sowohl eine Funktion der ISOM-Fachbibliothek als auch eine Hilfsfunktionen, die in ISOM/L definiert ist, sein.

Reine Variablendeklarationen werden ignoriert. Ist der Aufruf von CatchLastErrors() der erste innerhalb eines Blocks, so bezieht sich die Abfrage auf

  • die Bedingung innerhalb der übergeordneten if-Anweisung
  • die Bedingung innerhalb der übergeordneten while-Anweisung
  • das Muster innerhalb der übergeordneten switch-Anweisung 

   using Isom.Context.*; 
   using Isom.Sys.*; 
   ... 

   Boolean ShowCatchLastErrorsUsage() 
   { 
     // Abfragen und Löschen aller Fehler, die bei der Ausführung von 
     // anEcu.Identify().Failed() auftreten 
     if (anEcu.Identify().Failed()) 
     { 
       ErrorList errors = ErrorHistory.CatchLastErrors(); 
       ... 
     } 
     ... 
     ... 
     // stattdessen kann auch die unten definierte ISOM/L-Hilfsfunktion aufgerufen werden 
     if (HelperIdentifyEcu(enEcu).Failed()) 
     { 
       // enthält alle Fehler, die während der Ausführung von HelperIdentifyEcu(ecu).Failed() 
       // aufgetreten sind und die noch nicht mittels CatchLastErrors() bereits innerhalb 
       // von HelperIdentifyEcu(enEcu) abgefragt wurden 
       ErrorList errors = ErrorHistory.CatchLastErrors(); 
     } 

     // auch syntakisch möglich: 
     if (anEcu.Identify().Failed().Not()) 
     { 
       ... 
     } 
     else 
     { 
       ErrorList errors = ErrorHistory.CatchLastErrors(); 
       ... 
     } 
   } 

   Boolean HelperIdentifyEcu(Ecu ecu) 
   { 
     if (ecu.Identify().Failed()) 
     { 
       // enthält alle Fehler, die bei der Ausführung von ecu.Identify().Failed() 
       // aufgetreten sind 
       ErrorList errors = ErrorHistory.CatchLastErrors(); 

       // Versuche erneut, z.B. mit EDIABAS-Jobs 
       { 
         // Stattdessen könnten auch weitere ISOM/L-Hilfsfunktionen benutzt werden 
         EdiabasResultSetList results1 = Ediabas.CallEdiabas(...); 
         EdiabasResultSetList results2 = Ediabas.CallEdiabas(...); 
       } 

       // Abfrage aller Fehler, die während der Ausführung des vorherigen Blocks 
       // von Ediabas-Aufrufen aufgetreten sind 
       ErrorList ediabasErrors = ErrorHistory.CatchLastErrors(); 

       // Bewerte zweiten Versuch 
       ... 
       return secondAttemptSuccessul; 
     } 

     return true; 
   }
Rückgabe:
Liste der aufgetretenen Fehler.
Isom.Sys.ErrorHistory.Clear

Löscht die gesamte Fehlergeschichte.

Isom.Base.Boolean Isom.Sys.ErrorHistory.Clear  (  ) 

Löscht die gesamte Fehlergeschichte.

Rückgabe:
Immer 'true'.
Isom.Sys.ErrorHistory.GetAllErrors

Ruft die Liste von Fehlern ab, die seit dem letzten Aufruf von Clear() registriert wurden.

Isom.Sys.ErrorList Isom.Sys.ErrorHistory.GetAllErrors  (  ) 

Ruft die Liste von Fehlern ab, die seit dem letzten Aufruf von Clear() registriert wurden.

Rückgabe:
die gesamte Fehlergeschichte.
Isom.Sys.ErrorHistory.GetLastErrors

Ruft die Liste von Fehlern ab, die während der Ausführung der vorherigen Anweisung oder des vorherigen Blocks aufgetreten sind.

Isom.Sys.ErrorList Isom.Sys.ErrorHistory.GetLastErrors  (  ) 

Ruft die Liste von Fehlern ab, die während der Ausführung der vorherigen Anweisung oder des vorherigen Blocks aufgetreten sind.

Die abgerufenen Fehler werden nicht gelöscht. Weitere Aufrufe von GetLastErrors() oder CatchLastErrors() können die abgerufenen Fehler erneut liefern. Wenn die Fehler gelöscht werden sollen, muss CatchLastErrors() benutzt werden.

Die vorherige Anweisung, ebenso wie jede Anweisung in einem Block, kann dabei sowohl eine Funktion der ISOM-Fachbibliothek als auch eine Hilfsfunktionen, die in ISOM/L definiert ist, sein.

Reine Variablendeklarationen werden ignoriert. Ist der Aufruf von GetLastErrors() der erste innerhalb eines Blocks, so bezieht sich die Abfrage auf

  • die Bedingung innerhalb der übergeordneten if-Anweisung
  • die Bedingung innerhalb der übergeordneten while-Anweisung
  • das Muster innerhalb der übergeordneten switch-Anweisung 

   using Isom.Context.*; 
   using Isom.Sys.*; 
   ... 

   Boolean ShowGetLastErrorsUsage() 
   { 
     // Abfrage aller Fehler, die bei der Ausführung von anEcu.Identify().Failed() auftreten 
     if (anEcu.Identify().Failed()) 
     { 
       ErrorList errors = ErrorHistory.GetLastErrors(); 
       ... 
     } 
     ... 
     // stattdessen kann auch die unten definierte ISOM/L-Hilfsfunktion aufgerufen werden 
     if (HelperIdentifyEcu(enEcu).Failed()) 
     { 
       // enthält alle Fehler, die während der Ausführung von HelperIdentifyEcu(ecu).Failed() 
       // aufgetreten sind 
       ErrorList errors = ErrorHistory.GetLastErrors(); 
     } 

     // auch syntakisch möglich: 
     if (anEcu.Identify().Failed().Not()) 
     { 
       ... 
     } 
     else 
     { 
       ErrorList errors = ErrorHistory.GetLastErrors(); 
       ... 
     } 
   } 

   Boolean HelperIdentifyEcu(Ecu ecu) 
   { 
     if (ecu.Identify().Failed()) 
     { 
       // enthält alle Fehler, die bei der Ausführung von ecu.Identify().Failed() 
       // aufgetreten sind 
       ErrorList errors = ErrorHistory.GetLastErrors(); 

       // Versuche erneut, z.B. mit EDIABAS-Jobs 
       { 
         // Stattdessen könnten auch weitere ISOM/L-Hilfsfunktionen benutzt werden 
         EdiabasResultSetList results1 = Ediabas.CallEdiabas(...); 
         EdiabasResultSetList results2 = Ediabas.CallEdiabas(...); 
       } 

       // Abfrage aller Fehler, die während der Ausführung des vorherigen Blocks 
       // von Ediabas-Aufrufen aufgetreten sind 
       ErrorList ediabasErrors = ErrorHistory.GetLastErrors(); 

       // Bewerte zweiten Versuch 
       ... 
       return secondAttemptSuccessul; 
     } 

     return true; 
   }
Rückgabe:
Liste der aufgetretenen Fehler.

Version 9.10.1.0 vom 25 November 2013