Isom.Context.FutureVehicleContext

 ISOM/L-Bibliothek für Serviceautoren: <br />Isom.Context.FutureVehicleContext

ISOM/L-Bibliothek
für Serviceautoren

Version 9.10.1.0 vom 25 November 2013

Namensraum Isom.Context.FutureVehicleContext

Beschreibung

Hauptaufgabe des Fachobjekts FutureVehicleContext ist es, die Ziel-Informationen für die Logistikplanung bereitzustellen.

Weiterhin bestimmen die Steuergeräte in Isom.Context.FutureVehicleContext.GetEcus() die SG-Anzeige im Client.



Funktionen

Isom.Context.FutureVehicleContext.CalcFinalFutureContext

Berechnet einen neuen Soll-Kontext unter Berücksichtigung von Aktionen, die schon im Plan sind.

objectbound Isom.Base.Boolean Isom.Context.FutureVehicleContext.CalcFinalFutureContext  (  ) 

Berechnet einen neuen Soll-Kontext unter Berücksichtigung von Aktionen, die schon im Plan sind.

Zu beachten:
Verwendet für die Logistikabfrage den realen, zuletzt aus dem Fahrzeug gelesenen Ist-Kontext und den endgültigen Soll-Kontext der bisherigen Planung.
  1. Es wird ein nativer Logistikplan berechnet, wobei folgende Parameter einfließen:
    • Fahrzeugauftrag entsprechend CurrentVehicleContext als Ist-FA,
    • Fahrzeugauftrag inklusive eventueller geplanter Umrüstungen als Soll-FA,
    • Ist-SG-Liste entsprechend des während der identifizierung ermittelten CurrentVehicleContext,
    • Ist-Integrationsstände entsprechend des während der identifizierung ermittelten CurrentVehicleContext,
    • Soll-Integrationsstände entsprechend SetTargetVersion() bzw. neuester über die Logistik ermittelter Soll-Integrationsstand, wenn kein Integrationsstand per SetTargetVersion() explizit gesetzt,
    • Liste aller im Therapieplan manuell geplanten Aktionen als in die Logistik einzusteuernde Aktionen.
Der Logistikplan kann nachfolgend durch Aufruf von GeneratePlan() in den Therapieplan übertragen werden.
Verwendungshinweis:
Folgende Richtlinie gilt für die Auswahl der Planberechnungsfunktion:
  • CalcNewFutureContext() ist einzig dafür vorgesehen, um am Sitzungsanfang oder nach vollständiger Planabarbeitung einen neuen nativen Therapieplan zu generieren, der die bisherige Planung ersetzt.
  • CalcFinalFutureContext() ist einzig dafür vorgesehen, um vor Planabarbeitung einen Gesamt-Therapieplan inklusive aller manueller Aktionen und FA-Änderungen (Umrüstungen) zu generieren, der die vorherigen Therapiepläne ersetzt.
Verwendungsbeispiel:
   using Isom.Base.* 
   ... 
     Boolean CalculateFinalPlan() 
     { 
         ... 

         // Soll-Kontext holen 
         FutureVehicleContext futureContext = FutureVehicleContext.GetInstance (); 

         if( futureContext.CalcFinalFutureContext().Failed() ) 
         { 
            // Funktion fehlschlagen lassen 
            return false; 
         } 

         ... 
     } 
Rückgabe:
'true', falls keine Fehler aufgetreten sind, 'false' sonst.
Siehe auch:
Isom.Context.FutureVehicleContext.CalcNewFutureContext() für einen anderen Modus der Logistikplanung
Isom.Context.FutureVehicleContext.GeneratePlan() für die Berücksichtigung des berechneten Kontexts im Therapieplan
Isom.Context.FutureVehicleContext.CalcNewFutureContext

Berechnet einen neuen Soll-Kontext, der die bisherige Planung berücksichtigt.

objectbound Isom.Base.Boolean Isom.Context.FutureVehicleContext.CalcNewFutureContext  (  ) 

Berechnet einen neuen Soll-Kontext, der die bisherige Planung berücksichtigt.

Zu beachten:
Der Logistikplan kann nachfolgend durch Aufruf von GeneratePlan() in den Therapieplan übertragen werden.
Verwendungshinweis:
Folgende Richtlinie gilt für die Auswahl der Planberechnungsfunktion:
  • CalcNewFutureContext() ist zusammen mit ResetFutureContext() einzig dafür vorgesehen, um am Sitzungsanfang oder nach vollständiger Planabarbeitung einen neuen nativen Therapieplan zu generieren, der die bisherige Planung ersetzt.
  • CalcFinalFutureContext() ist einzig dafür vorgesehen, um vor Planabarbeitung einen Gesamt-Therapieplan inklusive aller manueller Aktionen und FA-Änderungen (Umrüstungen) zu generieren, der die vorherigen Therapiepläne ersetzt.
