Führt einen manuellen Planabbruch durch.

Diese Rückruffunktion wird von ISOM beim manuellen Abbruch einer Sitzung aufgerufen. In der Funktion können vom Serviceautor Arbeiten angewiesen werden, die zum korrekten Abschluss des abgebrochenen Plans nötig sind.

Dieser Einsprungspunkt kann in Phase 10 des Phasenmodells aufgerufen werden.

  Isom.Base.Boolean AbortActionPlan() 
  { 
      Isom.Plan.TherapyPlan tp = Isom.Plan.TherapyPlan.GetInstance (); 
      Isom.Plan.ActionPlan ap = Isom.Plan.ActionPlan.GetInstance (tp); 

      // Beenden signalisieren 
      Isom.Base.Boolean success = ap.TryAbort (10000); 

      // Falls das Signalisieren erfolgreich war, Planabbruch erzwingen 
      if( success ) 
      { 
          success = aPlan.ForceAbort (); 
      } 

      return success; 
  } 

Zu beachten:

Die Funktion wird im Prozesszustand "StateActionPlanPerforming" aufgerufen, um eine Planausführung vorzeitig abzubrechen.

Sinnvolle Spezialisierungsebenen

OEM, Fahrzeuggeneration, Baureihe

Rückgabe:

Isom.Base.Boolean
Rückgabewert wird nicht ausgewertet.

Datum:

letzte Änderung am 05.05.2010

Fügt eine Aktion zum Therapieplan hinzu.

Fügt dem Therapieplan die übergebene Aktion action hinzu.

Dieser Einsprungspunkt wird in Phase 7 des Phasenmodells aufgerufen.

  Isom.Base.Boolean AddActionManually( Isom.Plan.TherapyPlanAction action ) 
  { 
      Isom.Plan.TherapyPlan tp = Isom.Plan.TherapyPlan.GetInstance(); 

      // Aktion hinzufügen 
      Isom.Base.Boolean success = tp.Add( action ); 
      return success; 
  } 

Nachbedingung:

Wenn diese Funktion true zurückgibt, enthält der Therapieplan die übergebene Aktion action.

Zu beachten:

Die Funktion wird im Phasenmodell im Zustand "StateTherapyPlanCreated" aufgerufen, um dem Therapieplan eine Aktion hinzuzufügen.

Sinnvolle Spezialisierungsebenen

alle

Rückgabe:

Isom.Base.Boolean
true im Erfolgsfall,
false im Fehlerfall.

Datum:

letzte Änderung am 05.05.2010

Berechnet den finalen Therapieplan.

Ziel dieses Einsprungspunkts ist es, von der Logistik einen finalen Therapieplan ermitteln zu lassen, in dem der native Therapieplan mit den manuell hinzugefügten Aktionen zusammengeführt wird.

Dieser Einsprungspunkt wird in Phase 8 des Phasenmodells aufgerufen.

  Isom.Base.Boolean CalculateFinalPlan() 
  { 
      Isom.Context.FutureVehicleContext futureContext = Isom.Context.FutureVehicleContext.GetInstance (); 

      // Neuen Soll-Kontext mit manuellen Erweiterungen an die Logistik übergeben: 
      if (futureContext.CalcFinalFutureContext().Failed()) 
      { 
          return false; 
      } 

      // Füge dem Therapieplan eine Aktion hinzu: 
      Isom.Plan.TherapyPlan tp = Isom.Plan.TherapyPlan.GetInstance(); 
      Isom.Plan.TherapyPlanAction action = tp.CreateAction("FinalContext"); 
      if(tp.Add( action )) 
      { 
          return false; 
      } 

      return true; 
  } 

  Isom.Base.Boolean FilterFinalContext() 
  { 
      // Therapieplan für den neuen Soll-Kontext von Einsprungspunkt erzeugen lassen: 
      return GeneratePlan(); 
  } 

Nachbedingung:

Wenn diese Funktion true zurückgibt, ist ein gültiger Therapieplan vorhanden.

Zu beachten:

Die Funktion wird im Phasenmodell aufgerufen, um ISOM vom Zustand "StateTherapyPlanCreated" in den Zustand "StateTherapyPlanCompleted" zu überführen.

Sinnvolle Spezialisierungsebenen

OEM, Fahrzeuggeneration, Baureihe

Rückgabe:

Isom.Base.Boolean
true im Erfolgsfall,
false im Fehlerfall.

Datum:

letzte Änderung am 05.05.2010

Prüfung des Fahrzeugzugangs.

Dieser Einsprungspunkt wird zu Beginn der Phase 2 des Phasenmodells aufgerufen. Der Serviceautor hat hier die Möglichkeit, notwendige Eigenschaften des Fahrzeugzugangs zu überprüfen.

  Isom.Base.Boolean CheckAccess( ) 
  { 
      return true; 
  } 

Zu beachten:

Die Funktion wird im Phasenmodell im Zustand "StateConfigKnown" vor der Ermittlung der Steuergeräteliste mit UpdateCurrentContextVehicleData() aufgerufen

