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


Entpacken

Interne ID: agorum.object.unwrap

Sie können mit diesem Knoten E-Mail-Anhänge und / oder ZIP-Dateien entpacken. 

Hinweis: Das Metadatum ag_origin wird auf die entpackten E-Mail-Anhänge gesetzt und definiert, zu welcher originalen E-Mail die Anhänge gehört. Bei verschachtelten E-Mails enthält ag_origin dennoch die UUID der „ersten“ E-Mail.

Aussehen des Knotens

Verhaltensweise


Erreicht das System den Knoten, prüft es die enthaltenen Objekte in der Eingangsvariable. Je nachdem, was entpackt werden soll (E-Mails und / oder ZIP-Dateien) entpackt das System anschließend die Objekte und speichert die entpackten Objekte in der Ausgangsvariable.

Endpoints


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

Parameter


Parameter Beschreibung Beispiel
ZIP-Archive Definiert, ob ZIP-Archive entpackt werden.

Der Parameter E-Mails kann gleichzeitig aktiviert sein.

Definieren Sie etwa, dass nur ZIP-Archive entpackt werden, es befinden sich in der Eingangsvariable aber sowohl E-Mails, PDFs und ZIP-Archive, speichert das System alle Objekte, die dem Filter entsprechen, in der Ausgangsvariable. Es werden also die E-Mail sowie der Inhalt des ZIP-Archivs in die Ausgangsvariable gespeichert, nicht jedoch das ZIP-Archiv als solches.
E-Mails Definiert, ob E-Mails entpackt werden. Der Parameter "ZIP-Archive" kann gleichzeitig aktiviert sein.
Zwischenmails Definiert, ob neben E-Mail-Anhängen die E-Mail als solche entpackt wird.

Wenn E-Mails in anderen E-Mails verschachtelt sind, werden im Normalfall nur die Anhänge der E-Mail entpackt.

Beispiel
  • In E-Mail A ist E-Mail B enthalten.
  • In E-Mail B befindet sich der Anhang Rechnung01.pdf.
     
  • Ist zusätzlich der Parameter Rekursiv aktiv, werden der Anhang Rechnung01.pdf sowie die E-Mail B entpackt. Die Ausgangsvariable enthält somit beide Objekte.
  • Ist nur der Parameter Rekursiv aktiviert, wird nur der Anhang Rechnung01.pdf entpackt. Die Ausgangsvariable enthält somit nur ein Objekt.
Rekursiv Definiert, ob Objekte rekursiv entpackt werden, damit verschachtelte E-Mails (siehe Parameter Zwischenmails) und ZIP-Archive entpackt werden.
Regulärer Ausdruck zum Filtern der Anhänge Definiert einen regulären Ausdruck, der für die Filterung verwendet wird, und filtert die Daten der Objekte anhand des Namens.
  • Sie können einen String oder einen Regex angeben.
  • Bei Angabe eines Strings müssen Sie den Namen vollständig angeben.
Regulärer Ausdruck zum Filtern der Anhänge
Eingangsvariable Definiert eine Eingangsvariable, die Objekte (Arrays) enthält.
  • Alle Objekte werden mit diesem Knoten abgearbeitet.
  • 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 eine Ausgangsvariable, die das Ergebnis des Knotens enthält, sobald das System den Knoten verarbeitet hat.

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

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

Regulärer Ausdruck zum Filtern der Anhänge 


RegEx als Expression

Geben Sie ein RegEx an, müssen Sie dies als Expression folgendermaßen hinterlegen:

#{/^name_/}


String per Editor

Um etwa nach allen PDF-Dateien zu filtern, verwenden Sie folgende Schreibweise im Editor

.pdf$


String als Expression

Die folgende Schreibweise beachtet sowohl Groß- als auch Kleinschreibung von pdf:

/.pdf$/i

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'