Löscht die Fehlerspeichereinträge.

Die Funktion erlaubt es, Fahrzeugmale einzubringen, die z. B. als externe Datei vorliegen

Bemerkungen:

Auf der Serviceplattform Taurus® wird zur Datenablage der Dienst Hermes verwendet. Die unterstützten Datenarten werden in der Konfiguration von Hermes festgelegt. Instanzen der Fachklasse Isom.Exchange.DataDescription beschreiben die Daten, auf die zugegriffen wird. Sie legen die Indizes fest, mit denen die Daten gegenüber Hermes identifiziert werden. Ist wie z. B. wie bei ISOM Didact kein Dienst zur Datenablage vorhanden, muss ein gültiges Datenaustauschverzeichnis für ISOM konfiguriert sein.

Rückgabe:

Isom.Base.Boolean
true nach erfolgreichem Löschen, false sonst.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls der zur Fahrzeugkommunikation angebundene Fachdienst das Löschen von Fehlerspeichereinträgen nicht unterstützt.

Datum:

letzte Änderung am 07.07.2011

Erzeugt eine identische Kopie des Objekts.

Rückgabe:

Isom.Context.CurrentVehicleContext
Das geklonte Objekt.

Datum:

letzte Änderung am 04.07.2011

Schreibt alle Softwarestände aus dem Datenmodell in das Fahrzeug.

Ein Integrationsstand versioniert alle im Fahrzeug verbauten Steuergeräte eindeutig. Dabei handelt es sich üblicherweise um eine Versionsinformation, die einen festgelegten Stand von Hard- und Softwareeinheiten für Steuergeräte benennt. Die Funktion verwendet den zur Fahrzeugkommunikation angebundenen Fachdienst, um die im Datenmodell gesetzten Werte für den aktuellen Softwarestand, den Softwarestand beim Bau des Fahrzeugs und den Softwarestand vor der letzten Aktualisierung des Fahrzeugs in das Fahrzeug zu schreiben.

Achtung:

Nach fehlgeschlagenem Fachdienstaufruf (Rückgabewert Void) können alle Integrationsstände zurückgesetzt (Void) sein.

Rückgabe:

Isom.Base.Boolean
true, falls die Integrationsstände erfolgreich geschrieben wurden false sonst.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls ein technischer Fehler aufgetreten ist (z.B. Aufruf der Fachfunktion für Fahrzeuge, die keine Integrationsstände unterstützen)

Datum:

letzte Änderung am 07.07.2011

Schreibt das Benutzerprofil aus dem Sollkonntext in das Fahrzeug.

Die Funktion verwendet den zur Fahrzeugkommunikation angebundenen Fachdienst, um das im Isom.Context.FutureVehicleContext geführte Benutzerprofil in das Fahrzeug zu schreiben. Ist in Isom.Context.FutureVehicleContext kein Benutzerprofil gesetzt, wird das Benutzerprofil des Istkontexts Isom.Context.CurrentVehicleContext geschrieben.

Rückgabe:

Isom.Context.UserProfile
Das Benutzerprofil, das geschrieben wurde.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls das Benutzerprofil nicht geschrieben werden konnte.

Datum:

letzte Änderung am 07.07.2011

Ermittlung der aktuellen Batteriespannung.

Die Funktion verwendet den zum Fahrzeugzugang angebundenen Fachdienst, um den aktuellen Wert der Batteriespannung zu ermitteln.

Rückgabe:

Isom.Base.Number
Aktueller Wert der Batteriespannung in Volt.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls die Ermittlung nicht ausgeführt werden konnte.

Datum:

letzte Änderung am 07.07.2011

Liefert den Integrationsstand bei Bau des Fahrzeugs.

Der gelieferte Wert muss vorher mit der Funktion Isom.Context.CurrentVehicleContext.ReadVersions aus dem Fahrzeug ermittelt oder mit Isom.Context.CurrentVehicleContext.SetBuildVersion gesetzt werden.

Zu beachten:

Zur Anzeige des Werts auf der Serviceplattform Taurus® wird auf ihn innerhalb der BOAM-Daten mit ISOM:Vehicle.Context.BuildLevel zugegriffen.

Rückgabe:

Isom.Base.String
Identifikator des Integrationsstands bei Bau des Fahrzeugs.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls der Integrationsstand noch nicht ermittelt wurde.

Datum:

letzte Änderung am 07.07.2011

Liefert den aktuellen Integrationsstand des Fahrzeugs.

Der gelieferte Wert muss vorher mit der Funktion Isom.Context.CurrentVehicleContext.ReadVersions aus dem Fahrzeug ermittelt oder mit Isom.Context.CurrentVehicleContext.SetCurrentVersion gesetzt werden.

Zu beachten:

Zur Anzeige des Werts auf der Serviceplattform Taurus® wird auf ihn innerhalb der BOAM-Daten mit ISOM:Vehicle.Context.CurrentLevel zugegriffen.

Verwendungsbeispiel:

Der folgende Quelltext zeigt eine einfache Implementierung des Einsprungspunkts UpdateCurrentContextVehicleData, der die Integrationsstände vom Fahrzeug ermittelt:

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

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

      // Abfrage des aktuellen Integrationsstands 
      Isom.Base.String currentVersion = cctx.GetCurrentVersion(); 
      if (currentVersion.IsVoid()) 
      { 
        // Aktueller Integrationsstand ungültig 
        return false; 
      } 

      // Abfrage des Integrationsstands vor der letzten Aktualisierung 
      Isom.Base.String historicalVersion = cctx.GetHistoricalVersion(); 
      if (historicalVersion.IsVoid()) 
      { 
        // Integrationsstand vor der letzten Aktualisierung ungültig 
        return false; 
      } 

      // Abfrage des Integrationsstands bei Bau des Fahrzeugs 
      Isom.Base.String buildVersion = cctx.GetBuildVersion(); 
      if (buildVersion.IsVoid()) 
      { 
        // Integrationsstand bei Bau des Fahrzeugs ungültig 
        return false; 
      } 

      // Protokollierung und Auswertung der ermittelten Integrationsstände 
      // .. 

      return true; 
   } 