Sinnvolle Spezialisierungsebenen

OEM, Fahrzeuggeneration, Baureihe

Rückgabe:

Isom.Base.Boolean
true im Erfolgsfall,
false im Fehlerfall.

Datum:

letzte Änderung am 05.05.2010

Prüft, ob eine gespeicherte Sitzung vorhanden ist.

Es wird geprüft, ob eine gespeicherte Sitzung vorhanden ist, und ggf. wird sie wiederaufgenommen.

Dieser Einsprungspunkt wird in Phase 3 des Phasenmodells aufgerufen. Je nach Rückgabewert erfolgt der Wechsel zu zu Phase 4 (false) oder Phase 10 (true).

  Isom.Base.Boolean CheckForPreservedSession( ) 
  { 
      // Überprüfung, ob es eine gespeicherte Sitzung gibt 
      Isom.Base.Boolean result = Isom.Plan.ActionPlan.PreservedSessionExists (); 

      if (result) 
      { 
          // Versuch, gespeicherte Sitzung wiederaufzunehmen 
          result = ActionPlan.ResumePreservedSession(); 
      } 

      return result; 
  } 

Zu beachten:

Die Funktion wird im Phasenmodell im Zustand "StateVehicleDataKnown" aufgerufen.

Sinnvolle Spezialisierungsebenen

OEM

Rückgabe:

Isom.Base.Boolean
true wenn eine Sitzung wiederaufgenommen wurde.

Datum:

letzte Änderung am 05.05.2010

Schließt die Therapieplanermittlung ab.

Veraltet:

Veraltet seit Argonaut 1.5. Dieser Einsprungspunkt wird nur aus Gründen der Rückwärtskompatibilität unterstützt. Die Planvervollständigung sollte stattdessen in CalculateFinalPlan() erfolgen.

Zu beachten:

Die Funktion wird im Prozesszustand "StateTherapyPlanCompleted" aufgerufen.

Sinnvolle Spezialisierungsebenen

OEM, Fahrzeuggeneration, Baureihe

Rückgabe:

Isom.Base.Boolean
true im Erfolgsfall,
false im Fehlerfall.

Datum:

letzte Änderung am 05.05.2010

Ermittlung der Baureihe.

Dieser Einsprungspunkt wird zu Beginn der Phase 1 des Phasenmodells aufgerufen. Der Serviceautor hat hier die Möglichkeit, die Baureihenerkennung zu beeinflussen.

  Isom.Base.Boolean ContextIdent( ) 
  { 
      // Baureihengruppe aus Konfiguration holen 
      Isom.Context.ContextConfiguration config = Isom.Context.ContextConfiguration.GetInstance(); 
      Isom.Base.String modelSeriesGroup = config.GetModelSeriesGroup(); 

      if( modelSeriesGroup.Equals( "" ).Not().And( modelSeriesGroup.Equals( "Base" ).Not()) ) 
      { 
          // Baureihengruppe wurde extern vorgegeben - protokollieren 
      } 
      else 
      { 
          // Assistenten zur Baureihenauswahl ausführen 
      } 

      return true; 
  } 

Nachbedingung:

Wenn diese Funktion true zurückgibt, muss die Baureihe des Fahrzeugs im Ist-Kontext bekannt sein.

Zu beachten:

Die Funktion wird im Phasenmodell aufgerufen, um ISOM vom Zustand "StateConfigUnknown" in den Zustand "StateConfigKnown" zu überführen.

Sinnvolle Spezialisierungsebenen

OEM

Rückgabe:

Isom.Base.Boolean
true im Erfolgsfall,
false im Fehlerfall.

Datum:

letzte Änderung am 05.05.2010

Entfernt den finalen Therapieplan.

Entfernt den in CalculateFinalPlan() erstellten finalen Therapieplan wieder.

Dieser Einsprungspunkt kann in Phase 8 des Phasenmodells aufgerufen werden, um wieder in Phase 7 zurückzukehren.

  Isom.Base.Boolean DeleteFinalPlan() 
  { 
      // Entfernt die Aktion "FinalContext" aus dem Therapieplan: 
      Isom.Plan.TherapyPlan tp = Isom.Plan.TherapyPlan.GetInstance (); 
      if (tp.Remove (tp.CreateAction ("FinalContext")).Failed ()) 
      { 
          // ggf. protokollieren, dass kein finaler Therapieplan gefunden wurde 
      } 

      // immer @c true zurückgeben 
      return true; 
  } 

Zu beachten:

Die Funktion wird im Phasenmodell aufgerufen, um ISOM vom Zustand "StateTherapyPlanCompleted" in den Zustand "StateTherapyPlanCreated" zu überführen.

Sinnvolle Spezialisierungsebenen

OEM, Fahrzeuggeneration, Baureihe

Rückgabe:

Isom.Base.Boolean
true im Erfolgsfall,
false im Fehlerfall.

Datum:

letzte Änderung am 05.05.2010

Therapiefunktionen für die Codierung.

