Verlinken

Interne ID: agorum.object.link

Sie können mit diesem Knoten Objekte in Ordner verlinken.

Aussehen des Knotens

Verhaltensweise

Erreicht das System den Knoten im Workflow, prüft das System die angegebenen Parameter. Das System verlinkt die Objekte aus der Eingangsvariable in den Ordner, den Sie im Parameter Ordner angegeben haben. Zudem setzt das System die auf dem Ordner sitzende ACL als Scope-ACL auf das verlinkte Objekt. Das Ergebnis speichert das System in die Ausgangsvariable.

Endpoints

Standard	Veränderbar?	Weitere Endpoints möglich?
Default (Inlet)	Nein, kann nur ausgeblendet werden.	ja, beliebig viele
Default (Outlet)	Nein, kann nur ausgeblendet werden.	ja, beliebig viele

Parameter

Parameter	Beschreibung	Beispiel
Ordner	Definiert den Ordner, in den Objekte verlinkt werden.	Ordner
E-Mail-Anhänge verlinken	Definiert, ob Anhänge einer E-Mail ebenfalls verlinkt werden oder nicht. Wenn Sie den Haken nicht setzen, werden die Anhänge nur kopiert und als neues Objekt abgelegt.	E-Mail-Anhänge verlinken
Eingangsvariable	Definiert die Variable, die die Objekte enthält. Wenn Sie die Variable nicht angeben, verwendet das System automatisch die Anhänge des Workflows aus der internen Variable sys_acw_attachments.	Eingangsvariable
Ausgangsvariable	Definiert die Variable, in die das Ergebnis gespeichert wird. Der Aufbau einer Ausgangsvariable ist identisch zu dem Aufbau einer Eingangsvariable.	–
Rechte	Definiert, mit welchen Rechten die Aktion des Knotens ausgeführt wird.	Rechte auf Knoten vergeben

Hinweis: Handelt es sich bei dem zu verlinkenden Objekt um einen E-Mail-Anhang und wird dieser E-Mail-Anhang verlinkt, würde sich das dahinterliegende Objekt verändern und der Workflow könnte nicht mehr mit dem ursprünglichen Objekt weiterarbeiten. Damit dies nicht passiert, kopiert der Knoten den Anhang in den angegebenen Ordner, belässt jedoch den Anhang in der ursprünglichen E-Mail.

Beispiel

Eingangsvariable/Anhänge:
- Rechnung ABC (direktes Objekt) ID: 100001
- Rechnung XYZ (E-Mail-Anhang) ID: 100002
Ausgangsvariable/Anhänge:
- Rechnung ABC (direktes Objekt) ID: 100001
  - = Das Objekt wird mit alter ID zurückgegeben und wurde verlinkt, da es sich um keinen E-Mail-Anhang handelt.
- Rechnung XYZ (kopiertes Objekt) ID: 100003
  - = Das Objekt wird mit neuer ID zurückgegeben und wurde kopiert, da es sich um einen E-Mail-Anhang handelt. In der E-Mail ist trotzdem noch das alte Objekt mit ID: 100002 vorhanden.

Benennen Sie daher die Ausgangsvariable gleich wie die Eingangsvariable, damit Sie nach dem Verlassen des Knotens mit dem gleichen Objekt weiterarbeiten können wie zuvor.

Tipp: Verwenden Sie die Variablenauswahl, um einen Überblick über alle nutzbaren Variablen zu erhalten.

Ordner

Im Editor

Angabe eines Ordners im Editor:

/Rechnungen

Sie können die Angabe des Ordners mit einer Datumseingabe erweitern:

/Rechnungen/${date:yyyy}/${date:MM}

Als Expression

Angabe eines Ordners mit Datum (Jahr) als Expression:

'Rechnungen/' + new Date().getFullYear()

In diesem Beispiel verlinkt das System die Objekte der Eingangsvariable in den angegebenen Ordner. 'Rechnungen/' ist hierbei ein String, danach holt das System das aktuelle Jahr mit new Date().getFullYear(). Abhängig vom aktuellen Jahr erstellt das System unterhalb des Ordners Rechnungen weitere Unterordner mit Angabe des Jahres.

Jahr 2020:

Rechnungen/2020

E-Mail-Anhänge verlinken

Im Editor

Im Editor setzen Sie den Haken, um E-Mail Anhänge zu verlinken. Wenn Sie ihn nicht setzen, kopiert das System die Anhänge einer E-Mail.

Als Expression

Eine Expression muss true oder false als Ergebnis zurückliefern.

Sie können etwa über den vorangegangenen Knoten Skript eine Variable belegen, die hier verwendet wird.

Im Skript

token.variables.shouldLink=true;

In der Expression

token.variables.shouldLink

Eingangsvariable

Die nachfolgenden Beispiele gelten ebenfalls für eine Ausgangsvariable.

Für generelle Schreibweise von Variablen im Editor oder als Expression siehe Schreibweise von Variablen.

Im Editor

Im Editor geben Sie den Namen der Workflow-Variable an. Das System platziert die Variable automatisch in der Variable des Tokens (token.variables).

inputVariable

Als Expression

Wenn Sie diesen Parameter als Expression angeben, geben Sie den vollständigen Pfad zur Variable an, von der das System den eigentlichen Namen der gewünschten Variable lesen soll.

'token.variables.nameOfInputVariable'