Verwendungsbeispiel:
   using Isom.Base.* 
   ... 
     Boolean GetFutureContext() 
     { 
         ... 

         // Soll-Kontext holen 
         FutureVehicleContext futureContext = FutureVehicleContext.GetInstance (); 

         if( futureContext.CalcNewFutureContext().Failed() ) 
         { 
             // ggf. weitere Aufrufe nach Vervollständigung des Ist-Kontexts 
         } 

         ... 
     } 

     Boolean FinishPlan() 
     { 
         ... 

        // Soll-Kontext holen 
        FutureVehicleContext futureContext = FutureVehicleContext.GetInstance (); 

        // Soll-Kontext neu initialisieren und Therapiepaln leeren 
        if( futureContext.ResetFutureContext().Failed() ) 
         { 
             ... 
         } 

        // abschließende Kontextprüfung nach Planausführung 
        if (futureContext.CalcNewFutureContext ().Failed ()) 
        { 
            // Funktion fehlgeschlagen lassen 
            return false; 
        } 

        ... 
     } 
Rückgabe:
'true', falls keine Fehler aufgetreten sind, 'false' sonst.
Siehe auch:
Isom.Context.FutureVehicleContext.CalcFinalFutureContext() für einen anderen Modus der Logistikplanung
Isom.Context.FutureVehicleContext.ResetFutureContext() für die Neuinitialisierung des Soll-Kontexts
Isom.Context.FutureVehicleContext.GeneratePlan() für die Berücksichtigung des berechneten Kontexts im Therapieplan
Isom.Context.FutureVehicleContext.SetTargetVersion() für die (optionale) gezielte Beeinflussung des Ziel-Integrationsstands
Isom.Context.FutureVehicleContext.ChangeVehicleOrder

Plant die Änderungen, um das Fahrzeug vom aktuellen Soll-Fahrzeugauftrag in den vorgegebenen neuen Soll- Fahrzeugauftrag zu überführen.

objectbound Isom.Base.Boolean Isom.Context.FutureVehicleContext.ChangeVehicleOrder  ( Isom.Context.VehicleOrder  newVo  ) 

Plant die Änderungen, um das Fahrzeug vom aktuellen Soll-Fahrzeugauftrag in den vorgegebenen neuen Soll- Fahrzeugauftrag zu überführen.

Dafür wird

  • der aktuelle Soll-Fahrzeugauftrag im ISOM-Fachmodell geändert,
  • über die Logisik ein Updateplan berechnet und
  • dieser dem aktuellen Therapieplan hinzugefügt.

Das Schreiben des neuen FAs in das Fahrzeug (FA-Abgleich) ist nicht Bestandteil dieses Plans. Bei Fehlschlagen bleibt der Soll-Fahrzeugauftrag ungeändert.

Verwendungsbeispiel:
   using Isom.Base.* 
   ... 
  FutureVehicleContext futureContext = FutureVehicleContext.GetInstance(); 
  VehicleOrder voCopy = futureContext.GetVehicleOrderClone().Clone(); 
  voCopy.Add( ... ); 
  futureContext.ChangeVehicleOrder( voCopy ); 
Rückgabe:
'true' gdw. erfolgreich, 'false' sonst.
Isom.Context.FutureVehicleContext.Clone

Erzeugt eine identische Kopie des Objekts.

objectbound Isom.Context.FutureVehicleContext Isom.Context.FutureVehicleContext.Clone  (  ) 

Erzeugt eine identische Kopie des Objekts.

Rückgabe:
Das geklonte Objekt.
Isom.Context.FutureVehicleContext.GeneratePlan

Erzeugt einen nativen Therapieplan, welcher den Ist-Kontext in diesen Soll-Kontext überführt.

objectbound Isom.Base.Boolean Isom.Context.FutureVehicleContext.GeneratePlan  (  ) 

Erzeugt einen nativen Therapieplan, welcher den Ist-Kontext in diesen Soll-Kontext überführt.

Achtung:
Setzt einen vorherigen Aufruf von CalcNewFutureContext() oder CalcFinalFutureContext() voraus.
Zu beachten:
Für Top-Level-Aufrufe sollte stattdessen die verschattete Funktion Isom.Global.Processes.GeneratePlan() verwendet werden.
Rückgabe:
'true', falls keine Fehler aufgetreten sind, 'false' sonst.
Isom.Context.FutureVehicleContext.GetDisplayProp

Setzt den Wert der vorgegebenen Anzeigeeigenschaft für das Fahrzeug.

objectbound Isom.Base.String Isom.Context.FutureVehicleContext.GetDisplayProp  ( Isom.Base.String  propName  ) 

Setzt den Wert der vorgegebenen Anzeigeeigenschaft für das Fahrzeug.

Zu beachten:
Die unterstützten Eigenschaftsnamen sind in den herstellerspezifischen Begleitdokumenten zu finden.
Es gilt die Initialisierungsreihenfolge: ContextConfiguration -> CurrentVehicleContext -> FutureVehicleContext
Verwendungsbeispiel:
   // Consts.is: 
   deftext INTERNAL CCPROP_VO_TYPE "VehicleOrderType" 

   // *.is: 
   using Isom.Base.* 
   ... 
      FutureVehicleContext fvc = FutureVehicleContext.GetInstance(); 
      String val = fvc.GetDisplayProp( Consts.CCPROP_VO_TYPE ); 