In dieser Funktion implementiert der Serviceautor die Aktion Code unter Berücksichtigung aller fachlicher Aspekte.

  Isom.Base.Boolean DoCode (Isom.Plan.TherapyPlanAction action) 
  { 
      Isom.Context.Ecu ecu = action.GetEcu(); 

      Isom.Base.Boolean success = ecu.CodeWithDefaults(); 
      return success; 
  } 

Sinnvolle Spezialisierungsebenen

alle

Parameter:

action

Therapieplanaktion.

Rückgabe:

Isom.Base.Boolean
true im Erfolgsfall,
false im Fehlerfall.

Datum:

letzte Änderung am 05.05.2010

Therapiefunktionen für die Programmierung.

In dieser Funktion implementiert der Serviceautor die Aktion Flash unter Berücksichtigung aller fachlicher Aspekte.

  Isom.Base.Boolean DoFlash (Isom.Plan.TherapyPlanAction action) 
  { 
      Isom.Context.Ecu ecu = action.GetEcu(); 

      Isom.Base.Boolean success = ecu.FlashComfort(); 
      if(success.Failed()) 
      { 
          // Maßnahmensteigerung 
          success = ecu.FlashForced(); 
      } 

      return success; 
  } 

Sinnvolle Spezialisierungsebenen

alle

Parameter:

action

Therapieplanaktion.

Rückgabe:

Isom.Base.Boolean
true im Erfolgsfall,
false im Fehlerfall.

Datum:

letzte Änderung am 05.05.2010

Therapiefunktionen für den Einbau.

In dieser Funktion implementiert der Serviceautor die Aktion Mount unter Berücksichtigung aller fachlicher Aspekte.

  Isom.Base.Boolean DoMount (Isom.Plan.TherapyPlanAction action) 
  { 
      return true; 
  } 

Sinnvolle Spezialisierungsebenen

alle

Parameter:

action

Therapieplanaktion.

Rückgabe:

Isom.Base.Boolean
true im Erfolgsfall,
false im Fehlerfall.

Datum:

letzte Änderung am 05.05.2010

Therapiefunktionen für den Tausch.

In dieser Funktion implementiert der Serviceautor die Aktion Replace unter Berücksichtigung aller fachlicher Aspekte.

  Isom.Base.Boolean DoReplace (Isom.Plan.TherapyPlanAction action) 
  { 
      return true; 
  } 

Sinnvolle Spezialisierungsebenen

alle

Parameter:

action

Therapieplanaktion.

Rückgabe:

Isom.Base.Boolean
true im Erfolgsfall,
false im Fehlerfall.

Datum:

letzte Änderung am 05.05.2010

Ermittelt den aktuellen Aktionsplan.

Ermittelt zum aktuellen Therapieplan den zugehörigen Aktionsplan und setzt diesen als aktuellen Aktionsplan.

Dieser Einsprungspunkt wird in Phase 9 des Phasenmodells aufgerufen, unmittelbar nach SetExecutionOrder().

  Isom.Base.Boolean DoTp2Ap() 
  { 
      Isom.Plan.TherapyPlan tp = Isom.Plan.TherapyPlan.GetInstance (); 
      Isom.Plan.ActionPlan ap = Isom.Plan.ActionPlan.GetInstance (tp); 

      Isom.Base.Boolean success = ap.DoTp2Ap (); 
      return success; 
  } 

Zu beachten:

Die Funktion wird im Phasenmodell aufgerufen, um ISOM vom Zustand "StateTherapyPlanCreated" in den Zustand "StateActionPlanCreated" zu überführen.

Sinnvolle Spezialisierungsebenen

OEM, Fahrzeuggeneration, Baureihe

Rückgabe:

Isom.Base.Boolean
true im Erfolgsfall,
false im Fehlerfall.

Datum:

letzte Änderung am 05.05.2010

Therapiefunktionen für den Ausbau.

In dieser Funktion implementiert der Serviceautor die Aktion Unmount unter Berücksichtigung aller fachlicher Aspekte.

  Isom.Base.Boolean DoUnmount (Isom.Plan.TherapyPlanAction action) 
  { 
      return true; 
  } 

Sinnvolle Spezialisierungsebenen

alle

Parameter:

action

Therapieplanaktion.

Rückgabe:

Isom.Base.Boolean
true im Erfolgsfall,
false im Fehlerfall.

Datum:

letzte Änderung am 05.05.2010

Wird nach Abschluss einer Aktionsplanphase aufgerufen.

Wird nach der Ausführung einer Aktionsplanphase aufgerufen. Hier können vom Serviceautor Arbeiten angewiesen werden, die nach Abschluss einer Aktionsplanphase auszuführen sind - z.B. Reaktivieren des MOST-GW nach paralleler Programmierung.

Dieser Einsprungspunkt wird in Phase 10 des Phasenmodells aufgerufen.

  Isom.Base.Boolean EndPlanPhase(Isom.Plan.ActionPlanPhase phase) 
  { 
      return true; 
  } 

Parameter:

phase

Aktionsplanphase.

Zu beachten:

Die Funktion wird im Prozesszustand "StateActionPlanPerforming" aufgerufen.

