E-Mail-Anhänge entpacken und ablegen

Interne ID: agorum.mail.unwrap

Sie können mit diesem Knoten E-Mail-Anhänge entpacken und gleichzeitig in einen Ordner ablegen.

Hinweise:

Der Knoten entpackt nur E-Mails. Handelt es sich dabei um andere Arten von Objekten, etwa ZIP-Dateien, wirft das System einen Fehler.
Möchten Sie andere Objektarten, etwa ZIP-Dateien, entpacken, verwenden Sie den Knoten Entpacken.

Aussehen des Knotens

Verhaltensweise

Erreicht das System den Knoten, prüft es die enthaltenen Objekte in der Eingangsvariable. Das System entpackt anschließend die Objekte in den angegebenen Ordnern und speichert die entpackten Objekte in der Ausgangsvariable.

Auf die extrahierten Anhänge der E-Mails wird das Metadatum Ursprung mit der originalen UUID der E-Mail gesetzt, um die Herkunft zu speichern.

Hinweis: Das Metadatum ag_origin wird auf die entpackten Objekte gesetzt und definiert, zu welchem originalen Objekt das entpackte Objekt gehört.

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
Basisordner (Ordner-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
Zwischenmails	Definiert, ob neben E-Mail-Anhängen auch die E-Mail als solche entpackt werden. 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 sollen, damit verschachtelte E-Mails entpackt werden (siehe Parameter Zwischenmails).	–
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
Nur Anhänge zurückgeben	Definiert, ob nur die Anhänge einer E-Mail in die Ausgangsvariable geschrieben werden. Wenn Sie den Haken nicht setzen, wird nur die ursprüngliche E-Mail in der Ergebnisvariable zurückgegeben.	In E-Mail A sind die Anhänge B und C enthalten. Normalerweise würde in die Ergebnisvariable A, B und C geschrieben werden. Wird dieser Parameter aktiviert, wird die ursprüngliche E-Mail A nicht zurückgegeben. Das Ergebnis enthält nur B und C.
Regulärer Ausdruck zum Filtern der Anhänge	Definiert einen regulären Ausdruck, der für die Filterung verwendet wird. Filtert die Daten der Objekte anhand des Namens. Sie können einen String oder einen RegEx 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 werden.	Rechte auf Knoten vergeben

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

Basisordner (Ordner-ID oder Suche)

Ordner-ID

Angabe einer Ordner-ID, wenn der Haken die obige Eingabe ist eine Suche nicht gesetzt ist:

/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 einer Suche, wenn der Haken die obige Eingabe ist eine Suche gesetzt ist:

identifier:lieferanten test_lieferantennummer:(${test_lieferantennummer})

In diesem Beispiel wurde die Suche aktiviert. Das System sucht nach allen Objekten, die den identifier lieferanten 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:

Metadatum identifier im Objekt

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

Pfad

Im Editor

Angabe eines Pfads im Editor:

/Rechnungen

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

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

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

E-Mail-Anhänge verlinken

Im Editor

Im Editor setzen Sie den Haken, um E-Mail Anhänge zu verlinken, oder setzen ihn nicht, um Anhänge einer E-Mail nur zu kopieren.

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

Regulärer Ausdruck zum Filtern der Anhänge

RegEx im Editor

Um etwa per RegEx nach allen PDF-Dateien und DOCX-Dateien zu filtern, verwenden Sie folgende Schreibweise im Editor:

\.(pdf|docx)$

RegEx als Expression

Um etwa per RegEx nach allen PDF-Dateien und DOCX-Dateien zu filtern, verwenden Sie folgende Schreibweise in der Expression. Das System beachtet dabei sowohl Groß- als auch Kleinschreibung von pdf und docx:

/\.(pdf|docx)$/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'