Properties via OCL

Systemeinstellungen via OCL abfragen

Produktlinie

Standard

|

Expert

Betriebsart

CLOUD ABO

|

ON-PREMISES

Module

Leistung & CRM

Budget & Teilprojekt

Fremdkosten

Ressourcenplanung

Business Intelligence

Erstellt: 07.05.2004
Aktualisiert: 07.12.2024 | Neue OCL Operatoren ab Vertec 6.7.0.16.

Die Werte in den Systemeinstellungen können via OCL ausgewertet werden. Eine Systemeinstellung wird als Property bezeichnet.

  • Über den Namen (propertyName) kann die Property identifiziert werden.
  • Die Property ist von einem bestimmten Typ (Boolean, String, Object etc.).
  • Mit der Kombination von Typ und propertyName kann der Wert (propertyValue) abgefragt werden, der in der Systemeinstellung hinterlegt ist.
  • PropertyName und Typ sind bei der Beschreibung der jeweiligen Systemeinstellung zu finden.

Für die Abfrage von Property-Werten gibt es ab Vertec 6.7.0.16 folgende OCL Operatoren:

  • propertyBool('propertyName')
  • propertyInt('propertyName')
  • propertyCurr('propertyName')
  • propertyDate('propertyName')
  • propertyString('propertyName')
  • propertyObject('propertyName')

Diese liefern den in der Systemeinstellung hinterlegten Wert bzw. das Objekt zurück.

In früheren Versionen muss der Wert (propertyValue) explizit abgefragt werden:

<integer>property->select(propertyName='Name des Propertys')->first.propertyValue

StringProperty

Bei einer StringProperty handelt es sich um eine Property, wo ein alphanumerischer Text oder ein Pfad eingegeben wird. Dies kann ein Feld sein, in das der Wert von Hand getippt wird:

oder eines, wo der Wert über einen Browser gesetzt wird:

Beispiel-Abfrage

propertyString('PraefixRechnungsnummer')

liefert einen String zurück mit dem Wert, wie er im Feld steht.

In Vertec Versionen vor 6.7.0.16 lautet die Expression:

stringproperty->select(propertyName='PraefixRechnungsnummer')->first.propertyvalue

BooleanProperty

Ja/Nein-Werte. Zeigt eine Checkbox an.

Beispiel-Abfrage

propertyBool('CodeUpperCase')

gibt True oder False zurück.

In Vertec Versionen vor 6.7.0.16 lautet die Expression:

booleanproperty->select(propertyName='CodeUpperCase')->first.propertyvalue

AuswahlProperty

Wert auswählen aus einer Liste mittels Combobox:

Beispiel-Abfrage

Bei einer AuswahlProperty wird der Index der Auswahl abgefragt:

propertyInt('Jargon')

liefert den Index der Auswahl (hier im Beispiel 0 für Projekte und 1 für Mandate) als Integer.

In Vertec Versionen vor 6.7.0.16 lautet die Expression:

auswahlproperty->select(propertyName='Jargon')->first.asstring

liefert einen String (gleich geschrieben wie in der Auswahlliste selbst). Über die Abfrage:

auswahlproperty->select(propertyName='Jargon')->first.propertyvalue

erhält man den Index der Auswahl als Integer.

DatetimeProperty

Datumswerte. Zeigt einen Datepicker an.

Beispiel-Abfrage

propertyDate('Sperrdatum')

liefert einen Datumswert (Date) in der aktuell eingestellten Formatierung (30.11.2024 oder 2024-11-30 etc.).

In Vertec Versionen vor 6.7.0.16 lautet die Expression:

datetimeproperty->select(propertyName='Sperrdatum')->first.propertyvalue

IntegerProperty

Ganzzahliger Wert.

Beispiel-Abfrage

propertyInt('LaengeRechnungsnummer')

liefert die entsprechende Zahl.

In Vertec Versionen vor 6.7.0.16 lautet die Expression:

integerproperty->select(propertyName='LaengeRechnungsnummer')->first.propertyvalue

MinutenProperty

Funktioniert intern gleich wie die IntegerProperty (siehe oben), das heisst, der eingegebene Wert wird als ganzzahliger Minutenwert gespeichert. Die Anzeige wird gesteuert durch die Systemeinstellung Projekt > Anzeige Minuten.

Es gibt standardmässig in den Vertec Systemeinstellungen keine MinutenProperty, deshalb hier ein erfundenes Beispiel:

Beispiel-Abfrage

propertyInt('Zeitangabe')

liefert den Minutenwert, im Beispiel 2400.

In Vertec Versionen vor 6.7.0.16 lautet die Expression:

minutenproperty->select(propertyName='Zeitangabe')->first.propertyvalue

CurrencyProperty

Enthält eine Festkommazahl, zum Beispiel einen Frankenbetrag.

Es gibt standardmässig in den Vertec Systemeinstellungen keine CurrencyProperty, deshalb hier ein erfundenes Beispiel:

Beispiel-Abfrage

propertyCurr('Wertbetrag')

liefert eine Festkommazahl zurück.

In Vertec Versionen vor 6.7.0.16 lautet die Expression:

currencyproperty->select(propertyName='Wertbetrag')->first.propertyvalue

ObjectProperty

Enthält ein Vertec Objekt. Zur Auswahl kommt eine Liste mit Einträgen aus Vertec.

Beispiel-Abfrage

propertyObject('AktivitaetstypDokument')

liefert das entsprechende Objekt zurück.

In Vertec Versionen vor 6.7.0.16 lautet die Expression:

objectproperty->select(propertyName='AktivitaetstypDokument')->first.propertyvalue

und gibt eine ObjectReference zurück. Muss für die Weiterverwendung auf den jeweiligen Typ gecastet werden.

BlobProperty

Ein Wert, der in der Datenbank in einem Blob Feld abgespeichert wird. Wird für Bilder oder für lange Texte verwendet, für die ein normales String-Feld (255 Zeichen) nicht ausreicht.

Beispiel-Abfrage

blobproperty->select(propertyName='CompanyLogo')->first.propertyvalue

liefert das hinterlegte Logo als Bytestream zurück.

Bitte wählen Sie Ihren Standort