Sinnvolle Spezialisierungsebenen

OEM, Fahrzeuggeneration, Baureihe

Rückgabe:

Isom.Base.Boolean
true im Erfolgsfall,
false im Fehlerfall.

Datum:

letzte Änderung am 05.05.2010

Startet die Ausführung des Aktionsplans.

Startet die Ausführung des aktuellen Aktionsplans.

Dieser Einsprungspunkt wird in Phase 10 des Phasenmodells aufgerufen.

  Isom.Base.Boolean ExecuteActionPlan() 
  { 
      Isom.Plan.TherapyPlan tp = Isom.Plan.TherapyPlan.GetInstance (); 
      Isom.Plan.ActionPlan ap = Isom.Plan.ActionPlan.GetInstance (tp); 

      Isom.Base.Boolean success = ap.ExecuteActionPlan (); 
      return success; 
  } 

Zu beachten:

Die Funktion überführt ISOM im Phasenmodell vom Zustand "StateActionPlanCreated" in den Zustand "StateActionPlanPerforming".

Sinnvolle Spezialisierungsebenen

OEM, Fahrzeuggeneration, Baureihe

Rückgabe:

Isom.Base.Boolean
true im Erfolgsfall,
false im Fehlerfall.

Datum:

letzte Änderung am 05.05.2010

Wird nach Abschluss des Aktionsplans aufgerufen.

Wird nach der Ausführung des Aktionsplans aufgerufen. Hier kann der Serviceautor abschließende Arbeiten durchführen - z.B. Fehlerspeicher löschen.

Dieser Einsprungspunkt wird in Phase 10 des Phasenmodells aufgerufen.

  Isom.Base.Boolean FinishPlan() 
  { 
      return true; 
  } 

Zu beachten:

Die Funktion wird im Prozesszustand "StateActionPlanPerforming" aufgerufen.

Sinnvolle Spezialisierungsebenen

OEM, Fahrzeuggeneration, Baureihe

Rückgabe:

Isom.Base.Boolean
true im Erfolgsfall,
false im Fehlerfall.

Datum:

letzte Änderung am 05.05.2010

Erzeugt den nativen Therapieplan.

Der nativen Therapieplan enthält alle Aktionen, die erforderlich sind um den Ist-Kontext in den Soll-Kontext zu überführen.

Dieser Einsprungspunkt wird zu Beginn der Phase 6 des Phasenmodells aufgerufen.

  Isom.Base.Boolean GeneratePlan( ) 
  { 
      Isom.Context.FutureVehicleContext futureContext = Isom.Context.FutureVehicleContext.GetInstance (); 

      // nativen Therapieplan berechnen 
      Isom.Base.Boolean success = futureContext.GeneratePlan(); 
      return success; 
  } 

Nachbedingung:

Wenn diese Funktion true zurückgibt, ist ein gültiger Therapieplan vorhanden.

Zu beachten:

Die Funktion wird im Phasenmodell im Zustand "StateFutureContextKnown" aufgerufen, um einen Therapieplan zu erzeugen.

Sinnvolle Spezialisierungsebenen

OEM, Fahrzeuggeneration, Baureihe

Rückgabe:

Isom.Base.Boolean
true im Erfolgsfall,
false im Fehlerfall.

Datum:

letzte Änderung am 05.05.2010

Ermittlung des Soll-Kontexts.

In diesem Einsprungspunkt ermittelt der Serviceautor den Soll-Kontext.

Dieser Einsprungspunkt wird zu Beginn der Phase 5 des Phasenmodells aufgerufen.

  Isom.Base.Boolean GetFutureContext( ) 
  { 
      Isom.Context.FutureVehicleContext futureContext = Isom.Context.FutureVehicleContext.GetInstance (); 

      // Soll-Kontext über Logistik ermitteln 
      Isom.Base.Boolean success = futureContext.CalcNewFutureContext(); 
      return success; 
  } 

Nachbedingung:

Wenn diese Funktion true zurückgibt, muss der Soll-Kontext bekannt sein.

Zu beachten:

Die Funktion wird im Phasenmodell aufgerufen, um ISOM vom Zustand "StateCurrContextKnown" in den Zustand "StateFutureContextKnown" zu überführen.

Sinnvolle Spezialisierungsebenen

OEM, Fahrzeuggeneration, Baureihe

Rückgabe:

Isom.Base.Boolean
true im Erfolgsfall,
false im Fehlerfall.

Datum:

letzte Änderung am 05.05.2010

Wird aufgerufen, wenn der Status der Abarbeitung einer asynchronen Aktion auf den finalen Zustand 'ausgeführt' gesetzt wird.

Diese Rückruffunktion wird aufgerufen, wenn die Bearbeitung einer asynchronen Aktion beendet wird, d.h. wenn die Aktion durch ein externes Ausführungssystem gesteuert wurde.

  Isom.Base.Boolean OnAsyncActionFinished (Isom.Plan.TherapyPlanAction action, Isom.Base.Boolean succ) 
  { 
      return true; 
  } 

