Operatoren und Methoden für Links

Damit die Links in Scripts und OCL Expressions besser handhabbar sind, wurden im Zuge der Einführung von CustomLinks (Version 5.6) auch folgende Operatoren und Methoden eingeführt, welche für alle Linktypen (Generic-Links, Wrapper-Links, Custom-Links) gleichermassen anwendbar sind.

Methoden (Python und VB Script)

<Vertecobjekt>.linkto(target, rolle)

Macht eine Verknüpfung (via Linktyp) vom Objekt zum übergebenen Objekt (target) mit der angegebenen Rolle.

Als Rolle wird die Bezeichnung der gewünschten Linkrolle (Teil des Linktyps) angegeben.

<Vertecobjekt>.unlink(target, rolle)

Entfernt eine Verknüpfung zum übergebenen Objekt mit der angegebenen Rolle.

Hinweis für Custom-Links: Ist darauf die Löschweitergabe konfiguriert, dann kann der Link nicht mit der unlink Methode aufgelöst werden. Die Auflösung eines solchen Links ist nur durch Löschen eines der Linkpartner-Objekte möglich.

Beispiel

Linktyp

Die Beispiele beziehen sich auf den folgenden Linktyp Verwaltungsräte - VR-Mandate:

Als Rolle wird jeweils die Bezeichnung auf Seite des Targets angegeben:

PythonVB Script

Objekt: Person

Target: Firma

person = argobject
firma = vtcapp.getobjectbyid(2995)
person.linkto(firma, "VR-Mandate")
Dim person
Dim firma
Set person = vertec.argobject
Set firma = vertec.eval("firma->select(boldid=2995)->first")
person.linkto firma, "VR-Mandate"

Objekt: Firma

Target: Person

person = argobject
firma = vtcapp.getobjectbyid(2995)
firma.linkto(person, "Verwaltungsräte")
Dim person
Dim firma
Set person = vertec.argobject
Set firma = vertec.eval("firma->select(boldid=2995)->first")
firma.linkto person, "Verwaltungsräte"

Die unlink Methode funktioniert genau gleich. Einfach im Code linkto durch unlink ersetzen.

OCL Operator

usereintrag->getLinks(rolle)

Gibt eine Liste von Objekten zurück, die unter dieser Rolle mit dem Eintrag verlinkt sind.

Person->getLinks('VR-Mandate')

Das sind dieselben Einträge, die im Ordner VR-Mandate bei der Person erscheinen, falls dieser angezeigt wird.


03.05.2011 | 31.01.2017: Ausführlicheres Beispiel sowie Python Codebeispiele eingefügt.
Produktlinien: Expert
Module: Leistung & CRM