Isom.Context.Environment

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

ISOM/L-Bibliothek
für Serviceautoren

Version 9.10.1.0 vom 25 November 2013

Namensraum Isom.Context.Environment

Beschreibung

Dieses Fachobjekt ermöglicht Zugriff auf die Umgebung. Dazu gehört der Fahrzeugzugang, dessen Eigenschaften abgefragt werden können, ebenso wie Umgebungsvariablen und der aktuelle Betriebsmodus der Anwendung.

Hinweis: Dieses Fachobjekt funktioniert nicht mit ISOM Didact. Die meisten Funktionsaufrufe kehren mit dem Ergebnis 'Void' zurück.



Funktionen

Isom.Context.Environment.GetAllEnvironmentVars

Abfrage von Umgebungsparameter.

objectbound Isom.Base.StringDictionary Isom.Context.Environment.GetAllEnvironmentVars  (  ) 

Abfrage von Umgebungsparameter.

Rückgabe:
Die Umgebungsparameter als Wörterbuch
Isom.Context.Environment.GetBatteryVoltage

Liefert die aktuelle Batteriespannung.

objectbound Isom.Base.Number Isom.Context.Environment.GetBatteryVoltage  (  ) 

Liefert die aktuelle Batteriespannung.

Rückgabe:
Die aktuelle Batteriespannung in Volt.
Ausnahmebehandlung:
Bei fehlgeschlagener Ermittlung der Batteriespannung.
Isom.Context.Environment.GetCurrentVciFirmwareVersion

Ermittelt die Firmwareversion des Fahrzeugzugangs.

objectbound Isom.Base.String Isom.Context.Environment.GetCurrentVciFirmwareVersion  (  ) 

Ermittelt die Firmwareversion des Fahrzeugzugangs.

Rückgabe:
Die Firmwareversion des Fahrzeugzugangs.
Ausnahmebehandlung:
Bei fehlgeschlagener Ermittlung der Firmwareversion des Fahrzeugzugangs.
Isom.Context.Environment.GetEnvironmentVar

Abfrage eines Umgebungsparameters.

objectbound Isom.Base.String Isom.Context.Environment.GetEnvironmentVar  ( Isom.Base.String  name  ) 

Abfrage eines Umgebungsparameters.

Parameter:
name  Name des Umgebaungsparameters
Rückgabe:
Wert des Umgebungsparameters
Isom.Context.Environment.GetIgnitionVoltage

Liefert die aktuelle Zündungsspannung.

objectbound Isom.Base.Number Isom.Context.Environment.GetIgnitionVoltage  (  ) 

Liefert die aktuelle Zündungsspannung.

Rückgabe:
Die zuletzt gemessene Zündungsspannung in Volt.
Ausnahmebehandlung:
Bei fehlgeschlagener Ermittlung der Zündungsspannung.
Isom.Context.Environment.GetInstance

Liefert die statische Instanz des Umgebungs-Objektes.

Isom.Context.Environment Isom.Context.Environment.GetInstance  (  ) 

Liefert die statische Instanz des Umgebungs-Objektes.

Rückgabe:
Objekt zum Zugriff auf den Fahrzeugzugang
Isom.Context.Environment.GetLatestVciFirmwareVersion

Ermittelt die neueste Firmwareversion, die für den Fahrzeugzugang zur Verfügung steht.

objectbound Isom.Base.String Isom.Context.Environment.GetLatestVciFirmwareVersion  (  ) 

Ermittelt die neueste Firmwareversion, die für den Fahrzeugzugang zur Verfügung steht.

Rückgabe:
Die neueste zur Verfügung stehende Firmwareversion für den Fahrzeugzugang.
Isom.Context.Environment.GetOperationMode

Ermittelt den Betriebsmodus, in dem sich die Anwendung befindet.

objectbound Isom.Base.String Isom.Context.Environment.GetOperationMode  (  ) 

Ermittelt den Betriebsmodus, in dem sich die Anwendung befindet.

Rückgabe:
Betriebsmodus der Anwendung.
Isom.Context.Environment.GetVciChannelCount

Ermittelt die Anzahl der Kanäle des Fahrzeugzugangs.

objectbound Isom.Base.Number Isom.Context.Environment.GetVciChannelCount  (  ) 

Ermittelt die Anzahl der Kanäle des Fahrzeugzugangs.

Rückgabe:
Die Anzahl der Kanäle des Fahrzeugzugangs.
Isom.Context.Environment.GetVciChannelData

Ermittelt die Daten eines Kanals des Fahrzeugzugangs.

objectbound Isom.Base.StringDictionary Isom.Context.Environment.GetVciChannelData  ( Isom.Base.Number  index  ) 

Ermittelt die Daten eines Kanals des Fahrzeugzugangs.

Parameter:
index  der Index [ 0 ... (GetVciChannelCount()-1) ]
Rückgabe:
Die Daten eines Kanals des Fahrzeugzugangs.
Isom.Context.Environment.GetVciConnectionQuality