Rückgabe:
Wert der Eigenschaft.
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls der Wert ungesetzt oder gleich "" ist.
Siehe auch:
Isom.Context.FutureVehicleContext.SetDisplayProp()
Isom.Context.FutureVehicleContext.GetProp()
Isom.Context.FutureVehicleContext.GetDisplayPropNames

Liefert die Namen aller Anzeige-Eigenschaften für den Soll-Kontext des Fahrzeugs.

objectbound Isom.Base.StringList Isom.Context.FutureVehicleContext.GetDisplayPropNames  (  ) 

Liefert die Namen aller Anzeige-Eigenschaften für den Soll-Kontext des Fahrzeugs.

Es werden die Eigenschaftsnamen für die Anzeige-Eigenschaften (siehe Isom.Context.FutureVehicleContext.GetDisplayProp()) zurückgeliefert. Die systemseitig ermittelten Eigenschaftsnamen sind in den herstellerspezifischen Begleitdokumenten zu finden.

   Isom.Context.FutureVehicleContext fvc = Isom.Context.FutureVehicleContext.GetInstance(); 
   Isom.Base.StringList displayPropertyNames = fvc.GetDisplayPropNames(); 
   displayPropertyNames.Reset(); 
   while(displayPropertyNames.HasNext()) 
   { 
     //Abfrage des Werts für den gelieferten Eigenschaftsnamen und z. B. Aufzeichnung ins Protokoll 
   } 
Rückgabe:
Isom.Base.StringList
Liste der Namen aller Anzeige-Eigenschaften für den Soll-Kontext des Fahrzeugs.
Siehe auch:
Isom.Context.FutureVehicleContext.GetDisplayProp()
Datum:
letzte Änderung am 09.09.2010
Isom.Context.FutureVehicleContext.GetEcus

Ermittelt die Soll-Steuergeräteliste.

objectbound Isom.Context.EcuList Isom.Context.FutureVehicleContext.GetEcus  (  ) 

Ermittelt die Soll-Steuergeräteliste.

Rückgabe:
Liste der identifizierten Steuergeräte.
Isom.Context.FutureVehicleContext.GetEcusByBus

Liefert die Liste aller Steuergeräte, die an den Bus mit dem übergebenen Namen angeschlossen sind.

objectbound Isom.Context.EcuList Isom.Context.FutureVehicleContext.GetEcusByBus  ( Isom.Base.String  busName  ) 

Liefert die Liste aller Steuergeräte, die an den Bus mit dem übergebenen Namen angeschlossen sind.

Die Liste umfasst auch das Gateway-Steuergerät des Busses (falls definiert).

   using Isom.Base.* 

   FutureVehicleContext futureContext = FutureVehicleContext.GetInstance(); 
   EcuList ecusInBus = futureContext.GetEcusByBus("BUS-NAME"); 

Rückgabe:
Liste der an den Bus angeschlossenen Steuergeräte oder Void, falls der Bus oder seine Steuergeräte nicht ermittelt werden konnten.
Isom.Context.FutureVehicleContext.GetGatewayByBus

Liefert das Gateway-Steuergerät des Busses mit dem übergebenen Namen.

objectbound Isom.Context.Ecu Isom.Context.FutureVehicleContext.GetGatewayByBus  ( Isom.Base.String  busName  ) 

Liefert das Gateway-Steuergerät des Busses mit dem übergebenen Namen.

Das Gateway eines Busses wird in der ISOM-Fahrzeugbeschreibung festgelegt.

   using Isom.Base.* 

   FutureVehicleContext futureContext = FutureVehicleContext.GetInstance(); 
   Ecu gateway = futureContext.GetGatewayByBus("BUS-NAME"); 

Rückgabe:
Benutzerprofil oder Void.
Isom.Context.FutureVehicleContext.GetInstance

Ermittelt den für diese ISOM-Sitzung gültigen Soll-Fahrzeugkontext.

Isom.Context.FutureVehicleContext Isom.Context.FutureVehicleContext.GetInstance  (  ) 

Ermittelt den für diese ISOM-Sitzung gültigen Soll-Fahrzeugkontext.

Verwendungsbeispiel:
   using Isom.Base.* 
   using Isom.Context.FutureVehicleContext; 
   ... 
      FutureVehicleContext ftx = FutureVehicleContext.GetInstance(); 
Rückgabe:
Die für diese ISOM-Sitzung singuläre Kontext-Konfiguration.
Isom.Context.FutureVehicleContext.GetLogicalVehicles

Ermittelt die Liste verwendbarer logischer Fahrzeuge.

objectbound Isom.Context.LogicalVehicleList Isom.Context.FutureVehicleContext.GetLogicalVehicles  (  ) 

