Der first Operator liefert aus einer Liste den ersten Eintrag. Am häufigsten kommt der first Operator zur Anwendung, wenn aufgrund einer Selektion ein Objekt als Ergebnis verwendet werden soll. Da der ->select Operator eine Liste als Ergebnis liefert, muss darauf noch ->first angewendet werden, damit das Ergebnis ein einzelnes Objekt ist. Beispiel:

phasen->select(code= 'OFFERTE')->first.offeneleistungen->size

zeigt in einer Liste von Projekten die Anzahl offener Leistungen der Phase "OFFERTE" an.

Mit dem orderdescending Operator können Listen absteigend sortiert werden (sonst gleich wie ->orderby):

adresseintrag->orderdescending(projekte->size)

Der Operator oderMulti erlaubt das Sortieren einer Liste nach verschiedenen Sortierkriterien. Er kann in einer OCL-Expression auf einer Liste angewandt werden und erwartet einen String als Argument. Dieser String enthält die verschiedenen Sortierkriterien als einzelne OCL-Expressions, getrennt durch Semikolons:

projekt->ordermulti('projektleiter.name;code.asstring')

als Expression eines Expressionordners liefert sie eine Liste aller Projekte, sortiert in erster Linie nach dem Namen des Projektleiters, in zweiter Linie nach dem Projektcode. Diese Sortierung wird in der Listenanzeige allerdings nur sichtbar, wenn Sie die Sortierung auf Listenspalten entfernen. Doppelklicken Sie auf eine sortierte Listenspalte, bis diese keinen Sortierpfeil mehr anzeigt.

Will man nach Zusatzfeldern sortieren, hat man das Problem, dass man in der Expression keine Hochkommas verwenden kann. Bei den Zusatzfeldern erfordert das einen Umweg über die interne ID des Zusatzfelds (Einstellungen > Zusatzfelder > rechte Maustaste > Eigenschaften > interne ID):