Rückgabe:

Isom.Base.String
Identifikator des aktuellen Integrationsstands.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls der Integrationsstand noch nicht ermittelt wurde.

Datum:

letzte Änderung am 07.07.2011

Abfrage einer Anzeigeeigenschaft

Anzeigeeigenschaften erlauben es, den in dieser Fachklasse angebotenen Satz an Eigenschaften durch herstellerspezifische Eigenschaften zu erweitern. Systemseitig ermittelte Eigenschaftsnamen sind in den herstellerspezifischen Begleitdokumenten zu finden.

Zu beachten:

Zur Anzeige auf der Serviceplattform Taurus® stehen die Anzeigeeigenschaften innerhalb der BOAM-Daten durch den Bezeichner ISOM:Vehicle.Context.DisplayPropertiesCurrent.<Name> zur Verfügung.

Parameter:

propName

Eigenschaftsname

Rückgabe:

Isom.Base.String
Wert der Anzeigeeigenschaft

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls die abgefragte Eigenschaft nicht bekannt ist oder kein Wert gesetzt ist.

Datum:

letzte Änderung am 04.07.2011

Liefert die Namen aller Anzeigeeigenschaften.

Es werden die Eigenschaftsnamen für die Anzeigeeigenschaften zurückgeliefert, die mit Isom.Context.CurrentVehicleContext.GetDisplayProp() abgefragt werden können. Systemseitig ermittelte Eigenschaftsnamen sind in den herstellerspezifischen Begleitdokumenten zu finden.

Rückgabe:

Isom.Base.StringList
Liste der Namen aller Anzeigeeigenschaften

Datum:

letzte Änderung am 04.07.2011

Fragt die Steuergeräteliste ab.

Die abgefragte Steuergeräteliste enthält die Steuergeräte, die im Fahrzeug verbaut sind. Sie wird befüllt durch Aufruf von Isom.Context.CurrentVehicleContext.IdentifyAllEcus oder durch Setzen der Liste mit Isom.Context.CurrentVehicleContext.SetEcus

Achtung:

Es wird eine Kopie der Steuergeräteliste des Istkontexts zurückgegeben. Eine Änderung derselben wirkt sich nicht auf die im Istkontext geführte Liste aus.

Zu beachten:

Zur Anzeige des Werts auf der Serviceplattform Taurus® wird auf ihn innerhalb der BOAM-Daten mit ISOM:EcuList zugegriffen.

Verwendungsbeispiel:

Der folgende Quelltext zeigt eine einfache Implementierung des Einsprungspunkts UpdateCurrentContextEcus, die die Steuergeräte im Fahrzeug identifiziert:

   Isom.Base.Boolean UpdateCurrentContextEcus() // Einsprungspunkt zur Ermittlung der verbauten Steuergeräte (Phase 4) 
   { 
     // Abfrage der Zugriffsinstanz 
     Isom.Context.CurrentVehicleContext cctx = Isom.Context.CurrentVehicleContext.GetInstance(); 

     // Identifikation der Steuergeräte durch den Fachdienst zur Fahrzeugkommunikation 
     Isom.Context.EcuList ecus = cctx.IdentifyAllEcus(); 
     if (ecus.IsVoid()) 
     { 
       // Steuergeräte konnten nicht identifiziert werden 
       return false; 
     } 

     // Iteration über die Liste 
     ecus.Reset(); 
     while(ecus.HasNext()) 
     { 
       // Abfrage des nächsten N-Kanals 
       Isom.Context.Ecu ecu = ecus.Next(); 

       // Prüfung und Protokollierung 
       // .. 
     } 

     return true; 
   } 

Rückgabe:

Isom.Context.EcuList
Kopie der Steuergeräteliste des Istkontexts.

Datum:

letzte Änderung am 07.07.2011

Liefert die Steuergeräte an einem Fahrzeugbus.

Die Funktion liefert die Steuergeräte, die sich im vorgegebenen Fahrzeugbus befinden. Die Buszuordnung wird in der Fahrzeugbeschreibung festgelegt.

Rückgabe:

Isom.Context.EcuList
Steuergeräte an einem Fahrzeugbus.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls der Parameter busName das Void-Objekt ist.

Datum:

letzte Änderung am 07.07.2011

Ermittelt die Steuergeräte, die im Fahrzeug verbaut sein sollten.

Die Ermittlung benötigt einen angebundenen Fachdienst für Logistikinformationen, der die erwarteten Steuergeräte aus den ermittelten Fahrzeugmerkmalen herleitet.

Rückgabe:

Isom.Context.EcuList
Im Fahrzeug auf Basis der Fahrzeugmerkmale erwartete Steuergeräte.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls die Steuergeräte nicht ermittelt werden konnten.

Datum:

letzte Änderung am 07.07.2011

Liefert das Gateway-Steuergerät eines Fahrzeugbusses.

Die Funktion liefert das Steuergerät, das das Gateway des vorgegebenen Fahrzeugbusses ist. Die Gateway-Zuordnung wird in der Fahrzeugbeschreibung festgelegt.

Rückgabe:

Isom.Context.Ecu
Gateway-Steuergerät.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls das Gateway-Steuergerät nicht ermittelt werden konnte.

Datum:

letzte Änderung am 07.07.2011

Liefert den Integrationsstand vor der letzten Aktualisierung.

Der gelieferte Wert muss vorher mit der Funktion Isom.Context.CurrentVehicleContext.ReadVersions aus dem Fahrzeug ermittelt oder mit Isom.Context.CurrentVehicleContext.SetHistoricalVersion gesetzt werden.

Zu beachten:

