Vertec Systemeinstellungen erzeugen

Vertec Systemeinstellungen erzeugen: Aufbau und Codebeispiele

Produktlinie

Standard

|

Expert

Betriebsart

CLOUD ABO

|

ON-PREMISES

Module

Leistung & CRM

Budget & Teilprojekt

Fremdkosten

Ressourcenplanung

Business Intelligence

Erstellt: 18.02.2013
Aktualisiert: 24.09.2024 | Code für die Erzeugung von ObjectProperty korrigiert.

Vertec enthält eine Vielzahl von Systemeinstellungen (Properties), in denen Werte hinterlegt werden können.

Sie können auch eine zusätzliche Systemeinstellung erzeugen. Auf die darin hinterlegten Werte kann später in Scripts, Reports, OCL Expressions etc. zugegriffen werden (siehe Properties via OCL). Diese eignen sich zur kundenspezifischen Steuerung von Vertec.

Aufbau der Properties

Wir unterscheiden zwischen AuswahlProperty und anderen Property-Typen (BlobProperty, BooleanProperty, CurrencyProperty, DateTimeProperty, IntegerProperty, ObjectProperty und StringProperty).

Die AuswahlProperty ist intern eine IntegerProperty, hat aber ein zusätzliches Attribut Auswahlliste. Dieses enthält eine comma-delimited Liste von Optionen. Auf der Oberfläche wird dann eine Combobox mit diesen Optionen angezeigt. Als Werte werden die Indizes der Optionen (0-basiert) verwendet.

Alle andere Properties können via die Attribute Auswahltyp und Expression konfiguriert werden.

Die verschiedenen Propertytypen haben folgende Attribute:

Attribut

Bedeutung

propertyname

Interner Name des Propertys, ohne Sonderzeichen und Leerschläge. Über diesen Namen wird später auf das Property zugegriffen , er erscheint nicht auf der Oberfläche. Länge: 255 Zeichen.

propertycaption

Beschreibung des Propertys, die in den Systemeinstellungen angezeigt wird. Normaler Fliesstext, Länge: 255 Zeichen.

propertyvalue

Eigentlicher Wert des Property. Wird normalerweise vom User (über die Oberfläche) abgefragt. Wenn sie einen Standardwert setzen möchten, können Sie hier einen passenden Wert eingeben (gilt für alle Property-Typen ausser Object-Property ).

auswahltyp

Folgende Auswahltypen stehen zur Verfügung:

0: keiner

1: Allgemeine Objekt-Auswahl

  • Wird unterstützt für Object- oder String-Properties
  • Es erscheint ein Objekt-Listendialog.
  • Die angezeigte Auswahl-Liste wird gewonnen durch Anwendung der Property-Expression auf dem System.

2: Adressen-Auswahl

  • Wird unterstützt für Object- oder String-Properties.
  • Es erscheint ein Adressen-Suchdialog.

3: Ordner-Auswahl

  • Es erscheint ein Baum-Dialog zum Auswählen eines Vertec Containers.
  • In der Property Expression kann ein Klassenname angegeben werden, dann werden nur Container aufgelistet, die diese Klasse enthalten können.

4: File-Auswahl

  • Unterstützt für String Properties
  • Es erscheint ein Filesystem Datei-Auswahldialog und es kann eine Datei ausgewählt werden.
  • Setzt den vollen Pfad des Files als Propertywert ein.

5: Pfad-Auswahl

  • Unterstützt für String Properties.
  • Es erscheint ein Filesystem Ordner-Auswahldialog und es kann ein Ordner ausgewählt werden.
  • Setzt den vollen Pfad des Ordners als Propertywert ein.

6: Auswahldialog von Extension

  • Unterstützt für alle String-kompatiblen Properties.
  • Delegiert Anzeige von Dialog an eine Extension.
  • Property-Expression gibt den Namen der Extension an. Diese muss eine Methode SelectPropertyValue(valuename, defaultvalue) haben, welche den gewählten Wert als String zurückgibt. Diese Methode wird aufgerufen mit dem Namen der Property.

7: Image

  • Ab Vertec 6.5.0.11
  • Unterstützt für Blob-Properties
  • Zeigt ein Imagefeld an, wo ein Bild geladen oder gespeichert werden kann (Menüpunkte Bild öffnen, laden, speichern, löschen).

expression

Je nach Auswahltyp (siehe oben)

gruppe

Gibt an, in welcher Section in den Systemeinstellungen das Property angezeigt werden soll. Es gibt folgende Möglichkeiten:

0: Allgemein

1: Adressen

2: Projekt / Mandat

3: Rechnung / Honorarnote

4: Buchhaltung

8: Ressourcenplanung

9: CRM / Aktivitäten

10: Telefonie

12: Authentisierung

13: E-Mail

99: Unsichtbar

scope

Gibt an, ob es ein allgemeines oder ein benutzerspezifisches Property ist.

0: Global

1: Benutzerspezifisch

auswahlliste