Ermittelt die Liste verwendbarer logischer Fahrzeuge.

Siehe auch:
Isom.Context.ContextConfiguration.GetLogicalVehicles
Isom.Context.CurrentVehicleContext.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
Isom.Context.FutureVehicleContext.GetPossibleTargetVersions

Ermittelt über die Logistik die möglichen Ziel-Integrationsstände.

Isom.Base.StringList Isom.Context.FutureVehicleContext.GetPossibleTargetVersions  (  ) 

Ermittelt über die Logistik die möglichen Ziel-Integrationsstände.

Zu beachten:
Statische Funktion, damit frühzeitiger Aufruf ohne FutureVehicleContext-Instanzerzeugung möglich ist.
Verwendungsbeispiel:
    Boolean GetFutureContext() 
    { 
        FutureVehicleContext futureContext = FutureVehicleContext.GetInstance (); 
        // ... 

        // mögliche Ziel-Integrationsstände ermitteln 
        StringList possibleVersions = FutureVehicleContext.TargetVersions(); 

        // semantisch größten Ziel-Integrationsstand bestimmen; 
        possibleVersions.Reset(); 
        String futureVersion = possibleVersions.Next(); // ersten Wert als Vergleichsbasis 
        while( possibleVersions.HasNext() ) 
        { 
            String iLevelLoop = possibleVersions.Next(); 

            // Integrationsstände semantisch vergleichen 
            Boolean isMax = Helpers.IsILevelGreaterOrEqual (iLevelLoop, futureVersion); 
            if( isMax.IsVoid() ) // nicht vergleichbar 
            { 
                futureVersion = String.Void(); 
                break; 
            } 
            else if( isMax ) 
            { 
                futureVersion = iLevelLoop; 
            } 
        } 

        // max. Ziel-Integrationsstand setzen, wenn eindeutig ermittelt; sonst warnen und fortfahren 
        if( futureVersion.IsVoid() ) 
        { 
            // ... log warning ... 
        } 
        else 
        { 
            if( futureContext.SetTargetVersion( futureVersion ). Failed() ) 
            { 
                // ... log warning ... 
            } 
            else 
            { 
                // ... log success ... 
            } 
        } 

        // ... 

   } 
Rückgabe:
mögliche Ziel-Integrationsstände.
Siehe auch:
Isom.Context.FutureVehicleContext.SetTargetVersion()
Isom.Context.FutureVehicleContext.GetProp

Ermittelt den Wert der vorgegebenen Eigenschaft (property) für das Fahrzeug.

objectbound Isom.Base.String Isom.Context.FutureVehicleContext.GetProp  ( Isom.Base.String  propName  ) 

Ermittelt den Wert der vorgegebenen Eigenschaft (property) für das Fahrzeug.

Zu beachten:
Die systemseitig ermittelten Eigenschaftsnamen sind in den herstellerspezifischen Begleitdokumenten zu finden.
Es gilt die Initialisierungsreihenfolge: ContextConfiguration -> CurrentVehicleContext -> FutureVehicleContext
Verwendungsbeispiel:
   // Consts.is: 
   deftext INTERNAL CCPROP_VO_TYPE "VehicleOrderType" 

   // *.is: 
   using Isom.Base.* 
   ... 
      FutureVehicleContext fvc = ...; 
      String val = fvc.GetProp( Consts.CCPROP_VO_TYPE ); 
Rückgabe:
Wert der Eigenschaft.
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls der Wert ungesetzt oder gleich "" ist.
Siehe auch:
Isom.Context.Ecu.GetProp()
Isom.Context.FutureVehicleContext.GetPropNames

Liefert die Namen aller technischen Eigenschaften für den Soll-Kontext des Fahrzeugs.

objectbound Isom.Base.StringList Isom.Context.FutureVehicleContext.GetPropNames  (  ) 

Liefert die Namen aller technischen Eigenschaften für den Soll-Kontext des Fahrzeugs.

Es werden die Eigenschaftsnamen für die technischen Eigenschaften (siehe Isom.Context.FutureVehicleContext.GetProp()) zurückgeliefert. Die systemseitig ermittelten Eigenschaftsnamen sind in den herstellerspezifischen Begleitdokumenten zu finden.

   Isom.Context.FutureVehicleContext fvc = Isom.Context.FutureVehicleContext.GetInstance(); 
   Isom.Base.StringList propertyNames = fvc.GetPropNames(); 
   propertyNames.Reset(); 
   while(propertyNames.HasNext()) 
   { 
     //Abfrage des Werts für den gelieferten Eigenschaftsnamen und z. B. Aufzeichnung ins Protokoll 
   } 
Rückgabe:
Isom.Base.StringList
Liste der Namen aller technischen Eigenschaften für den Soll-Kontext des Fahrzeugs.
Siehe auch:
Isom.Context.FutureVehicleContext.GetProp()
Datum:
letzte Änderung am 09.09.2010
Isom.Context.FutureVehicleContext.GetSoftwareVersionEcus