Ermittelt die Qualität der Verbindung zum Fahrzeugzugang.

objectbound Isom.Base.String Isom.Context.Environment.GetVciConnectionQuality  (  ) 

Ermittelt die Qualität der Verbindung zum Fahrzeugzugang.

Rückgabe:
Die Qualität der Verbindung.
Isom.Context.Environment.GetVciConnectionType

Ermittelt Art der Verbindung zum Fahrzeugzugang (zum Beispiel Ethernet oder WLAN).

objectbound Isom.Base.String Isom.Context.Environment.GetVciConnectionType  (  ) 

Ermittelt Art der Verbindung zum Fahrzeugzugang (zum Beispiel Ethernet oder WLAN).

Rückgabe:
Die Art der Verbindung.
Isom.Context.Environment.GetVciGateway

Ermittelt das Gateway der Netzwerkverbindung des Fahrzeugzugangs.

objectbound Isom.Base.String Isom.Context.Environment.GetVciGateway  (  ) 

Ermittelt das Gateway der Netzwerkverbindung des Fahrzeugzugangs.

Rückgabe:
Das Gateway.
Isom.Context.Environment.GetVciIp

Ermittelt die IP-Adresse des Fahrzeugzugangs.

objectbound Isom.Base.String Isom.Context.Environment.GetVciIp  (  ) 

Ermittelt die IP-Adresse des Fahrzeugzugangs.

Rückgabe:
Die IP-Adresse des Fahrzeugzugangs.
Isom.Context.Environment.GetVciMac

Ermittelt die MAC-Adresse des Fahrzeugzugangs.

objectbound Isom.Base.String Isom.Context.Environment.GetVciMac  (  ) 

Ermittelt die MAC-Adresse des Fahrzeugzugangs.

Rückgabe:
Die MAC-Adresse des Fahrzeugzugangs.
Isom.Context.Environment.GetVciName

Ermittelt den Namen des Fahrzeugzugangs.

objectbound Isom.Base.String Isom.Context.Environment.GetVciName  (  ) 

Ermittelt den Namen des Fahrzeugzugangs.

Rückgabe:
Der Name des Fahrzeugzugangs.
Isom.Context.Environment.GetVciNetmask

Ermittelt die Maske der Netzwerkverbindung des Fahrzeugzugangs.

objectbound Isom.Base.String Isom.Context.Environment.GetVciNetmask  (  ) 

Ermittelt die Maske der Netzwerkverbindung des Fahrzeugzugangs.

Rückgabe:
Die Netzmaske.
Isom.Context.Environment.GetVciState

Ermittelt den Zustand des Fahrzeugzugangs.

objectbound Isom.Base.Number Isom.Context.Environment.GetVciState  (  ) 

Ermittelt den Zustand des Fahrzeugzugangs.

Rückgabe:
1, wenn das VCI erreichbar ist, 0, wenn das VCI nicht erreichbar ist.
Isom.Context.Environment.GetVehiclePreparationState

Abfrage der Fortschritts-Phase der Fachdienste.

objectbound Isom.Base.String Isom.Context.Environment.GetVehiclePreparationState  (  ) 

Abfrage der Fortschritts-Phase der Fachdienste.

Die Ergebniswerte sind fachdienstabhängig und sind in den herstellerspezifischen Begleitdokumenten unter dem Schlagwort 'Fortschritts-Phasen' zu finden.

Fachdienstübergreifend bedeutet eine leere Zeichenkette als Ergebniswert, dass die Fortschrittsinformationen zwar ermittelt werden, jedoch keiner Phase zugeordnet werden konnten.

     Boolean OnEnvironmentUpdate() 
     { 
         // ... 

         Environment env = Environment.GetInstance(); 

         String prepState = env.GetVehiclePreparationState (); 
         // anzuzeigenden, übersetzbaren Text bestimmen 
         String prepStateText = prepState.Clone (); 
         switch (prepState) 
         { 
             case "GetEcuInfo": 
                 prepStateText = Texts.PROGRESS_GET_ECU_INFO; 
             case "PrepareVehicleForFlash": 
                 prepStateText = Texts.PROGRESS_PREPARE_VEHICLE_FOR_FLASH; 
             // ... 
             default: 
                 ; 
         } 

         // abgelegte ID der Meldung holen 
         Number progressId = Number.GetGlobal (Consts.GLOBALKEY_PREPSTATEID); 

         // Es wird bereits eine Meldung angezeigt 
         if (progressId.IsVoid ().Not ()) 
         { 
             Helpers.UpdateProgressText (progressId, prepStateText); 
         } 

         // ... 
     } 
Rückgabe:
Name der Fortschritts-Phase, in der sich die Vehicleproxy-Fachdienste befinden.
Isom.Context.Environment.IsVoid

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

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

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

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

Erzeugt ein ungültiges Objekt.

Isom.Context.Environment Isom.Context.Environment.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