Anhand der Klasse TAACondition können Eigenschaften eines TAA-Laufzeitzustands abgefragt und verändert werden. Ausserdem stellt die Klasse diverse Methoden zur Be- und Verarbeitung der Condition zur Verfügung.
Um eine Instanz dieser Klasse zu erhalten, benutzen Sie die Methoden cndSet oder Conditions der Klasse ModlEnv.
Eine Referenz auf eine Instanz der Klasse TAACondition kann im Laufe der Verarbeitung ungültig werden, wenn der referenzierte Eintrag aus der Liste der aufgetretenen Laufzeitzustände entfernt wurde. Deshalb sollten solche Refererenzen nicht über längere Zeit aufbewahrt werden.
Wenn Sie versuchen, eine Methode oder Eigenschaft auf einen Laufzeitzustand anzuwenden, der nicht mehr gültig ist, gibt die TAA-Infrastruktur eine Fehlermeldung.
TeamWiSE.TAA.TAAConditionSeverity Severity (String sSev)
Über diese Methode kann der Severity Code für eine als String angegebene Severity ermittelt werden. Weitere Methoden und Eigenschaften der Klasse TAACondition
TeamWiSE.TAA.TAAConditionSeverity cndSeverity [ get, set ]
Über diese Eigenschaft kann der Severity Code des Laufzeitzustands abgefragt oder gesetzt werden. Der Wert muss einer der Konstanten für den Severity Code entsprechen.
In der Regel wird die Severity beim Eintrag eines Laufzeitzustands angegeben (cndSet) und anschließend abgefragt, aber nicht verändert.
Der Severity Code für eine Severity kann bei Bedarf über die Methode Severity ermittelt werden.
uint cndCode [ get]
Die Eigenschaft enthält den Code, der in der Anweisung cndSet angegeben wurde. ==== cndGroup: Meldungsgruppe für die Condition ====
String cndCode [ get]
Die Eigenschaft enthält die Gruppe, die in der Anweisung cndSet angegeben wurde.
uint cndID [ get]
Diese Eigenschaft enthält eine Kennung als Alternative zu der Identifikation über cndGroup und cndCode.
String cndImpl [ get, set ]
Diese Eigenschaft gibt an, wie das Modul, das den Laufzeitzustand gesetzt hat, oder die Komponente innerhalb des Moduls, technisch implementiert ist. Bei TAA-Modulen kann die Eigenschaft nicht verändert werden. Wenn die Implementierungsart nicht automatisch ausgefüllt werden konnte (z.B. weil das eintragende Modul kein TAA-Modul ist), kann die Eigenschaft einmalig manuell gesetzt werden.
uint cndLine [ get, set]
Über diese Eigenschaft kann die Nummer der Zeile abgefragt werden, in der in dem eintragenden Modul der Laufzeitzustand gesetzt wurde.Wenn die Implementierungsart nicht automatisch ausgefüllt werden konnte, kann die Eigenschaft einmalig manuell gesetzt werden.
String cndModule [ get, set]
Über diese Eigenschaft kann der Name des TAA-Moduls, das den Laufzeitzustand in die Liste der aufgetretenen Laufzeitzustände eingetragen hat (der Name, unter dem das Modul registriert ist), abgefragt werden. Wenn der Modulname nicht automatisch ausgefüllt werden konnte (z.B. weil das Modul zu dem Zeitpunkt, als der Laufzeitzustand gesetzt wurde, noch nicht registriert war), kann die Eigenschaft einmalig manuell gesetzt werden.
String cndTimeStamp [ get]
Diese Eigenschaft enthält den Zeitpunkt, zu dem der Laufzeitzustand gesetzt wurde. Sobald die Eigenschaft einmal gesetzt wurde, kann sie nicht mehr verändert werden.
Das Format des Timestamps entspricht der Definition in Klasse TAATimeStamp
String cndRemoteTS [ get]
Diese Eigenschaft enthält den Zeitpunkt, zu dem der Laufzeitzustand mglw. auf einem anderen Rechner (z.B. Host, andere Workstation) gesetzt wurde. Sobald die Eigenschaft einmal gesetzt wurde, kann sie nicht mehr verändert werden.
Das Format des Timestamps entspricht der Definition in Klasse TAATimeStamp
String cndMessage [ get]
Über diese Eigenschaft kann der Meldungstext des Laufzeitzustands abgefragt, aber nicht verändert werden. Dies ist der Text der Meldung, so wie er in der EDB definiert wurde. Diese Eigenschaft wird dynamisch geladen, abhängig von der Gruppen- und Codeangabe für den Laufzeitzustand.
Wenn der Wert der Meldung abgefragt wird, sind ggf. vorhandene Argumente bereits eingefügt worden. Änderungen in den Argumenten werden in cndMessage automatisch nachgeführt.
String cndMessage [ get]
Liefert einen String, in dem Meldungstext aus cndMessage vorangestellt sind: Severity-Code (als Text), Gruppe und Code der Condition.
String cndTitle [ get, set]
Über diese Eigenschaft kann der Titel des Laufzeitzustands abgefragt oder gesetzt werden. Der Default-Wert des Titels wird abgeleitet aus dem Anwendungskürzel, der Gruppe, dem Code, und dem Severity- Code, z.B.
LEVERT: Warning AAEingAusg(00247)
Dem Titel kann eine beliebige Zeichenfolge zugewiesen werden. Wenn Sie einen leeren String zuweisen, wird der Titel auf den Default zurückgesetzt.
Wenn Sie die Severity eines Laufzeitzustands ändern, wird diese Änderung im Default-Titel automatisch nachgeführt.
uint cndHelpContextID[ get] String cndHelpFile[ get]
Die Eigenschaften geben an, in welcher Hilfedatei Online-Hilfe zu dem Laufzeitzustand enthalten ist, und unter welcher Kontext-ID das entsprechende Kapitel zu finden ist. Die Eigenschaften werden automatisch von der TAA-Infrastruktur ausgefüllt.