Liefert eine Liste der Steuergeräte, von denen der Softwarezustand des Fahrzeugs ermittelt werden kann.

objectbound Isom.Context.EcuList Isom.Context.FutureVehicleContext.GetSoftwareVersionEcus  (  ) 

Liefert eine Liste der Steuergeräte, von denen der Softwarezustand des Fahrzeugs 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.FutureVehicleContext.GetEcus abgefragt wird.
  2. Sie sind in der Fahrzeugbeschreibung im Element "SoftwareVersionEcus" für die aktuell eingestellte Baureihengruppe angegeben.

      Isom.Context.FutureVehicleContext ftx = Isom.Context.FutureVehicleContext.GetInstance(); 
      Isom.Context.EcuList softwareVersionEcus = ftx.GetSoftwareVersionEcus(); 
      while(softwareVersionEcus.HasNext()) 
      { 
        //... 
      } 
Rückgabe:
Isom.Context.EcuList
Steuergeräte, von denen der Softwarezustand des Fahrzeugs ermittelt werden kann.
Siehe auch:
Isom.Context.ContextConfiguration.GetSoftwareVersionEcus()
Isom.Context.CurrentVehicleContext.GetSoftwareVersionEcus()
Seit:
Eingeführt zu Version 6.1.2.0
Datum:
letzte Änderung am 11.06.2010
Isom.Context.FutureVehicleContext.GetTargetVersion

Ermittelt den aktuell eingestellten Soll-Integrationsstand für Logistikpläne.

objectbound Isom.Base.String Isom.Context.FutureVehicleContext.GetTargetVersion  (  ) 

Ermittelt den aktuell eingestellten Soll-Integrationsstand für Logistikpläne.

Zu beachten:
Die Zielversion wird spätestens durch einen der folgenden Funktionsaufrufe festgelegt: * SetTargetVersion ODER * CalcNewFutureContext ODER * CalcFinalFutureContext
Verwendungsbeispiel:
   using Isom.Base.* 
   ... 
  FutureVehicleContext futureContext = FutureVehicleContext.GetInstance(); 
  String ilevel = futureContext.GetTargetVersion(); 
Rückgabe:
Soll-Integrationsstand.
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls der Integrationsstand noch nicht ermittelt ist.
Siehe auch:
Isom.Context.FutureVehicleContext.SetTargetVersion()
Isom.Context.FutureVehicleContext.GetUserProfile

Ermittelt das Benutzerprofil.

objectbound Isom.Context.UserProfile Isom.Context.FutureVehicleContext.GetUserProfile  (  ) 

Ermittelt das Benutzerprofil.

Rückgabe:
Benutzerprofil
Isom.Context.FutureVehicleContext.GetVehicleConfigurationEcus

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

objectbound Isom.Context.EcuList Isom.Context.FutureVehicleContext.GetVehicleConfigurationEcus  (  ) 

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.FutureVehicleContext.GetEcus abgefragt wird.
  2. Sie sind in der Fahrzeugbeschreibung im Element "VehicleConfigurationEcus" für die aktuell eingestellte Baureihengruppe angegeben.

      Isom.Context.FutureVehicleContext ftx = Isom.Context.FutureVehicleContext.GetInstance(); 
      Isom.Context.EcuList vcEcus = ftx.GetVehicleConfigurationEcus(); 
      while(vcEcus.HasNext()) 
      { 
        //... 
      } 
Rückgabe:
Isom.Context.EcuList
Steuergeräte, von denen die Fahrzeugmerkmale ermittelt werden können.
Siehe auch:
Isom.Context.ContextConfiguration.GetVehicleConfigurationEcus()
Isom.Context.CurrentVehicleContext.GetVehicleConfigurationEcus()
Datum:
letzte Änderung am 11.06.2010
Isom.Context.FutureVehicleContext.GetVehicleOrderClone

Ermittelt eine Kopie des Soll-Fahrzeugauftrags.

objectbound Isom.Context.VehicleOrder Isom.Context.FutureVehicleContext.GetVehicleOrderClone  (  ) 

Ermittelt eine Kopie des Soll-Fahrzeugauftrags.

Zu beachten:
Der echte Fahrzeugauftrag kann nicht direkt manipuliert werden, sondern nur über ChangeVehicleOrder() inklusive Logistikberechnung.
Verwendungsbeispiel:
   using Isom.Base.* 
   ... 
  FutureVehicleContext futureContext = futureContext.GetInstance(); 
  VehicleOrder voCopy = futureContext.GetVehicleOrderClone().Clone(); 
  voCopy.Add( ... ); 
  futureContext.ChangeVehicleOrder( voCopy ); 
Rückgabe:
Soll-Fahrzeugauftrag (Clone).
Ausnahmebehandlung:
Es wird das Void-Objekt zurückgegeben, falls der Fahrzeugauftrag noch nicht ermittelt ist.
Isom.Context.FutureVehicleContext.GetVinEcus

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

