Scripts registrieren

Bezeichnung

Unter diesem Namen erscheint das Script später im Menü Aktionen. Es sollte also darauf geachtet werden, dass der Name aussagekräftig ist, aber nicht allzu lang.

Plattform

Hier kann angegeben werden, um welche (Code-)Sprache es sich bei dem Script handelt:

• Python: Das ist der Standard und bei neuen Scripteinträgen voreingestellt. Python Scripts sind cloudfähig und auch in der Cloud App und der Web App ausführbar. Ab Vertec 6.7.0.12 können nur noch Python Scripts als Menüpunkte registriert werden.
• VBScript: Diese Einstellung ist verfügbar aus Rückwärtskompatibilitätsgründen. VBScripts in Vertec  sind nur in der Desktop App lauffähig (On-Premises) und nicht cloudfähig. Wir empfehlen deshalb, nur noch Python Scripts zu verwenden.

In Vertec Versionen vor 6.6 gibt es dieses Feld noch nicht. In diesem Fall muss der Script Text mit einem # beginnen, wenn es sich um ein Python Script handelt.

Klassen

Geben Sie hier an, für welche Art von Objekten (Klassen) in Vertec das Script ausgeführt werden kann. Der Menüpunkt erscheint im Menü Aktionen (bzw. im Kontextmenü) nur dort, wofür es registriert wurde. Ist eine Klasse in der Auswahl nicht vorhanden, kann sie auch einfach von Hand ins Feld eingetippt werden. Beachten Sie dabei, dass Klassennamen mit grossem Anfangsbuchstaben geschrieben werden müssen.

 Versionen vor 6.7.0.12: Gültig sind alle Klassen in Vertec, die von der Klasse UserEintrag erben. Scripts können also nicht auf Container (Ordner) registriert werden.

Versionen ab 6.7.0.12 bei Scripts nach neuer Art (siehe Abschnitt Änderungen ab Vertec Version 6.7.0.12 ): Gültig sind alle Klassen in Vertec, die von der Klasse Eintrag erben. Scripts können also auch auf Container (Ordner, Expression-Ordner, Link Container etc.) registriert werden.

Anzeigebedingung

Hier kann eine Anzeigebedingung als OCL Expression angegeben werden, mit welcher gesteuert werden kann, ob das Script im Menü Aktionen (bzw. im Kontextmenü) erscheint oder nicht. Durch Klick auf den Button mit den drei Punkten öffnet sich der Expression Editor. Das Resultat dieser Expression muss einen Ja/Nein Wert (Boolean) zurückliefern. Nur wenn die Bedingung erfüllt ist, erscheint das Script im Menü Aktionen.

Versionen vor 6.7.0.12

Die Bedingung gilt nur für Scripts auf einzelnen Objekten. Bei Scripts, die zur Anzeige auf Listen konfiguriert sind, wird die Bedingung nicht ausgewertet. Die OCL Expression bezieht sich auf das argobject. Beispiel:

• verrechnet für ein Script, das nur auf Rechnungen erscheinen soll, die bereits verrechnet sind.

Versionen ab 6.7.0.12

Bei Scripts nach neuer Art (siehe Abschnitt Änderungen ab Vertec Version 6.7.0.12 ) bezieht sich die Anzeigebedingung auf die Liste der ausgewählten Objekte (selectedobjects). Im OCL Expression Editor entspricht self dieser Liste. Beispiele:

• self->size = 1 für Scripts, die sich so verhalten sollen wie früher Scripts auf einzelnen Objekten. Erscheinen also nur, wenn nur genau ein Objekt ausgewählt ist.
• self.oclAsType(Rechnung)->select(not verrechnet)->size = 0 für ein Rechnungsscript, das nur erscheinen sein soll, wenn alle ausgewählten Rechnungen bereits verrechnet sind.
• self->first.objid = xxxx für Containerscripts, die nur auf einem ganz bestimmten Ordner angezeigt werden sollen. Alternativ auch mit Eintrag ID möglich.
• self->collect(oclType.asstring)->asSet->size = 1 für ein Script, das nur erscheinen soll, wenn alle ausgewählten Objekte den gleichen Typ haben.

Auf einzelne Objekte anwendbar

Vertec Versionen vor 6.7.0.12. Setzen Sie hier ein Häkchen, falls das Script auf dem einzelnen Objekt (z.B. auf einer Rechnung) angewendet werden kann.

Bei Scripts, die vor 6.7.0.12 registriert wurden, befindet sich diese Checkbox nach dem Update auf 6.7.0.12 auf der Seite Weitere Info. Siehe dazu Abschnitt Änderungen ab Vertec Version 6.7.0.12 .

Auf Listen (Container) anwendbar

Vertec Versionen vor 6.7.0.12. Setzen Sie hier ein Häkchen, falls das Script auf einer Liste von Objekten (z.B. auf einer Projektliste) angewendet werden kann.

Bei Scripts, die vor 6.7.0.12 registriert wurden, befindet sich diese Checkbox nach dem Update auf 6.7.0.12 auf der Seite Weitere Info. Siehe dazu Abschnitt Änderungen ab Vertec Version 6.7.0.12 .

Erweiterte Berechtigungen

Sollen registrierte Scripts später auch von Usern mit eingeschränkten Benutzerrechten ausgeführt werden können, kann für die entsprechenden Codestellen eine erweiterte Berechtigung erteilt werden. Siehe dazu den Artikel Erweiterte Berechtigungen in Scripts .

Script Text

Hier wird der Script Code eingefügt. Siehe dazu den Abschnitt Code in Scripts als Menüpunkte weiter unten.

Ausführen...

Script Editor...

Öffnet das Script, falls es sich um ein Python Script handelt, im Script Editor . Der Script Editor ist dann mit dem Scripteintrag verbunden. Das heisst: wird im Script Editor Code angepasst, ändert sich der Script Text im Scripteintrag ebenfalls.