Zur Anzeige des Werts auf der Serviceplattform Taurus® wird auf ihn innerhalb der BOAM-Daten mit ISOM:Vehicle.Context.HistoricalLevel zugegriffen.

Rückgabe:

Isom.Base.String
Identifikator des Integrationsstands vor der letzten Aktualisierung.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls der Integrationsstand noch nicht ermittelt wurde.

Datum:

letzte Änderung am 07.07.2011

Ermittlung der aktuellen Zündspannung.

Die Funktion verwendet den zum Fahrzeugzugang angebundenen Fachdienst, um den aktuellen Wert der Zündspannung zu ermitteln.

Rückgabe:

Isom.Base.Number
Aktueller Wert der Zündspannung in Volt.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls die Ermittlung nicht ausgeführt werden konnte.

Datum:

letzte Änderung am 07.07.2011

Liefert die Objektinstanz zum Zugriff auf die bereitgestellten Funktionen.

Rückgabe:

Isom.Context.CurrentVehicleContext
Objektinstanz zum Zugriff auf die bereitgestellten Funktionen.

Datum:

letzte Änderung am 07.07.2011

Ermittelt die Liste verwendbarer logischer Fahrzeuge.

   Isom.Context.CurrentVehicleContext cvc = Isom.Context.CurrentVehicleContext.GetInstance(); 
   Isom.Context.LogicalVehicleList vl = cvc.GetLogicalVehicles(); 

Siehe auch:

Isom.Context.ContextConfiguration.GetLogicalVehicles

Isom.Context.FutureVehicleContext.GetLogicalVehicles

Isom.Context.Ecu.GetLogicalVehicle

Isom.Plan.TherapyPlanAction.GetLogicalVehicles

Seit:

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

Rückgabe:

Isom.Context.LogicalVehicleList
Liste verwendbarer Logischer Fahrzeuge

Datum:

letzte Änderung am 29.06.2011

Liefert die physikalische Maßeinheit des Wegstreckenzählers.

Der gelieferte Wert muss vorher mit der Funktion Isom.Context.CurrentVehicleContext.ReadOdometerFromEcus aus dem Fahrzeug ermittelt oder mit Isom.Context.CurrentVehicleContext.SetOdometer gesetzt werden.

Zu beachten:

Zur Anzeige des Werts auf der Serviceplattform Taurus® wird auf ihn innerhalb der BOAM-Daten mit ISOM:Vehicle.Context.OdometerUnit zugegriffen.

Rückgabe:

Isom.Base.String
Einheit des Wegstreckenzählers.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls die Einheit des Wegstreckenzählers noch nicht ermittelt wurde.

Datum:

letzte Änderung am 07.07.2011

Liefert den Wert des Stands des Wegstreckenzählers.

Der gelieferte Wert muss vorher mit der Funktion Isom.Context.CurrentVehicleContext.ReadOdometerFromEcus aus dem Fahrzeug ermittelt oder mit Isom.Context.CurrentVehicleContext.SetOdometer gesetzt werden. Die Funktion Isom.Context.CurrentVehicleContext.GetOdometerUnit liefert die physikalische Maßeinheit, in der der Wegstreckenzähler geführt wird.

Zu beachten:

Zur Anzeige des Werts auf der Serviceplattform Taurus® wird auf ihn innerhalb der BOAM-Daten mit ISOM:Vehicle.Context.OdometerCount zugegriffen.

Verwendungsbeispiel:

Der folgende Quelltext zeigt eine einfache Implementierung des Einsprungspunkts UpdateCurrentContextVehicleData, der den Stand des Wegstreckenzählers vom Fahrzeug ermittelt:

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

      // Ermittlung von Wert und Maßeinheit des Wegstreckenzählers durch den Fachdienst zur Fahrzeugkommunikation 
      if (cctx.ReadOdometerFromEcus().Failed()) 
      { 
        // Wegstreckenzähler konnte nicht ausgelesen werden 
        return false; 
      } 

      // Abfrage des Werts 
      Isom.Base.String odomValue = cctx.GetOdometerValue(); 
      if (odomValue.IsVoid()) 
      { 
        // Wert des Wegstreckenzählers ungültig 
        return false; 
      } 

      // Abfrage der Maßeinheit 
      Isom.Base.String odomUnit = cctx.GetOdometerUnit(); 
      if (odomUnit.IsVoid()) 
      { 
        // Einheit des Wegstreckenzählers ungültig 
        return false; 
      } 

      // Protokollierung und Auswertung der ermittelten Werte 
      // .. 

      return true; 
   } 

Rückgabe:

Isom.Base.String
Wert des Wegstreckenzählers.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls der Wert des Wegstreckenzählers noch nicht ermittelt wurde.

Datum:

letzte Änderung am 07.07.2011

Ermittelt die Versionskennung der Programmierapplikation, die im Rahmen der letzten Fahrzeugbehandlung verwendet wurde.

Falls die Versionskennung nicht bereits aus dem Fahrzeug gelesen wurde, ermittelt die Fachfunktion die Kennung über einen angebundenen Fachdienst für Logistik durch den aktuellen Integrationsstand des Fahrzeugs.

Zu beachten:

Zur Anzeige des Werts auf der Serviceplattform Taurus® wird auf ihn innerhalb der BOAM-Daten mit ISOM:Vehicle.Context.PreviousApplicationVersion zugegriffen.

Rückgabe:

Isom.Base.String
Versionskennung.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls die Versionskennung nicht ermittelt oder nicht von ISOM ausgewertet werden konnte.

Datum:

letzte Änderung am 07.07.2011

Abfrage einer technischen Eigenschaft

Eigenschaften erlauben es, den in dieser Fachklasse angebotenen Satz an Eigenschaften durch herstellerspezifische Eigenschaften zu erweitern. Systemseitig ermittelte Eigenschaftsnamen sind in den herstellerspezifischen Begleitdokumenten zu finden.

