Die Liste der vorhandenen Felder in Vertec wird durch das Modell vorgegeben und kann nicht geändert werden. Da es jedoch vorkommt, dass Sie auf Daten noch zusätzliche Informationen ablegen wollen (z.B. Auftragswahrscheinlichkeit auf Projekt), gibt es Zusatzfelder.

Zusatzfelder definieren

Zusatzfelder werden im Ordner Einstellungen - Zusatzfelder verwaltet. Jedes Zusatzfeld basiert auf einer Zusatzfeldklasse. Wenn Sie ein neues Zusatzfeld erzeugen müssen, klicken Sie mit der rechten Maustaste auf den Ordner und wählen Sie Neu - Zusatzfeldklasse.

Zusatzfelder ansehen

Die Zusatzfeld erscheinen in der Einzelansicht der entsprechenden Einträge unter dem Reiter Weitere Info:

Zugriff auf Zusatzfelder

Sie können diese Zusatzfelder auch in Listen anzeigen, in Word-Berichten verwenden oder in einem Expression-Ordner danach filtern, indem Sie via OCL darauf zugreifen. Auch die Abfrage via SQL-Ordner ist möglich.

SQL

Über SQL kann auf die verschiedenen Zusatzfelder folgendermassen zugegriffen werden:

Detaillierte Beschreibung und Beispiele finden Sie im Artikel SQL-Expressions für SQL-Ordner.

OCL

Über OCL kann auf die verschiedenen Zusatzfelder folgendermassen zugegriffen werden:

• zusatzfeldAsString(name): liefert den Wert eines Zusatzfeldes unabhängig von dessen Typ als Stringwert.

• Abhängig vom Typ wird das Feld folgendermassen abgefragt:

  Zusatzfeld-typ	Operator
  Zeichen	zusatzfeld
  Wahr, Falsch	zusatzfeldbool
  Ganzzahl	zusatzfeldint
  Minuten	zusatzfeldint
  Festkommazahl	zusatzfeldcurr
  Datum	zusatzfelddate
  Text	zusatzfeldblob
  Bild	zusatzfeldblob
  Objekt	zusatzfeldobj (siehe Tipps weiter unten)
  Auswahl	zusatzfeldint (gibt Position der Auswahl zurück) zusatzfeldasstring (gibt den Auswahltext zurück)

  Beispiel: Alle Adressen, die als ABC-Adressen gekennzeichnet sind (Wahr,Falsch-Zusatzfeld "ABC-Adresse" auf Adresseintrag):

  adresseintrag->select(zusatzfeldbool('ABC-Adresse'))

Unterschied zwischen typenabhängiger und typenunabhängiger Abfrage

In den meisten Fällen kommt das auf der Oberfläche auf dasselbe heraus, da schlussendlich meist ein String dargestellt wird.

Unterschied gibt vor allem bei Auswahl-Zusatzfeldern. Diese sind intern als Integer Zusatzfelder implementiert. Das bedeutet, dass die Expression zusatzfeldint(name) eine Zahl liefert. Wenn der Text der Auswahl angezeigt werden soll, dann sollte die expression zusatzfeldasstring(name) verwendet werden.

Ebenso liefern die typspezifischen OCL Operatoren NULL Werte, falls das Zusatzfeld den Wert NULL hat. Dies stellt aber in den meisten Fällen kein Problem dar, da NULL Werte als Leerstrings dargestellt werden. Falls ein NULL Wert Probleme macht, kann dies durch Verwendung von zusatzfeldAsString vermieden werden.

Tipps zum Umgang mit zusatzfeldobj

Der Operator zusatzfeldObj zum Abfragen von Objekt-Zusatzfeldern kann zu Fehlern führen, wenn er in einer OCL Expression auf einer Liste von Objekten angewendet wird. Die Fehlermeldung lautet:

TBoldObjectList.AddElement: Element not a TBoldObject

Beispiel: Objektzusatzfeld 'Niederlassung' auf Projektbearbeiter. Zeigt z.B. auf eine Adresse.

offeneLeistungen.bearbeiter.zusatzfeldobj('Niederlassung')->asset->size

sollte die Anzahl verschiedener Niederlassungen in einer Leistungliste angeben. Gibt aber den obigen Fehler.

Lösung:

offeneLeistungen.bearbeiter->collect(zusatzfeldObj('Niederlassung')->oclasType
(UserEintrag))->asset->size

Erklärung:

Die Anwendung von zusatzfeldObj auf eine Liste entspricht einer impliziten "collect" operation. Diese schlägt fehl, weil zusatzfeldObj nicht direkt das verknüpfte Objekt sondern das Verknüpfungfeld liefert.

Eine Typumwandlung auf einen kompatiblen Objekttyp (den eigentlichen Typ des Objekts oder UserEintrag) behebt das Problem. Damit die Typumwandlung stattfinden kann, muss die collect Operation explizit formuliert werden.