Durchsuchbare Dokumentation aufrufen | Zurück zur Dokumentationsübersicht
Navigation: Dokumentationen agorum core > agorum core workflow 3.0 > ACLs/Berechtigungen im Workflow setzen > DATEV XML-Schnittstelle online > Übersicht vorhandener Knoten
Interne ID: agorum.object.link
Sie können mit diesem Knoten Objekte in Ordner verlinken.
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.
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 | 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.
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
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
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'