projekt->ordermulti('projektleiter.name;zusatzfelder
->select(metaZusatzfeld.boldID=<interne ID>)->first.wert')

Je nach Feld-Typ können Sie den Wert wie folgt abfragen:

.wert
.wertBlob
.wertBoolean
.wertInteger
.wertCurrency
.wertDatum
.wertObject

Der union-Operator erlaubt die Zusammenfassung zweier Listen in einer. Er kann in einer OCL-Expression auf einer Liste angewandt werden und erwartet eine weitere Liste (Collection) als Argument:

offeneLeistungen->union(verrechneteLeistungen)

als Expression auf einem Projekt liefert alle offenen und verrechneten Leistungen des Projekts. Mit dieser Liste kann normal weitergearbeitet werden. Als Typ wird immer die gemeinsame Basisklasse verwendet, dessen Attribute zur Verfügung stehen. Das obige Beispiel liefert also eine Liste mit Einträgen vom Typ Leistung. Bei einer Expression projekt->union(adresseintrag) wäre die gemeinsame Basisklasse z.B. UserEintrag.

Zum Beispiel will man die Summe der Honorarnoten (netto) des jeweils letzten Jahres anzeigen:

rechnungen->select(datum.year=date.year-1)->collect(umsatz+vorschussbetrag-vorschusseffektiv)->sum

ohne den Collect-Operator müsste man die ganze '->select'-Expression für jeden Wert (umsatz, vorschussbetrag etc) wiederholen.

Man kann auch noch einen Schritt weitergehn, indem man den Wert, der aus dem collect resultiert, einer Variable zuweist und damit weiterarbeitet.

Als Beispiel nehmen wir eine Liste von Projekten. Jedes Projekt befindet sich (in diesem Beispiel) entweder in einem Ordner "Kundenprojekte" oder in einem Ordner "Interne Projekte" oder in einem Ordner "Auftragsprojekte". Diese Ordner sind jeweils Unterordner des Ordners "Projektkategorie". In der Liste möchten wir nun entweder 1, 2, oder 3 anzeigen, je nachdem, in welchem Ordner sich das Projekt in der Liste befindet:

ordner->select(parentordner.bezeichnung='Projektkategorie')
->first.bezeichnung.substring(1,1)->asSet->collect(x|if x ='K'then
'1'else if x='I'then'2'else if x='A'then'3'
else'Keine Angabe'endif endif endif)->first

Die Expression geht von einem Projekt aus (jedes Projekt in der Liste). ordner bedeutet also die Ordner, in denen sich das Projekt befindet. Wir suchen zuerst den Unterordner des Ordners Projektkategorie. Von diesem nehmen wir den ersten Buchstaben (bezeichnung.substring(1,1)). Das ist nun ein einzelner Buchstabe, entweder "K" oder "I" oder "A". Da der Collect-Operator nur auf einer Liste ausgeführt werden kann, fügen wir ein ->asSet an. Nun kommte der ->collect Operator dran: Anstatt für jede if Abfrage den ganzen ordner->select(...) Abschnitt zu wiederholen, kann einfach die Variable x mehrfach eingesetzt werden. Das x in der Klammer bezieht sich auf den aktuellen Wert. Das ist ja im Moment unser einzelner Buchstabe. Nun können wir über das x diesen Buchstaben abfragen und je nachdem den gewünschten Wert einsetzen. Das Ganze ist nun noch immer eine Liste. Wir möchten aber den einzelnen Wert im Feld anzeigen. Deshalb fügen wir wieder ein ->first an.

wandelt eine Zahl in ein Datum um. Die folgenden Expression zählt zum datum des Eintrags (z.B. einer Leistung) 31 Tage dazu:

(datum->dateToFloat+31)->floatToDate

Beispiel: statt

projekt->select(betreffend.asstring='') (alle Projekte ohne Betreffend)

kann man nun

projekt->select(betreffend.isNull)

ausführen.

Durch diesen Operator können Listen in Strings dargestellt werden. So liefert die Expression:

phasen.code->listToString(',')

ausgeführt auf einem Projekt (z.B. via Listeneinstellungen) die Liste der Phasen-Codes, mit "," getrennt.

Fragt die entsprechende Sprachversion eines Members ab. Dies gilt für alle MLStrings, das sind Werte, die für die verschiedenen Sprachen jeweils ein eigenes Feld haben (Beispiele sind Tätigkeiten, Spesen- und Auslagetypen). Zum Beispiel bei Auslagetypen auf einer Rechnung: Wenn man die französische Bezeichnung des Typs haben möchte, kann dies mit folgender Expression geschehen:

text.asStringByLanguage('FR')

Mögliche Sprachen / Parameter sind standardmässig 'DE', 'FR', 'IT', 'EN'. Wenn unter Einstellungen > Sprachen weitere Sprachen hinzugefügt wurden, wird davon jeweils die interne Bezeichnung verwendet.

(date.year-2000).pad(2,'0') / ergibt 06
(date.year-2000).pad(3,'0') / ergibt 006
...

Dieser Operator gibt die Anzahl Zeichen einer Zeichenfolge zurück. Zum Beispiel gibt die Expression adresseintrag->select(standardplz.length=4) alle Adressen mit einer vierstelligen PLZ zurück.

Die Syntax lautet wie folgt:

<string>->replaceString(substring, replacement)

Sie geben darin den Teil an, den Sie ersetzen möchten (substring) sowie den Teil, durch den er ersetzt werden soll (replacement). Rückgabewert ist wieder ein String.

Sie möchten beispielsweise in einem Text alle Meyer durch Maier ersetzen:

<text>->replaceString('Meyer', 'Maier')

Der Replace-String ist Case-Sensitiv, das heisst, er beachtet die Gross/Klein-Schreibung.

Die Syntax lautet wie folgt:

<string>->replaceRegex(template, replacement)

Hier kann ein regulärer Ausdruck, eine sogenannte Regular Expression, angegeben werden, sowohl für den Teil, den Sie ersetzen möchten (template) wie auch für den Teil, der ersetzt werden soll (replacement). Rückgabewert ist wieder ein String.

Ein kleines Beispiel, was damit möglich ist:

In einem Text sind Bezeichnung der Art <Abschnitt>:<Kapitel> vorhanden, z.B. 2:15 oder 3:10. Diese Bezeichnungen sollen getauscht werden, sodass sie als 15:2 bzw. 10:3 dargestellt werden. Dies kann mit folgender Expression geschehen:

<text>->replaceRegex('([0-9]*):([0-9]*)', '$2:$1')

->getSollzeit(von, bis)

Sollzeit in der Periode (minuten)

bisher

->getArbeitszeit(von, bis)

Arbeitszeit in der Periode (minuten). Berechnet aus der Summe aller vorhandenen Leistungen plus der Ferien, die als Abwesenheiten erfasst wurden.

bisher

->getUeberzeitvortrag(datum)

liefert den Ueberzeitsaldo per Datum-1, ausser auf Datum ist ein Vortrag erfasst, dann wird dieser Vortrag geliefert.

bisher

->getUeberzeitvortragDatum(datum)

liefert Datum des letzten Ueberzeitvortrags vor Datum

neu

->getUeberzeitsaldo(datum)

liefert Ueberzeitsaldo per Datum

neu

->getFerienVorgabe(von,bis)

Ferienguthaben innerhalb Periode

bisher

->getFerienBezug(von,bis)

Ferienbezug, sowohl Abwesenheiten als auch Ferienleistungen

neu

->getFerienVortrag(datum)

liefert den Feriensaldo per Datum-1, ausser auf Datum ist ein Vortrag erfasst, dann wird dieser Vortrag geliefert.

bisher

->getFerienVortragdatum(datum):

liefert Datum des letzten Ferienvortrags vor Datum

neu

->getFerienStart(datum)

liefert Startdatum für Berechnung des Ferienguthabens. Ist der nächste Ferien-Stichtag nach dem letzen Vortrag

neu

->getFerienEnd(datum)

liefert Enddatum für Berechnung des Ferienguthabens. Ist das nächst Ferienperiode-Ende

neu

->getFerienSaldo(datum)

liefert FerienSaldo per Datum

neu

->getLohn(von,bis)

Lohn innerhalb der angegebenen Periode

neu

->getGemeinkosten(von,bis)

Gemeinkosten innerhalb der angegebenen Periode

neu

berechnet den letzten Tag des Quartals. Beispiel:

self->groupleistungenP(date.firstOfQuarter.asstring,
date.lastOfQuarter.asstring, '')->collect(minutenintoffen+
minutenintverrechnet)->sum

berechnet ein Datum aufgrund von Zahlenwerten für Jahr, Monat und Tag. Beispiel: Ordner mit allen Rechnungen, die im Jahr 2012 erstellt wurden:

rechnung->select((datum >= encodeDate(2012,01,01)) and (datum <= encodeDate(2012,12,31)))

Beispiel:

creationdatetime.formatdatetime('c')-> '16.10.2010 15:24:31'

Der Formatstring kann folgendes enthalten:

• c: Zeigt das Datum im globalen Format Kurzes Datum (ShortDateFormat), gefolgt von der Zeit im globalen Format Lange Uhrzeit (LongTimeFormat). Wenn es keinen Zeitwert hat, erscheint nur das Datum.
• d: Tag als Zahl ohne vorangestellte 0 (1-31).
• dd: Tag als zweistellige Zahl (01-31).
• ddd: Tag als Abkürzung (Mo-So) gemäss globalen Einstellungen (ShortDayNames).
• dddd: Tag als Wort (Montag-Sonntag) gemäss globalen Einstellungen (LongDayNames).
• m: Monat als Zahl ohne vorangestellte 0 (1-12). Wenn m direkt auf h oder hh folgt, wird es als Platzhalter für Minuten statt für den Monat interpretiert, und es werden die Minuten angezeigt.
• mm: Monat als zweistellige Zahl (01-12). Wenn mm direkt auf h oder hh folgt, wird es als Platzhalter für Minuten statt für den Monat interpretiert, und es werden die Minuten angezeigt.
• mmm: Monat als Abkürzung (Jan-Dez) gemäss globalen Einstellungen (ShortMonthNames).
• mmmm: Monat als Wort (Januar-Dezember) gemäss globalen Einstellungen (LongMonthNames).
• yy: Jahr als zweistellige Zahl (00-99).
• yyyy: Jahr als vierstellige Zahl (0000-9999).
• h: Stunden ohne vorangestellte 0 (0-23).
• hh: Stunden als zweistellige Zahl (00-23).
• n: Minuten ohne vorangestellte 0 (0-59).
• nn: Minuten als zweistellige Zahl (00-59).
• s: Sekunden ohne vorangestellte 0 (0-59).
• ss: Sekunden als zweistellige Zahl (00-59).
• z: Milisekunden ohne vorangestellte 0 (0-999).
• zz: Milisekunden als dreistellige Zahl (000-999).
• t: Zeitwert im Format der kurzen Uhrzeit (ShortTimeFormat), z.B. 11:37.

• tt: Zeitwert im Format der langen Uhrzeit(LongTimeFormat), z.B. 11:37:40.

• /: Datumstrennzeichen gemäss globalen Einstellungen (DateSeparator).
• :: Zeittrennzeichen gemäss globalen Einstellungen (TimeSeparator).
• xx: Andere Buchstaben und Zeichen werden nicht formatiert, sondern so dargestellt wie eingegeben, z.B. hh...mm ergibt 11...37. Ausnahme: e, g.

projekt->select(code->sqllike('AB%'))

Als Platzhalter können folgende Zeichen verwendet werden:

• '%': Ersetzt einen beliebig langen String. Z.B. AA% beschreibt alle Strings, die mit AA beginnen.
• '_': Ersetzt einen einzelnen Buchstaben. Z.B. AA_ beschreibt alle Strings, die mit AA beginnen und danach genau einen beliebigen Buchstaben enthalten.

., *, +, [, ], ^, $, -, \