Knoten „docform Daten laden“ verwenden

Interne ID: agorum.docform.load

Mit diesem Knoten lesen Sie die relevanten Daten aus einem Dokument mit agorum core docform aus. Das System speichert die relevanten Daten anschließend als Metadaten ab. Die Metadaten können in anderen Knoten weiterverwendet werden.

Verhaltensweise

---

Erreicht das System den Knoten im Workflow, prüft das System die eingehenden Daten und erstellt dafür die entsprechenden agorum-Metadaten:

1. Der Knoten und docform werden initialisiert, die Konfiguration wird gelesen und validiert.
2. docform wird mit dem oder den Attachments aufgerufen. docform extrahiert die Werte, wenn schon geeigneter Text vorhanden ist.
3. Die Daten werden geladen. Der Knoten wird über den Default-Ausgang verlassen.
4. Falls keine Daten gefunden werden, weil docform den Text noch extrahieren muss, wird der Workflow in den wait-Zustand versetzt.

Der Knoten wartet potenziell ewig weiter auf Daten. Es bietet sich daher an, eine Art Retry-Mechanismus über weitere Workflow-Knoten einzurichten, damit der Knoten irgendwann erfolgreich beendet wird oder auf andere Weise auf ausbleibende Daten reagiert wird.

Anwendung

---

Beispiel eines Workflows mit agorum.docform.load und einem Retry-Mechanismus

Der folgende Workflow zeigt an einem Beispiel, wie Sie den Knoten agorum.docform.load zum Laden der Daten aus Dokumenten, die über einen Skript-Knoten gefunden werden, verwenden können. Weiterhin zeigt der Workflow, wie Sie einen Retry-und-Delay-Mechanismus etablieren könnten. In diesem Beispiel wird dafür eine Variable agorum_doc_test_load_retry mit einem Zähler eingeführt, der nach jedem Versuch, die Daten zu laden, um 1 erhöht wird. Wenn die Höchstzahl an Versuchen, die Daten zu laden, nicht erreicht ist, wird nach einer Minute ein weiterer Versuch unternommen, die Daten zu laden.

 

Der Workflow durchläuft folgende Knoten:

• start: Der Workflow wird über einen Kommentar-Knoten (agorum.comment) gestartet.
• script: Der Skript-Knoten (agorum.script) liefert die Dokumentdaten. Dazu erstellt er eine neue Datei als Kopie einer anderen und übergibt die UUID der neuen Datei in der Variable sys_acw_attachments des Tokens.
• load: Der docform.load-Knoten versucht, die Daten aus der Datei zu laden, ohne zu wissen, ob die Daten nach der OCR-Erkennung schon zur Verfügung stehen. Dazu ruft er die Funktion docform.match auf, um die Daten zu suchen, die den Kriterien der Definition entsprechen. Wenn keine passenden Daten gefunden werden, wird die Variable wait auf true gesetzt. Im Erfolgsfall wird der Knoten über das Default-Outlet verlassen, sonst über das wait-Outlet.
• set: Der set-Knoten (agorum.data.set) setzt mit der Variable agorum_doc_test_load_retry einen Zähler, der bei jedem Durchlauf des Knotens um 1 erhöht wird:

  (token.variables.agorum_doc_test_load_retry || 0) + 1

• condition: Der condition-Knoten (agorum.flow.condition) dient zur Angabe einer Höchstzahl von Versuchen, die Daten zu laden. In diesem Fall ist die Höchstzahl auf 5 festgelegt. Ist die Höchstzahl nicht erreicht, wird der delay-Knoten aufgerufen, sonst der timeout-Knoten.

  token.variables.agorum_doc_test_load_retry <= 5

• delay: Der delay-Knoten (agorum.flow.delay) sorgt für eine Verzögerung von 1 Minute in diesem Beispiel, bevor der docform.load-Knoten erneut aufgerufen wird.
• timeout: Der timeout-Knoten ist in diesem Beispiel ein Kommentar-Knoten. Der Knoten ist nur als Beispiel für eine beliebige Vorgehensweise gedacht für den Fall, dass keine Daten geladen werden können.
• success: Sobald der docform.load Knoten die Daten erfolgreich als Metadaten laden und zuordnen kann, wird in diesem Beispiel der success-Knoten aufgerufen. In diesem Beispiel ist das ein Kommentar-Knoten, der nur stellvertretend für die weitere Verarbeitung der Daten in Ihren Workflows steht.

In der Log-Ansicht könnte die Anzeige etwa wie folgt aussehen. In diesem Beispiel ist nur eine Wiederholung vor der erfolgreichen Verarbeitung erforderlich.

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
wait (Outlet)	Nein, kann nur ausgeblendet werden.	nein, nicht nötig

Parameter

---

Parameter	Beschreibung	Beispiel
Definition	Sie können optional den Namen der docform-Definition angeben, um die richtige docform-Definition für die verarbeiteten Dokumente zu nutzen. Im Standard werden alle docform-Definitionen verwendet. Wenn mehr als eine zutreffende Definition für ein Objekt gefunden wird, muss die Definition eingeschränkt werden.	Sie können ein Sternchen/Asterisk (*) in der Definition verwenden, um nach einer Zeichenkette alles zu erlauben.
pro Objekt	Aktiviert Lädt die Metadaten gruppiert in einer Struktur nach UUID. Deaktiviert Lädt das System nur die Metadaten des ersten Objekts.
Eingangsvariable	Definiert die Objekte, von denen die Metadaten mithilfe von agorum core docform ausgelesen werden. Der Parameter Eingangsvariable enthält ein Array von Elementen, die mit diesem Knoten verarbeitet werden sollen. Wird die Variable leer gelassen, werden automatisch die Attachments des Workflows genommen. Diese Attachments sind in der internen Variable sys_acw_attachments vorhanden. Für die generelle Schreibweise von Variablen im Editor oder als Expression siehe Schreibweise von Variablen.
Ergebnisvariable	Definiert den Namen einer Variablen, in die alle gelesenen und gefilterten Metadaten abgelegt werden. Für die generelle Schreibweise von Variablen im Editor oder als Expression siehe Schreibweise von Variablen.
Rechte	Siehe Rechte auf Knoten vergeben.