objectbound Isom.Context.EcuList Isom.Context.FutureVehicleContext.GetVinEcus  (  ) 

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.FutureVehicleContext.GetEcus abgefragt wird.
  2. Sie sind in der Fahrzeugbeschreibung im Element "VinEcus" für die aktuell eingestellte Baureihengruppe angegeben.

      Isom.Context.FutureVehicleContext ftx = Isom.Context.FutureVehicleContext.GetInstance(); 
      Isom.Context.EcuList vinEcus = ftx.GetVinEcus(); 
      while(vinEcus.HasNext()) 
      { 
        //... 
      } 
Rückgabe:
Isom.Context.EcuList
Steuergeräte, von denen die Fahrgestellnummer ermittelt werden kann.
Siehe auch:
Isom.Context.ContextConfiguration.GetVinEcus()
Isom.Context.CurrentVehicleContext.GetVinEcus()
Datum:
letzte Änderung am 11.06.2010
Isom.Context.FutureVehicleContext.IsVoid

Bestimmt, ob es sich um das Void-Objekt handelt.

objectbound Isom.Base.Boolean Isom.Context.FutureVehicleContext.IsVoid  (  ) 

Bestimmt, ob es sich um das Void-Objekt handelt.

Rückgabe:
'true', falls dies das Void-Objekt ist, 'false' sonst.
Isom.Context.FutureVehicleContext.RecalcPlanAfterReassembly

Berechnet alle Logistik-(Teil-)Pläne im Therapieplan neu und führt vorige, ggf.

objectbound Isom.Base.Boolean Isom.Context.FutureVehicleContext.RecalcPlanAfterReassembly  ( Isom.Base.String  vin7  ) 

Berechnet alle Logistik-(Teil-)Pläne im Therapieplan neu und führt vorige, ggf.

bereits teilweise ausgeführte Logistikpläne mit diesen zusammen. Der Aktionsplan wird aktualisiert und neu gestartet. Bereits abgearbeitete Aktionen verbleiben im Plan, werden jedoch nicht neu gestartet.

Die Funktion prüft außerdem das tatsächliche Vorhandensein von ein-/auszubauenden Steuergeräten.

Verwendung: Geführter Tausch, nach der Durchführung von Umbauten am Fahrzeug.

Verwendungsbeispiel:
   using Isom.Base.* 
   ... 
     Boolean DoRecalcPlanAfterReassembly (TherapyPlanAction action) 
     { 
         // Fahrgestellnummer ermitteln 
         String vin = IdentVin (); 
         String vin7; 

         if( vin.Length().Gt( 7 ) ) 
         { 
             Number index = vin.Length().Sub( 7 ); 
             vin7 = vin.Substring( index, -1 ); 
         } 

         // Soll-Kontext holen 
         FutureVehicleContext futureContext = FutureVehicleContext.GetInstance (); 
         // Plan neu berechnen nach Umbau 
         if (futureContext.RecalcPlanAfterReassembly (vin7).Failed ()) 
         { 
             ... 
             return false; 
         } 
         return true; 
     } 
Parameter:
vin7  7-stellige FgNr des neu identifizierten Fahrzeugs.
Rückgabe:
'true' gdw. erfolgreich, 'false' sonst.
Isom.Context.FutureVehicleContext.ResetFutureContext

Initialisiert den Soll-Kontext neu und leert den Therapieplan

objectbound Isom.Base.Boolean Isom.Context.FutureVehicleContext.ResetFutureContext  (  ) 

Initialisiert den Soll-Kontext neu und leert den Therapieplan

Der Aufruf bewirkt folgende Änderungen an Kontexten und Plänen:

  1. der bisherige Aktionsplan wird verworfen,
  2. der Therapieplan wird geleert,
  3. der Sollkontext wird neu initialisiert
  4. der Soll-Fahrzeugauftrag sowie die Soll-SG-Liste werden auf den letzten aus dem Fahrzeug gelesenen / importierten / vom Autor gesetzten Zustand entsprechend CurrentVehicleContext gebracht.

Achtung:
Alle vor Aufruf eventuell vorgenommenen Änderungen am Fahrzeugauftrag, am Therapie- und am Aktionsplan gehen durch den Aufruf verloren, d.h. die Kontextfortschreibung beginnt mit CurrentVehicleContext als Ausgangspunkt von vorn.
Verwendungshinweis:
Diese Funktion soll vor dem Aufruf von CalcNewFutureContext() aufgerufen werden.
Verwendungsbeispiel:
    // Entfernen aller Aktionen aus dem Maßnahmenplan wird 
     // rückgängig gemacht 
     Boolean RestoreNativePlan(Isom.Plan.TherapyPlanAction action) 
     { 
         // ... 

         // Soll-Kontext holen 
         Isom.Context.FutureVehicleContext futureContext = 
             Isom.Context.FutureVehicleContext.GetInstance (); 

     // Soll-Kontext und Pläne leeren 
         if( futureContext.ResetFutureContext().Failed() ) 
         { 
       // Fehler protokollieren 
             Isom.Sys.Log.Error("", "..."); 

       // ggf. weitere Maßnahmen zur Fehlerbehandlung 
         } 

     // Soll-Kontext neu berechnen 
         if( futureContext.CalcNewFutureContext().Failed() ) 
         { 
       // Fehler protokollieren 
             Isom.Sys.Log.Error("", "..."); 

       // ggf. weitere Maßnahmen zur Fehlerbehandlung 
         } 

         // ... 
     } 