Nur bei AuswahlProperties. Enthält eine comma-delimited Liste von Optionen. Auf der Oberfläche wird dann eine Combobox mit diesen Optionen angezeigt.

masked

Nur bei String-Properties. Zeigt den Wert maskiert an, z.B. für Passwörter.

Codebeispiele

StringProperty

Bei einem Stringproperty handelt es sich um ein Property, wo ein alphanumerischer Text oder ein Pfad eingegeben wird.

Einfaches Feld

Es kann z.B. ein Feld sein, in das der Wert von Hand getippt wird:

Wird wie folgt erzeugt:

p = vtcapp.createobject("StringProperty")

p.propertyname = "name_property"
p.propertycaption = "Bezeichnung"
p.auswahltyp = 0 #Keiner
p.gruppe = 0 #Allgemein
Browser Filesystem

oder aber auch über einen Browser (im Filesystem oder in einem externen Programm wie z.B. der Buchhaltung:

Wird wie folgt erzeugt:

p = vtcapp.createobject("StringProperty")

p.propertyname = "name_property"
p.propertycaption = "Bezeichnung"
p.auswahltyp = 5 
p.gruppe = 0 #Allgemein

BooleanProperty

Ja/Nein-Werte. Boolean-Properties werden standardmässig auf Nein initialisiert. Sie können den Standard explizit setzen, indem Sie wie hier im Beispiel den propertyvalue setzen.

Wird wie folgt erzeugt:

p = vtcapp.createobject("BooleanProperty")

p.propertyname = "name_property"
p.propertycaption = "Bezeichnung"
p.auswahltyp = 0 
p.gruppe = 0 #Allgemein
p.propertyvalue = True

AuswahlProperty

Wert auswählen aus einer Liste mittels Combobox.

Wird wie folgt erzeugt:

p = vtcapp.createobject("AuswahlProperty")
p.propertyname = "name_property"
p.propertycaption = "Bezeichnung"
p.auswahltyp = 0
p.gruppe = 0 #Allgemein
p.auswahlliste = '"Wert 1","Wert 2","Wert 3"'

DatetimeProperty

Datumswerte.

Wird wie folgt erzeugt:

p = vtcapp.createobject("DatetimeProperty")

p.propertyname = "name_property"
p.propertycaption = "Bezeichnung"
p.auswahltyp = 0 
p.gruppe = 0 #Allgemein

IntegerProperty

Ganzzahliger Wert (wie z.B. bei der Länge der Rechnungsnummer).

Wird wie folgt erzeugt:

p = vtcapp.createobject("IntegerProperty")

p.propertyname = "name_property"
p.propertycaption = "Bezeichnung"
p.auswahltyp = 0 
p.gruppe = 0 #Allgemein

MinutenProperty

Eingabe eines Minutenwerts. Anzeige des Wertes auf der Oberfläche gemäss Einstellung der Systemeinstellungen Projekt > Anzeige Minuten. Wird intern als Integer gespeichert.

Wird wie folgt erzeugt:

p = vtcapp.createobject("MinutenProperty")

p.propertyname = "name_property"
p.propertycaption = "Bezeichnung"
p.auswahltyp = 0 
p.gruppe = 0 #Allgemein

CurrencyProperty

Enthält eine Festkommazahl, zum Beispiel einen Frankenbetrag.

Wird wie folgt erzeugt:

p = vtcapp.createobject("CurrencyProperty")

p.propertyname = "name_property"
p.propertycaption = "Bezeichnung"
p.auswahltyp = 0 
p.gruppe = 0 #Allgemein

ObjectProperty

Internes Vertec Objekt. Zeigt ein Auswahlfeld mit Einträgen aus Vertec gemäss der OCL Expression.

Wird wie folgt erzeugt:

p = vtcapp.createobject("ObjectProperty")

p.propertyname = "name_property"
p.propertycaption = "Bezeichnung"
p.auswahltyp = 1 
p.gruppe = 9 #CRM/Aktivitäten
p.expression = "Aktivitaetstyp.allInstances" #OCL Expression
p.objectboldid = 12345

Um einen Wert zuzuweisen im Code, kann nicht wie bei den anderen Properties die propertyValue gesetzt werden, da ObjectProperty.propertyValue derived ist. Die Zuweisung erfolgt hier über das Member objectBoldID:

p.objectboldid = 12345 #(ID des zugewiesenen Objekts)

Ab Vertec 6.4.0.8 kann die Python Methode vtcapp.setpropertyvalue auch für ObjectProperties verwendet werden.

BlobProperty

Ein Wert, der in der Datenbank in einem Blob-Feld abgespeichert wird. Wird zum Beispiel für sehr lange Referenznummern verwendet, für die ein normales String-Feld nicht ausreicht.

Wird wie folgt erzeugt:

p = vtcapp.createobject("BlobProperty")

p.propertyname = "name_property"
p.propertycaption = "Bezeichnung"
p.auswahltyp = 0 
p.gruppe = 1 #Adressen

Bitte wählen Sie Ihren Standort