Sinnvolle Spezialisierungsebenen

OEM, Fahrzeuggeneration, Basisbaureihe

Parameter:

	action	Therapieplanaktion.
	succ	Gibt an, ob die Ausführung der Aktion erfolgreich war.

Rückgabe:

Isom.Base.Boolean
Rückgabewert wird nicht ausgewertet.

Datum:

letzte Änderung am 05.05.2010

Wird aufgerufen, wenn der Status der Abarbeitung einer asynchronen Aktion auf den Zustand 'in Ausführung' gesetzt wird.

Diese Rückruffunktion wird aufgerufen, wenn die Bearbeitung einer asynchronen Aktion begonnen wird, d.h. wenn die Aktion durch ein externes Ausführungssystem gesteuert wird.

  Isom.Base.Boolean OnAsyncActionStarting (Isom.Plan.TherapyPlanAction action) 
  { 
      return true; 
  } 

Sinnvolle Spezialisierungsebenen

OEM, Fahrzeuggeneration, Basisbaureihe

Parameter:

action

Therapieplanaktion.

Rückgabe:

Isom.Base.Boolean
Rückgabewert wird nicht ausgewertet.

Datum:

letzte Änderung am 05.05.2010

Wird aufgerufen, wenn bei der Abarbeitung eines asynchronen Plans Fehler aufgetreten sind und eine Maßnahmensteigerung möglich ist.

Diese Rückruffunktion wird aufgerufen, wenn bei der Abarbeitung eines asynchronen Plans Fehler aufgetreten sind und eine Maßnahmensteigerung möglich ist. über den Rückgabewert dieser Rückruffunktion wird festgelegt, ob eine Maßnahmensteigerung durchgeführt werden soll.

Zu beachten:

Der Umfang der Maßnahmensteigerung kann nicht beeinflusst werden. Es werden immer alle Aktionen ausgeführt, die noch nicht erfolgreich waren.

  Isom.Base.Boolean OnAsyncPhaseHalted (Isom.Plan.TherapyPlanActionList actions, Isom.Sys.ErrorList errors) 
  { 
      // nie eine Maßnahmensteigerung durchführen 
      return false; 
  } 

Sinnvolle Spezialisierungsebenen

OEM, Fahrzeuggeneration, Basisbaureihe

Parameter:

	actions	ausgeführte Aktionen
	errors	Ausführungsfehler

Rückgabe:

Isom.Base.Boolean
gibt an, ob eine Maßnahmensteigerung auszuführen ist.

Seit:

Diese Rückruffunktion wurde zu Argonaut 1.15 eingeführt.

Wird aufgerufen, wenn sich die Liste der Clients ändert, die mit der Sitzung verbunden sind.

  Isom.Base.Boolean OnClientListChanged (Isom.Sys.ClientDataList added, Isom.Sys.ClientDataList removed) 
  { 
      return true; 
  } 

Sinnvolle Spezialisierungsebenen

OEM

Parameter:

	added	neu hinzugekommene Clients
	removed	Clients, die die Verbindung getrennt haben

Rückgabe:

Isom.Base.Boolean
Rückgabewert wird nicht ausgewertet.

Datum:

letzte Änderung am 05.05.2010

Wird aufgerufen, sobald die statische Prüfung der Skripte abgeschlossen ist.

In dieser Rückruffunktion können vom Serviceautor Arbeiten angewiesen werden, die nur einmal zu Beginn einer Fahrzeugsitzung auszuführen sind, z.B. das Starten von Umgebungswächtern.

Diese Rückruffunktion gehört nicht zum Phasenmodell.

  Isom.Base.Boolean OnIsomStarting( ) 
  { 
      // Zeitgeber für Umgebungsüberwachung erzeugen 
      Isom.Sys.Events.PeriodicTimer environmentUpdateTimer = Isom.Sys.Events.PeriodicTimer.CreatePeriodicTimer( 
          "EnvironmentUpdateTimer", 5000, "OnEnvironmentUpdate"); 
      environmentUpdateTimer.Enable(); 

      return true; 
  } 

  // Periodisch aufgerufene Rückruffunktion des Zeitgebers 
  Boolean OnEnvironmentUpdate(Isom.Sys.Events.TimerInfo info) 
  { 
      // Prüfung der Umgebungswerte, z.B. Spannungen 
  } 

Sinnvolle Spezialisierungsebenen

OEM

Zu beachten:

Die Funktion wird aufgerufen, während ISOM sich im Processzustand "StateConfigUnknown" befindet

Rückgabe:

Isom.Base.Boolean
true im Erfolgsfall,
false im Fehlerfall.

Datum:

letzte Änderung am 05.05.2010

Wird vor dem eigentlichem Beenden von ISOM aufgerufen.

Diese Rückruffunktion wird vor dem eigentlichem Beenden von ISOM aufgerufen. Der Serviceautor kann hier Arbeiten anweisen, die zur korrekten Beendigung einer Fahrzeugsitzung nötig sind.