Siehe auch:
Isom.Context.FutureVehicleContext.CalcNewFutureContext() für einen Modus einer neuen Logistikplanung
Isom.Context.FutureVehicleContext.RunProcess

Ruft einen benannten Sonderprozess auf.

objectbound Isom.Base.StringDictionary Isom.Context.FutureVehicleContext.RunProcess  ( Isom.Base.String  processName,
Isom.Base.StringDictionary  arguments  )

Ruft einen benannten Sonderprozess auf.

Verwendungsbeispiel:
   using Isom.Base.* 
   using Isom.Context.*; 
   ... 
      FutureVehicleContext fvc = FutureVehicleContext.GetInstance(); 
      StringDictionary args = StringDictionary.CreateStringDictionary(); 
      String processName = ...; 
      ... 
      StringDictionary result = fvc.RunProcess(processName, args); 
Rückgabe:
'true' Ein prozessspezifisches Wörterbuch der Aufrufergebnisse.
Ausnahmebehandlung:
Wenn der aufgerufene Sonderprozess nicht implementiert ist.
Wenn der aufgerufene Sonderprozess fehlgeschlagen ist.
Isom.Context.FutureVehicleContext.SetCurrentOemVersion

Setzt den Wert der aktuellen Versionskennung für den Soll-Kontext.

objectbound Isom.Base.Boolean Isom.Context.FutureVehicleContext.SetCurrentOemVersion  ( Isom.Base.String  currentVersion  ) 

Setzt den Wert der aktuellen Versionskennung für den Soll-Kontext.

Parameter:
currentVersion  Die aktuelle Versionskennung der verwendeten Werkstattapplikation.
Verwendungsbeispiel:
   using Isom.Base.*; 
   using Isom.Sys.*; 
   ... 
   FutureVehicleContext futureContext = FutureVehicleContext.GetInstance(); 
   String currentOemVersion = VersionInfo.GetOemVersion(); 
   futureContext.SetCurrentOemVersion(currentOemVersion); 
Rückgabe:
'true', falls die Versionskennung darüber hinaus ins Fahrzeug geschrieben werden konnte, 'false' sonst. Gibt daher aktuell immer 'false' zurück, da ein Speichern im Fahrzeug zur Zeit nicht implementiert ist.
Isom.Context.FutureVehicleContext.SetDisplayProp

Setzt den Wert der vorgegebenen Anzeigeeigenschaft für das Fahrzeug.

objectbound Isom.Base.Boolean Isom.Context.FutureVehicleContext.SetDisplayProp  ( Isom.Base.String  propName,
Isom.Base.String  propValue  )

Setzt den Wert der vorgegebenen Anzeigeeigenschaft für das Fahrzeug.

Zu beachten:
Die unterstützten Eigenschaftsnamen sind in den herstellerspezifischen Begleitdokumenten zu finden.
Es gilt die Initialisierungsreihenfolge: ContextConfiguration -> CurrentVehicleContext -> FutureVehicleContext
Das Setzen einer Anzeigeeigenschaft (display property) im Soll-Fahrzeugkontext wirkt sich konventionsmäßig immer auf alle im System bekannten Fahrzeug-Kontexte aus (transparentes Autoren-Property-Modell), d.h. autorengesetzte Eigenschaften haben globalen Charakter und unterliegen keiner Einfügehistorie.
Verwendungsbeispiel:
   // Consts.is: 
   deftext INTERNAL CCPROP_VO_TYPE "VehicleOrderType" 
   deftext MESSAGE VO_MSG "Fahrzeugauftrag" 

   // *.is: 
   using Isom.Base.* 
   ... 
      FutureVehicleContext fvc = FutureVehicleContext.GetInstance(); 
      if( fvc.GetDisplayProp( Consts.CCPROP_VO_TYPE ).IsVoid() ) 
        fvc.SetDisplayProp( Consts.CCPROP_VO_TYPE, VO_MSG ); 
Rückgabe:
'true' nach erfolgreichem Setzen. 'false' niemals.
Siehe auch:
Isom.Context.FutureVehicleContext.GetDisplayProp()
Isom.Context.FutureVehicleContext.SetEcus

Setzt die Soll-Steuergeräteliste.

objectbound Isom.Base.Boolean Isom.Context.FutureVehicleContext.SetEcus  ( Isom.Context.EcuList  newList  ) 

Setzt die Soll-Steuergeräteliste.