Parameter:

propName

Eigenschaftsname

Rückgabe:

Isom.Base.String
Wert der Eigenschaft

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls die abgefragte Eigenschaft nicht bekannt ist oder kein Wert gesetzt ist.

Datum:

letzte Änderung am 04.07.2011

Liefert die Namen aller technischen Eigenschaften für das Fahrzeug.

Es werden die Eigenschaftsnamen für die technischen Eigenschaften zurückgeliefert, die mit Isom.Context.CurrentVehicleContext.GetProp() abgefragt werden können. Systemseitig ermittelte Eigenschaftsnamen sind in den herstellerspezifischen Begleitdokumenten zu finden.

Verwendungsbeispiel:

Der folgende Quelltext zeigt eine Implementierung des Einsprungspunkts OnRestartTherapySession, die die Eigenschaften, die bei der vorherigen Sitzungsdurchführung gesetzt wurden untersucht und für den Wiedereinstieg ggf. verändert:

   Isom.Base.Boolean OnRestartTherapySession() // Einsprungspunkt bei Wiedereinstieg in eine Sitzung 
   { 
     // Abfrage der Zugriffsinstanz 
     Isom.Context.CurrentVehicleContext cctx = Isom.Context.CurrentVehicleContext.GetInstance(); 

     // Abfrage der Namen der gesetzten Eigenschaften 
     Isom.Base.StringList propNames = cctx.GetPropNames(); 

     // Iteration über die Liste 
     propNames.Reset(); 
     while(propNames.HasNext()) 
     { 
       // Abfrage des nächsten Eigenschaftsnamens 
       Isom.Base.String propName = propNames.Next(); 

       // Behandlung der Eigenschaft beim Wiedereinstieg 
       // .. 
     } 

     // Weitere Behandlung des Wiedereinstiegs 
     // .. 
     return true; 
   } 

Rückgabe:

Isom.Base.StringList
Liste der Namen aller technischen Eigenschaften

Datum:

letzte Änderung am 04.07.2011

Liefert eine Liste der Steuergeräte, von denen die Integrationsstände des Fahrzeugs ermittelt werden können.

Die Funktion liefert eine Liste aller Steuergeräte, die folgende zwei Bedingungen erfüllen:

1. Sie sind Elemente der Steuergeräte-Liste dieses Kontexts, die mit Isom.Context.CurrentVehicleContext.GetEcus abgefragt wird.
2. Sie sind in der Fahrzeugbeschreibung im Element „SoftwareVersionEcus“ für die aktuell eingestellte Baureihengruppe angegeben.

Rückgabe:

Isom.Context.EcuList
Steuergeräte, von denen die Integrationsstände des Fahrzeugs ermittelt werden können.

Datum:

letzte Änderung am 07.07.2011

Liefert eine Liste der Steuergeräte mit besonderen Funktionsmerkmalen.

Steuergeräte mit besonderen Funktionsmerkmalen werden in der Fahrzeugbeschreibung mit 'SpecialFunction' modelliert. Die Elemente in der gelieferten Liste sind dem Wert der 'Priority' nach aufsteigend angeordnet.

Verwendungsbeispiel:

Der folgende Quelltext zeigt eine einfache Implementierung des Einsprungspunkts DisplayVo, in der das Auslesen der Steuergeräte mit besonderen Funktionsmerkmalen erfolgt:

