Ordnerstruktur anlegen

Interne ID: agorum.folder.structure

Mit diesem Knoten legen Sie eine Ordnerstruktur auf Basis einer Anlagekonfiguration des agorum core smart assistant konfigurators an.

Aussehen des Knotens

Verhaltensweise

Erreicht das System den Knoten im Workflow, prüft das System die angegebenen Parameter. Sofern die erforderlichen Parameter vorhanden sind, verwendet der Knoten die angegebene Suchanfrage, um eine vorhandene Ordnerstruktur in agorum core zu suchen. Ist diese nicht vorhanden, verwendet der Knoten die angegebene Anlagekonfiguration des agorum core smart assistant konfigurators, den angegebenen Zielordner und die angegebene Datenstruktur der Metadaten, um eine neue Ordnerstruktur anzulegen.

Ist in der Anlagekonfiguration des agorum core smart assistant konfigurators ein Sprungziel angegeben, wird diese Anlagekonfiguration als Array in der Ergebnisvariable zurückgegeben.

Endpoints

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

Parameter

Parameter	Beschreibung	Beispiel
Suche nach vorhandener Struktur	Definiert eine auszuführende Suchanfrage. Geben Sie eine beliebige agorum core smart search-Anfrage ein. Details erhalten Sie in der Dokumentation zur Suche. Liefert diese Suchanfrage ein Ergebnis, wird dieser Ordner in der Ergebnisvariable zurückgegeben. Tipp: Geben Sie die Suche zuerst im agorum core information center ein und testen Sie die Suche, bevor Sie sie in diesem Parameter verwenden.	Suche nach vorhandener Struktur
Interner Name der Anlagekonfiguration	Definiert, welche Anlagekonfiguration verwendet wird. Geben Sie den internen Namen der Anlagekonfiguration aus der agorum core smart assistant-Konfiguration an, die der Knoten verwenden soll.	Interner Name der Anlagekonfiguration
Zielverzeichnis (Ordner-ID oder Suche)	Definiert einen Zielordner für die Anlage (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), sofern in der im Parameter Interner Name der Anlagekonfiguration angegebenen Anlagekonfiguration kein Zielordner definiert wurde. Tipp: Wenn Sie eine Suche angeben, testen Sie diese zuerst im agorum core information center, bevor Sie sie in diesem Parameter verwenden.	Zielverzeichnis (Ordner-ID oder Suche)
Datenvariable	Definiert die Variable, die Metadaten enthält oder speichert. Wenn Sie die Variable nicht angeben, werden alle Metadaten und Werte genommen, die zu diesem Zeitpunkt im Knoten vorliegen und durch andere Knoten übergeben wurden.	Datenvariable
Ergebnisvariable	Definiert die Variable, die das Ergebnis des Knotens enthält, in diesem Fall die UUID des Ordners, der über die Suchanfrage gefunden oder in der Anlagekonfiguration des agorum core smart assistant konfigurators als Sprungziel definiert ist. Ist dort kein Sprungziel definiert, wird dieses Ergebnis nicht im Token abgelegt.	–

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

Suche nach vorhandener Struktur

Im Editor

Angabe einer Suche im Editor:

identifier:lieferantenakte test_lieferantenname_ci:(${lieferantenName})

Hierbei wird Variable lieferantenName automatisch durch den Inhalt dieser Variable ersetzt.

Würde dieser Inhalt etwa agorum Software GmbH heißen, dann wäre das Ergebnis der Suche Folgendes:

identifier:lieferantenakte test_lieferantenname_ci:(agorum Software GmbH)

Als Expression

Wenn Sie die Suche als Expression angeben, muss das Ergebnis der Expression der String für die Suchanfrage sein:

'identifier:lieferantenakte test_lieferantenname_ci:(' + token.variables.lieferantenName + ')'

Interner Name der Anlagekonfiguration

Im Editor

Angabe eines internen Namens der Anlagekonfiguration im Editor:

text

Als Expression

Angabe eines internen Namens der Anlagekonfiguration als Expression:

text

Zielverzeichnis (Ordner-ID oder Suche)

Ordner-ID (im Editor)

Angabe eines Zielverzeichnisses 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.

Ordner-ID (als Expression)

Angabe eines Zielverzeichnisses als Expression (Haken die obige Eingabe ist eine Suche nicht gesetzt). Bei einer Expression muss das Ergebnis ein String sein.

'/agorum/roi/Files/Demo'

Es kann auch der Inhalt einer Variable angegeben werden, die die ID enthält. Die folgende Angabe liefert etwa die ID des Zielordners:

token.variables.zielOrdner

Suche (im Editor)

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

identifier:lieferantenakte 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:

Metadatum identifier im Objekt

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

Suche (als Expression)

Wenn Sie eine Suchanfrage als Expression angeben, muss das Ergebnis der Expression der String für die Suchanfrage sein.

Suchen beginnen immer mit einem ? am Anfang:

'? identifier:lieferantenakte test_lieferantenname_ci:(' + token.variables.lieferantenName + ')'

Datenvariable

Die nachfolgenden Beispiele gelten ebenfalls für eine Ergebnisvariable.

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).

dataVariable

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.nameOfDataVariable'