Um lange Listen aufgrund verschiedener Kriterien performant filtern zu können, wurde mit der Vertec Version 6.1.0.10 die Möglichkeit geschaffen, kundenspezifische Werte auf User-Einträgen ablegen zu können, welche via OCL abgefragt werden können.
Dafür gibt es ein neues Feld Keys auf UserEintrag (UserEinträge sind alle Objekte in Vertec, welche in Ordnern abgelegt werden können, wie Adressen, Projekte, Bearbeiter, Leistungen, etc.), in welches (via Python) die Key-Values Wertepaare eingetragen werden. Es werden folgende Datentypen unterstützt:
Die Key-Values werden mit der COM Methode oder der Python Methode setkeyvalue(key, value) gesetzt, z.B.
argobject.setkeyvalue('datum', argobject.eval("creationdatetime.firstOfMonth"))
Als value werden die oben genannten Datentypen akzeptiert. Die Umwandlung in den entsprechenden Key-Value-Typ ist wie folgt:
| Datentyp | Eingabe | Beispiel |
|---|---|---|
| String | String | argobject.setkeyvalue("Mykey", "Mein Text hier") |
| Boolean | True, False | argobject.setkeyvalue("Erledigt", True) |
| Date | ISO Datestring ("2017-02-03") | argobject.setkeyvalue('datum', vtcapp.currentdate()) |
| Datetime | ISO Datetime ("2017-02-03T08:30") | argobject.setkeyvalue('datum', vtcapp.currentdatetime()) |
| Integer | Ganzzahl | argobject.setkeyvalue("Anzahl", 5) |
| Currency | Fliesskommazahl | argobject.setkeyvalue("Betrag", 10573.65) setkeyvalue() schreibt nummerische Typen mit so wenig Dezimalstellen wie möglich und maximal 4 Dezimalstellen. Es wird auf die 4. Dezimalstelle gerundet. |
| None | Leerstring | argobject.setkeyvalue("Mykey", None) oder argobject.setkeyvalue("Mykey", "") |
Die maximale Länge aller auf einem User-Eintrag gesetzten Key-Values Wertepaare ist gesamthaft 1000 Zeichen. Wird diese Länge überschritten, erscheint eine Fehlermeldung.
Zum Abfragen eines Key-Values stehen sowohl Python-Methoden als auch OCL-Operatoren zur Verfügung. Abgefragt wird jeweils typspezifisch.
| Methode | Resultat |
|---|---|
getkeystring("key")
|
liefert genau was im Key-Value drin steht |
getkeybool("key")
|
liefert False für Leerstring, "False" (case insensitive) oder numerische 0-Werte, sonst true |
getkeycurr("key")
|
liefert einen Float oder 0 als float |
getkeyint("key")
|
liefert einen Integer oder 0 als integer |
getkeydate("key")
|
liefert ein Datum mit Zeitteil oder None |
getkeyint("key") und getkeycurr("key") geben nummerische Werte des jeweils anderen Typs (integer vs. float) zurück, wenn kein Datenverlust stattfindet.
| Operator | Resultat |
|---|---|
keystring('key')
|
alles -> string, sonst "" |
keybool('key')
|
"", "False", "0", "0.0" -> False, sonst True |
keydate('key')
|
iso-date (mit oder ohne time) -> datetime, sonst empty |
keyint('key')
|
integer string -> integer, sonst 0 |
keycurr('key')
|
currency string -> currency, sonst 0.00 |
Leere oder ungültige Werte führen zu einem Default-Wert des entsprechenden Typs. Defaultwerte sind:
Es gibt keine Methode zum Löschen von Key-Values. Das Entfernen eines solchen Wertepaars geschieht über das Setzen des entsprechenden Keys mit None bzw. Leerstring:
setkeyvalue('mykey', None) oder setkeyvalue('mykey', Leerstring)