Der folgende Quelltext zeigt die Modellierung der besonderen Funktionsmerkmale im XML-Knoten 'SpecialFunctions' innerhalb einer Fahrzeugbeschreibung:

   Isom.Base.String DisplayVo() 
  { 
  // Abfrage der Zugriffsinstanz 
     Isom.Context.CurrentVehicleContext cvc = Isom.Context.CurrentVehicleContext.GetInstance(); 
     //.. 

    // Ermittelt alle FA-tragenden SG 
    Isom.Context.EcuList voEcus = cvc.GetSpecialFunctionEcus("VehicleOrderSequence"); 

    //... 

   <Ecus> 
  <!-- Gateways haben Adressen 1-10 --> 
  <BaseVariant Name="PLCGW"> 
   
1
 
    <GroupName>G_ZGW</GroupName> 
    <SpecialFunctions> 
      <Function Name="VehicleOrderSequence" Priority="1" /> 
      <Function Name="VinSequence" Priority="1" /> 
    </SpecialFunctions> 
 //... 

Parameter:

functionName

Name des Funktionsmerkmals.

Rückgabe:

Isom.Context.EcuList
Steuergeräte mit dem Funktionsmerkmal.

Datum:

letzte Änderung am 07.07.2011

Liefert das Benutzerprofil.

Der gelieferte Wert wurde mit der Funktion Isom.Context.CurrentVehicleContext.ReadUserProfile aus dem Fahrzeug ermittelt.

Achtung:

Es wird eine Kopie des Benutzerprofils zurückgegeben.

Rückgabe:

Isom.Context.UserProfile
Fahrzeugmerkmale.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls das Benutzerprofil noch nicht ermittelt wurde.

Datum:

letzte Änderung am 07.07.2011

Liefert eine Liste der Steuergeräte, von denen die Fahrzeugmerkmale ermittelt werden können.

Die Funktion liefert eine Liste aller Steuergeräte, die folgende zwei Bedingungen erfüllen:

1. Sie sind Elemente der Steuergeräte-Liste dieses Kontexts, die mit Isom.Context.CurrentVehicleContext.GetEcus abgefragt wird.
2. Sie sind in der Fahrzeugbeschreibung im Element „VehicleConfigurationEcus“ für die aktuell eingestellte Baureihengruppe angegeben.

Rückgabe:

Isom.Context.EcuList
Steuergeräte, von denen die Fahrzeugmerkmale ermittelt werden können.

Datum:

letzte Änderung am 07.07.2011

Liefert die Fahrzeuggeneration.

Der gelieferte Wert muss vorher beim Festlegen der Baureihe oder der Baureihengruppe mit Isom.Context.ContextConfiguration.SetModelSeries bzw. Isom.Context.ContextConfiguration.SetModelSeriesGroup automatisch ermittelt oder mit Isom.Context.CurrentVehicleContext.SetVehicleGeneration gesetzt werden.

Rückgabe:

Isom.Base.String
Fahrzeuggeneration.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls die Fahrzeuggeneration noch nicht ermittelt wurde.

Datum:

letzte Änderung am 07.07.2011

Liefert die 17-stellige Fahrgestellnummer des Fahrzeugs.

Der gelieferte Wert muss vorher mit der Funktion Isom.Context.CurrentVehicleContext.ReadVin aus dem Fahrzeug ermittelt oder mit Isom.Context.ContextConfiguration.SetVin17 gesetzt werden.

Zu beachten:

Zur Anzeige des Werts auf der Serviceplattform Taurus® wird auf ihn innerhalb der BOAM-Daten mit ISOM:Vehicle.Context.Vin17 zugegriffen.

Rückgabe:

Isom.Base.String
Fahrgestellnummer.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls die Fahrgestellnummer noch nicht ermittelt wurde.

Datum:

letzte Änderung am 07.07.2011

Liefert die Repräsentation der Fahrzeugmerkmale.

Der gelieferte Wert muss vorher mit der Funktion Isom.Context.CurrentVehicleContext.ReadVehicleOrder aus dem Fahrzeug ermittelt oder mit Isom.Context.CurrentVehicleContext.SetVehicleOrder gesetzt werden.

Achtung:

Es wird eine Kopie der Repräsentation der Fahrzeugmerkmale zurückgegeben. Eine Änderung derselben wirkt sich nicht auf die im Istkontext geführten Fahrzeugmerkmale aus.

Zu beachten:

Zur Anzeige einer Zeichenkettenrepräsentation der Fahrzeugmerkmale auf der Serviceplattform Taurus® wird innerhalb der BOAM-Daten mit ISOM:Vehicle.Context.VehicleOrderOriginal zugegriffen.

Rückgabe:

Isom.Context.VehicleOrder
Fahrzeugmerkmale.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls die Fahrzeugmerkmale noch nicht ermittelt wurde.

Datum:

letzte Änderung am 07.07.2011

Liefert eine Liste der Steuergeräte, von denen die Fahrgestellnummer ermittelt werden kann.

Die Funktion liefert eine Liste aller Steuergeräte, die folgende zwei Bedingungen erfüllen:

1. Sie sind Elemente der Steuergeräte-Liste dieses Kontexts, die mit Isom.Context.CurrentVehicleContext.GetEcus() abgefragt wird.
2. Sie sind in der Fahrzeugbeschreibung der eingestellten Baureihengruppe im Element „VinEcus“ angegeben.

Rückgabe:

Isom.Context.EcuList
Steuergeräte, von denen die Fahrgestellnummer ermittelt werden kann.

Datum:

letzte Änderung am 07.07.2011

Identifiziert alle Steuergeräte des Fahrzeugs.

Die Funktion verwendet den zur Fahrzeugkommunikation angebundenen Fachdienst, um die Steuergeräte zu identifizieren. Wenn funktionale Identifikation möglich ist, wird diese genutzt. Andernfalls dient die Steuergeräteliste, die Isom.Context.CurrentVehicleContext.GetEcus() liefert, als Liste der zu identifizierenden Steuergeräte.

Rückgabe:

Isom.Context.EcuList
Alle Steuergeräte, die identifiziert wurden oder deren Identifikation versucht wurde.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls die Ermittlung nicht ausgeführt werden konnte.

Datum:

letzte Änderung am 07.07.2011

Importiert Fahrzeugmale aus einer externen Datenquelle.

Die Funktion erlaubt es, Fahrzeugmale einzubringen, die z. B. als externe Datei vorliegen

Bemerkungen:

Auf der Serviceplattform Taurus® wird zur Datenablage der Dienst Hermes verwendet. Die unterstützten Datenarten werden in der Konfiguration von Hermes festgelegt. Instanzen der Fachklasse Isom.Exchange.DataDescription beschreiben die Daten, auf die zugegriffen wird. Sie legen die Indizes fest, mit denen die Daten gegenüber Hermes identifiziert werden. Ist wie z. B. wie bei ISOM Didact kein Dienst zur Datenablage vorhanden, muss ein gültiges Datenaustauschverzeichnis für ISOM konfiguriert sein.

Rückgabe:

Isom.Base.Boolean
true, wenn die Fahrzeugmale erfolgreich importiert werden konnte, false, sonst.

Datum:

letzte Änderung am 07.07.2011

Bestimmt, ob die Aufrufinstanz das Void-Objekt ist.

Das Void-Objekt kann z. B. bei Funktionsaufrufen geliefert werden, um einen Fehler anzuzeigen.

Rückgabe:

Isom.Base.Boolean
true, falls dies das Void-Objekt ist, false sonst

Datum:

letzte Änderung am 07.07.2011

Ermittelt die Fehlerspeichereinträge.

Die Funktion verwendet den zur Fahrzeugkommunikation angebundenen Fachdienst, um die Fehlerspeichereinträge zu ermitteln. Die Einstellungen des Benutzerprofils müssen in der Fahrzeugbeschreibung der eingestellten Baureihengruppe angegeben werden.

Rückgabe:

Isom.Base.Boolean
true, falls die Fehlerspeichereinträge erfolgreich ermittelt wurden false sonst.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls die Ermittlung nicht ausgeführt werden konnte.

Datum:

letzte Änderung am 07.07.2011

Ermittelt den Wert und Maßeinheit des gezeigten Wegstreckenzählers

Die Funktion verwendet den zur Fahrzeugkommunikation angebundenen Fachdienst, um Wert und Maßeinheit des gezeigten Wegstreckenzählers aus dem Fahrzeug zu ermitteln. Die Liste der Steuergeräte, die dazu gefragt werden, wird als Parameter übergeben. Die Reihenfolge der SG in der Liste gibt die Reihenfolge bei der Abfrage und die Priorisierung bei der Übernahme des Werts vor. Die ermittelten Werte werden bei erfolgreicher Ausführung in das Datenmodell übernommen.

Parameter:

odometerEcus

Liste der Steuergeräte, von denen der gezeigte Wegstreckenzähler abgefragt werden kann.

Rückgabe:

Isom.Base.Boolean
true, falls der gezeigte Wegstreckenzähler erfolgreich ermittelt werden konnte,
false sonst.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls die Ermittlung nicht ausgeführt werden konnte.

Datum:

letzte Änderung am 07.07.2011

Ermittelt das Benutzerprofil des Fahrzeugs.

Die Funktion verwendet den zur Fahrzeugkommunikation angebundenen Fachdienst, um das Benutzerprofil zu ermitteln. Die Einstellungen des Benutzerprofils müssen in der Fahrzeugbeschreibung der eingestellten Baureihengruppe angegeben werden.

Rückgabe:

Isom.Base.Boolean
true, falls das Benutzerprofil erfolgreich ermittelt wurde false sonst.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls die Ermittlung nicht ausgeführt werden konnte.

Datum:

letzte Änderung am 07.07.2011

Ermittelt die vollständigen Fahrzeugmerkmale.

Die Funktion verwendet den zur Fahrzeugkommunikation angebundenen Fachdienst, um die Fahrzeugmerkmale zu ermitteln. Es werden nacheinander alle Steuergeräte, die Isom.Context.ContextConfiguration.GetVehicleOrderEcus() liefert, nach den Fahrzeugmerkmalen befragt. Das erste erfolgreich abgefragte Ergebnis wird in das Datenmodell übernommen.

Zu beachten:

Ein Aufruf dieser Funktion entspricht einem Aufruf von Isom.Context.CurrentVehicleContext.ReadVehicleOrderPure, gefolgt von einem Aufruf von Isom.Context.CurrentVehicleContext.ReadVehicleOrderAdditionals

Rückgabe:

Isom.Base.Boolean
true, falls die Fahrzeugmerkmale erfolgreich ermittelt wurden false sonst.

Achtung:

Mit der Hauptversion 1.21 wurde eingeführt, dass vom Serviceautor mittels Isom.Context.CurrentVehicleContext.SetVehicleOrder vorgegebene Fahrzeugmerkmale im ISOM-Objektmodell nicht mehr überschrieben werden, wenn mit Isom.Context.CurrentVehicleContext.ReadVehicleOrder die Fahrzeugmerkmale aus dem Fahrzeug gelesenen werden. Um die Daten aus dem Fahrzeug zu übernehmen, muss der Serviceautor seine Vorgabe zuvor mit Isom.Context.CurrentVehicleContext.SetVehicleOrder(VehicleOrder.Void()) ausdrücklich zurücknehmen.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls der Sonderprozess nicht ausgeführt werden konnte.

Datum:

letzte Änderung am 23.10.2012

Vervollständigt vom Fahrzeug gelesene Fahrzeugmerkmale mit Zusatzinformationen

Die Funktion verwendet den zur Fahrzeugkommunikation angebundenen Fachdienst, um Zusatzinformationen zu den Fahrzeugmerkmalen zu ermitteln. Bei erfolgreicher Ausführung wird das Ergebnis in das Datenmodell übernommen.

Zu beachten:

Die Fahrzeugmerkmale können mit einem Aufruf von Isom.Context.CurrentVehicleContext.ReadVehicleOrderPure vom Fahrzeug ausgelesen werden.

Achtung:

Mit der Hauptversion 1.21 wurde eingeführt, dass vom Serviceautor mittels Isom.Context.CurrentVehicleContext.SetVehicleOrder vorgegebene Fahrzeugmerkmale im ISOM-Objektmodell nicht mehr überschrieben werden, wenn mit Isom.Context.CurrentVehicleContext.ReadVehicleOrderAdditionals die Fahrzeugmerkmale aus dem Fahrzeug gelesenen werden. Um die Daten aus dem Fahrzeug zu übernehmen, muss der Serviceautor seine Vorgabe zuvor mit Isom.Context.CurrentVehicleContext.SetVehicleOrder(VehicleOrder.Void()) ausdrücklich zurücknehmen.

Rückgabe:

Isom.Base.Boolean
true, falls die Fahrzeugmerkmale erfolgreich vervollständigt wurden false sonst.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls die Ermittlung nicht ausgeführt werden konnte.

Datum:

letzte Änderung am 23.10.2012

Ermittelt die Fahrzeugmerkmale, wie sie vom Fahrzeug geliefert werden.

Die Funktion verwendet den zur Fahrzeugkommunikation angebundenen Fachdienst, um die Fahrzeugmerkmale zu ermitteln. Es werden nacheinander alle Steuergeräte, die Isom.Context.ContextConfiguration.GetVehicleOrderEcus() liefert, nach den Fahrzeugmerkmalen befragt. Das erste erfolgreich abgefragte Ergebnis wird in das Datenmodell übernommen.

Zu beachten:

Die ermittelten Fahrzeugmerkmale können mit einem Aufruf von Isom.Context.CurrentVehicleContext.ReadVehicleOrderAdditionals mit zusätzlichen Informationen vervollständigt werden.

Achtung:

Mit der Hauptversion 1.21 wurde eingeführt, dass vom Serviceautor mittels Isom.Context.CurrentVehicleContext.SetVehicleOrder vorgegebene Fahrzeugmerkmale im ISOM-Objektmodell nicht mehr überschrieben werden, wenn mit Isom.Context.CurrentVehicleContext.ReadVehicleOrderPure die Fahrzeugmerkmale aus dem Fahrzeug gelesenen werden. Um die Daten aus dem Fahrzeug zu übernehmen, muss der Serviceautor seine Vorgabe zuvor mit Isom.Context.CurrentVehicleContext.SetVehicleOrder(VehicleOrder.Void()) ausdrücklich zurücknehmen.

Rückgabe:

Isom.Base.Boolean
true, falls die Fahrzeugmerkmale erfolgreich ermittelt wurden false sonst.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls die Ermittlung nicht ausgeführt werden konnte.

Datum:

letzte Änderung am 23.10.2012

Ermittlung der Integrationsstände des Fahrzeugs.

Ein Integrationsstand versioniert alle im Fahrzeug verbauten Steuergeräte eindeutig. Dabei handelt es sich üblicherweise um eine Versionsinformation, die einen festgelegten Stand von Hard- und Softwareeinheiten für Steuergeräte benennt. Die Funktion verwendet den zur Fahrzeugkommunikation angebundenen Fachdienst, um den aktuellen Softwarestand, den Softwarestand beim Bau des Fahrzeugs und den Softwarestand vor der letzten Aktualisierung des Fahrzeugs zu ermitteln. Die ermittelten Werte werden bei erfolgreicher Ausführung in das Datenmodell übernommen.

Achtung:

Mit der Hauptversion 1.21 wurde eingeführt, dass vom Serviceautor mittels Isom.Context.CurrentVehicleContext.SetCurrentVersion, Isom.Context.CurrentVehicleContext.SetBuildVersion oder Isom.Context.CurrentVehicleContext.SetHistoricalVersion vorgegebene Versionsinformationen im ISOM-Objektmodell nicht mehr überschrieben werden, wenn mit Isom.Context.CurrentVehicleContext.ReadVersions die Versionsinformationen aus dem Fahrzeug gelesenen werden. Um die Daten aus dem Fahrzeug zu übernehmen, muss der Serviceautor seine Vorgabe zuvor mit ausdrücklich zurücknehmen, indem er die entsprechende Set-Funktion mit String.Void als Parameter aufruft.

Rückgabe:

Isom.Base.Boolean
true wenn die Integrationsstände erfolgreich ermittelt wurden
false sonst.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls die Ermittlung nicht ausgeführt werden konnte.

Datum:

letzte Änderung am 23.10.2012

Ermittelt die Fahrgestellnummer

Die Funktion verwendet den zur Fahrzeugkommunikation angebundenen Fachdienst, um die Fahrgestellnummer aus dem Fahrzeug zu ermitteln. Es werden nacheinander alle Steuergeräte, die Isom.Context.ContextConfiguration.GetVinEcus() liefert, nach der Fahrgestellnummer befragt. Das erste erfolgreich abgefragte Ergebnis wird in das Datenmodell übernommen.

Rückgabe:

Isom.Base.Boolean
true, falls der gezeigte Wegstreckenzähler erfolgreich ermittelt werden konnte,
false sonst.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls die Ermittlung nicht ausgeführt werden konnte.

Datum:

letzte Änderung am 07.07.2011

Führt eine benannte OEM-Funktion aus.

Steuergeräte mit besonderen Funktionsmerkmalen werden in der Fahrzeugbeschreibung mit 'SpecialFunction' modelliert. Die unterstützten OEM-Funktionen werden in diesen Elementen als 'Function' aufgeführt. Die Ausführung der OEM-Funktion erfolgt über den angebundenen Fachdienst zur Fahrzeugkommunikation.

Parameter:

	processName	Name der OEM-Funktion.
	arguments	Ausführungsparameter.

Rückgabe:

Isom.Base.StringDictionary
Ein prozessspezifisches Wörterbuch der Ausführungsergebnisse.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls die OEM-Funktion nicht implementiert ist.

Datum:

letzte Änderung am 07.07.2011 (23.10.2012)

Setzt den Integrationsstand bei Bau des Fahrzeugs.

Ein Integrationsstand versioniert alle im Fahrzeug verbauten Steuergeräte eindeutig. Dabei handelt es sich üblicherweise um eine Versionsinformation, die einen festgelegten Stand von Hard- und Softwareeinheiten für Steuergeräte benennt.

Parameter:

version

Zu setzender Integrationsstand.

Rückgabe:

Isom.Base.Boolean
true, falls der Integrationstand erfolgreich gesetzt wurde false sonst.

Datum:

letzte Änderung am 07.07.2011

Setzt den aktuellen Integrationsstand des Fahrzeugs.

Ein Integrationsstand versioniert alle im Fahrzeug verbauten Steuergeräte eindeutig. Dabei handelt es sich üblicherweise um eine Versionsinformation, die einen festgelegten Stand von Hard- und Softwareeinheiten für Steuergeräte benennt.

Parameter:

version

Zu setzender Integrationsstand.

Rückgabe:

Isom.Base.Boolean
true, falls der Integrationstand erfolgreich gesetzt wurde false sonst.

Datum:

letzte Änderung am 07.07.2011

Setzt eine Anzeigeeigenschaft

Anzeigeeigenschaften erlauben es, den in dieser Fachklasse angebotenen Satz an Eigenschaften durch herstellerspezifische Eigenschaften zu erweitern. Systemseitig ermittelte Eigenschaftsnamen sind in den herstellerspezifischen Begleitdokumenten zu finden.

Zu beachten:

Im Vergleich zu Isom.Context.CurrentVehicleContext.SetProp() eignet sich diese Funktion für Eigenschaftswerte, die lokalisiert werden.

Parameter:

	propName	Eigenschaftsname
	propValue	Neuer Wert der Eigenschaft

Rückgabe:

Isom.Base.Boolean
Immer true.

Datum:

letzte Änderung am 04.07.2011

Setzt die Steuergeräteliste.

Die Funktion setzt die Liste der Steuergeräte, die im Fahrzeug verbaut sind.

Verwendungsbeispiel:

Der folgende Quelltext zeigt eine einfache Implementierung des Einsprungspunkts UpdateCurrentContextEcus, die die Steuergeräteliste so setzt, wie sie von der Fachfunktion Isom.Context.CurrentVehicleContext.GetExpectedEcus geliefert wird:

   Isom.Base.Boolean UpdateCurrentContextEcus() // Einsprungspunkt zur Ermittlung der verbauten Steuergeräte (Phase 4) 
   { 
     // Abfrage der Zugriffsinstanz 
     Isom.Context.CurrentVehicleContext cctx = Isom.Context.CurrentVehicleContext.GetInstance(); 

     // Ermittlung der Steuergeräte durch den Fachdienst für Logistikinformationen 
     Isom.Context.EcuList expected = cctx.GetExpectedEcus(); 
     if (expected.IsVoid()) 
     { 
       // Erwartete Steuergeräte konnten nicht ermitteln werden 
       return false; 
     } 

     // Übernahme der erwarteten Steuergeräte in den Istkontext 
     cctx.SetEcus(expected); 

     return true; 
   } 

Parameter:

newList

Liste der Steuergeräte.

Rückgabe:

Isom.Base.Boolean
Immer true.

Datum:

letzte Änderung am 07.07.2011

Setzt den Integrationsstand vor der letzten Aktualisierung.

Ein Integrationsstand versioniert alle im Fahrzeug verbauten Steuergeräte eindeutig. Dabei handelt es sich üblicherweise um eine Versionsinformation, die einen festgelegten Stand von Hard- und Softwareeinheiten für Steuergeräte benennt.

Parameter:

version

Zu setzender Integrationsstand.

Rückgabe:

Isom.Base.Boolean
true, falls der Integrationstand erfolgreich gesetzt wurde false sonst.

Datum:

letzte Änderung am 07.07.2011

Setzt Wert und Maßeinheit des Wegstreckenzählers im Datenmodell.

Achtung:

Der Wert kann nicht ins Fahrzeug geschrieben werden.

Parameter:

	newOdoValue	neuer Wert des Wegstreckenzählers
	newOdoUnit	neue Maßeinheit des Wegstreckenzählers

Rückgabe:

Isom.Base.Boolean
true, falls Wert und Maßeinheit erfolgreich gesetzt wurde false sonst.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls die übergebenen Werte nicht gesetzt werden konnten.

Datum:

letzte Änderung am 07.07.2011

Setzt eine technische Eigenschaft

Eigenschaften erlauben es, den in dieser Fachklasse angebotenen Satz an Eigenschaften durch herstellerspezifische Eigenschaften zu erweitern. Systemseitig ermittelte Eigenschaftsnamen sind in den herstellerspezifischen Begleitdokumenten zu finden.

Zu beachten:

Im Vergleich zu Isom.Context.CurrentVehicleContext.SetDisplayProp() eignet sich diese Funktion nur für Eigenschaftswerte, die nicht lokalisiert werden.

Parameter:

	propName	Eigenschaftsname
	propValue	Eigenschaftswert

Rückgabe:

Isom.Base.Bool'true'> Immer true.

Datum:

letzte Änderung am 04.07.2011

Setzt die Fahrzeuggeneration im Datenmodell.

Die Fahrzeuggeneration wird üblicherweise bereits beim Festlegen der Baureihe oder der Baureihengruppe mit Isom.Context.ContextConfiguration.SetModelSeries bzw. Isom.Context.ContextConfiguration.SetModelSeriesGroup anhand der Fahrzeugbeschreibung automatisch festgelegt.

Parameter:

vehicleGeneration

Zu setzende Fahrzeuggeneration.

Rückgabe:

Isom.Base.Boolean
true, falls die Fahrzeuggeneration erfolgreich gesetzt wurde false sonst.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls die übergebene Fahrzeuggeneration gesetzt werden konnte.

Datum:

letzte Änderung am 07.07.2011

Setzt die Fahrzeugmerkmale.

Diese Funktion setzt die Fahrzeugmerkmale im Modell, aber nimmt keinen Abgleich mit dem Fahrzeug vor.

Parameter:

vo

Repräsentation der Fahrzeugmerkmale

Rückgabe:

Isom.Base.Boolean
true nach erfolgreicher Übernahme in das Datenmodell, false sonst.

Datum:

letzte Änderung am 07.07.2011

Setzt die Fahrgestellnummer im Datenmodell.

Achtung:

Der Wert kann nicht ins Fahrzeug geschrieben werden.

Parameter:

vin17

Zu setzende Fahrgestellnummer.

Rückgabe:

Isom.Base.Boolean
true, falls die Fahrgestellnummer erfolgreich gesetzt wurde false sonst.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls die übergebene Fahrgestellnummer gesetzt werden konnte.

Datum:

letzte Änderung am 07.07.2011

Prüft, ob das Benutzerprofil im Sollkontext Änderungen gegenüber dem Istkontext enthält.

Die Funktion vergleicht das im Isom.Context.FutureVehicleContext geführte Benutzerprofil mit Benutzerprofil aus dem Istkontext Isom.Context.CurrentVehicleContext.

Rückgabe:

Isom.Base.Boolean
true, falls das Benutzerprofil geändert wurde false sonst.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls das Benutzerprofil nicht geschrieben werden konnte.

Datum:

letzte Änderung am 07.07.2011

Erzeugt ein Void-Objekt.

Die Funktion kann in Fehlerfällen verwendet werden, um z.B. einen ungültigen Funktionsrückgabewert zu erzeugen.

Rückgabe:

Isom.Context.CurrentVehicleContext
Die Funktion liefert immer ein Void-Objekt.

Ausnahmebehandlung:

Void wird von dieser Funktion immer geliefert.

Datum:

letzte Änderung am 04.07.2011