Diese Rückruffunktion gehört nicht zum Phasenmodell.

  Isom.Base.Boolean OnIsomStopping(Isom.Base.Boolean isForced, Isom.Base.String message) 
  { 
      return true; 
  } 

Achtung:

Die Abarbeitungszeit dieser Funktion ist auf 3 Sekunden beschränkt.

Parameter:

	isForced	Zeigt an, ob die Beendigung erzwungen ist.
	message	Beschreibt die Ursache für das Beenden.

Sinnvolle Spezialisierungsebenen

OEM

Rückgabe:

Isom.Base.Boolean
Rückgabewert wird nicht ausgewertet.

Datum:

letzte Änderung am 05.05.2010

Benachrichtigung über einen Wechsel des aktiven logischen Fahrzeugs

Für jedes logische Fahrzeug kann in der ISOM-Fahrzeugbeschreibung ein eigener Fachdienstesatz vorgegeben werden.
Jedesmal wenn Fachdienste für ein anderes logisches Fahrzeug als bisher angefordert werden, wird diese Rückruffunktion aufgerufen.

  Isom.Base.Boolean OnLogicalVehicleChanged ( 
    Isom.Base.String previousLV,  
    Isom.Base.String nextLV, 
    Isom.Base.String requestedPChannel) 
  { 
      // Wechsel protokollieren 

      return true; 
  } 

Sinnvolle Spezialisierungsebenen

OEM, Fahrzeuggeneration, Baureihe

Parameter:

	previousLV	Name des bisher verwendeten logischen Fahrzeugs
	nextLV	Name des ab jetzt verwendeten logischen Fahrzeugs
	requestedPChannel	Angefragter P-Kanal entsprechend Kanalmodell aus der ISOM-Fahrzeugbeschreibung

Rückgabe:

Isom.Base.Boolean
true im Erfolgsfall,
false im Fehlerfall;
Der Rückgabewert wird von ISOM nicht ausgewertet.

Seit:

Eingeführt mit BZ-12385/BZ-12497/WA-588-5637 (Mischbordnetze).

Datum:

letzte Änderung am 23. 08 .2011

Wird beim Wiedereinstieg in eine Sitzung aufgerufen.

Diese Rückruffunktion wird von ISOM beim Wiedereinstieg in eine Sitzung aufgerufen. In der Funktion können vom Serviceautor Arbeiten angewiesen werden, die zum Wiedereinstieg nötig sind - z.B. globale Flaggen löschen.

  Isom.Base.Boolean OnRestartTherapySession() 
  { 
      return true; 
  } 

Sinnvolle Spezialisierungsebenen

OEM

Rückgabe:

Isom.Base.Boolean
Rückgabewert wird nicht ausgewertet.

Datum:

letzte Änderung am 05.05.2010

Wird aufgerufen, wenn sich die Liste der Sitzungen ändert, die momentan aktiv sind.

  Isom.Base.Boolean OnSessionListChanged (Isom.Base.StringList started, Isom.Base.StringList stopped) 
  { 
      return true; 
  } 

Sinnvolle Spezialisierungsebenen

OEM

Parameter:

	started	neu gestartete Sitzungen
	stopped	Sitzungen, die beendet wurden

Rückgabe:

Isom.Base.Boolean
Rückgabewert wird nicht ausgewertet.

Datum:

letzte Änderung am 05.05.2010

Wird aufgerufen, wenn das Benutzerprofil über die Client-Schnittstelle verändert wurde.

Der Serviceautor wird mit dieser Rückruffunktion über Änderungen am Benutzerprofil informiert und kann diese Ereignisse beispielsweise protokollieren.

  Isom.Base.Boolean OnUserProfileChanged (Isom.Context.UserProfile userProfileChanges) 
  { 
      // Änderungen protokollieren 

      return true; 
  } 

Sinnvolle Spezialisierungsebenen

OEM, Fahrzeuggeneration, Baureihe

Parameter:

userProfileChanges

Geänderte Benutzerprofil-Werte.

Rückgabe:

Isom.Base.Boolean
Rückgabewert wird nicht ausgewertet.

Datum:

letzte Änderung am 05.05.2010

Wird zu Beginn des Aktionsplans aufgerufen.

Wird zu Beginn der Ausführung des Aktionsplans aufgerufen.

Dieser Einsprungspunkt wird in Phase 10 des Phasenmodells aufgerufen.

  Isom.Base.Boolean PreparePlan() 
  { 
      return true; 
  } 

Zu beachten:

Die Funktion wird im Phasenmodell aufgerufen, um ISOM vom Zustand "StateTherapyPlanCompleted" in den Zustand "StateActionPlanCreated" zu überführen.

Sinnvolle Spezialisierungsebenen

OEM, Fahrzeuggeneration, Baureihe

Rückgabe:

Isom.Base.Boolean
true im Erfolgsfall,
false im Fehlerfall.

Datum:

letzte Änderung am 05.05.2010

Neubewertung der Datenverfügbarkeit für alle Aktionen.

Startet die Neubewertung der Datenverfügbarkeit für alle Aktionen im Therapieplan.

