Objekte suchen und Positionen zusammenfassen

Interne ID: agorum.accounting.search.merge

Mit diesem Knoten suchen Sie Objekte und laden deren Metadaten. Sie können optional zusätzlich Positionsdaten der Objekte zusammenfassen.

Verhaltensweise

---

Erreicht das System den Knoten im Workflow, prüft es die gesetzten Parameter. Anschließend sucht das System die Objekte anhand der angegebenen Suche und lädt deren Metadaten. Falls Sie Positionen zusammenfassen wollen, führt das System dies im Anschluss durch. Die Ergebnisse speichert das System in der Ergebnisvariable.

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	Definiert die Suchanfrage.	Suche
Filtern der Daten	Filtert die Daten der Objekte anhand des Namens.	Filtern der Daten
Metadaten mit Positionen	Definiert, wie das Metadatum lautet, in dem die Buchungspositionen gespeichert sind. Diese Angabe benötigt der Knoten für das Zusammenführen der positionsbezogenen Daten.	Metadaten mit Positionen
Metadaten für die Übereinstimmung	Definiert die Metadaten, die auf Positionsebene von den Werten her übereinstimmen müssen, um diese Positionen zusammenzuführen. Die Namen müssen in den Positionen als Metadaten enthalten sein.	Metadaten für die Übereinstimmung
Metadaten für die Summierung	Definiert die Metadaten, deren Werte das System auf Positionsebene summieren soll. Die Metadaten müssen in den Positionen enthalten sein.	Metadaten für die Summierung
Ergebnisvariable	Definiert die Variable, in der das System die Daten speichern soll. Die angegebene Variable enthält ein Array mit den Datenstrukturen.	Ergebnisvariable

Suche

Im Editor

Sie können Platzhalter von Workflow-Variablen eintragen.

agorum_accounting_document_supplier_number_ci:(${agorum_accounting_document_supplier_number}) nameextension:pdf

In diesem Beispiel sucht das System Rechnungen eines bestimmten Lieferanten und berücksichtigt dabei ausschließlich PDF-Dateien. Die Lieferantennummer ist dynamisch innerhalb des Workflows als Variable verfügbar, das System ersetzt daher den Inhalt dieser Variable automatisch.

Ergebnis der Suche

agorum_accounting_document_supplier_number:(12345) nameextension:pdf

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

Als Expression

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

'agorum_accounting_document_supplier_number_ci:(' + token.variables.agorum_accounting_document_supplier_number + ') nameextension:pdf'

Filtern der Daten

Im Editor

Im Editor geben Sie einen String für das Filtern an, wenn ein Array mitgegeben wird. Bei Angabe eines Strings muss der Name vollständig sein.

#{/^name_/}
DocFormType

Als Expression

Wenn Sie diesen Parameter als Expression angeben, verwenden Sie diese Schreibweise:

/^ac_/

Metadaten mit Positionen

Im Editor

Im Editor tragen Sie das Metadatum ein, das die Positionen enthält. 

agorum_accounting_document_item_list

Als Expression

Wenn Sie diesen Parameter als Expression angeben, geben Sie den vollständigen Pfad zur Variable an, in der die Positionsvariable hinterlegt ist.

token.variables.positionVariable
'agorum_accounting_document_item_list'

Metadaten für die Übereinstimmung

Im Editor

Im Editor tragen Sie pro Zeile ein Metadatum ein.

article_number​​​

Als Expression

Wenn Sie diesen Parameter als Expression angeben, geben Sie den vollständigen Pfad zur Variable an, in der das Array mit den enthaltenen Kriterien hinterlegt ist.

token.variables.mergeCriterias
[article_number, article_group]

Metadaten für die Summierung

Im Editor

Im Editor tragen Sie pro Zeile ein Metadatum ein.

article_number​​​

Als Expression

Wenn Sie diesen Parameter als Expression angeben, geben Sie den vollständigen Pfad zur Variable an, in der das Array mit den enthaltenen Werten hinterlegt ist.

token.variables.mergeSums
[net_amount, net_price]

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

resultVariable

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