Zu beachten:
Die Soll-Steuergeräteliste wird vom ISOM-Kern bei Erstzugriff auf den FutureVehicleContext.GetInstance() anhand der Ist-SG-Liste initialisiert, so dass eine Nutzung von FutureVehicleContext.SetEcus() nur in Ausnahmefällen notwendig ist.
Verwendungsbeispiel:
   using Isom.Base.* 
   using Isom.Context.EcuList; 
   ... 
    Boolean CompleteFurturEcuList() 
    { ... 
      EcuList ecuList = currentContext.GetEcus(); 
      Ecu newAggregate = Ecu.CreateNewByAddress( -123 ); 
      ecuList.Add( newAggregate ); 
      futureContect.SetEcus( ecuList ); 
    } 
Rückgabe:
Immer true, solange keine Exceptions aufgetreten.
Isom.Context.FutureVehicleContext.SetProp

Setzt den Wert der vorgegebenen Eigenschaft (property) für das Fahrzeug.

objectbound Isom.Base.Boolean Isom.Context.FutureVehicleContext.SetProp  ( Isom.Base.String  propName,
Isom.Base.String  propValue  )

Setzt den Wert der vorgegebenen Eigenschaft (property) für das Fahrzeug.

Die systemseitig ermittelten Eigenschaftsnamen sind in den herstellerspezifischen Begleitdokumenten zu finden.

Zu beachten:
Es gilt die Initialisierungsreihenfolge: ContextConfiguration -> CurrentVehicleContext -> FutureVehicleContext
Das Setzen einer Eigenschaft (property) im Soll-Fahrzeugkontext wirkt sich konventionsmäßig immer auf alle im System bekannten Fahrzeug-Kontexte aus (transparentes Autoren-Property-Modell), d.h. autorengesetzte Eigenschaften haben globalen Charakter und unterliegen keiner Einfügehistorie.
Verwendungsbeispiel:
   // Consts.is: 
   deftext INTERNAL CCPROP_VO_TYPE "VehicleOrderType" 

   // *.is: 
   using Isom.Base.* 
   ... 
      FutureVehicleContext fvc = ...; 
      if( fvc.GetProp( Consts.CCPROP_VO_TYPE ).IsVoid() ) 
        fvc.SetProp( Consts.CCPROP_VO_TYPE, "FA" ); 
Rückgabe:
liefert immer 'true'.
Siehe auch:
Isom.Context.Ecu.GetProp()
Isom.Context.FutureVehicleContext.SetTargetVersion

Setzt den für Logistikpläne zu verwendenden Soll-Integrationsstand.

objectbound Isom.Base.Boolean Isom.Context.FutureVehicleContext.SetTargetVersion  ( Isom.Base.String  newGoalVersion  ) 

Setzt den für Logistikpläne zu verwendenden Soll-Integrationsstand.

Verwendungsbeispiel:
    Boolean GetFutureContext() 
    { 
        FutureVehicleContext futureContext = FutureVehicleContext.GetInstance (); 
        // ... 

        StringList possibleVersions = FutureVehicleContext.GetPossibleTargetVersions(); 
        // mögliche Ziel-Integrationsstände ermitteln 

        // semantisch größten Ziel-Integrationsstand bestimmen; 
        possibleVersions.Reset(); 
        String futureVersion = possibleVersions.Next(); // ersten Wert als Vergleichsbasis 
        while( possibleVersions.HasNext() ) 
        { 
            String iLevelLoop = possibleVersions.Next(); 

            // Integrationsstände semantisch vergleichen 
            Boolean isMax = Helpers.IsILevelGreaterOrEqual (iLevelLoop, futureVersion); 
            if( isMax.IsVoid() ) // nicht vergleichbar 
            { 
                futureVersion = String.Void(); 
                break; 
            } 
            else if( isMax ) 
            { 
                futureVersion = iLevelLoop; 
            } 
        } 

        // max. Ziel-Integrationsstände setzen, wenn eindeutig ermittelt; sonst warnen und fortfahren 
        if( futureVersion.IsVoid() ) 
        { 
            // ... log warning ... 
        } 
        else 
        { 
            if( futureContext.SetTargetVersion( futureVersion ). Failed() ) 
            { 
                // ... log warning ... 
            } 
            else 
            { 
                // ... log success ... 
            } 
        } 

        // ... 

   } 
Rückgabe:
Immer true, solange keine Exceptions aufgetreten.
Siehe auch:
Isom.Context.FutureVehicleContext.GetTargetVersion()
Isom.Context.FutureVehicleContext.GetPossibleTargetVersions()
Isom.Context.FutureVehicleContext.SetCurrentOemVersion()
Isom.Context.FutureVehicleContext.Void

Erzeugt ein ungültiges Objekt.

Isom.Context.FutureVehicleContext Isom.Context.FutureVehicleContext.Void  (  ) 

Erzeugt ein ungültiges Objekt.

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

Rückgabe:
Ungültiges Objekt.

Version 9.10.1.0 vom 25 November 2013