Dieser Einsprungspunkt kann in den Phasen 7 bis 9 des Phasenmodells aufgerufen werden.

  Isom.Base.Boolean ReevaluateDataAvailability() 
  { 
      Isom.Plan.TherapyPlan tp = Isom.Plan.TherapyPlan.GetInstance (); 

      Isom.Base.Boolean success = tp.ReevaluateDataAvailability(); 
      return success; 
  } 

Sinnvolle Spezialisierungsebenen

OEM, Fahrzeuggeneration, Baureihe

Rückgabe:

Isom.Base.Boolean
true im Erfolgsfall,
false im Fehlerfall.

Datum:

letzte Änderung am 05.05.2010

Enfernt eine Aktion aus dem Therapieplan.

Entfernt die übergebene Aktion action aus dem Therapieplan.

Dieser Einsprungspunkt wird in Phase 7 des Phasenmodells aufgerufen.

  Isom.Base.Boolean RemoveActionManually( Isom.Plan.TherapyPlanAction action ) 
  { 
      Isom.Plan.TherapyPlan tp = Isom.Plan.TherapyPlan.GetInstance(); 

      // Aktion entfernen 
      Isom.Base.Boolean success = tp.Remove( action ); 
      return success; 
  } 

Nachbedingung:

Wenn diese Funktion true zurückgibt, wurde die übergebene Aktion action aus dem Therapieplan entfernt.

Zu beachten:

Die Funktion wird im Phasenmodell im Zustand "StateTherapyPlanCreated" aufgerufen, um eine Aktion aus dem Therapieplan zu entfernen.

Sinnvolle Spezialisierungsebenen

alle

Rückgabe:

Isom.Base.Boolean
true im Erfolgsfall,
false im Fehlerfall.

Datum:

letzte Änderung am 05.05.2010

Sofortausführung einer einzelnen Aktion

Die übergebene Aktion action wird sofort ausgeführt. Eventuell vorhandene Vor- und Nachbereiter werden nicht ausgeführt.

Dieser Einsprungspunkt kann in den Phasen 2 bis 7 des Phasenmodells aufgerufen werden.

Achtung:

Damit eine Aktion (z.B. "SelfTest") sofort ausgeführt werden kann, wird eine ISOM/L-Funktion namens "Run<Aktionsname>" (z.B. "RunSelfTest") benötigt, in der der Serviceautor die Ausführung programmiert.

  Isom.Base.Boolean RunAction( Isom.Plan.TherapyPlanAction action ) 
  { 
      Isom.Base.Boolean success = action.Run(); 
      return success; 
  } 

  Isom.Base.Boolean RunSelfTest( Isom.Context.Ecu ecu ) 
  { 
      // Selbsttest ausführen 
      // Isom.Services.AsamResponseList results = Isom.Services.Asam.ExecuteOnEcu(ecu, ...); 

      return true; 
  } 

Nachbedingung:

Wenn diese Funktion true zurückgibt, wurde die übergebene Aktion action ausgeführt.

Zu beachten:

Die Funktion kann im Phasenmodell in folgenden Zuständen aufgerufen werden:

• StateConfigKnown
• StateVehicleDataKnown
• StateCurrContextKnown
• StateFutureContextKnown
• StateTherapyPlanCreated

Sinnvolle Spezialisierungsebenen

alle

Rückgabe:

Isom.Base.Boolean
true im Erfolgsfall,
false im Fehlerfall.

Datum:

letzte Änderung am 05.05.2010

Festlegung der Ausführungsreihenfolge.

In diesem Einsprungspunkt legt der Serviceautor die Ausführungsreihenfolge von Aktionen fest. Diese Reihenfolge wird für die folgende Aktionsplanberechnung benötigt.

Dieser Einsprungspunkt wird in Phase 9 des Phasenmodells aufgerufen, unmittelbar vor DoTp2Ap().

  Isom.Base.Boolean SetExecutionOrder() 
  { 
      Isom.Plan.TherapyPlan tp = Isom.Plan.TherapyPlan.GetInstance (); 
      Isom.Plan.ActionPlan ap = Isom.Plan.ActionPlan.GetInstance (tp); 

      // Reihenfolge der Aktionen: 
      // "Umbau" vor "Programmierung" vor "Codierung" 

      // "Umbau" umfasst Ausbau, Einbau und Tausch 
      ap.SetExecutionOrders ("Unmount"); 
      ap.SetExecutionOrders ("Mount"); 
      ap.SetExecutionOrders ("Replace"); 

      // "Programmierung" 
      ap.SetExecutionOrders ("Flash"); 

      // "Codierung" 
      ap.SetExecutionOrders ("Code"); 

      // immer @c true zurückgeben 
      return true; 
  } 

Zu beachten:

Die Funktion wird im Prozesszustand "StateTherapyPlanCompleted" aufgerufen.

Sinnvolle Spezialisierungsebenen

OEM, Fahrzeuggeneration, Baureihe

Rückgabe:

Isom.Base.Boolean
true im Erfolgsfall,
false im Fehlerfall.

Datum:

letzte Änderung am 05.05.2010

