Open Source Dokumentenmanagement
Dokumentation

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


Dokumente in Ordner auschecken

Interne ID: agorum.versioning.checkOutInto

Sie können mit diesem Knoten Dokumente auschecken und in einen Ordner ablegen. Für ausgecheckte Dokumente erstellt das System jeweils eine Arbeitskopie und sperrt die aktuellen Dokumente. Die Arbeitskopie wird standardmäßig im Ordner Eigene Dateien/In Bearbeitung des aktuellen Benutzers angelegt.

Aussehen des Knotens

Verhaltensweise


Erreicht das System den Knoten im Workflow, prüft das System die Eingangsvariable, in der sich die auszucheckenden Dokumente befinden. Anschließend sperrt das System die ausgecheckten Dokumente gegen Veränderungen, erstellt gleichzeitig Arbeitskopien der ausgecheckten Dokumente für den aktuellen Benutzer und legt die ausgecheckten Dokumente im angegebenen Ordner ab. Die ausgecheckten Dokumente übergibt das System in der Ausgangsvariable.

Endpoints


Standard Veränderbar? Weitere Endpoints möglich?
Default (Inlet) Nein, kann nur ausgeblendet werden. nicht nötig
Default (Outlet)

Parameter


Parameter Beschreibung Beispiel
Eingangsvariable Definiert, welche Dokumente ausgecheckt werden.

Wenn Sie die Variable nicht angeben, verwendet das System automatisch die Anhänge des Workflows aus der internen Variable sys_acw_attachments.
Eingangsvariable
Basisordner (Order-ID oder Suche) Definiert einen Basisordner für die Ablage (wenn Haken die obige Eingabe ist eine Suche nicht gesetzt ist) oder ermöglicht eine Suche nach einem bestimmten Ordner (wenn Haken die obige Eingabe ist eine Suche gesetzt ist). Basisordner (Ordner-ID oder Suche)
Pfad Definiert den Pfad unterhalb des Basisordners. Pfad
Ausgangsvariable Definiert, in welcher Variable die ausgecheckten Dokumente übergeben werden.

Der Aufbau einer Ausgangsvariable ist identisch zu dem Aufbau einer Eingangsvariable.
Rechte: Ablage Definiert, mit welchen Rechten die Aktion des Knotens ausgeführt wird. Rechte auf Knoten vergeben
Rechte: Checkout

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

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'

Basisordner (Ordner-ID oder Suche)
 

Ordner-ID

Angabe eines Basisordners als ID im Editor (Haken die obige Eingabe ist eine Suche nicht gesetzt):

/agorum/roi/Files/Lieferantenakten/${test_lieferantennummer}

In diesem Beispiel wurde eine feste ID / ein fester Ordner inklusive Workflow-Variable als Platzhalter angegeben (${test_lieferantennummer}). Die Variable muss zuvor existieren, etwa können Sie die Variable in einem Skript-Knoten erstellen und befüllen:

/*global sc, sca, token, instance, outlets, inlet, parameters */

token.variables.test_lieferantennummer = '123456';

token.leave('');

Der Ordner /Lieferantenakten/123456 muss ebenfalls zu diesem Zeitpunkt schon bestehen, er wird also durch diesen Knoten nicht angelegt.
 

Suche

Angabe eines Basisordners im Editor (Haken die obige Eingabe ist eine Suche gesetzt):

identifier:lieferantenake test_lieferantennummer:(${test_lieferantennummer})

In diesem Beispiel wurde die Suche aktiviert. Das System sucht nach allen Objekten, die den identifier lieferantenakte gesetzt haben. Außerdem wird der Ordner test_lieferantennummer mit der Nummer aus der Variablen test_lieferantennummer gefüllt. Der identifier und test_lieferantennummer sind Metadaten auf einem Objekt.

Sie können des Weiteren beliebige agorum core smart search-Anfragen beim Basisordner angeben.

Pfad
 

Im Editor

Angabe eines Pfads im Editor:

/Rechnungen


Als Expression

Angabe eines Pfads mit Datum (Jahr) als Expression:

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

In diesem Beispiel wurde eine Datumsangabe (Jahr) als Expression gesetzt. '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