Wird zu Beginn einer Aktionsplanphase aufgerufen.

Wird vor der Ausführung einer Aktionsplanphase aufgerufen. Hier können vom Serviceautor Arbeiten angewiesen werden, die zu Beginn einer Aktionsplanphase auszuführen sind - z.B. Deaktivieren des MOST-GW bei paralleler Programmierung.

Dieser Einsprungspunkt wird in Phase 10 des Phasenmodells aufgerufen.

  Isom.Base.Boolean StartPlanPhase(Isom.Plan.ActionPlanPhase phase) 
  { 
      return true; 
  } 

Zu beachten:

Die Funktion wird im Prozesszustand "StateActionPlanPerforming" aufgerufen.

Sinnvolle Spezialisierungsebenen

OEM, Fahrzeuggeneration, Baureihe

Rückgabe:

Isom.Base.Boolean
true im Erfolgsfall,
false im Fehlerfall.

Datum:

letzte Änderung am 05.05.2010

Ermittlung und Setzen der Ist-Steuergeräteliste im Modell.

In diesem Einsprungspunkt ermittelt der Serviceautor die Listen der Steuergeräte, die im Fahrzeug verbaut sind bzw. erwartet werden, und ergänzt den Ist-Kontext entsprechend.

Dieser Einsprungspunkt wird zu Beginn der Phase 4 des Phasenmodells aufgerufen.

  Isom.Base.Boolean UpdateCurrentContextEcus( ) 
  { 
      Isom.Context.CurrentVehicleContext currentContext = Isom.Context.CurrentVehicleContext.GetInstance (); 
      Isom.Context.EcuList expectedEcus = currentContext.GetExpectedEcus(); 
      Isom.Context.EcuList identifiedEcus = currentContext.IdentifyAllEcus(); 

      // Behandlung für nicht antwortende oder unerwartet verbaute SG 

      Isom.Base.Boolean success = currentContext.SetEcus(identifiedEcus); 
      return success; 
  } 

Nachbedingung:

Wenn diese Funktion true zurückgibt, muss der Ist-Kontext vollständig sein.

Zu beachten:

Die Funktion wird im Phasenmodell aufgerufen, um ISOM vom Zustand "StateVehicleDataKnown" in den Zustand "StateCurrContextKnown" zu überführen.

Sinnvolle Spezialisierungsebenen

OEM, Fahrzeuggeneration, Baureihe

Rückgabe:

Isom.Base.Boolean
true im Erfolgsfall,
false im Fehlerfall.

Datum:

letzte Änderung am 05.05.2010

Ermittlung des Ist-Kontexts außer der Steuergeräteliste.

In diesem Einsprungspunkt kann der Serviceautor fehlende Daten des Ist-Kontexts ergänzen.

Dieser Einsprungspunkt wird zu Beginn der Phase 3 des Phasenmodells aufgerufen.

Verwendungsbeispiel:

Der folgende Quelltext zeigt eine einfache Implementierung des Einsprungspunkts UpdateCurrentContextVehicleData:

  Isom.Base.Boolean UpdateCurrentContextVehicleData() // Einsprungspunkt zur Ermittlung von Fahrzeuginformationen (Phase 3)  
  {  
     // Abfrage der Zugriffsinstanz  
     Isom.Context.CurrentVehicleContext cctx = Isom.Context.CurrentVehicleContext.GetInstance();  

     // Ermittlung der Fahrzeugmerkmale durch den Fachdienst zur Fahrzeugkommunikation  
     if (cctx.ReadVehicleOrder().Failed())  
     {  
        // Fahrzeugmerkmale konnten nicht ausgelesen werden  
        return false;  
     }  

     // Ermittlung der Integrationsstände durch den Fachdienst zur Fahrzeugkommunikation  
     if (cctx.ReadVersions().Failed())  
     {  
        // Integrationsstände konnten nicht ausgelesen werden  
        return false;  
     }  

     // Ermittlung des Benutzerprofils durch den Fachdienst zur Fahrzeugkommunikation  
     if (cctx.ReadUserProfile().Failed())  
     {  
        // Benutzerprofil konnte nicht ausgelesen werden  
        return false;  
     }  

     // Abfrage einer Kopie der ermittelten Fahrzeugmerkmale  
     Isom.Context.VehicleOrder vo = cctx.GetVehicleOrderClone();  

     // Auswertung der ermittelten Fahrzeugmerkmale  
     // ..  

      return true;  
  } 

Nachbedingung:

Wenn diese Funktion true zurückgibt, muss der Ist-Kontext bis auf die Liste der Steuergeräte vollständig sein.

Zu beachten:

Die Funktion wird im Phasenmodell aufgerufen, um ISOM vom Zustand "StateConfigKnown" in den Zustand "StateVehicleDataKnown" zu überführen.

Sinnvolle Spezialisierungsebenen

OEM, Fahrzeuggeneration, Baureihe

Rückgabe:

Isom.Base.Boolean
true im Erfolgsfall,
false im Fehlerfall.

Datum:

letzte Änderung am 05.05.2010