Helper - Benutzerbeiträge [de]

KI Bearbeitung

2026-04-16T13:10:18Z

Stefan: Erster Eintrag zum neuen Job

;Mantiseinträge:
3614
;Systemtyp:
80

'''OJOHZDOKIBearbeitung'''

== Beschreibung ==

Ermöglicht die Auswertung von Text und Bilddateien über verschiedene KI Modelle -insbesondere LLM's - über Prompt gesteuerte Anweisungen. Es werden PDF Dateien sowie JPEG und PNG Bilddateien unterstützt.
Es können verschiedene Anbieter und API Schnittstellen angesprochen werden, Online oder in lokaler Infrastruktur. Generell wird die OpenAI API in der neuesten Version empfohlen. Die meisten Anbieter unterstützen diese.
Der Serverjob macht genau einen Aufruf mit einer Anfrage. Es gibt einen Sytstem-Prompt und einen User-Prompt, welcher generell als der Chatprompt bei Chatbasierten LLM Applikationen.
Der System-Prompt hat mehr Gewicht als der User-Prompt. Über diesen wird die KI als Werkzeug definiert und in ihrem Verhalten instruiert und eingeschränkt. Der User-Prompt macht dann nur noch eine spezifische Anfrage.

Für das Speichern der Ausgabe aus den Abfragen in Metadatenfeldern, ist die Angabe eines fixen Schemas notwendig. Dabei muss der Name des Schemaelements mit dem Metadatumsnamen Feld übereinstimmen, in welches das Resultat abgefüllt werden soll.

== Konfiguration ==

Übersicht über alle Workflowschritte

2026-04-14T08:25:48Z

Stefan:

{|class="sortable wikitable zebra toptextcells"
! SYSTEMTYP !! BEZEICHNUNG
|-
| 0 || [[Normaler Arbeitsschritt]]
|-
| 1 || [[Bedingung]]
|-
| 2 || [[Kontrollieren]]
|-
| 3 || [[Korrigieren]]
|-
| 4 || [[Interaktion]]
|-
| 5 || [[Files kopieren]]
|-
| 6 || [[Objekterstellung]]
|-
| 7 || [[Objekterstellung2]]
|-
| 8 || [[SFTP-Upload]]
|-
| 9 || [[Formatvergrösserung]]
|-
| 10 || [[Bildbearbeitung (Client)]]
|-
| 11 || [[Verzweigung nach Zufall]]
|-
| 12 || [[Filenamen ändern Metadaten]]
|-
| 13 || [[CheckIn]]
|-
| 14 || [[CheckOut]]
|-
| 15 || [[Daten löschen]]
|-
| 16 || [[Zusammenführen von Daten]] und [[Assistiertes Metadatieren]]
|-
| 17 || [[SFTP-Quittierung]]
|-
| 18 || [[Filetest]]
|-
| 19 || [[PDF-Metadaten]]
|-
| 20 || [[Auf Unterobjekte warten]]
|-
| 21 || [[Objekt Umwandlung/Verdoppelung]]
|-
| 22 || [[Verzweigung nach Metadaten]]
|-
| 23 || [[Metadaten umwandeln]]
|-
| 24 || [[Daten bewegen]]
|-
| 25 || [[Generischer CMD Code]]
|-
| 26 || [[Files messen]]
|-
| 27 || [[Bedingung nach Metadaten]]
|-
| 28 || [[Warte bestimmte Zeit]]
|-
| 29 || [[Serverjob zur Auftrennung von Objekten nach Barcodeblättern]]
|-
| 30 || [[Bild freistellen]]
|-
| 31 || [[Metadaten mit Anzeige des Files]]
|-
| 32 || [[Sammelblätter aufteilen]]
|-
| 33 || [[Bilder freistellen]]
|-
| 34 || [[Metadaten Datenbank]]
|-
| 35 || [[XML Metadaten File-Export]]
|-
| 36 || [[Beleg erstellen]]
|-
| 37 || [[WIA extern Kontrolle]]
|-
| 38 || [[Vorerfassung]]
|-
| 39 || [[Metadaten aus Bildfile lesen]]
|-
| 40 || [[QR-Code-File erstellen]]
|-
| 41 || [[Photoshop Skript verarbeiten]]
|-
| 42 || [[Bilder löschen]]
|-
| 43 || [[Objekttyp ändern]]
|-
| 44 || [[Objekthierarchie ändern]]
|-
| 45 || [[Duplikate auflösen]]
|-
| 46 || [[Hashfile erstellen]]
|-
| 47 || [[Files hinzufügen]]
|-
| 48 || [[Word Interaktiv]]
|-
| 49 || [[Word automatisch bearbeiten]]
|-
| 50 || [[Word File Info]]
|-
| 51 || [[Word konvertieren]]
|-
| 52 || [[Kunde Informieren]]
|-
| 53 || [[Dokument versenden]]
|-
| 54 || [[Kinder/Enkel zuweisen]]
|-
| 55 || [[PDF Bearbeitung]]
|-
| 56 || [[PDF Lesezeichen schreiben]]
|-
| 57 || [[Generische Verzweigung]]
|-
| 58 || [[GBA Auftragsübersicht]]
|-
| 59 || [[Filehandling]]
|-
| 60 || [[Barcode ersetzen]]
|-
| 61 || [[OCR Texterkennung]]
|-
| 62 || [[ICC-Profil Bearbeiten]]
|-
| 63 || [[KOST-Val Validierung]]
|-
| 64 || [[REST-Service]] (Server)
|-
| 65 || [[Bildbearbeitung (serverseitig)]]
|-
| 66 || [[Rahmen setzen]] (Client)
|-
| 67 || [[Bilderstellung]] (Server)
|-
| 68 || [[Metadaten Einlesen]] (Server)
|-
| 69 || [[REST API]] (Server)
|-
| 70 || [[Warten auf Rückmeldung]] (Server)
|-
| kein || [[Geleistete Arbeit]]
|-
| 71 || [[Seitenrahmen finden]] (Server)
|-
| 72 || [[Seitenrahmen kontrollieren]]
|-
| 73 || [[Bilderstellung aus Rahmen]] (Server)
|-
| 74 || [[Warten nach Objekttyp]] (Server)
|-
| 75 || [[Format anpassen]]
|-
| 76 || [[Generische Vorerfassung]]
|-
| 77 || [[RestAPI Services Up-/Download]] (Server)
|-
| 78 || [[Hotfolder Objektimport]] (Server)
|-
| 79 || [[Entausschiessen]] (Server)
|-
| 80 || [[KI Bearbeitung]] (Server)
|}
[[Kategorie:Workflowschritt]]

Filetest

2026-02-20T13:15:38Z

Stefan: /* Konfiguration FileAnzahl */

;Mantiseinträge:
1526

1822
;Systemtyp:
18

==Beschreibung==
Besteht aus einem Serverjob OJOHZDOFiletest. Überprüft die Files auf ihre Richtigkeit. Das Ergebnis (0/1) kann in einem Attribut gespeichert werden. Falls ein Test fehlschlägt geht das Objekt zu zum roten Ausgang und im Fehlertext steht, welche Bedingung(en) nicht erfüllt wurde(n).

'''Grundsätzlich sind hier keine Formeln für die Werte möglich, mit Ausnahme:''' ''FileAnzahl''

===Konfiguration FileAnzahl===
Bei diesem Test werden die '''Dateien und Ordner''' im auf oberster Ebene im Objektordner gezählt. Die Dateien in (Unter-)Ordnern zählen nicht. Der Ordner 'Hilfsobjekte' zählt auch.

'''Speziallfall:''' Die Anzahl kann über die Operatoren "=" und "<>" mit dem Wert "G" oder "H" die Parität (Gerade / ungerade Anzahl Dateien und Ordner) vergleichen.

[[Datei:FileTestParität.png|Beispiel für Paritätstest]]

'''Zugriff auf Metadaten des Objektes, bzw. das einsetzen von Formel sind für diesen Test erlaubt.''' ''Das Metadatum ist wie üblich in eckigen Klammern zu nennen: [MetadatumMitAnzahl]''

===Konfiguration FileTyp===
Bei diesem Test wird jedes File im Objektordner mit konfigurierten Filetyp verglichen. Ordner werden (natürlich) nicht verglichen. Files in Unterordnern werden nur getestet, wenn 'Rekursiv' angekreuzt ist.

===Konfiguration BildformatXY===
Bei diesem Test können beide Seiten des Bildformats (X und Y) berücksichtigt werden.
*Operator Codes können sein (>, *>, >>, *>>) Bzw. die Varianten für kleiner (<) und gleich (=)
*>,= wenn eine Seite grösser/gleich als ihr entsprechender Maximalwert (xi > xs) | (yi > ys)
*>>,== wenn beide Seiten grösser / gleich wie der entsprechende Maximalwert (xi > xs) & (yi > ys)
* *>, *= wenn mindestens eine beliebige Seite grösser / gleich ist wie ein beliebiger Maximalwert
* *>>, *== wenn je beide Seiten grösser / gleich wie ein beliebiger Maximalwert sind (Bildausrichtung gleich oder gedreht)
Der Vergleichswert wird geschrieben: 2000x3000

===Konfiguration Farbraum===
Bei diesem Test wird der Farbraum aus dem File gelesen. Typische Werte sind 'Gray' oder 'sRGB'. Bitte achten Sie auf Grosskleinschreibung.

=== Konfiguration Positions SW Histogramm ===
Bei diesem Test wird ein Histogramm in einem PDF / Bild generiert basierend auf einer bestimmten Position sowie einem Grössenbereich.
Grundsätzlich wird immer von links oben aus gerechnet. 

1. Parameter = Seite - zB 4 (Wird nur bei PDF's verwendet) 
2. Parameter = Position X - zB 250 oder -150 (Bei Bildern in Pixel, bei PDF's in mm / Negative Zahlen werden von Rechts statt Links aus gerechnet) 
3. Parameter = Position Y - zB 300 oder - 200 (Bei Bildern in Pixel, bei PDF's in mm / Negative Zahlen werden von Unten statt Oben aus gerechnet) 
4. Parameter = Breite - zB 500 oder 25 % (Entweder Prozentangabe oder bei Bildern in Pixel, bei PDF's in mm) 
5. Parameter = Höhe - zB 200 oder 15 % (Entweder Prozentangabe oder bei Bildern in Pixel, bei PDF's in mm) 
6. Parameter = Helligkeitsgrenzwert - zB 150 (Werte von 0 - 255, wobei 0=Schwarz / 255 = Weiss) 
7. Parameter = Prozent - zB 35% (Wie viel Prozent der Pixel müssen über oder unter der angegeben Helligkeit sein) 
 
Hier ein komplettes Beispiel: "1,100,-150,140,5%,200,30%" 
*Es wird Seite 1 gemessen (falls es um ein PDF geht)
*Es wird der folgende Bildausschnitt genommen: Annahme das Bild ist 1000x500px gross
** Linke obere Ecke: 100/350 px. (350=500-150)
** Grösse des Ausschnitts: 140x25 px. (25=5% von 500)
** Rechte untere Ecke: 240/375 px.
*Es wird folgende Formel evaluiert:
(Pixelheller (als Grauwert 200) / TotaleAnzahlPixel) > oder < Prozent (30%).
Es werden also immer die helleren Pixel als der Helligkeitsgrenzwert gezählt und durch die totale Anzahl Pixel geteilt. Das Ergebnis wird mit dem Prozentsatz verglichen.
Falls ein Wert nicht angegeben werden soll muss das Komma dennoch da stehen. Beispiel ohne die Angabe der Seite: ",100,-150,140,5%,200,30%". 
==== Beispiele Bildausschnitt====
* Das ganze Bild (Seite 1) soll gemessen werden: "1,1,1,100%,100%..."
* Links oben in der Ecke soll ein Quadrat von 100px gemessen werden: "1,1,1,100,100..."
==== Beispiele Helligkeit====
* Es darf fast keine (fast) schwarzen Pixel haben: > "...20, 98%" -> mehr als 98% der Pixel sollen heller sein als fast schwarz (Grauwert 20)
* Es soll fast ganz weiss sein: > "...240, 99%" -> 99% der Pixel sollen heller als der Grauwert 240 sein (fast weiss)

=== Konfiguration Ist Extrem ===
Bei diesem Test wird jedes DO geprüft ob es nach der konfigurierten Weise extrem ist.

1. Parameter = Sortierfeld - Dieser Wert wird aufs "Extrem sein" geprüft. Muss ein AT-Name sein 
2. Parameter = Selektionsfeld - Es werden nur DOs berücksichtig die den gleichen Wert im Selektionsfeld haben wie das DO welches gerade angeschaut wird. Muss ein AT-Name sein. Falls leer wird DO_DO_SEQ automatisch verwendet. 
3. Parameter = Menge - Ab wann wird ein DO als Extrem beachtet? zB. 10 
 
Hier ein komplettes Beispiel: "seitenanzahl,pdfname,10" 
Ist das DO in den Top 10 mit den Seitenzahlen verglichen mit allen DOs welche denselben PDF Namen haben?

===Konfiguration Pixeltiefe pro Kanal===
Bei diesem Test wird die Anzahl Pixel pro Kanal aus dem File gelesen. Typische Werte sind 8 oder 16.

===Konfiguration ICC Profile===
Bei diesem Test wird aus dem File die Zeile icc:description gefiltert und der Text danach herausgelesen. Ein typischer Wert ist 'Adobe RGB (1998)'.

Sie können das Feld bei einem Bild auch auslesen:
identify -verbose "Pfad zum Bild"
Suchen Sie nach der Zeile 'icc:description'

===Dateigrösse===

Bei diesem Test wird eine Dateigrösse in Bytes geprüft.

Operator Codes können sein (>,<).

===SeitenAnzahl===

Bei diese Test wird die Anzahl Seiten in einem PDF oder TIFF Dokument geprüft.

Operator Codes können sein (>,<,=,<>).

===Anzahl Barcodes in Ordner===

Bei diesem Test wir die Anzahl Barcodes eines bestimmten Typs mit einem bestimmten Wert im gesamten Ordner getestet.

Operator Codes können sein (>,<,=,<>,<=, >=).

Wertkonfiguration: Anzahl Barcodes,Barcodewert,Barcodetyp

Beispiel: 2,ABC1234,Code 39

===Konfiguration Pixeltiefe pro Kanal===
Bei diesem Test wird die Anzahl Pixel pro Kanal aus dem File gelesen. Typische Werte sind 8 oder 16.

==Allgemeine Metadaten von Bildformaten==

Für die unten folgenden Konfigurationen kann für die gesuchten Werte auf diese Auflistungen von TAG Namen zurückgegriffen werden:

[https://www.exiftool.org/TagNames/ TAG Übersicht]

[https://www.exiftool.org/TagNames/EXIF.html EXIF Tags]

[https://www.exiftool.org/TagNames/IPTC.html IPTC Tags]

[https://www.exiftool.org/TagNames/XMP.html XMP Tags]

'''Suche nach leeren Tags'''

Falls nach leeren, bzw. fehlenden Werten gesucht werden soll, dann ist der Wertebereicht nach dem Komma leer zu lassen.

Bsp.: Kein Änderungsdatum vorhanden

[[Datei:Metadatum Datum leer.png]]

===Konfiguration Metadatum Text===

Bei diesem Test wird ein TAG mit Textinhalt verglichen.

Operator Codes können sein (=, <>)

Bsp.: Gesucht wird der Hersteller des Aufnahmegerätes. Der entsprechende TAG heisst 'Make'. Der gesuchte Wert soll auf 'Canon' lauten.

[[Datei:Metadatum Text.png]]

===Konfiguration Metadatum Zahl===

Bei diesem Test wird ein TAG mit Zahleninhalt verglichen.

Operator Codes können sein (=, <>, >, >=, <, <=)

Bsp.: Gesucht wird nach der X Auflösung des Bildes. Der entsprechende TAG heisst 'XResolution'. Der gesuchte Wert soll grösser oder gleich 3500 sein.

[[Datei:Metadatum Zahl.png]]

===Konfiguration Metadatum Datum===

Bei diesem Test wird ein TAG mit Datumsinhalt verglichen.

Operator Codes können sein (=, <>, >, >=, <, <=)

Bsp.: Gesucht wird dem Änderungsdatum. Der entsprechende TAG heisst 'DateModify'. Der gesuchte Wert soll nach dem 23.03.2021 08:05:14 liegen.

[[Datei:Metadatum Datum.png]]

==Dateien auch in den Unterordnern prüfen==

Soll auch in Unterordner geprüft werden, ist folgende Checkbox zu aktivieren:

[[File:filetest_rekursiv.png]]

Der Filetest beim Abschliessen eines clientseitigen Arbeitsschrittes ist nicht rekursiv.

== Dateinamen auf Regex überprüfen ==
Sie können den Dateinamen mithilfe eines Regex überprüfen lassen.
Wählen Sie dazu die Kondition "Dateiname" und den Operator "entspricht Regex", dann '''muss jedes File''' im Objektordner dem Regex entsprechen.
Wenn Sie "entspricht nicht Regex" wählen, dann '''darf kein File''' dem Regex entsprechen.

Tool um Regex zu schreiben: https://regex101.com

[[Datei:Filetest regexmatching.png|500px]]

==Barcodes finden==

Ermittelt, ob die Seiten einen Barcode besitzen. Ein bestimmer Suchwert für den Inhalt des Barcodes kann ebenfalls als Einschränkung mitgegeben werden.

Kann alle Seiten, oder nur die geraden, oder nur die ungeraden prüfen. Wenn wir hier von Seiten sprechen, dann sind damit einzelne Dateien gemeint, welche in der Regel eine einzelne Seite darstellen. Die Reihenfolge der nach Namen sortierten Dateien im Dateisystem legt dabei die Seitenzahl fest. Die erste Datei - Sortiernummer 1 - entspricht demnach einer ungeraden Seite. Datei achte Datei - Sortiernummer 8 - einer geraden Seite.

Unterstüzte Dateitypen - alle gängigen Bildformate.

'''Attribut:''' SeiteHatBarcodes

'''Operator Code:''' ( = )

'''Wert:''' A/U/G/[Zahl]''','''Barcodeinhalt,Barcodetyp

*A = alle Seiten (es muss auf allen Seiten einen Barcode haben)
*U = ungerade Seiten (es darf nur auf ungeraden Seiten barcodes haben. Es muss aber nicht auf allen ungeraden Seiten Barcodes haben)
*G = gerade Seiten (es darf nur auf geraden Seiten barcodes haben. Es muss aber nicht auf allen geraden Seiten Barcodes haben)
*[Zahl] = zB. 5 => Hat es auf der 5. Seite einen Barcode?

'''Bsp.:'''

1) Suche auf ungeraden Seiten nach einem Barcode: '''Wert = 1'''

2) Suche auf geraden Seiten (2) nach einem Barcode mit dem Wert 0783A-123: '''Wert = 2,0783A-123'''

'''Merke:''' Die Suche nach einem Wert funktioniert aktuell nur für den ersten gefundenen Barcode! Wenn es mehrere Barcodes auf der Seite gibt, wird jeweils der erste Ausgewertet.

Falls eine Zahl angegeben wird, kann der Barcodetyp definiert werden. In der anderen Fällen ist der Parameter nicht implementiert. Ebenfalls kann der Wert ein Regex sein, sofern eine Zahl definiert ist.

==Unsichtbare Dateien==
File test prüft auch unsichtbare/geschützte Systemdateien wie Thumps.db. Dies ist Absicht, damit verhindert werden kann, dass diese Dateien weiter im Workflow gehen. Damit Sie die unsichtbaren/geschützen Systemdateien sehen (und ggf. löschen) können, müssen Sie sie in Windows sichtbar machen:
* Für geschützte Systemdateien: Deselektieren Sie 'Ordneroptionen: Ansicht: Erweiterte Einstellungen: Geschützte Systemdateien ausblenden'
* Für unsichtbare Dateien: Im Befehlsband: 'Ansicht', 'unsichtbare Dateien'

==Essentielle Felder==
AR_FILETEST, HZ_FILETEST ''Code kTab Attribut kTab Operator kTab Wert(e) kCR''

HZ_TESTERGEBNIS

HZ_FILEVERHALTEN

==Pane im Produktionsauftrag (FHK_Maske)==

[[File:0.jpg]]

[[Kategorie:Workflowschritt]]

Filetest

2026-02-20T13:15:24Z

Stefan: 3596 /* Konfiguration FileAnzahl */

;Mantiseinträge:
1526

1822
;Systemtyp:
18

==Beschreibung==
Besteht aus einem Serverjob OJOHZDOFiletest. Überprüft die Files auf ihre Richtigkeit. Das Ergebnis (0/1) kann in einem Attribut gespeichert werden. Falls ein Test fehlschlägt geht das Objekt zu zum roten Ausgang und im Fehlertext steht, welche Bedingung(en) nicht erfüllt wurde(n).

'''Grundsätzlich sind hier keine Formeln für die Werte möglich, mit Ausnahme:''' ''FileAnzahl''

===Konfiguration FileAnzahl===
Bei diesem Test werden die '''Dateien und Ordner''' im auf oberster Ebene im Objektordner gezählt. Die Dateien in (Unter-)Ordnern zählen nicht. Der Ordner 'Hilfsobjekte' zählt auch.

'''Speziallfall:''' Die Anzahl kann über die Operatoren "=" und "<>" mit dem Wert "G" oder "H" die Parität (Gerade / ungerade Anzahl Dateien und Ordner) vergleichen.
[[Datei:FileTestParität.png|Beispiel für Paritätstest]]

'''Zugriff auf Metadaten des Objektes, bzw. das einsetzen von Formel sind für diesen Test erlaubt.''' ''Das Metadatum ist wie üblich in eckigen Klammern zu nennen: [MetadatumMitAnzahl]''

===Konfiguration FileTyp===
Bei diesem Test wird jedes File im Objektordner mit konfigurierten Filetyp verglichen. Ordner werden (natürlich) nicht verglichen. Files in Unterordnern werden nur getestet, wenn 'Rekursiv' angekreuzt ist.

===Konfiguration BildformatXY===
Bei diesem Test können beide Seiten des Bildformats (X und Y) berücksichtigt werden.
*Operator Codes können sein (>, *>, >>, *>>) Bzw. die Varianten für kleiner (<) und gleich (=)
*>,= wenn eine Seite grösser/gleich als ihr entsprechender Maximalwert (xi > xs) | (yi > ys)
*>>,== wenn beide Seiten grösser / gleich wie der entsprechende Maximalwert (xi > xs) & (yi > ys)
* *>, *= wenn mindestens eine beliebige Seite grösser / gleich ist wie ein beliebiger Maximalwert
* *>>, *== wenn je beide Seiten grösser / gleich wie ein beliebiger Maximalwert sind (Bildausrichtung gleich oder gedreht)
Der Vergleichswert wird geschrieben: 2000x3000

===Konfiguration Farbraum===
Bei diesem Test wird der Farbraum aus dem File gelesen. Typische Werte sind 'Gray' oder 'sRGB'. Bitte achten Sie auf Grosskleinschreibung.

=== Konfiguration Positions SW Histogramm ===
Bei diesem Test wird ein Histogramm in einem PDF / Bild generiert basierend auf einer bestimmten Position sowie einem Grössenbereich.
Grundsätzlich wird immer von links oben aus gerechnet. 

1. Parameter = Seite - zB 4 (Wird nur bei PDF's verwendet) 
2. Parameter = Position X - zB 250 oder -150 (Bei Bildern in Pixel, bei PDF's in mm / Negative Zahlen werden von Rechts statt Links aus gerechnet) 
3. Parameter = Position Y - zB 300 oder - 200 (Bei Bildern in Pixel, bei PDF's in mm / Negative Zahlen werden von Unten statt Oben aus gerechnet) 
4. Parameter = Breite - zB 500 oder 25 % (Entweder Prozentangabe oder bei Bildern in Pixel, bei PDF's in mm) 
5. Parameter = Höhe - zB 200 oder 15 % (Entweder Prozentangabe oder bei Bildern in Pixel, bei PDF's in mm) 
6. Parameter = Helligkeitsgrenzwert - zB 150 (Werte von 0 - 255, wobei 0=Schwarz / 255 = Weiss) 
7. Parameter = Prozent - zB 35% (Wie viel Prozent der Pixel müssen über oder unter der angegeben Helligkeit sein) 
 
Hier ein komplettes Beispiel: "1,100,-150,140,5%,200,30%" 
*Es wird Seite 1 gemessen (falls es um ein PDF geht)
*Es wird der folgende Bildausschnitt genommen: Annahme das Bild ist 1000x500px gross
** Linke obere Ecke: 100/350 px. (350=500-150)
** Grösse des Ausschnitts: 140x25 px. (25=5% von 500)
** Rechte untere Ecke: 240/375 px.
*Es wird folgende Formel evaluiert:
(Pixelheller (als Grauwert 200) / TotaleAnzahlPixel) > oder < Prozent (30%).
Es werden also immer die helleren Pixel als der Helligkeitsgrenzwert gezählt und durch die totale Anzahl Pixel geteilt. Das Ergebnis wird mit dem Prozentsatz verglichen.
Falls ein Wert nicht angegeben werden soll muss das Komma dennoch da stehen. Beispiel ohne die Angabe der Seite: ",100,-150,140,5%,200,30%". 
==== Beispiele Bildausschnitt====
* Das ganze Bild (Seite 1) soll gemessen werden: "1,1,1,100%,100%..."
* Links oben in der Ecke soll ein Quadrat von 100px gemessen werden: "1,1,1,100,100..."
==== Beispiele Helligkeit====
* Es darf fast keine (fast) schwarzen Pixel haben: > "...20, 98%" -> mehr als 98% der Pixel sollen heller sein als fast schwarz (Grauwert 20)
* Es soll fast ganz weiss sein: > "...240, 99%" -> 99% der Pixel sollen heller als der Grauwert 240 sein (fast weiss)

=== Konfiguration Ist Extrem ===
Bei diesem Test wird jedes DO geprüft ob es nach der konfigurierten Weise extrem ist.

1. Parameter = Sortierfeld - Dieser Wert wird aufs "Extrem sein" geprüft. Muss ein AT-Name sein 
2. Parameter = Selektionsfeld - Es werden nur DOs berücksichtig die den gleichen Wert im Selektionsfeld haben wie das DO welches gerade angeschaut wird. Muss ein AT-Name sein. Falls leer wird DO_DO_SEQ automatisch verwendet. 
3. Parameter = Menge - Ab wann wird ein DO als Extrem beachtet? zB. 10 
 
Hier ein komplettes Beispiel: "seitenanzahl,pdfname,10" 
Ist das DO in den Top 10 mit den Seitenzahlen verglichen mit allen DOs welche denselben PDF Namen haben?

===Konfiguration Pixeltiefe pro Kanal===
Bei diesem Test wird die Anzahl Pixel pro Kanal aus dem File gelesen. Typische Werte sind 8 oder 16.

===Konfiguration ICC Profile===
Bei diesem Test wird aus dem File die Zeile icc:description gefiltert und der Text danach herausgelesen. Ein typischer Wert ist 'Adobe RGB (1998)'.

Sie können das Feld bei einem Bild auch auslesen:
identify -verbose "Pfad zum Bild"
Suchen Sie nach der Zeile 'icc:description'

===Dateigrösse===

Bei diesem Test wird eine Dateigrösse in Bytes geprüft.

Operator Codes können sein (>,<).

===SeitenAnzahl===

Bei diese Test wird die Anzahl Seiten in einem PDF oder TIFF Dokument geprüft.

Operator Codes können sein (>,<,=,<>).

===Anzahl Barcodes in Ordner===

Bei diesem Test wir die Anzahl Barcodes eines bestimmten Typs mit einem bestimmten Wert im gesamten Ordner getestet.

Operator Codes können sein (>,<,=,<>,<=, >=).

Wertkonfiguration: Anzahl Barcodes,Barcodewert,Barcodetyp

Beispiel: 2,ABC1234,Code 39

===Konfiguration Pixeltiefe pro Kanal===
Bei diesem Test wird die Anzahl Pixel pro Kanal aus dem File gelesen. Typische Werte sind 8 oder 16.

==Allgemeine Metadaten von Bildformaten==

Für die unten folgenden Konfigurationen kann für die gesuchten Werte auf diese Auflistungen von TAG Namen zurückgegriffen werden:

[https://www.exiftool.org/TagNames/ TAG Übersicht]

[https://www.exiftool.org/TagNames/EXIF.html EXIF Tags]

[https://www.exiftool.org/TagNames/IPTC.html IPTC Tags]

[https://www.exiftool.org/TagNames/XMP.html XMP Tags]

'''Suche nach leeren Tags'''

Falls nach leeren, bzw. fehlenden Werten gesucht werden soll, dann ist der Wertebereicht nach dem Komma leer zu lassen.

Bsp.: Kein Änderungsdatum vorhanden

[[Datei:Metadatum Datum leer.png]]

===Konfiguration Metadatum Text===

Bei diesem Test wird ein TAG mit Textinhalt verglichen.

Operator Codes können sein (=, <>)

Bsp.: Gesucht wird der Hersteller des Aufnahmegerätes. Der entsprechende TAG heisst 'Make'. Der gesuchte Wert soll auf 'Canon' lauten.

[[Datei:Metadatum Text.png]]

===Konfiguration Metadatum Zahl===

Bei diesem Test wird ein TAG mit Zahleninhalt verglichen.

Operator Codes können sein (=, <>, >, >=, <, <=)

Bsp.: Gesucht wird nach der X Auflösung des Bildes. Der entsprechende TAG heisst 'XResolution'. Der gesuchte Wert soll grösser oder gleich 3500 sein.

[[Datei:Metadatum Zahl.png]]

===Konfiguration Metadatum Datum===

Bei diesem Test wird ein TAG mit Datumsinhalt verglichen.

Operator Codes können sein (=, <>, >, >=, <, <=)

Bsp.: Gesucht wird dem Änderungsdatum. Der entsprechende TAG heisst 'DateModify'. Der gesuchte Wert soll nach dem 23.03.2021 08:05:14 liegen.

[[Datei:Metadatum Datum.png]]

==Dateien auch in den Unterordnern prüfen==

Soll auch in Unterordner geprüft werden, ist folgende Checkbox zu aktivieren:

[[File:filetest_rekursiv.png]]

Der Filetest beim Abschliessen eines clientseitigen Arbeitsschrittes ist nicht rekursiv.

== Dateinamen auf Regex überprüfen ==
Sie können den Dateinamen mithilfe eines Regex überprüfen lassen.
Wählen Sie dazu die Kondition "Dateiname" und den Operator "entspricht Regex", dann '''muss jedes File''' im Objektordner dem Regex entsprechen.
Wenn Sie "entspricht nicht Regex" wählen, dann '''darf kein File''' dem Regex entsprechen.

Tool um Regex zu schreiben: https://regex101.com

[[Datei:Filetest regexmatching.png|500px]]

==Barcodes finden==

Ermittelt, ob die Seiten einen Barcode besitzen. Ein bestimmer Suchwert für den Inhalt des Barcodes kann ebenfalls als Einschränkung mitgegeben werden.

Kann alle Seiten, oder nur die geraden, oder nur die ungeraden prüfen. Wenn wir hier von Seiten sprechen, dann sind damit einzelne Dateien gemeint, welche in der Regel eine einzelne Seite darstellen. Die Reihenfolge der nach Namen sortierten Dateien im Dateisystem legt dabei die Seitenzahl fest. Die erste Datei - Sortiernummer 1 - entspricht demnach einer ungeraden Seite. Datei achte Datei - Sortiernummer 8 - einer geraden Seite.

Unterstüzte Dateitypen - alle gängigen Bildformate.

'''Attribut:''' SeiteHatBarcodes

'''Operator Code:''' ( = )

'''Wert:''' A/U/G/[Zahl]''','''Barcodeinhalt,Barcodetyp

*A = alle Seiten (es muss auf allen Seiten einen Barcode haben)
*U = ungerade Seiten (es darf nur auf ungeraden Seiten barcodes haben. Es muss aber nicht auf allen ungeraden Seiten Barcodes haben)
*G = gerade Seiten (es darf nur auf geraden Seiten barcodes haben. Es muss aber nicht auf allen geraden Seiten Barcodes haben)
*[Zahl] = zB. 5 => Hat es auf der 5. Seite einen Barcode?

'''Bsp.:'''

1) Suche auf ungeraden Seiten nach einem Barcode: '''Wert = 1'''

2) Suche auf geraden Seiten (2) nach einem Barcode mit dem Wert 0783A-123: '''Wert = 2,0783A-123'''

'''Merke:''' Die Suche nach einem Wert funktioniert aktuell nur für den ersten gefundenen Barcode! Wenn es mehrere Barcodes auf der Seite gibt, wird jeweils der erste Ausgewertet.

Falls eine Zahl angegeben wird, kann der Barcodetyp definiert werden. In der anderen Fällen ist der Parameter nicht implementiert. Ebenfalls kann der Wert ein Regex sein, sofern eine Zahl definiert ist.

==Unsichtbare Dateien==
File test prüft auch unsichtbare/geschützte Systemdateien wie Thumps.db. Dies ist Absicht, damit verhindert werden kann, dass diese Dateien weiter im Workflow gehen. Damit Sie die unsichtbaren/geschützen Systemdateien sehen (und ggf. löschen) können, müssen Sie sie in Windows sichtbar machen:
* Für geschützte Systemdateien: Deselektieren Sie 'Ordneroptionen: Ansicht: Erweiterte Einstellungen: Geschützte Systemdateien ausblenden'
* Für unsichtbare Dateien: Im Befehlsband: 'Ansicht', 'unsichtbare Dateien'

==Essentielle Felder==
AR_FILETEST, HZ_FILETEST ''Code kTab Attribut kTab Operator kTab Wert(e) kCR''

HZ_TESTERGEBNIS

HZ_FILEVERHALTEN

==Pane im Produktionsauftrag (FHK_Maske)==

[[File:0.jpg]]

[[Kategorie:Workflowschritt]]

Datei:FileTestParität.png

2026-02-20T13:14:29Z

Stefan:

Paritätsvergleich

Barcodetrenner - Auftrennung von Objekten nach Barcodeblättern / OCR-Text

2026-02-09T10:23:37Z

Stefan: /* Beschreibung */

;Mantiseinträge:
1973, 2980, 3582
;Systemtyp:
29

==Beschreibung==
Der Workflow besteht aus dem Serverjob OJOHZDOBarcodeTrenner.
Er durchsucht den Ordner eines Objekts nach Trennblättern, erstellt für jedes erkannte Trennblatt ein Kindobjekt und ordnet diesem alle Seiten bis zum nächsten Trennblatt zu.

Ein Trennblatt kann auf unterschiedliche Weise erkannt werden:

* über einen Barcode mit einem definierten Wert
* über eine Seite, die einen bestimmten Text enthält (OCR)
* über einen Bildvergleich mit einer bereitgestellten Vorlagendatei

'''Dieser Schritt hat zwei Ausgänge:'''

* erster Ausgang (grün) - Für das Vaterobjekt
* zweiter Ausgang (rot) - Für die Kindobjekte

==Konfiguration für Barcodes==
[[Datei:Barcode mode.png|400px]]
===Barcodetyp===
Hier können Sie im Dropdown definieren nach welchen Barcodetypen gesucht werden soll. Falls alle Barcodes gefunden und überprüft werden soll, wählen Sie "Alle finden".
===Barcodewert===
Definieren Sie einen Wert, welcher der Barcode beinhalten muss, damit diese Seite als Trennblatt zählt. Es ist möglich statische Werte sowie einen '''Regex''' zu definieren. Sie können zusätzlich den Platzhalter "[DOSEQ]" (ohne Anführungszeichen) verwenden. Mit dieser Konfiguration wird ein bereits bestehendes DO mit der entsprechenden Nummer gesucht. Die Seite wird nur zum Trennblatt wenn ein bestehendes Objekt gefunden wurde. Falls Sie das Kind nach dieser Sequenznummer zuordnen müssen, lesen Sie den Abschnitt "Signatur der Kinder".

Beispiele für Regex:
* Alle Zahlen: [0-9]*

==Konfiguration für OCR==
[[Datei:ocr mode.png|400px]] 
Beachten Sie, dass dieser Schritt nur Funktioniert, wenn die Objekte vorher durch den [https://www.helper.ch/wiki/index.php?title=OCR_Texterkennung OCR-Serverjob] gelaufen sind!
===OCR-Trenntext===
Mithilfe des OCR-Trenntextes können Sie definieren was für ein Text auf einer Seite stehen muss, damit die Seite als Trennblatt gewertet wird. Es ist möglich statische Begriffe sowie Regex zu definieren. Beachten Sie, dass sich der gesamte Ausdruck auf '''einer Zeile''' befinden muss!
====Beispiele====
OCR-Trenntext: Auszug aus dem Protokoll ==> Es wird auf jeder Seite nach "Auszug aus dem Protokoll" gesucht 
OCR-Trenntext: [0-9][0-9][0-9] ==> Es wird auf jeder Seite nach 3 stelligen Zahlen gesucht (123, 822, 111) 
OCR-Trenntext: aus .{5} ==> Es wird auf jeder Seite nach "aus <Wort mit 5 Zeichen egal welche>" gesucht ("aus Berlin" nicht aber "aus Bern")

==Konfiguration für Trennblatt-Vorlagedatei==

[[Datei:Bildschirmfoto 2026-01-23 um 17.32.41.png|Konfiguration Trennblattvorlage]]

'''Merke:''' Es werden nur Bilddateien unterstützt.

Im HZ-Ordner muss sich eine Datei befinden, die als Vorlage für die Trennblatterkennung verwendet wird.
Diese Vorlage ist in einem Unterordner mit dem Namen „Trennblatt“ abzulegen.

Der Ordner kann über die Konfiguration mit der Taste „Vorlagenordner öffnen…“ direkt geöffnet werden.
Existiert der Ordner noch nicht, wird er automatisch erstellt. Voraussetzung dafür ist, dass in der Konfiguration des Arbeitsschrittes bereits ein HZ-Ordner definiert ist.

Über die Einstellung „Grenzwert“ kann die Erkennungsschwelle mit einem Wert zwischen 0.00 und 100.00 festgelegt werden.
Zur Ermittlung eines geeigneten Grenzwerts lassen sich einzelne Dateien über die Taste „Teste Datei!“ prüfen.
Der Vergleichs-Score wird anschließend in einer Meldung ausgegeben. Bei eindeutigen Vorlagen ist typischerweise ein Wert um 75 ausreichend.

==Allgemeine Konfiguration==
===Modus für erste Datei im Vater===
Hier können Sie definieren ob die erste Datei im Vater ein Trennblatt sein '''muss''' oder ob alle Dateien bis zum ersten Trennblatt '''ignoriert''' werden sollen. Falls die erste Seite ein Trennblatt sein soll sie jedoch keine ist, gibt es ein Fehler. 
[[Datei:father mode.png|300px]]

===Modus für Trennblätter===
Hier können Sie definieren, was mit dem Trennblatt geschehen soll: Soll die Datei mit ins Kind kopiert werden, oder nicht? 
[[Datei:trennblatt mode.png|300px]]

====Anzahl Files zu löschen nach dem Trennblatt====
Steht diese Zahl auf 0 werden alle Seiten, nach dem Trennblatt bis zum nächsten, ins Kind kopiert. Schreiben Sie zB. 2 hinein werden alle Seiten, '''bis auf die ersten 2''', nach dem Trennblatt ins Kind kopiert. 
Diese Zahl kann auch negativ sein; In diesem Falle werden X Blätter '''vor''' dem nächsten Trennblatt gelöscht.

===Modus für Kinder===
[[Datei:child mode.png|500px]]
====Nichts tun====
Nichts tun ist aktuell keine Option! Es gibt einen Fehler und der aktuelle Arbeitsschritt wird gestoppt.
====Kinder erstellen====
Wählen Sie die Option "Kinder erstellen", wird für jedes Trennblatt ein neues Kind erstellt.

====Daten bestehendem Kind zuordnen====
Wählen Sie diese Option, falls ein bestimmtes Objekt gesucht werden soll, welches die getrennten Daten erhält. Gesucht wird nach dem Typ des Objektes sowie der definierten Signatur. Wird kein passendes Objekt gefunden, gibt es einen Fehler. Das gefundene Objekt wird danach automatisch zum Kind vom Haupt-Objekt.
=====Typ der Kinder=====
* Welchen Typ sollen die neu erstellten Kinder erhalten?
* Von welchem Typ sollen die gesuchten Kinder sein?
=====Signatur der Kinder=====
Hier definieren Sie eine Omnisformel, welche beim erstellen evaluiert wird und die Signatur des neuen Kindes definiert. Oder aber es definiert die Signatur des zu findenden Objektes (Je nach der Konfiguration "Modus für Kinder") 

'''Für alle "Kinder-Modus" brauchbar:'''
* Eine Liste der Omnisfunktionen finden Sie hier: [https://helper.ch/wiki/index.php?title=Omnisgrundlagen] 
* Es ist möglich Attribute des Vaters zu evaluieren ("[Attributname]")
* Es ist möglich der Ahnen des Vaters zu evaluieren ("[^Attributname]" für jede Generation nach oben ein "^" mehr)
* Es ist möglich via OCR nach Text auf der Seite zu suchen und diesen zu evaluieren ("[OCR-Treffer='<Wort>'+/-<Treffer Offset>]")
* Es ist möglich den Platzhalter [DOSigantur] zu verwenden (Signatur des aktuellen DO / Vater der Kinder)
* Es ist möglich den Platzhalter [BarcodeValue] zu verwenden (Den Wert des Barcodes) 
'''Für den Kind-Modus "Kinder erstellen" brauchbar:'''
* Es ist möglich den Platzhalter [DOKindNr] zu verwenden (Laufnummer des Kindes -> Das wievielte Kind bin ich?) 
'''Für den Kind-Modus "Daten bestehendem Objekt zuordnen" brauchbar:'''
* Es ist möglich den Platzhalter [DOSEQ=BarcodeValue] '''ALLEINE''' zu verwenden (Sucht das Kind basierend auf der DOSEQ im BarcodeValue und '''nicht''' nach der Signatur!)
 
'''Beispiele:''' 
* con('Buch_',[Jahr]) ==> Attribut "Jahr" des aktuellen DO wird eigesetzt ==> Mögliche Resultate: Buch_1999 / Buch_2018
* con('Ordner_',[^Farbe])" ==> Attribut "Farbe" des Vaters des aktuellen DO wird eingesetzt ==> Mögliche Resultate: Ordner_grün, Ordner_Blau
* con('Kalender_',[^^Grösse],'_gebunden')" ==> Attribut "Grösse" des Grossvaters des aktuellen DO wird eingesetzt ==> Mögliche Resultate: Kalender_200cm_gebunden
* con('Buch_',[OCR-Treffer="Nr."+1]) ==> Es wird auf der Seite nach dem ersten Vorkommen von "Nr." gesucht und das '''Folgewort''' eingesetzt
* con('Buch_',[OCR-Treffer="Personen"+3]) ==> Es wird auf der Seite nach dem ersten Vorkommen von "Personen" gesucht und das '''3. Wort nach Personen''' eingesetzt
* con('Buch_',[OCR-Treffer="[0-9][0-9]"-2]) ==> Es wird auf der Seite nach der ersten 2 stelligen Zahl (21, 00, 11) gesucht und das '''2. Wort vor dieser Zahl''' eingesetzt

====Objekte müssen bereits Kinder sein====
Hier können Sie definieren ob irgend ein Objekt mit der gewünschten Signatur gesucht werden soll, oder ob dieses '''bereits''' ein Kind des Hauptobjektes sein '''muss'''. 
Nein = Irgend ein Objekt wird gesucht mit der gewünschten Signatur
Ja = Es werden nur bestehende Kinder mit der gewünschten Signatur gesucht

====Dateinamen der Kinder für die Belegzuordnung vorbereiten====

Dieses Option ist Pflicht für eine anschliessende Belegzuordnung.
Falls einer der nächsten Arbeitsschritte eine Belegzuordnung sein wird, dann müssen die Dateinamen der bereits zugeordneten Dateien entsprechend der Namenskonvention des Belegzuordungsfenster geändert werden.
Ansonst wird das Belegzordnungsfenster nicht mit den Dateinamen umgehen können und daher nicht verwendbar sein.

==Fehler handling==
Grundsätzlich stoppt der Job falls ein unerwarteter Umstand auftritt (Fehler beim aktualisieren von Daten, falsche Konfiguration). Ist der Kind-Modus "Daten bestehendem Objekt zuordnen" ausgewählt und es gibt Trennblätter wofür kein passendes Objekt gefunden wurde, arbeitet der Job einfach weiter.

===Produktionsauftrag 20P0010===
Bei diesem Auftrag werden "]" welche aus dem OCR gelesen wurden durch "1" ersetzt. Diese Anpassung ist nötig, da das GDPicture OCR die Schreibmaschinen Eins als eckige Klammer interpretiert.

==Essentielle Felder==
HZ_BARCODETYP ''Welcher Barcodetyp soll geprüft werden?''

HZ_BARCODEWERT ''Nach welchem Wert soll im Barcode gesucht werden, damit die Seite ein Trennblatt wird?''

HZ_BARCODEFILEWEG ''Wieviele Files nach dem Barcodeblatt sollen gelöscht werden?''

HZ_BARCODE1WEG ''0 = Trennblatt wird nicht ins Kind kopiert 1 = Trennblatt wird ins Kind kopiert''

HZ_FORMEL ''Eine Omnisformel welche evaluiert wird und danach als Signatur für neue Kinder verwendet wird, oder aber mit der bestehende Kinder gesucht werden''

HZ_HASHTYP ''0 = Es wird nach Barcodes gesucht 1 = Es wird nach OCR-Text gesucht 2 = Es wird mit einer Dateivorlage verglichen''

HZ_DATENVORHERLOSCHEN ''0 = Erste Seite muss ein Trennblatt sein 1 = Alle Seiten bis zum ersten Trennblatt werden ignoriert''

HZ_FILEVERHALTEN ''Modus für Kinder: 0 = Nichts tun 1 = Kinder erstellen 2 = Daten bestehendem Kind zuordnen''

HZ_DY_SEQ1 ''Sequenznummer des Objekttypes welche die Kinder haben sollen''

HZ_KINDERVERDOPPELN. ''0 = Objekt muss kein Kind vom Haupt DO sein 1 = Objekt muss bereits ein Kind des Haupt DO sein

HZ_EXPORTFILETYP ''0 = Die Dateinamen bleiben bestehen 1 = Die Dateinamen der den Kindesobjekte zugeordneten Dateien werden für die benötigte Nameskonvention bereits zugeordneter Belege im Belegzuordnungsfenster angepasst.

HZ_WORDERSETZEN ''Regex nach dem getrennt werden soll im Fall 'Trennen nach OCR-Text' ''

HZ_WARTEDAUER ''Grenzwert für Suche nach OCR-Score''

;Erlaubte Werte:
Es soll ein regulärer Ausdruck angegeben werden, um nur die erlaubten Worte zuzulassen.

In Wikipedia befindet sich eine genaue Erklärung dazu: https://de.wikipedia.org/wiki/Regulärer_Ausdruck#Reguläre_Ausdrücke_in_der_Praxis

;Beispiel:

Das Format der Barcodewerte wäre zum Beispiel: AB1234
Dann wird Folgendes für den Barcodewert angegeben: [A-Z][A-Z][0-9][0-9][0-9][0-9]
Wenn der Anfang der Barcodes immer fix AB wäre, dann kann man stattdessen Folgendes angeben: [A][B][0-9][0-9][0-9][0-9]

Damit ist es fix, dass nur AB am Anfang zugelassen wird. Sonst wäre alles zwischen A-Z erlaubt.

Auf https://guides.gdpicture.com/content/GdPicture.NET.14~GdPicture14.Barcode1DReaderType.html stehen die Barcodetypen von GdPicture und deren Werte.

==Pane im Produktionsauftrag==

[[File:barcode.png|400px]][[File:barcodeOCR.png|400px]]

[[Kategorie:Workflowschritt]]

Barcodetrenner - Auftrennung von Objekten nach Barcodeblättern / OCR-Text

2026-01-27T17:47:10Z

Stefan: /* Konfiguration für Trennblatt-Vorlagedatei */

;Mantiseinträge:
1973, 2980, 3582
;Systemtyp:
29

==Beschreibung==
Der Workflow besteht aus dem Serverjob OJOHZDOBarcodeTrenner.
Er durchsucht den Ordner eines Objekts nach Trennblättern, erstellt für jedes erkannte Trennblatt ein Kindobjekt und ordnet diesem alle Seiten bis zum nächsten Trennblatt zu.

Ein Trennblatt kann auf unterschiedliche Weise erkannt werden:

* über einen Barcode mit einem definierten Wert
* über eine Seite, die einen bestimmten Text enthält (OCR)
* über einen Bildvergleich mit einer bereitgestellten Vorlagendatei

==Konfiguration für Barcodes==
[[Datei:Barcode mode.png|400px]]
===Barcodetyp===
Hier können Sie im Dropdown definieren nach welchen Barcodetypen gesucht werden soll. Falls alle Barcodes gefunden und überprüft werden soll, wählen Sie "Alle finden".
===Barcodewert===
Definieren Sie einen Wert, welcher der Barcode beinhalten muss, damit diese Seite als Trennblatt zählt. Es ist möglich statische Werte sowie einen '''Regex''' zu definieren. Sie können zusätzlich den Platzhalter "[DOSEQ]" (ohne Anführungszeichen) verwenden. Mit dieser Konfiguration wird ein bereits bestehendes DO mit der entsprechenden Nummer gesucht. Die Seite wird nur zum Trennblatt wenn ein bestehendes Objekt gefunden wurde. Falls Sie das Kind nach dieser Sequenznummer zuordnen müssen, lesen Sie den Abschnitt "Signatur der Kinder".

Beispiele für Regex:
* Alle Zahlen: [0-9]*

==Konfiguration für OCR==
[[Datei:ocr mode.png|400px]] 
Beachten Sie, dass dieser Schritt nur Funktioniert, wenn die Objekte vorher durch den [https://www.helper.ch/wiki/index.php?title=OCR_Texterkennung OCR-Serverjob] gelaufen sind!
===OCR-Trenntext===
Mithilfe des OCR-Trenntextes können Sie definieren was für ein Text auf einer Seite stehen muss, damit die Seite als Trennblatt gewertet wird. Es ist möglich statische Begriffe sowie Regex zu definieren. Beachten Sie, dass sich der gesamte Ausdruck auf '''einer Zeile''' befinden muss!
====Beispiele====
OCR-Trenntext: Auszug aus dem Protokoll ==> Es wird auf jeder Seite nach "Auszug aus dem Protokoll" gesucht 
OCR-Trenntext: [0-9][0-9][0-9] ==> Es wird auf jeder Seite nach 3 stelligen Zahlen gesucht (123, 822, 111) 
OCR-Trenntext: aus .{5} ==> Es wird auf jeder Seite nach "aus <Wort mit 5 Zeichen egal welche>" gesucht ("aus Berlin" nicht aber "aus Bern")

==Konfiguration für Trennblatt-Vorlagedatei==

[[Datei:Bildschirmfoto 2026-01-23 um 17.32.41.png|Konfiguration Trennblattvorlage]]

'''Merke:''' Es werden nur Bilddateien unterstützt.

Im HZ-Ordner muss sich eine Datei befinden, die als Vorlage für die Trennblatterkennung verwendet wird.
Diese Vorlage ist in einem Unterordner mit dem Namen „Trennblatt“ abzulegen.

Der Ordner kann über die Konfiguration mit der Taste „Vorlagenordner öffnen…“ direkt geöffnet werden.
Existiert der Ordner noch nicht, wird er automatisch erstellt. Voraussetzung dafür ist, dass in der Konfiguration des Arbeitsschrittes bereits ein HZ-Ordner definiert ist.

Über die Einstellung „Grenzwert“ kann die Erkennungsschwelle mit einem Wert zwischen 0.00 und 100.00 festgelegt werden.
Zur Ermittlung eines geeigneten Grenzwerts lassen sich einzelne Dateien über die Taste „Teste Datei!“ prüfen.
Der Vergleichs-Score wird anschließend in einer Meldung ausgegeben. Bei eindeutigen Vorlagen ist typischerweise ein Wert um 75 ausreichend.

==Allgemeine Konfiguration==
===Modus für erste Datei im Vater===
Hier können Sie definieren ob die erste Datei im Vater ein Trennblatt sein '''muss''' oder ob alle Dateien bis zum ersten Trennblatt '''ignoriert''' werden sollen. Falls die erste Seite ein Trennblatt sein soll sie jedoch keine ist, gibt es ein Fehler. 
[[Datei:father mode.png|300px]]

===Modus für Trennblätter===
Hier können Sie definieren, was mit dem Trennblatt geschehen soll: Soll die Datei mit ins Kind kopiert werden, oder nicht? 
[[Datei:trennblatt mode.png|300px]]

====Anzahl Files zu löschen nach dem Trennblatt====
Steht diese Zahl auf 0 werden alle Seiten, nach dem Trennblatt bis zum nächsten, ins Kind kopiert. Schreiben Sie zB. 2 hinein werden alle Seiten, '''bis auf die ersten 2''', nach dem Trennblatt ins Kind kopiert. 
Diese Zahl kann auch negativ sein; In diesem Falle werden X Blätter '''vor''' dem nächsten Trennblatt gelöscht.

===Modus für Kinder===
[[Datei:child mode.png|500px]]
====Nichts tun====
Nichts tun ist aktuell keine Option! Es gibt einen Fehler und der aktuelle Arbeitsschritt wird gestoppt.
====Kinder erstellen====
Wählen Sie die Option "Kinder erstellen", wird für jedes Trennblatt ein neues Kind erstellt.

====Daten bestehendem Kind zuordnen====
Wählen Sie diese Option, falls ein bestimmtes Objekt gesucht werden soll, welches die getrennten Daten erhält. Gesucht wird nach dem Typ des Objektes sowie der definierten Signatur. Wird kein passendes Objekt gefunden, gibt es einen Fehler. Das gefundene Objekt wird danach automatisch zum Kind vom Haupt-Objekt.
=====Typ der Kinder=====
* Welchen Typ sollen die neu erstellten Kinder erhalten?
* Von welchem Typ sollen die gesuchten Kinder sein?
=====Signatur der Kinder=====
Hier definieren Sie eine Omnisformel, welche beim erstellen evaluiert wird und die Signatur des neuen Kindes definiert. Oder aber es definiert die Signatur des zu findenden Objektes (Je nach der Konfiguration "Modus für Kinder") 

'''Für alle "Kinder-Modus" brauchbar:'''
* Eine Liste der Omnisfunktionen finden Sie hier: [https://helper.ch/wiki/index.php?title=Omnisgrundlagen] 
* Es ist möglich Attribute des Vaters zu evaluieren ("[Attributname]")
* Es ist möglich der Ahnen des Vaters zu evaluieren ("[^Attributname]" für jede Generation nach oben ein "^" mehr)
* Es ist möglich via OCR nach Text auf der Seite zu suchen und diesen zu evaluieren ("[OCR-Treffer='<Wort>'+/-<Treffer Offset>]")
* Es ist möglich den Platzhalter [DOSigantur] zu verwenden (Signatur des aktuellen DO / Vater der Kinder)
* Es ist möglich den Platzhalter [BarcodeValue] zu verwenden (Den Wert des Barcodes) 
'''Für den Kind-Modus "Kinder erstellen" brauchbar:'''
* Es ist möglich den Platzhalter [DOKindNr] zu verwenden (Laufnummer des Kindes -> Das wievielte Kind bin ich?) 
'''Für den Kind-Modus "Daten bestehendem Objekt zuordnen" brauchbar:'''
* Es ist möglich den Platzhalter [DOSEQ=BarcodeValue] '''ALLEINE''' zu verwenden (Sucht das Kind basierend auf der DOSEQ im BarcodeValue und '''nicht''' nach der Signatur!)
 
'''Beispiele:''' 
* con('Buch_',[Jahr]) ==> Attribut "Jahr" des aktuellen DO wird eigesetzt ==> Mögliche Resultate: Buch_1999 / Buch_2018
* con('Ordner_',[^Farbe])" ==> Attribut "Farbe" des Vaters des aktuellen DO wird eingesetzt ==> Mögliche Resultate: Ordner_grün, Ordner_Blau
* con('Kalender_',[^^Grösse],'_gebunden')" ==> Attribut "Grösse" des Grossvaters des aktuellen DO wird eingesetzt ==> Mögliche Resultate: Kalender_200cm_gebunden
* con('Buch_',[OCR-Treffer="Nr."+1]) ==> Es wird auf der Seite nach dem ersten Vorkommen von "Nr." gesucht und das '''Folgewort''' eingesetzt
* con('Buch_',[OCR-Treffer="Personen"+3]) ==> Es wird auf der Seite nach dem ersten Vorkommen von "Personen" gesucht und das '''3. Wort nach Personen''' eingesetzt
* con('Buch_',[OCR-Treffer="[0-9][0-9]"-2]) ==> Es wird auf der Seite nach der ersten 2 stelligen Zahl (21, 00, 11) gesucht und das '''2. Wort vor dieser Zahl''' eingesetzt

====Objekte müssen bereits Kinder sein====
Hier können Sie definieren ob irgend ein Objekt mit der gewünschten Signatur gesucht werden soll, oder ob dieses '''bereits''' ein Kind des Hauptobjektes sein '''muss'''. 
Nein = Irgend ein Objekt wird gesucht mit der gewünschten Signatur
Ja = Es werden nur bestehende Kinder mit der gewünschten Signatur gesucht

====Dateinamen der Kinder für die Belegzuordnung vorbereiten====

Dieses Option ist Pflicht für eine anschliessende Belegzuordnung.
Falls einer der nächsten Arbeitsschritte eine Belegzuordnung sein wird, dann müssen die Dateinamen der bereits zugeordneten Dateien entsprechend der Namenskonvention des Belegzuordungsfenster geändert werden.
Ansonst wird das Belegzordnungsfenster nicht mit den Dateinamen umgehen können und daher nicht verwendbar sein.

==Fehler handling==
Grundsätzlich stoppt der Job falls ein unerwarteter Umstand auftritt (Fehler beim aktualisieren von Daten, falsche Konfiguration). Ist der Kind-Modus "Daten bestehendem Objekt zuordnen" ausgewählt und es gibt Trennblätter wofür kein passendes Objekt gefunden wurde, arbeitet der Job einfach weiter.

===Produktionsauftrag 20P0010===
Bei diesem Auftrag werden "]" welche aus dem OCR gelesen wurden durch "1" ersetzt. Diese Anpassung ist nötig, da das GDPicture OCR die Schreibmaschinen Eins als eckige Klammer interpretiert.

==Essentielle Felder==
HZ_BARCODETYP ''Welcher Barcodetyp soll geprüft werden?''

HZ_BARCODEWERT ''Nach welchem Wert soll im Barcode gesucht werden, damit die Seite ein Trennblatt wird?''

HZ_BARCODEFILEWEG ''Wieviele Files nach dem Barcodeblatt sollen gelöscht werden?''

HZ_BARCODE1WEG ''0 = Trennblatt wird nicht ins Kind kopiert 1 = Trennblatt wird ins Kind kopiert''

HZ_FORMEL ''Eine Omnisformel welche evaluiert wird und danach als Signatur für neue Kinder verwendet wird, oder aber mit der bestehende Kinder gesucht werden''

HZ_HASHTYP ''0 = Es wird nach Barcodes gesucht 1 = Es wird nach OCR-Text gesucht 2 = Es wird mit einer Dateivorlage verglichen''

HZ_DATENVORHERLOSCHEN ''0 = Erste Seite muss ein Trennblatt sein 1 = Alle Seiten bis zum ersten Trennblatt werden ignoriert''

HZ_FILEVERHALTEN ''Modus für Kinder: 0 = Nichts tun 1 = Kinder erstellen 2 = Daten bestehendem Kind zuordnen''

HZ_DY_SEQ1 ''Sequenznummer des Objekttypes welche die Kinder haben sollen''

HZ_KINDERVERDOPPELN. ''0 = Objekt muss kein Kind vom Haupt DO sein 1 = Objekt muss bereits ein Kind des Haupt DO sein

HZ_EXPORTFILETYP ''0 = Die Dateinamen bleiben bestehen 1 = Die Dateinamen der den Kindesobjekte zugeordneten Dateien werden für die benötigte Nameskonvention bereits zugeordneter Belege im Belegzuordnungsfenster angepasst.

HZ_WORDERSETZEN ''Regex nach dem getrennt werden soll im Fall 'Trennen nach OCR-Text' ''

HZ_WARTEDAUER ''Grenzwert für Suche nach OCR-Score''

;Erlaubte Werte:
Es soll ein regulärer Ausdruck angegeben werden, um nur die erlaubten Worte zuzulassen.

In Wikipedia befindet sich eine genaue Erklärung dazu: https://de.wikipedia.org/wiki/Regulärer_Ausdruck#Reguläre_Ausdrücke_in_der_Praxis

;Beispiel:

Das Format der Barcodewerte wäre zum Beispiel: AB1234
Dann wird Folgendes für den Barcodewert angegeben: [A-Z][A-Z][0-9][0-9][0-9][0-9]
Wenn der Anfang der Barcodes immer fix AB wäre, dann kann man stattdessen Folgendes angeben: [A][B][0-9][0-9][0-9][0-9]

Damit ist es fix, dass nur AB am Anfang zugelassen wird. Sonst wäre alles zwischen A-Z erlaubt.

Auf https://guides.gdpicture.com/content/GdPicture.NET.14~GdPicture14.Barcode1DReaderType.html stehen die Barcodetypen von GdPicture und deren Werte.

==Pane im Produktionsauftrag==

[[File:barcode.png|400px]][[File:barcodeOCR.png|400px]]

[[Kategorie:Workflowschritt]]

Barcodetrenner - Auftrennung von Objekten nach Barcodeblättern / OCR-Text

2026-01-27T08:17:50Z

Stefan: /* Essentielle Felder */

;Mantiseinträge:
1973, 2980, 3582
;Systemtyp:
29

==Beschreibung==
Der Workflow besteht aus dem Serverjob OJOHZDOBarcodeTrenner.
Er durchsucht den Ordner eines Objekts nach Trennblättern, erstellt für jedes erkannte Trennblatt ein Kindobjekt und ordnet diesem alle Seiten bis zum nächsten Trennblatt zu.

Ein Trennblatt kann auf unterschiedliche Weise erkannt werden:

* über einen Barcode mit einem definierten Wert
* über eine Seite, die einen bestimmten Text enthält (OCR)
* über einen Bildvergleich mit einer bereitgestellten Vorlagendatei

==Konfiguration für Barcodes==
[[Datei:Barcode mode.png|400px]]
===Barcodetyp===
Hier können Sie im Dropdown definieren nach welchen Barcodetypen gesucht werden soll. Falls alle Barcodes gefunden und überprüft werden soll, wählen Sie "Alle finden".
===Barcodewert===
Definieren Sie einen Wert, welcher der Barcode beinhalten muss, damit diese Seite als Trennblatt zählt. Es ist möglich statische Werte sowie einen '''Regex''' zu definieren. Sie können zusätzlich den Platzhalter "[DOSEQ]" (ohne Anführungszeichen) verwenden. Mit dieser Konfiguration wird ein bereits bestehendes DO mit der entsprechenden Nummer gesucht. Die Seite wird nur zum Trennblatt wenn ein bestehendes Objekt gefunden wurde. Falls Sie das Kind nach dieser Sequenznummer zuordnen müssen, lesen Sie den Abschnitt "Signatur der Kinder".

Beispiele für Regex:
* Alle Zahlen: [0-9]*

==Konfiguration für OCR==
[[Datei:ocr mode.png|400px]] 
Beachten Sie, dass dieser Schritt nur Funktioniert, wenn die Objekte vorher durch den [https://www.helper.ch/wiki/index.php?title=OCR_Texterkennung OCR-Serverjob] gelaufen sind!
===OCR-Trenntext===
Mithilfe des OCR-Trenntextes können Sie definieren was für ein Text auf einer Seite stehen muss, damit die Seite als Trennblatt gewertet wird. Es ist möglich statische Begriffe sowie Regex zu definieren. Beachten Sie, dass sich der gesamte Ausdruck auf '''einer Zeile''' befinden muss!
====Beispiele====
OCR-Trenntext: Auszug aus dem Protokoll ==> Es wird auf jeder Seite nach "Auszug aus dem Protokoll" gesucht 
OCR-Trenntext: [0-9][0-9][0-9] ==> Es wird auf jeder Seite nach 3 stelligen Zahlen gesucht (123, 822, 111) 
OCR-Trenntext: aus .{5} ==> Es wird auf jeder Seite nach "aus <Wort mit 5 Zeichen egal welche>" gesucht ("aus Berlin" nicht aber "aus Bern")

==Konfiguration für Trennblatt-Vorlagedatei==

'''Merke:''' Es werden nur Bilddateien unterstützt.

Im HZ-Ordner muss sich eine Datei befinden, die als Vorlage für die Trennblatterkennung verwendet wird.
Diese Vorlage ist in einem Unterordner mit dem Namen „Trennblatt“ abzulegen.

Der Ordner kann über die Konfiguration mit der Taste „Vorlagenordner öffnen…“ direkt geöffnet werden.
Existiert der Ordner noch nicht, wird er automatisch erstellt. Voraussetzung dafür ist, dass in der Konfiguration des Arbeitsschrittes bereits ein HZ-Ordner definiert ist.

Über die Einstellung „Grenzwert“ kann die Erkennungsschwelle mit einem Wert zwischen 0.00 und 100.00 festgelegt werden.
Zur Ermittlung eines geeigneten Grenzwerts lassen sich einzelne Dateien über die Taste „Teste Datei!“ prüfen.
Der Vergleichs-Score wird anschließend in einer Meldung ausgegeben. Bei eindeutigen Vorlagen ist typischerweise ein Wert um 75 ausreichend.

[[Datei:Bildschirmfoto 2026-01-23 um 17.32.41.png|Konfiguration Trennblattvorlage]]

==Allgemeine Konfiguration==
===Modus für erste Datei im Vater===
Hier können Sie definieren ob die erste Datei im Vater ein Trennblatt sein '''muss''' oder ob alle Dateien bis zum ersten Trennblatt '''ignoriert''' werden sollen. Falls die erste Seite ein Trennblatt sein soll sie jedoch keine ist, gibt es ein Fehler. 
[[Datei:father mode.png|300px]]

===Modus für Trennblätter===
Hier können Sie definieren, was mit dem Trennblatt geschehen soll: Soll die Datei mit ins Kind kopiert werden, oder nicht? 
[[Datei:trennblatt mode.png|300px]]

====Anzahl Files zu löschen nach dem Trennblatt====
Steht diese Zahl auf 0 werden alle Seiten, nach dem Trennblatt bis zum nächsten, ins Kind kopiert. Schreiben Sie zB. 2 hinein werden alle Seiten, '''bis auf die ersten 2''', nach dem Trennblatt ins Kind kopiert. 
Diese Zahl kann auch negativ sein; In diesem Falle werden X Blätter '''vor''' dem nächsten Trennblatt gelöscht.

===Modus für Kinder===
[[Datei:child mode.png|500px]]
====Nichts tun====
Nichts tun ist aktuell keine Option! Es gibt einen Fehler und der aktuelle Arbeitsschritt wird gestoppt.
====Kinder erstellen====
Wählen Sie die Option "Kinder erstellen", wird für jedes Trennblatt ein neues Kind erstellt.

====Daten bestehendem Kind zuordnen====
Wählen Sie diese Option, falls ein bestimmtes Objekt gesucht werden soll, welches die getrennten Daten erhält. Gesucht wird nach dem Typ des Objektes sowie der definierten Signatur. Wird kein passendes Objekt gefunden, gibt es einen Fehler. Das gefundene Objekt wird danach automatisch zum Kind vom Haupt-Objekt.
=====Typ der Kinder=====
* Welchen Typ sollen die neu erstellten Kinder erhalten?
* Von welchem Typ sollen die gesuchten Kinder sein?
=====Signatur der Kinder=====
Hier definieren Sie eine Omnisformel, welche beim erstellen evaluiert wird und die Signatur des neuen Kindes definiert. Oder aber es definiert die Signatur des zu findenden Objektes (Je nach der Konfiguration "Modus für Kinder") 

'''Für alle "Kinder-Modus" brauchbar:'''
* Eine Liste der Omnisfunktionen finden Sie hier: [https://helper.ch/wiki/index.php?title=Omnisgrundlagen] 
* Es ist möglich Attribute des Vaters zu evaluieren ("[Attributname]")
* Es ist möglich der Ahnen des Vaters zu evaluieren ("[^Attributname]" für jede Generation nach oben ein "^" mehr)
* Es ist möglich via OCR nach Text auf der Seite zu suchen und diesen zu evaluieren ("[OCR-Treffer='<Wort>'+/-<Treffer Offset>]")
* Es ist möglich den Platzhalter [DOSigantur] zu verwenden (Signatur des aktuellen DO / Vater der Kinder)
* Es ist möglich den Platzhalter [BarcodeValue] zu verwenden (Den Wert des Barcodes) 
'''Für den Kind-Modus "Kinder erstellen" brauchbar:'''
* Es ist möglich den Platzhalter [DOKindNr] zu verwenden (Laufnummer des Kindes -> Das wievielte Kind bin ich?) 
'''Für den Kind-Modus "Daten bestehendem Objekt zuordnen" brauchbar:'''
* Es ist möglich den Platzhalter [DOSEQ=BarcodeValue] '''ALLEINE''' zu verwenden (Sucht das Kind basierend auf der DOSEQ im BarcodeValue und '''nicht''' nach der Signatur!)
 
'''Beispiele:''' 
* con('Buch_',[Jahr]) ==> Attribut "Jahr" des aktuellen DO wird eigesetzt ==> Mögliche Resultate: Buch_1999 / Buch_2018
* con('Ordner_',[^Farbe])" ==> Attribut "Farbe" des Vaters des aktuellen DO wird eingesetzt ==> Mögliche Resultate: Ordner_grün, Ordner_Blau
* con('Kalender_',[^^Grösse],'_gebunden')" ==> Attribut "Grösse" des Grossvaters des aktuellen DO wird eingesetzt ==> Mögliche Resultate: Kalender_200cm_gebunden
* con('Buch_',[OCR-Treffer="Nr."+1]) ==> Es wird auf der Seite nach dem ersten Vorkommen von "Nr." gesucht und das '''Folgewort''' eingesetzt
* con('Buch_',[OCR-Treffer="Personen"+3]) ==> Es wird auf der Seite nach dem ersten Vorkommen von "Personen" gesucht und das '''3. Wort nach Personen''' eingesetzt
* con('Buch_',[OCR-Treffer="[0-9][0-9]"-2]) ==> Es wird auf der Seite nach der ersten 2 stelligen Zahl (21, 00, 11) gesucht und das '''2. Wort vor dieser Zahl''' eingesetzt

====Objekte müssen bereits Kinder sein====
Hier können Sie definieren ob irgend ein Objekt mit der gewünschten Signatur gesucht werden soll, oder ob dieses '''bereits''' ein Kind des Hauptobjektes sein '''muss'''. 
Nein = Irgend ein Objekt wird gesucht mit der gewünschten Signatur
Ja = Es werden nur bestehende Kinder mit der gewünschten Signatur gesucht

====Dateinamen der Kinder für die Belegzuordnung vorbereiten====

Dieses Option ist Pflicht für eine anschliessende Belegzuordnung.
Falls einer der nächsten Arbeitsschritte eine Belegzuordnung sein wird, dann müssen die Dateinamen der bereits zugeordneten Dateien entsprechend der Namenskonvention des Belegzuordungsfenster geändert werden.
Ansonst wird das Belegzordnungsfenster nicht mit den Dateinamen umgehen können und daher nicht verwendbar sein.

==Fehler handling==
Grundsätzlich stoppt der Job falls ein unerwarteter Umstand auftritt (Fehler beim aktualisieren von Daten, falsche Konfiguration). Ist der Kind-Modus "Daten bestehendem Objekt zuordnen" ausgewählt und es gibt Trennblätter wofür kein passendes Objekt gefunden wurde, arbeitet der Job einfach weiter.

===Produktionsauftrag 20P0010===
Bei diesem Auftrag werden "]" welche aus dem OCR gelesen wurden durch "1" ersetzt. Diese Anpassung ist nötig, da das GDPicture OCR die Schreibmaschinen Eins als eckige Klammer interpretiert.

==Essentielle Felder==
HZ_BARCODETYP ''Welcher Barcodetyp soll geprüft werden?''

HZ_BARCODEWERT ''Nach welchem Wert soll im Barcode gesucht werden, damit die Seite ein Trennblatt wird?''

HZ_BARCODEFILEWEG ''Wieviele Files nach dem Barcodeblatt sollen gelöscht werden?''

HZ_BARCODE1WEG ''0 = Trennblatt wird nicht ins Kind kopiert 1 = Trennblatt wird ins Kind kopiert''

HZ_FORMEL ''Eine Omnisformel welche evaluiert wird und danach als Signatur für neue Kinder verwendet wird, oder aber mit der bestehende Kinder gesucht werden''

HZ_HASHTYP ''0 = Es wird nach Barcodes gesucht 1 = Es wird nach OCR-Text gesucht 2 = Es wird mit einer Dateivorlage verglichen''

HZ_DATENVORHERLOSCHEN ''0 = Erste Seite muss ein Trennblatt sein 1 = Alle Seiten bis zum ersten Trennblatt werden ignoriert''

HZ_FILEVERHALTEN ''Modus für Kinder: 0 = Nichts tun 1 = Kinder erstellen 2 = Daten bestehendem Kind zuordnen''

HZ_DY_SEQ1 ''Sequenznummer des Objekttypes welche die Kinder haben sollen''

HZ_KINDERVERDOPPELN. ''0 = Objekt muss kein Kind vom Haupt DO sein 1 = Objekt muss bereits ein Kind des Haupt DO sein

HZ_EXPORTFILETYP ''0 = Die Dateinamen bleiben bestehen 1 = Die Dateinamen der den Kindesobjekte zugeordneten Dateien werden für die benötigte Nameskonvention bereits zugeordneter Belege im Belegzuordnungsfenster angepasst.

HZ_WORDERSETZEN ''Regex nach dem getrennt werden soll im Fall 'Trennen nach OCR-Text' ''

HZ_WARTEDAUER ''Grenzwert für Suche nach OCR-Score''

;Erlaubte Werte:
Es soll ein regulärer Ausdruck angegeben werden, um nur die erlaubten Worte zuzulassen.

In Wikipedia befindet sich eine genaue Erklärung dazu: https://de.wikipedia.org/wiki/Regulärer_Ausdruck#Reguläre_Ausdrücke_in_der_Praxis

;Beispiel:

Das Format der Barcodewerte wäre zum Beispiel: AB1234
Dann wird Folgendes für den Barcodewert angegeben: [A-Z][A-Z][0-9][0-9][0-9][0-9]
Wenn der Anfang der Barcodes immer fix AB wäre, dann kann man stattdessen Folgendes angeben: [A][B][0-9][0-9][0-9][0-9]

Damit ist es fix, dass nur AB am Anfang zugelassen wird. Sonst wäre alles zwischen A-Z erlaubt.

Auf https://guides.gdpicture.com/content/GdPicture.NET.14~GdPicture14.Barcode1DReaderType.html stehen die Barcodetypen von GdPicture und deren Werte.

==Pane im Produktionsauftrag==

[[File:barcode.png|400px]][[File:barcodeOCR.png|400px]]

[[Kategorie:Workflowschritt]]

Barcodetrenner - Auftrennung von Objekten nach Barcodeblättern / OCR-Text

2026-01-26T15:39:22Z

Stefan: /* Konfiguration für Trennblattvorlage */

;Mantiseinträge:
1973, 2980, 3582
;Systemtyp:
29

==Beschreibung==
Der Workflow besteht aus dem Serverjob OJOHZDOBarcodeTrenner.
Er durchsucht den Ordner eines Objekts nach Trennblättern, erstellt für jedes erkannte Trennblatt ein Kindobjekt und ordnet diesem alle Seiten bis zum nächsten Trennblatt zu.

Ein Trennblatt kann auf unterschiedliche Weise erkannt werden:

* über einen Barcode mit einem definierten Wert
* über eine Seite, die einen bestimmten Text enthält (OCR)
* über einen Bildvergleich mit einer bereitgestellten Vorlagendatei

==Konfiguration für Barcodes==
[[Datei:Barcode mode.png|400px]]
===Barcodetyp===
Hier können Sie im Dropdown definieren nach welchen Barcodetypen gesucht werden soll. Falls alle Barcodes gefunden und überprüft werden soll, wählen Sie "Alle finden".
===Barcodewert===
Definieren Sie einen Wert, welcher der Barcode beinhalten muss, damit diese Seite als Trennblatt zählt. Es ist möglich statische Werte sowie einen '''Regex''' zu definieren. Sie können zusätzlich den Platzhalter "[DOSEQ]" (ohne Anführungszeichen) verwenden. Mit dieser Konfiguration wird ein bereits bestehendes DO mit der entsprechenden Nummer gesucht. Die Seite wird nur zum Trennblatt wenn ein bestehendes Objekt gefunden wurde. Falls Sie das Kind nach dieser Sequenznummer zuordnen müssen, lesen Sie den Abschnitt "Signatur der Kinder".

Beispiele für Regex:
* Alle Zahlen: [0-9]*

==Konfiguration für OCR==
[[Datei:ocr mode.png|400px]] 
Beachten Sie, dass dieser Schritt nur Funktioniert, wenn die Objekte vorher durch den [https://www.helper.ch/wiki/index.php?title=OCR_Texterkennung OCR-Serverjob] gelaufen sind!
===OCR-Trenntext===
Mithilfe des OCR-Trenntextes können Sie definieren was für ein Text auf einer Seite stehen muss, damit die Seite als Trennblatt gewertet wird. Es ist möglich statische Begriffe sowie Regex zu definieren. Beachten Sie, dass sich der gesamte Ausdruck auf '''einer Zeile''' befinden muss!
====Beispiele====
OCR-Trenntext: Auszug aus dem Protokoll ==> Es wird auf jeder Seite nach "Auszug aus dem Protokoll" gesucht 
OCR-Trenntext: [0-9][0-9][0-9] ==> Es wird auf jeder Seite nach 3 stelligen Zahlen gesucht (123, 822, 111) 
OCR-Trenntext: aus .{5} ==> Es wird auf jeder Seite nach "aus <Wort mit 5 Zeichen egal welche>" gesucht ("aus Berlin" nicht aber "aus Bern")

==Konfiguration für Trennblatt-Vorlagedatei==

'''Merke:''' Es werden nur Bilddateien unterstützt.

Im HZ-Ordner muss sich eine Datei befinden, die als Vorlage für die Trennblatterkennung verwendet wird.
Diese Vorlage ist in einem Unterordner mit dem Namen „Trennblatt“ abzulegen.

Der Ordner kann über die Konfiguration mit der Taste „Vorlagenordner öffnen…“ direkt geöffnet werden.
Existiert der Ordner noch nicht, wird er automatisch erstellt. Voraussetzung dafür ist, dass in der Konfiguration des Arbeitsschrittes bereits ein HZ-Ordner definiert ist.

Über die Einstellung „Grenzwert“ kann die Erkennungsschwelle mit einem Wert zwischen 0.00 und 100.00 festgelegt werden.
Zur Ermittlung eines geeigneten Grenzwerts lassen sich einzelne Dateien über die Taste „Teste Datei!“ prüfen.
Der Vergleichs-Score wird anschließend in einer Meldung ausgegeben. Bei eindeutigen Vorlagen ist typischerweise ein Wert um 75 ausreichend.

[[Datei:Bildschirmfoto 2026-01-23 um 17.32.41.png|Konfiguration Trennblattvorlage]]

==Allgemeine Konfiguration==
===Modus für erste Datei im Vater===
Hier können Sie definieren ob die erste Datei im Vater ein Trennblatt sein '''muss''' oder ob alle Dateien bis zum ersten Trennblatt '''ignoriert''' werden sollen. Falls die erste Seite ein Trennblatt sein soll sie jedoch keine ist, gibt es ein Fehler. 
[[Datei:father mode.png|300px]]

===Modus für Trennblätter===
Hier können Sie definieren, was mit dem Trennblatt geschehen soll: Soll die Datei mit ins Kind kopiert werden, oder nicht? 
[[Datei:trennblatt mode.png|300px]]

====Anzahl Files zu löschen nach dem Trennblatt====
Steht diese Zahl auf 0 werden alle Seiten, nach dem Trennblatt bis zum nächsten, ins Kind kopiert. Schreiben Sie zB. 2 hinein werden alle Seiten, '''bis auf die ersten 2''', nach dem Trennblatt ins Kind kopiert. 
Diese Zahl kann auch negativ sein; In diesem Falle werden X Blätter '''vor''' dem nächsten Trennblatt gelöscht.

===Modus für Kinder===
[[Datei:child mode.png|500px]]
====Nichts tun====
Nichts tun ist aktuell keine Option! Es gibt einen Fehler und der aktuelle Arbeitsschritt wird gestoppt.
====Kinder erstellen====
Wählen Sie die Option "Kinder erstellen", wird für jedes Trennblatt ein neues Kind erstellt.

====Daten bestehendem Kind zuordnen====
Wählen Sie diese Option, falls ein bestimmtes Objekt gesucht werden soll, welches die getrennten Daten erhält. Gesucht wird nach dem Typ des Objektes sowie der definierten Signatur. Wird kein passendes Objekt gefunden, gibt es einen Fehler. Das gefundene Objekt wird danach automatisch zum Kind vom Haupt-Objekt.
=====Typ der Kinder=====
* Welchen Typ sollen die neu erstellten Kinder erhalten?
* Von welchem Typ sollen die gesuchten Kinder sein?
=====Signatur der Kinder=====
Hier definieren Sie eine Omnisformel, welche beim erstellen evaluiert wird und die Signatur des neuen Kindes definiert. Oder aber es definiert die Signatur des zu findenden Objektes (Je nach der Konfiguration "Modus für Kinder") 

'''Für alle "Kinder-Modus" brauchbar:'''
* Eine Liste der Omnisfunktionen finden Sie hier: [https://helper.ch/wiki/index.php?title=Omnisgrundlagen] 
* Es ist möglich Attribute des Vaters zu evaluieren ("[Attributname]")
* Es ist möglich der Ahnen des Vaters zu evaluieren ("[^Attributname]" für jede Generation nach oben ein "^" mehr)
* Es ist möglich via OCR nach Text auf der Seite zu suchen und diesen zu evaluieren ("[OCR-Treffer='<Wort>'+/-<Treffer Offset>]")
* Es ist möglich den Platzhalter [DOSigantur] zu verwenden (Signatur des aktuellen DO / Vater der Kinder)
* Es ist möglich den Platzhalter [BarcodeValue] zu verwenden (Den Wert des Barcodes) 
'''Für den Kind-Modus "Kinder erstellen" brauchbar:'''
* Es ist möglich den Platzhalter [DOKindNr] zu verwenden (Laufnummer des Kindes -> Das wievielte Kind bin ich?) 
'''Für den Kind-Modus "Daten bestehendem Objekt zuordnen" brauchbar:'''
* Es ist möglich den Platzhalter [DOSEQ=BarcodeValue] '''ALLEINE''' zu verwenden (Sucht das Kind basierend auf der DOSEQ im BarcodeValue und '''nicht''' nach der Signatur!)
 
'''Beispiele:''' 
* con('Buch_',[Jahr]) ==> Attribut "Jahr" des aktuellen DO wird eigesetzt ==> Mögliche Resultate: Buch_1999 / Buch_2018
* con('Ordner_',[^Farbe])" ==> Attribut "Farbe" des Vaters des aktuellen DO wird eingesetzt ==> Mögliche Resultate: Ordner_grün, Ordner_Blau
* con('Kalender_',[^^Grösse],'_gebunden')" ==> Attribut "Grösse" des Grossvaters des aktuellen DO wird eingesetzt ==> Mögliche Resultate: Kalender_200cm_gebunden
* con('Buch_',[OCR-Treffer="Nr."+1]) ==> Es wird auf der Seite nach dem ersten Vorkommen von "Nr." gesucht und das '''Folgewort''' eingesetzt
* con('Buch_',[OCR-Treffer="Personen"+3]) ==> Es wird auf der Seite nach dem ersten Vorkommen von "Personen" gesucht und das '''3. Wort nach Personen''' eingesetzt
* con('Buch_',[OCR-Treffer="[0-9][0-9]"-2]) ==> Es wird auf der Seite nach der ersten 2 stelligen Zahl (21, 00, 11) gesucht und das '''2. Wort vor dieser Zahl''' eingesetzt

====Objekte müssen bereits Kinder sein====
Hier können Sie definieren ob irgend ein Objekt mit der gewünschten Signatur gesucht werden soll, oder ob dieses '''bereits''' ein Kind des Hauptobjektes sein '''muss'''. 
Nein = Irgend ein Objekt wird gesucht mit der gewünschten Signatur
Ja = Es werden nur bestehende Kinder mit der gewünschten Signatur gesucht

====Dateinamen der Kinder für die Belegzuordnung vorbereiten====

Dieses Option ist Pflicht für eine anschliessende Belegzuordnung.
Falls einer der nächsten Arbeitsschritte eine Belegzuordnung sein wird, dann müssen die Dateinamen der bereits zugeordneten Dateien entsprechend der Namenskonvention des Belegzuordungsfenster geändert werden.
Ansonst wird das Belegzordnungsfenster nicht mit den Dateinamen umgehen können und daher nicht verwendbar sein.

==Fehler handling==
Grundsätzlich stoppt der Job falls ein unerwarteter Umstand auftritt (Fehler beim aktualisieren von Daten, falsche Konfiguration). Ist der Kind-Modus "Daten bestehendem Objekt zuordnen" ausgewählt und es gibt Trennblätter wofür kein passendes Objekt gefunden wurde, arbeitet der Job einfach weiter.

===Produktionsauftrag 20P0010===
Bei diesem Auftrag werden "]" welche aus dem OCR gelesen wurden durch "1" ersetzt. Diese Anpassung ist nötig, da das GDPicture OCR die Schreibmaschinen Eins als eckige Klammer interpretiert.

==Essentielle Felder==
HZ_BARCODETYP ''Welcher Barcodetyp soll geprüft werden?''

HZ_BARCODEWERT ''Nach welchem Wert soll im Barcode gesucht werden, damit die Seite ein Trennblatt wird?''

HZ_BARCODEFILEWEG ''Wieviele Files nach dem Barcodeblatt sollen gelöscht werden?''

HZ_BARCODE1WEG ''0 = Trennblatt wird nicht ins Kind kopiert 1 = Trennblatt wird ins Kind kopiert''

HZ_FORMEL ''Eine Omnisformel welche evaluiert wird und danach als Signatur für neue Kinder verwendet wird, oder aber mit der bestehende Kinder gesucht werden''

HZ_HASHTYP ''0 = Es wird nach Barcodes gesucht 1 = Es wird nach OCR-Text gesucht''

HZ_DATENVORHERLOSCHEN ''0 = Erste Seite muss ein Trennblatt sein 1 = Alle Seiten bis zum ersten Trennblatt werden ignoriert''

HZ_FILEVERHALTEN ''Modus für Kinder: 0 = Nichts tun 1 = Kinder erstellen 2 = Daten bestehendem Kind zuordnen''

HZ_DY_SEQ1 ''Sequenznummer des Objekttypes welche die Kinder haben sollen''

HZ_KINDERVERDOPPELN ''0 = Objekt muss kein Kind vom Haupt DO sein 1 = Objekt muss bereits ein Kind des Haupt DO sein

HZ_EXPORTFILETYP ''0 = Die Dateinamen bleiben bestehen 1 = Die Dateinamen der den Kindesobjekte zugeordneten Dateien werden für die benötigte Nameskonvention bereits zugeordneter Belege im Belegzuordnungsfenster angepasst.

HZ_WORDERSETZEN ''Regex nach dem getrennt werden soll im Fall 'Trennen nach OCR-Text' ''

HZ_WARTEDAUER zukünftig ''Grenzwert für Suche nach OCR-Score''

;Erlaubte Werte:
Es soll ein regulärer Ausdruck angegeben werden, um nur die erlaubten Worte zuzulassen.

In Wikipedia befindet sich eine genaue Erklärung dazu: https://de.wikipedia.org/wiki/Regulärer_Ausdruck#Reguläre_Ausdrücke_in_der_Praxis

;Beispiel:

Das Format der Barcodewerte wäre zum Beispiel: AB1234
Dann wird Folgendes für den Barcodewert angegeben: [A-Z][A-Z][0-9][0-9][0-9][0-9]
Wenn der Anfang der Barcodes immer fix AB wäre, dann kann man stattdessen Folgendes angeben: [A][B][0-9][0-9][0-9][0-9]

Damit ist es fix, dass nur AB am Anfang zugelassen wird. Sonst wäre alles zwischen A-Z erlaubt.

Auf https://guides.gdpicture.com/content/GdPicture.NET.14~GdPicture14.Barcode1DReaderType.html stehen die Barcodetypen von GdPicture und deren Werte.

==Pane im Produktionsauftrag==

[[File:barcode.png|400px]][[File:barcodeOCR.png|400px]]

[[Kategorie:Workflowschritt]]

Barcodetrenner - Auftrennung von Objekten nach Barcodeblättern / OCR-Text

2026-01-26T15:38:33Z

Stefan:

;Mantiseinträge:
1973, 2980, 3582
;Systemtyp:
29

==Beschreibung==
Der Workflow besteht aus dem Serverjob OJOHZDOBarcodeTrenner.
Er durchsucht den Ordner eines Objekts nach Trennblättern, erstellt für jedes erkannte Trennblatt ein Kindobjekt und ordnet diesem alle Seiten bis zum nächsten Trennblatt zu.

Ein Trennblatt kann auf unterschiedliche Weise erkannt werden:

* über einen Barcode mit einem definierten Wert
* über eine Seite, die einen bestimmten Text enthält (OCR)
* über einen Bildvergleich mit einer bereitgestellten Vorlagendatei

==Konfiguration für Barcodes==
[[Datei:Barcode mode.png|400px]]
===Barcodetyp===
Hier können Sie im Dropdown definieren nach welchen Barcodetypen gesucht werden soll. Falls alle Barcodes gefunden und überprüft werden soll, wählen Sie "Alle finden".
===Barcodewert===
Definieren Sie einen Wert, welcher der Barcode beinhalten muss, damit diese Seite als Trennblatt zählt. Es ist möglich statische Werte sowie einen '''Regex''' zu definieren. Sie können zusätzlich den Platzhalter "[DOSEQ]" (ohne Anführungszeichen) verwenden. Mit dieser Konfiguration wird ein bereits bestehendes DO mit der entsprechenden Nummer gesucht. Die Seite wird nur zum Trennblatt wenn ein bestehendes Objekt gefunden wurde. Falls Sie das Kind nach dieser Sequenznummer zuordnen müssen, lesen Sie den Abschnitt "Signatur der Kinder".

Beispiele für Regex:
* Alle Zahlen: [0-9]*

==Konfiguration für OCR==
[[Datei:ocr mode.png|400px]] 
Beachten Sie, dass dieser Schritt nur Funktioniert, wenn die Objekte vorher durch den [https://www.helper.ch/wiki/index.php?title=OCR_Texterkennung OCR-Serverjob] gelaufen sind!
===OCR-Trenntext===
Mithilfe des OCR-Trenntextes können Sie definieren was für ein Text auf einer Seite stehen muss, damit die Seite als Trennblatt gewertet wird. Es ist möglich statische Begriffe sowie Regex zu definieren. Beachten Sie, dass sich der gesamte Ausdruck auf '''einer Zeile''' befinden muss!
====Beispiele====
OCR-Trenntext: Auszug aus dem Protokoll ==> Es wird auf jeder Seite nach "Auszug aus dem Protokoll" gesucht 
OCR-Trenntext: [0-9][0-9][0-9] ==> Es wird auf jeder Seite nach 3 stelligen Zahlen gesucht (123, 822, 111) 
OCR-Trenntext: aus .{5} ==> Es wird auf jeder Seite nach "aus <Wort mit 5 Zeichen egal welche>" gesucht ("aus Berlin" nicht aber "aus Bern")

==Konfiguration für Trennblattvorlage==

'''Merke:''' Es werden nur Bilddateien unterstützt.

Im HZ-Ordner muss sich eine Datei befinden, die als Vorlage für die Trennblatterkennung verwendet wird.
Diese Vorlage ist in einem Unterordner mit dem Namen „Trennblatt“ abzulegen.

Der Ordner kann über die Konfiguration mit der Taste „Vorlagenordner öffnen…“ direkt geöffnet werden.
Existiert der Ordner noch nicht, wird er automatisch erstellt. Voraussetzung dafür ist, dass in der Konfiguration des Arbeitsschrittes bereits ein HZ-Ordner definiert ist.

Über die Einstellung „Grenzwert“ kann die Erkennungsschwelle mit einem Wert zwischen 0.00 und 100.00 festgelegt werden.
Zur Ermittlung eines geeigneten Grenzwerts lassen sich einzelne Dateien über die Taste „Teste Datei!“ prüfen.
Der Vergleichs-Score wird anschließend in einer Meldung ausgegeben. Bei eindeutigen Vorlagen ist typischerweise ein Wert um 75 ausreichend.

[[Datei:Bildschirmfoto 2026-01-23 um 17.32.41.png|Konfiguration Trennblattvorlage]]

==Allgemeine Konfiguration==
===Modus für erste Datei im Vater===
Hier können Sie definieren ob die erste Datei im Vater ein Trennblatt sein '''muss''' oder ob alle Dateien bis zum ersten Trennblatt '''ignoriert''' werden sollen. Falls die erste Seite ein Trennblatt sein soll sie jedoch keine ist, gibt es ein Fehler. 
[[Datei:father mode.png|300px]]

===Modus für Trennblätter===
Hier können Sie definieren, was mit dem Trennblatt geschehen soll: Soll die Datei mit ins Kind kopiert werden, oder nicht? 
[[Datei:trennblatt mode.png|300px]]

====Anzahl Files zu löschen nach dem Trennblatt====
Steht diese Zahl auf 0 werden alle Seiten, nach dem Trennblatt bis zum nächsten, ins Kind kopiert. Schreiben Sie zB. 2 hinein werden alle Seiten, '''bis auf die ersten 2''', nach dem Trennblatt ins Kind kopiert. 
Diese Zahl kann auch negativ sein; In diesem Falle werden X Blätter '''vor''' dem nächsten Trennblatt gelöscht.

===Modus für Kinder===
[[Datei:child mode.png|500px]]
====Nichts tun====
Nichts tun ist aktuell keine Option! Es gibt einen Fehler und der aktuelle Arbeitsschritt wird gestoppt.
====Kinder erstellen====
Wählen Sie die Option "Kinder erstellen", wird für jedes Trennblatt ein neues Kind erstellt.

====Daten bestehendem Kind zuordnen====
Wählen Sie diese Option, falls ein bestimmtes Objekt gesucht werden soll, welches die getrennten Daten erhält. Gesucht wird nach dem Typ des Objektes sowie der definierten Signatur. Wird kein passendes Objekt gefunden, gibt es einen Fehler. Das gefundene Objekt wird danach automatisch zum Kind vom Haupt-Objekt.
=====Typ der Kinder=====
* Welchen Typ sollen die neu erstellten Kinder erhalten?
* Von welchem Typ sollen die gesuchten Kinder sein?
=====Signatur der Kinder=====
Hier definieren Sie eine Omnisformel, welche beim erstellen evaluiert wird und die Signatur des neuen Kindes definiert. Oder aber es definiert die Signatur des zu findenden Objektes (Je nach der Konfiguration "Modus für Kinder") 

'''Für alle "Kinder-Modus" brauchbar:'''
* Eine Liste der Omnisfunktionen finden Sie hier: [https://helper.ch/wiki/index.php?title=Omnisgrundlagen] 
* Es ist möglich Attribute des Vaters zu evaluieren ("[Attributname]")
* Es ist möglich der Ahnen des Vaters zu evaluieren ("[^Attributname]" für jede Generation nach oben ein "^" mehr)
* Es ist möglich via OCR nach Text auf der Seite zu suchen und diesen zu evaluieren ("[OCR-Treffer='<Wort>'+/-<Treffer Offset>]")
* Es ist möglich den Platzhalter [DOSigantur] zu verwenden (Signatur des aktuellen DO / Vater der Kinder)
* Es ist möglich den Platzhalter [BarcodeValue] zu verwenden (Den Wert des Barcodes) 
'''Für den Kind-Modus "Kinder erstellen" brauchbar:'''
* Es ist möglich den Platzhalter [DOKindNr] zu verwenden (Laufnummer des Kindes -> Das wievielte Kind bin ich?) 
'''Für den Kind-Modus "Daten bestehendem Objekt zuordnen" brauchbar:'''
* Es ist möglich den Platzhalter [DOSEQ=BarcodeValue] '''ALLEINE''' zu verwenden (Sucht das Kind basierend auf der DOSEQ im BarcodeValue und '''nicht''' nach der Signatur!)
 
'''Beispiele:''' 
* con('Buch_',[Jahr]) ==> Attribut "Jahr" des aktuellen DO wird eigesetzt ==> Mögliche Resultate: Buch_1999 / Buch_2018
* con('Ordner_',[^Farbe])" ==> Attribut "Farbe" des Vaters des aktuellen DO wird eingesetzt ==> Mögliche Resultate: Ordner_grün, Ordner_Blau
* con('Kalender_',[^^Grösse],'_gebunden')" ==> Attribut "Grösse" des Grossvaters des aktuellen DO wird eingesetzt ==> Mögliche Resultate: Kalender_200cm_gebunden
* con('Buch_',[OCR-Treffer="Nr."+1]) ==> Es wird auf der Seite nach dem ersten Vorkommen von "Nr." gesucht und das '''Folgewort''' eingesetzt
* con('Buch_',[OCR-Treffer="Personen"+3]) ==> Es wird auf der Seite nach dem ersten Vorkommen von "Personen" gesucht und das '''3. Wort nach Personen''' eingesetzt
* con('Buch_',[OCR-Treffer="[0-9][0-9]"-2]) ==> Es wird auf der Seite nach der ersten 2 stelligen Zahl (21, 00, 11) gesucht und das '''2. Wort vor dieser Zahl''' eingesetzt

====Objekte müssen bereits Kinder sein====
Hier können Sie definieren ob irgend ein Objekt mit der gewünschten Signatur gesucht werden soll, oder ob dieses '''bereits''' ein Kind des Hauptobjektes sein '''muss'''. 
Nein = Irgend ein Objekt wird gesucht mit der gewünschten Signatur
Ja = Es werden nur bestehende Kinder mit der gewünschten Signatur gesucht

====Dateinamen der Kinder für die Belegzuordnung vorbereiten====

Dieses Option ist Pflicht für eine anschliessende Belegzuordnung.
Falls einer der nächsten Arbeitsschritte eine Belegzuordnung sein wird, dann müssen die Dateinamen der bereits zugeordneten Dateien entsprechend der Namenskonvention des Belegzuordungsfenster geändert werden.
Ansonst wird das Belegzordnungsfenster nicht mit den Dateinamen umgehen können und daher nicht verwendbar sein.

==Fehler handling==
Grundsätzlich stoppt der Job falls ein unerwarteter Umstand auftritt (Fehler beim aktualisieren von Daten, falsche Konfiguration). Ist der Kind-Modus "Daten bestehendem Objekt zuordnen" ausgewählt und es gibt Trennblätter wofür kein passendes Objekt gefunden wurde, arbeitet der Job einfach weiter.

===Produktionsauftrag 20P0010===
Bei diesem Auftrag werden "]" welche aus dem OCR gelesen wurden durch "1" ersetzt. Diese Anpassung ist nötig, da das GDPicture OCR die Schreibmaschinen Eins als eckige Klammer interpretiert.

==Essentielle Felder==
HZ_BARCODETYP ''Welcher Barcodetyp soll geprüft werden?''

HZ_BARCODEWERT ''Nach welchem Wert soll im Barcode gesucht werden, damit die Seite ein Trennblatt wird?''

HZ_BARCODEFILEWEG ''Wieviele Files nach dem Barcodeblatt sollen gelöscht werden?''

HZ_BARCODE1WEG ''0 = Trennblatt wird nicht ins Kind kopiert 1 = Trennblatt wird ins Kind kopiert''

HZ_FORMEL ''Eine Omnisformel welche evaluiert wird und danach als Signatur für neue Kinder verwendet wird, oder aber mit der bestehende Kinder gesucht werden''

HZ_HASHTYP ''0 = Es wird nach Barcodes gesucht 1 = Es wird nach OCR-Text gesucht''

HZ_DATENVORHERLOSCHEN ''0 = Erste Seite muss ein Trennblatt sein 1 = Alle Seiten bis zum ersten Trennblatt werden ignoriert''

HZ_FILEVERHALTEN ''Modus für Kinder: 0 = Nichts tun 1 = Kinder erstellen 2 = Daten bestehendem Kind zuordnen''

HZ_DY_SEQ1 ''Sequenznummer des Objekttypes welche die Kinder haben sollen''

HZ_KINDERVERDOPPELN ''0 = Objekt muss kein Kind vom Haupt DO sein 1 = Objekt muss bereits ein Kind des Haupt DO sein

HZ_EXPORTFILETYP ''0 = Die Dateinamen bleiben bestehen 1 = Die Dateinamen der den Kindesobjekte zugeordneten Dateien werden für die benötigte Nameskonvention bereits zugeordneter Belege im Belegzuordnungsfenster angepasst.

HZ_WORDERSETZEN ''Regex nach dem getrennt werden soll im Fall 'Trennen nach OCR-Text' ''

HZ_WARTEDAUER zukünftig ''Grenzwert für Suche nach OCR-Score''

;Erlaubte Werte:
Es soll ein regulärer Ausdruck angegeben werden, um nur die erlaubten Worte zuzulassen.

In Wikipedia befindet sich eine genaue Erklärung dazu: https://de.wikipedia.org/wiki/Regulärer_Ausdruck#Reguläre_Ausdrücke_in_der_Praxis

;Beispiel:

Das Format der Barcodewerte wäre zum Beispiel: AB1234
Dann wird Folgendes für den Barcodewert angegeben: [A-Z][A-Z][0-9][0-9][0-9][0-9]
Wenn der Anfang der Barcodes immer fix AB wäre, dann kann man stattdessen Folgendes angeben: [A][B][0-9][0-9][0-9][0-9]

Damit ist es fix, dass nur AB am Anfang zugelassen wird. Sonst wäre alles zwischen A-Z erlaubt.

Auf https://guides.gdpicture.com/content/GdPicture.NET.14~GdPicture14.Barcode1DReaderType.html stehen die Barcodetypen von GdPicture und deren Werte.

==Pane im Produktionsauftrag==

[[File:barcode.png|400px]][[File:barcodeOCR.png|400px]]

[[Kategorie:Workflowschritt]]

Datei:Barcode mode.png

2026-01-23T16:35:37Z

Stefan: Stefan lud eine neue Version von Datei:Barcode mode.png hoch

Datei:Ocr mode.png

2026-01-23T16:35:23Z

Stefan: Stefan lud eine neue Version von Datei:Ocr mode.png hoch

Barcodetrenner - Auftrennung von Objekten nach Barcodeblättern / OCR-Text

2026-01-23T16:35:07Z

Stefan: /* Konfiguration Trennblattvorlage */

;Mantiseinträge:
1973, 2980, 3582
;Systemtyp:
29

==Beschreibung==
Besteht aus einem Serverjob OJOHZDOBarcodeTrenner. Durchsucht den Ordner eines Objektes nach Trennblätter und erstellt für jedes Trennblatt ein Kind-Objekt und fügt die Bilder bis zum nächsten Trennblatt diesem Kind hinzu. Ein Trennblatt kann ein Barcode mit einem bestimmten Wert sein oder eine Seite welche einen bestimmten Text beinhaltet oder eine beliebige Seite mit Textinhalt, welche als Vorlagendatei zur verfügung gestellt wird.

==Konfiguration für Barcodes==
[[Datei:Barcode mode.png|400px]]
===Barcodetyp===
Hier können Sie im Dropdown definieren nach welchen Barcodetypen gesucht werden soll. Falls alle Barcodes gefunden und überprüft werden soll, wählen Sie "Alle finden".
===Barcodewert===
Definieren Sie einen Wert, welcher der Barcode beinhalten muss, damit diese Seite als Trennblatt zählt. Es ist möglich statische Werte sowie einen '''Regex''' zu definieren. Sie können zusätzlich den Platzhalter "[DOSEQ]" (ohne Anführungszeichen) verwenden. Mit dieser Konfiguration wird ein bereits bestehendes DO mit der entsprechenden Nummer gesucht. Die Seite wird nur zum Trennblatt wenn ein bestehendes Objekt gefunden wurde. Falls Sie das Kind nach dieser Sequenznummer zuordnen müssen, lesen Sie den Abschnitt "Signatur der Kinder".

Beispiele für Regex:
* Alle Zahlen: [0-9]*

==Konfiguration für OCR==
[[Datei:ocr mode.png|400px]] 
Beachten Sie, dass dieser Schritt nur Funktioniert, wenn die Objekte vorher durch den [https://www.helper.ch/wiki/index.php?title=OCR_Texterkennung OCR-Serverjob] gelaufen sind!
===OCR-Trenntext===
Mithilfe des OCR-Trenntextes können Sie definieren was für ein Text auf einer Seite stehen muss, damit die Seite als Trennblatt gewertet wird. Es ist möglich statische Begriffe sowie Regex zu definieren. Beachten Sie, dass sich der gesamte Ausdruck auf '''einer Zeile''' befinden muss!
====Beispiele====
OCR-Trenntext: Auszug aus dem Protokoll ==> Es wird auf jeder Seite nach "Auszug aus dem Protokoll" gesucht 
OCR-Trenntext: [0-9][0-9][0-9] ==> Es wird auf jeder Seite nach 3 stelligen Zahlen gesucht (123, 822, 111) 
OCR-Trenntext: aus .{5} ==> Es wird auf jeder Seite nach "aus <Wort mit 5 Zeichen egal welche>" gesucht ("aus Berlin" nicht aber "aus Bern")

==Konfiguration für Trennblattvorlage==

'''Merke:''' Es werden nur Bilddateien unterstützt.

Im HZ-Ordner muss sich eine Datei befinden, die als Vorlage für die Trennblatterkennung verwendet wird.
Diese Vorlage ist in einem Unterordner mit dem Namen „Trennblatt“ abzulegen.

Der Ordner kann über die Konfiguration mit der Taste „Vorlagenordner öffnen…“ direkt geöffnet werden.
Existiert der Ordner noch nicht, wird er automatisch erstellt. Voraussetzung dafür ist, dass in der Konfiguration des Arbeitsschrittes bereits ein HZ-Ordner definiert ist.

Über die Einstellung „Grenzwert“ kann die Erkennungsschwelle mit einem Wert zwischen 0.00 und 100.00 festgelegt werden.
Zur Ermittlung eines geeigneten Grenzwerts lassen sich einzelne Dateien über die Taste „Teste Datei!“ prüfen.
Der Vergleichs-Score wird anschließend in einer Meldung ausgegeben. Bei eindeutigen Vorlagen ist typischerweise ein Wert um 75 ausreichend.

[[Datei:Bildschirmfoto 2026-01-23 um 17.32.41.png|Konfiguration Trennblattvorlage]]

==Allgemeine Konfiguration==
===Modus für erste Datei im Vater===
Hier können Sie definieren ob die erste Datei im Vater ein Trennblatt sein '''muss''' oder ob alle Dateien bis zum ersten Trennblatt '''ignoriert''' werden sollen. Falls die erste Seite ein Trennblatt sein soll sie jedoch keine ist, gibt es ein Fehler. 
[[Datei:father mode.png|300px]]

===Modus für Trennblätter===
Hier können Sie definieren, was mit dem Trennblatt geschehen soll: Soll die Datei mit ins Kind kopiert werden, oder nicht? 
[[Datei:trennblatt mode.png|300px]]

====Anzahl Files zu löschen nach dem Trennblatt====
Steht diese Zahl auf 0 werden alle Seiten, nach dem Trennblatt bis zum nächsten, ins Kind kopiert. Schreiben Sie zB. 2 hinein werden alle Seiten, '''bis auf die ersten 2''', nach dem Trennblatt ins Kind kopiert. 
Diese Zahl kann auch negativ sein; In diesem Falle werden X Blätter '''vor''' dem nächsten Trennblatt gelöscht.

===Modus für Kinder===
[[Datei:child mode.png|500px]]
====Nichts tun====
Nichts tun ist aktuell keine Option! Es gibt einen Fehler und der aktuelle Arbeitsschritt wird gestoppt.
====Kinder erstellen====
Wählen Sie die Option "Kinder erstellen", wird für jedes Trennblatt ein neues Kind erstellt.

====Daten bestehendem Kind zuordnen====
Wählen Sie diese Option, falls ein bestimmtes Objekt gesucht werden soll, welches die getrennten Daten erhält. Gesucht wird nach dem Typ des Objektes sowie der definierten Signatur. Wird kein passendes Objekt gefunden, gibt es einen Fehler. Das gefundene Objekt wird danach automatisch zum Kind vom Haupt-Objekt.
=====Typ der Kinder=====
* Welchen Typ sollen die neu erstellten Kinder erhalten?
* Von welchem Typ sollen die gesuchten Kinder sein?
=====Signatur der Kinder=====
Hier definieren Sie eine Omnisformel, welche beim erstellen evaluiert wird und die Signatur des neuen Kindes definiert. Oder aber es definiert die Signatur des zu findenden Objektes (Je nach der Konfiguration "Modus für Kinder") 

'''Für alle "Kinder-Modus" brauchbar:'''
* Eine Liste der Omnisfunktionen finden Sie hier: [https://helper.ch/wiki/index.php?title=Omnisgrundlagen] 
* Es ist möglich Attribute des Vaters zu evaluieren ("[Attributname]")
* Es ist möglich der Ahnen des Vaters zu evaluieren ("[^Attributname]" für jede Generation nach oben ein "^" mehr)
* Es ist möglich via OCR nach Text auf der Seite zu suchen und diesen zu evaluieren ("[OCR-Treffer='<Wort>'+/-<Treffer Offset>]")
* Es ist möglich den Platzhalter [DOSigantur] zu verwenden (Signatur des aktuellen DO / Vater der Kinder)
* Es ist möglich den Platzhalter [BarcodeValue] zu verwenden (Den Wert des Barcodes) 
'''Für den Kind-Modus "Kinder erstellen" brauchbar:'''
* Es ist möglich den Platzhalter [DOKindNr] zu verwenden (Laufnummer des Kindes -> Das wievielte Kind bin ich?) 
'''Für den Kind-Modus "Daten bestehendem Objekt zuordnen" brauchbar:'''
* Es ist möglich den Platzhalter [DOSEQ=BarcodeValue] '''ALLEINE''' zu verwenden (Sucht das Kind basierend auf der DOSEQ im BarcodeValue und '''nicht''' nach der Signatur!)
 
'''Beispiele:''' 
* con('Buch_',[Jahr]) ==> Attribut "Jahr" des aktuellen DO wird eigesetzt ==> Mögliche Resultate: Buch_1999 / Buch_2018
* con('Ordner_',[^Farbe])" ==> Attribut "Farbe" des Vaters des aktuellen DO wird eingesetzt ==> Mögliche Resultate: Ordner_grün, Ordner_Blau
* con('Kalender_',[^^Grösse],'_gebunden')" ==> Attribut "Grösse" des Grossvaters des aktuellen DO wird eingesetzt ==> Mögliche Resultate: Kalender_200cm_gebunden
* con('Buch_',[OCR-Treffer="Nr."+1]) ==> Es wird auf der Seite nach dem ersten Vorkommen von "Nr." gesucht und das '''Folgewort''' eingesetzt
* con('Buch_',[OCR-Treffer="Personen"+3]) ==> Es wird auf der Seite nach dem ersten Vorkommen von "Personen" gesucht und das '''3. Wort nach Personen''' eingesetzt
* con('Buch_',[OCR-Treffer="[0-9][0-9]"-2]) ==> Es wird auf der Seite nach der ersten 2 stelligen Zahl (21, 00, 11) gesucht und das '''2. Wort vor dieser Zahl''' eingesetzt

====Objekte müssen bereits Kinder sein====
Hier können Sie definieren ob irgend ein Objekt mit der gewünschten Signatur gesucht werden soll, oder ob dieses '''bereits''' ein Kind des Hauptobjektes sein '''muss'''. 
Nein = Irgend ein Objekt wird gesucht mit der gewünschten Signatur
Ja = Es werden nur bestehende Kinder mit der gewünschten Signatur gesucht

====Dateinamen der Kinder für die Belegzuordnung vorbereiten====

Dieses Option ist Pflicht für eine anschliessende Belegzuordnung.
Falls einer der nächsten Arbeitsschritte eine Belegzuordnung sein wird, dann müssen die Dateinamen der bereits zugeordneten Dateien entsprechend der Namenskonvention des Belegzuordungsfenster geändert werden.
Ansonst wird das Belegzordnungsfenster nicht mit den Dateinamen umgehen können und daher nicht verwendbar sein.

==Fehler handling==
Grundsätzlich stoppt der Job falls ein unerwarteter Umstand auftritt (Fehler beim aktualisieren von Daten, falsche Konfiguration). Ist der Kind-Modus "Daten bestehendem Objekt zuordnen" ausgewählt und es gibt Trennblätter wofür kein passendes Objekt gefunden wurde, arbeitet der Job einfach weiter.

===Produktionsauftrag 20P0010===
Bei diesem Auftrag werden "]" welche aus dem OCR gelesen wurden durch "1" ersetzt. Diese Anpassung ist nötig, da das GDPicture OCR die Schreibmaschinen Eins als eckige Klammer interpretiert.

==Essentielle Felder==
HZ_BARCODETYP ''Welcher Barcodetyp soll geprüft werden?''

HZ_BARCODEWERT ''Nach welchem Wert soll im Barcode gesucht werden, damit die Seite ein Trennblatt wird?''

HZ_BARCODEFILEWEG ''Wieviele Files nach dem Barcodeblatt sollen gelöscht werden?''

HZ_BARCODE1WEG ''0 = Trennblatt wird nicht ins Kind kopiert 1 = Trennblatt wird ins Kind kopiert''

HZ_FORMEL ''Eine Omnisformel welche evaluiert wird und danach als Signatur für neue Kinder verwendet wird, oder aber mit der bestehende Kinder gesucht werden''

HZ_HASHTYP ''0 = Es wird nach Barcodes gesucht 1 = Es wird nach OCR-Text gesucht''

HZ_DATENVORHERLOSCHEN ''0 = Erste Seite muss ein Trennblatt sein 1 = Alle Seiten bis zum ersten Trennblatt werden ignoriert''

HZ_FILEVERHALTEN ''Modus für Kinder: 0 = Nichts tun 1 = Kinder erstellen 2 = Daten bestehendem Kind zuordnen''

HZ_DY_SEQ1 ''Sequenznummer des Objekttypes welche die Kinder haben sollen''

HZ_KINDERVERDOPPELN ''0 = Objekt muss kein Kind vom Haupt DO sein 1 = Objekt muss bereits ein Kind des Haupt DO sein

HZ_EXPORTFILETYP ''0 = Die Dateinamen bleiben bestehen 1 = Die Dateinamen der den Kindesobjekte zugeordneten Dateien werden für die benötigte Nameskonvention bereits zugeordneter Belege im Belegzuordnungsfenster angepasst.

HZ_WORDERSETZEN ''Regex nach dem getrennt werden soll im Fall 'Trennen nach OCR-Text' ''

HZ_WARTEDAUER zukünftig ''Grenzwert für Suche nach OCR-Score''

;Erlaubte Werte:
Es soll ein regulärer Ausdruck angegeben werden, um nur die erlaubten Worte zuzulassen.

In Wikipedia befindet sich eine genaue Erklärung dazu: https://de.wikipedia.org/wiki/Regulärer_Ausdruck#Reguläre_Ausdrücke_in_der_Praxis

;Beispiel:

Das Format der Barcodewerte wäre zum Beispiel: AB1234
Dann wird Folgendes für den Barcodewert angegeben: [A-Z][A-Z][0-9][0-9][0-9][0-9]
Wenn der Anfang der Barcodes immer fix AB wäre, dann kann man stattdessen Folgendes angeben: [A][B][0-9][0-9][0-9][0-9]

Damit ist es fix, dass nur AB am Anfang zugelassen wird. Sonst wäre alles zwischen A-Z erlaubt.

Auf https://guides.gdpicture.com/content/GdPicture.NET.14~GdPicture14.Barcode1DReaderType.html stehen die Barcodetypen von GdPicture und deren Werte.

==Pane im Produktionsauftrag==

[[File:barcode.png|400px]][[File:barcodeOCR.png|400px]]

[[Kategorie:Workflowschritt]]

Datei:Bildschirmfoto 2026-01-23 um 17.32.41.png

2026-01-23T16:34:35Z

Stefan:

...

Barcodetrenner - Auftrennung von Objekten nach Barcodeblättern / OCR-Text

2026-01-23T15:34:18Z

Stefan: 3582 Neue Eigenschaft beschreiben

;Mantiseinträge:
1973, 2980, 3582
;Systemtyp:
29

==Beschreibung==
Besteht aus einem Serverjob OJOHZDOBarcodeTrenner. Durchsucht den Ordner eines Objektes nach Trennblätter und erstellt für jedes Trennblatt ein Kind-Objekt und fügt die Bilder bis zum nächsten Trennblatt diesem Kind hinzu. Ein Trennblatt kann ein Barcode mit einem bestimmten Wert sein oder eine Seite welche einen bestimmten Text beinhaltet oder eine beliebige Seite mit Textinhalt, welche als Vorlagendatei zur verfügung gestellt wird.

==Konfiguration für Barcodes==
[[Datei:Barcode mode.png|400px]]
===Barcodetyp===
Hier können Sie im Dropdown definieren nach welchen Barcodetypen gesucht werden soll. Falls alle Barcodes gefunden und überprüft werden soll, wählen Sie "Alle finden".
===Barcodewert===
Definieren Sie einen Wert, welcher der Barcode beinhalten muss, damit diese Seite als Trennblatt zählt. Es ist möglich statische Werte sowie einen '''Regex''' zu definieren. Sie können zusätzlich den Platzhalter "[DOSEQ]" (ohne Anführungszeichen) verwenden. Mit dieser Konfiguration wird ein bereits bestehendes DO mit der entsprechenden Nummer gesucht. Die Seite wird nur zum Trennblatt wenn ein bestehendes Objekt gefunden wurde. Falls Sie das Kind nach dieser Sequenznummer zuordnen müssen, lesen Sie den Abschnitt "Signatur der Kinder".

Beispiele für Regex:
* Alle Zahlen: [0-9]*

==Konfiguration für OCR==
[[Datei:ocr mode.png|400px]] 
Beachten Sie, dass dieser Schritt nur Funktioniert, wenn die Objekte vorher durch den [https://www.helper.ch/wiki/index.php?title=OCR_Texterkennung OCR-Serverjob] gelaufen sind!
===OCR-Trenntext===
Mithilfe des OCR-Trenntextes können Sie definieren was für ein Text auf einer Seite stehen muss, damit die Seite als Trennblatt gewertet wird. Es ist möglich statische Begriffe sowie Regex zu definieren. Beachten Sie, dass sich der gesamte Ausdruck auf '''einer Zeile''' befinden muss!
====Beispiele====
OCR-Trenntext: Auszug aus dem Protokoll ==> Es wird auf jeder Seite nach "Auszug aus dem Protokoll" gesucht 
OCR-Trenntext: [0-9][0-9][0-9] ==> Es wird auf jeder Seite nach 3 stelligen Zahlen gesucht (123, 822, 111) 
OCR-Trenntext: aus .{5} ==> Es wird auf jeder Seite nach "aus <Wort mit 5 Zeichen egal welche>" gesucht ("aus Berlin" nicht aber "aus Bern")

==Konfiguration Trennblattvorlage==

Es werden nur Bilddateien unterstützt. Im HZ Ordner muss eine Datei, welche als Vorlage zur Trennblatterkennung verwendet wird, in einem Ordner mit dem Namen "Trennblatt" abgelegt worden sein.
Der Ordner lässt sich aus der Konfiguration über eine Taste öffnen, bzw. er wird erstellt falls er noch nicht existiert. Dazu muss zwingen bereits ein HZ Ordner in der Konfiguration des Arbeitsschrittes eingerichtet worden sein.
Über die "Grenzwert" Einstellung lässt sich die Schwelle für die Erkennung einrichten. Um die Schwelle zu ermitteln, lassen sich einzelne Dateien hier testen. Der Score für den Vergleich wird dabei ausgegeben.

==Allgemeine Konfiguration==
===Modus für erste Datei im Vater===
Hier können Sie definieren ob die erste Datei im Vater ein Trennblatt sein '''muss''' oder ob alle Dateien bis zum ersten Trennblatt '''ignoriert''' werden sollen. Falls die erste Seite ein Trennblatt sein soll sie jedoch keine ist, gibt es ein Fehler. 
[[Datei:father mode.png|300px]]

===Modus für Trennblätter===
Hier können Sie definieren, was mit dem Trennblatt geschehen soll: Soll die Datei mit ins Kind kopiert werden, oder nicht? 
[[Datei:trennblatt mode.png|300px]]

====Anzahl Files zu löschen nach dem Trennblatt====
Steht diese Zahl auf 0 werden alle Seiten, nach dem Trennblatt bis zum nächsten, ins Kind kopiert. Schreiben Sie zB. 2 hinein werden alle Seiten, '''bis auf die ersten 2''', nach dem Trennblatt ins Kind kopiert. 
Diese Zahl kann auch negativ sein; In diesem Falle werden X Blätter '''vor''' dem nächsten Trennblatt gelöscht.

===Modus für Kinder===
[[Datei:child mode.png|500px]]
====Nichts tun====
Nichts tun ist aktuell keine Option! Es gibt einen Fehler und der aktuelle Arbeitsschritt wird gestoppt.
====Kinder erstellen====
Wählen Sie die Option "Kinder erstellen", wird für jedes Trennblatt ein neues Kind erstellt.

====Daten bestehendem Kind zuordnen====
Wählen Sie diese Option, falls ein bestimmtes Objekt gesucht werden soll, welches die getrennten Daten erhält. Gesucht wird nach dem Typ des Objektes sowie der definierten Signatur. Wird kein passendes Objekt gefunden, gibt es einen Fehler. Das gefundene Objekt wird danach automatisch zum Kind vom Haupt-Objekt.
=====Typ der Kinder=====
* Welchen Typ sollen die neu erstellten Kinder erhalten?
* Von welchem Typ sollen die gesuchten Kinder sein?
=====Signatur der Kinder=====
Hier definieren Sie eine Omnisformel, welche beim erstellen evaluiert wird und die Signatur des neuen Kindes definiert. Oder aber es definiert die Signatur des zu findenden Objektes (Je nach der Konfiguration "Modus für Kinder") 

'''Für alle "Kinder-Modus" brauchbar:'''
* Eine Liste der Omnisfunktionen finden Sie hier: [https://helper.ch/wiki/index.php?title=Omnisgrundlagen] 
* Es ist möglich Attribute des Vaters zu evaluieren ("[Attributname]")
* Es ist möglich der Ahnen des Vaters zu evaluieren ("[^Attributname]" für jede Generation nach oben ein "^" mehr)
* Es ist möglich via OCR nach Text auf der Seite zu suchen und diesen zu evaluieren ("[OCR-Treffer='<Wort>'+/-<Treffer Offset>]")
* Es ist möglich den Platzhalter [DOSigantur] zu verwenden (Signatur des aktuellen DO / Vater der Kinder)
* Es ist möglich den Platzhalter [BarcodeValue] zu verwenden (Den Wert des Barcodes) 
'''Für den Kind-Modus "Kinder erstellen" brauchbar:'''
* Es ist möglich den Platzhalter [DOKindNr] zu verwenden (Laufnummer des Kindes -> Das wievielte Kind bin ich?) 
'''Für den Kind-Modus "Daten bestehendem Objekt zuordnen" brauchbar:'''
* Es ist möglich den Platzhalter [DOSEQ=BarcodeValue] '''ALLEINE''' zu verwenden (Sucht das Kind basierend auf der DOSEQ im BarcodeValue und '''nicht''' nach der Signatur!)
 
'''Beispiele:''' 
* con('Buch_',[Jahr]) ==> Attribut "Jahr" des aktuellen DO wird eigesetzt ==> Mögliche Resultate: Buch_1999 / Buch_2018
* con('Ordner_',[^Farbe])" ==> Attribut "Farbe" des Vaters des aktuellen DO wird eingesetzt ==> Mögliche Resultate: Ordner_grün, Ordner_Blau
* con('Kalender_',[^^Grösse],'_gebunden')" ==> Attribut "Grösse" des Grossvaters des aktuellen DO wird eingesetzt ==> Mögliche Resultate: Kalender_200cm_gebunden
* con('Buch_',[OCR-Treffer="Nr."+1]) ==> Es wird auf der Seite nach dem ersten Vorkommen von "Nr." gesucht und das '''Folgewort''' eingesetzt
* con('Buch_',[OCR-Treffer="Personen"+3]) ==> Es wird auf der Seite nach dem ersten Vorkommen von "Personen" gesucht und das '''3. Wort nach Personen''' eingesetzt
* con('Buch_',[OCR-Treffer="[0-9][0-9]"-2]) ==> Es wird auf der Seite nach der ersten 2 stelligen Zahl (21, 00, 11) gesucht und das '''2. Wort vor dieser Zahl''' eingesetzt

====Objekte müssen bereits Kinder sein====
Hier können Sie definieren ob irgend ein Objekt mit der gewünschten Signatur gesucht werden soll, oder ob dieses '''bereits''' ein Kind des Hauptobjektes sein '''muss'''. 
Nein = Irgend ein Objekt wird gesucht mit der gewünschten Signatur
Ja = Es werden nur bestehende Kinder mit der gewünschten Signatur gesucht

====Dateinamen der Kinder für die Belegzuordnung vorbereiten====

Dieses Option ist Pflicht für eine anschliessende Belegzuordnung.
Falls einer der nächsten Arbeitsschritte eine Belegzuordnung sein wird, dann müssen die Dateinamen der bereits zugeordneten Dateien entsprechend der Namenskonvention des Belegzuordungsfenster geändert werden.
Ansonst wird das Belegzordnungsfenster nicht mit den Dateinamen umgehen können und daher nicht verwendbar sein.

==Fehler handling==
Grundsätzlich stoppt der Job falls ein unerwarteter Umstand auftritt (Fehler beim aktualisieren von Daten, falsche Konfiguration). Ist der Kind-Modus "Daten bestehendem Objekt zuordnen" ausgewählt und es gibt Trennblätter wofür kein passendes Objekt gefunden wurde, arbeitet der Job einfach weiter.

===Produktionsauftrag 20P0010===
Bei diesem Auftrag werden "]" welche aus dem OCR gelesen wurden durch "1" ersetzt. Diese Anpassung ist nötig, da das GDPicture OCR die Schreibmaschinen Eins als eckige Klammer interpretiert.

==Essentielle Felder==
HZ_BARCODETYP ''Welcher Barcodetyp soll geprüft werden?''

HZ_BARCODEWERT ''Nach welchem Wert soll im Barcode gesucht werden, damit die Seite ein Trennblatt wird?''

HZ_BARCODEFILEWEG ''Wieviele Files nach dem Barcodeblatt sollen gelöscht werden?''

HZ_BARCODE1WEG ''0 = Trennblatt wird nicht ins Kind kopiert 1 = Trennblatt wird ins Kind kopiert''

HZ_FORMEL ''Eine Omnisformel welche evaluiert wird und danach als Signatur für neue Kinder verwendet wird, oder aber mit der bestehende Kinder gesucht werden''

HZ_HASHTYP ''0 = Es wird nach Barcodes gesucht 1 = Es wird nach OCR-Text gesucht''

HZ_DATENVORHERLOSCHEN ''0 = Erste Seite muss ein Trennblatt sein 1 = Alle Seiten bis zum ersten Trennblatt werden ignoriert''

HZ_FILEVERHALTEN ''Modus für Kinder: 0 = Nichts tun 1 = Kinder erstellen 2 = Daten bestehendem Kind zuordnen''

HZ_DY_SEQ1 ''Sequenznummer des Objekttypes welche die Kinder haben sollen''

HZ_KINDERVERDOPPELN ''0 = Objekt muss kein Kind vom Haupt DO sein 1 = Objekt muss bereits ein Kind des Haupt DO sein

HZ_EXPORTFILETYP ''0 = Die Dateinamen bleiben bestehen 1 = Die Dateinamen der den Kindesobjekte zugeordneten Dateien werden für die benötigte Nameskonvention bereits zugeordneter Belege im Belegzuordnungsfenster angepasst.

HZ_WORDERSETZEN ''Regex nach dem getrennt werden soll im Fall 'Trennen nach OCR-Text' ''

HZ_WARTEDAUER zukünftig ''Grenzwert für Suche nach OCR-Score''

;Erlaubte Werte:
Es soll ein regulärer Ausdruck angegeben werden, um nur die erlaubten Worte zuzulassen.

In Wikipedia befindet sich eine genaue Erklärung dazu: https://de.wikipedia.org/wiki/Regulärer_Ausdruck#Reguläre_Ausdrücke_in_der_Praxis

;Beispiel:

Das Format der Barcodewerte wäre zum Beispiel: AB1234
Dann wird Folgendes für den Barcodewert angegeben: [A-Z][A-Z][0-9][0-9][0-9][0-9]
Wenn der Anfang der Barcodes immer fix AB wäre, dann kann man stattdessen Folgendes angeben: [A][B][0-9][0-9][0-9][0-9]

Damit ist es fix, dass nur AB am Anfang zugelassen wird. Sonst wäre alles zwischen A-Z erlaubt.

Auf https://guides.gdpicture.com/content/GdPicture.NET.14~GdPicture14.Barcode1DReaderType.html stehen die Barcodetypen von GdPicture und deren Werte.

==Pane im Produktionsauftrag==

[[File:barcode.png|400px]][[File:barcodeOCR.png|400px]]

[[Kategorie:Workflowschritt]]

Hotfolder Objektimport

2025-12-19T16:00:49Z

Stefan: /* Fehlerhandling */

;Mantiseinträge:
3575
;Systemtyp:
78

Dies ist ein HZ Job

==Beschreibung==

Importiert Dateien aus einem vorgegebenen Ordner in den Workflow eines Auftrages.

Erstellt für jede gefundene Datei ein DO Objekt und kopiert die Datei in den zugehörigen Unterornder des Arbeitsschrittes.

Schickt das Objekt zum nächsten verbundenen Arbeitsschritt.

Aktuell können nur Dateien importiert werden. Es dürfen sich keine Ordner im Hotfolder befinden.

==Konfiguration==

Typ für neue Dateien: Wählen Sie aus dem Dropdown Menu den gewünschten Objekttyp.

Pfad zum Hotfolder: Geben Sie den Pfad zum Ordner an, welcher als Hotfolder für den Dateiimport dienen soll.

[[Datei:FHZ STyp078.png]]

Der Arbeitsschritt muss einen Unterordner erhalten, damit die Dateien zu dem Schritt importiert werden können.

[[Datei:HZ Typ78.png]]

==Fehlerhandling==

Der Arbeitsschritt wird mit Fehler angehalten wenn

* Der Auftragspfad fehlt
* Der Unterordner für den Arbeitsschritt fehlt
* Der Hotfolder nicht eingerichtet wurde oder wenn nicht auf diesen zugegriffen werden kann
* Sich weitere Ordner im genannten Hotfolder befinden

Für den Fall, dass eine Datei nicht kopiert werden kann, wird ein bereits erstelltes DO Objekt wieder gelöscht.

Hotfolder Objektimport

2025-12-19T15:59:50Z

Stefan: *

;Mantiseinträge:
3575
;Systemtyp:
78

Dies ist ein HZ Job

==Beschreibung==

Importiert Dateien aus einem vorgegebenen Ordner in den Workflow eines Auftrages.

Erstellt für jede gefundene Datei ein DO Objekt und kopiert die Datei in den zugehörigen Unterornder des Arbeitsschrittes.

Schickt das Objekt zum nächsten verbundenen Arbeitsschritt.

Aktuell können nur Dateien importiert werden. Es dürfen sich keine Ordner im Hotfolder befinden.

==Konfiguration==

Typ für neue Dateien: Wählen Sie aus dem Dropdown Menu den gewünschten Objekttyp.

Pfad zum Hotfolder: Geben Sie den Pfad zum Ordner an, welcher als Hotfolder für den Dateiimport dienen soll.

[[Datei:FHZ STyp078.png]]

Der Arbeitsschritt muss einen Unterordner erhalten, damit die Dateien zu dem Schritt importiert werden können.

[[Datei:HZ Typ78.png]]

==Fehlerhandling==

Der Arbeitsschritt wird mit Fehler angehalten wenn:

* Der Auftragspfad fehlt
* Der Unterordner für den Arbeitsschritt fehlt
* Der Hotfolder nicht eingerichtet wurde oder wenn nicht auf diesen zugegriffen werden kann
* Sich weitere Ordner im genannten Hotfolder befinden

Für den Fall dass eine Datei nicht kopiert werden kann, wird das bereits erstellte DO Objekt wieder gelöscht.

Datei:HZ Typ78.png

2025-12-19T15:40:33Z

Stefan:

Konfiguration des Unterordners

Hotfolder Objektimport

2025-12-19T15:38:15Z

Stefan: 3375 - Neuer Systemtyp

Datei:FHZ STyp078.png

2025-12-19T15:36:25Z

Stefan:

Konfigurationsmaske zum Systemtyp 78

Übersicht über alle Workflowschritte

2025-12-18T16:37:25Z

Stefan: 3575 : Neuer Systemtyp 78

Verfügbare Funktionen

2025-10-23T15:18:15Z

Stefan: /* §istMin und §istMax */

Die hier gelisteten Funktionen lassen sich bei allen Workflowschritten anwenden, welche einen Link zu dieser Seite besitzen.

==Funktionen==

'''Beachte:''' Die Metadatumsfelder sind hier unbedingt als String ('Metadatum') zu übergeben und nicht wie andersweitig in eckigen Klammern.

===§getQuittungsFeld===

Holt den Wert aus einem Quittungsfeld. Das Objekt muss dazu eine Quittung besitzen. Es wird immer auf die letzte erstellte Quittung zurückgegriffen. Aktuell werden Quittungsdetail im JSON Format unterstützt.

Die Funktion erwartet einen gültigen Pfad zu einem JSON Member, oder anderst gesagt den Schlüssel zu einem Attribut in dem JSON. (JSON Pfade der Quittung finden: Siehe [[Warten auf Rückmeldung]])

§getQuittungsFeld('pfad.zu.dem.gewünschten.feld')

===§istInWortliste===

Ermittelt ob ein Metadatum in einer Wortliste vorkommt; wobei 1 = kommt vor, 0 = kommt nicht vor.

Die Wortliste ist als [https://helper.ch/wiki/index.php?title=Konfiguration Konfigurationsdatensatz] zu erstellen. Der Name der erstellen Wortliste wird als Parameter zum finden der Liste benötigt.

§istInWortliste(Metadatumsname,Wortlistenname,Suchtyp,Zeilenumbruchtyp)

;Metadatumsname: Wert des Metadatums, zB 'Eugen' oder [Vorname]
;Wortlistenname: Name der Wortliste, also des Konfigurationsdatensatzes.
;Suchtyp: 0=Es wird genau nach dem Wert gesucht (Standard), 1=Findet auch 'Hans', wenn in der Wortliste 'Eugen Hans' oder 'Hans-Peter' steht
;Zeilenumbruchtyp: Welcher Zeilenumbruch wird in der Wortliste verwendet: 0=Zeilenumbruch ist 'CR' (Standard), 1=Zeilenumbruch ist 'CRLF'

Bsp.: Es wurde eine Liste mit Vornamen in der Konfiguration erstellt. Diese Liste lautet auf den Namen "Vornamenkonfiguration". Ein Metadatum "Vorname" wurde erstellt, dort wurden zuvor Vornamen gespeichert.

§istInWortliste('Vorname','Vornamenkonfiguration')

===§getConfidenceOfWordInRegionXML===

Gibt die vom OCR ermittelte Konfidenz zu einem gefundenen Begriff zurück und schreibt den Wert in ein Metadatum. Erlaubt optional die Angabe eines Einschräkungsbereiches, in welchem der gesuchte Begriff vorkommen muss.

Der Bereich ist als Row(left,top,width,height) anzugeben: §getConfidenceOfWordInRegionXML('Suchwort',row(left,top,width,height))

Bsp.:
§getConfidenceOfWordInRegionXML('London',row(57,154,75,25))

0 = Begriff nicht gefunden
0.1 - 100 = Konfidenz des gefundenen Begriffes

===§KinderWertATMin(AttributName) und §KinderWertATMax(AttributName)===

Gibt den kleinsten oder den grössten Wert eines Metadatums mit dem gegebenen Atrributnamen von den direkten Nachfahren des Objektes zurück.

Berücktichtigt den Datentyp für die Sortierung, falls dieser beim Attribut angegeben wurde. Bei Datumstypen ist Min das jüngste und Max das älteste.

Gibt das ermittelte Metadatum zurück.

===§KinderWertATStetig(AttributName,Min,Max)===

Prüft ob ein Nachfahre des Objektes mit dem gegebenen Attributnamen im Bereich Min-Max eine stetige Zahlenfolge besitzt.

Eignet sich z.B. um zu ermitteln, ob die Seitenzahlen der Kindobjekte im Metadatum mit dem Attributsnamen "Seitenzahl" zwischen den Werten 1-20 alle vorhanden sind.

Gibt wahr oder falsch zurück.

===§istMin und §istMax===

Vergleicht von DO Objekten die Attributswerte des angegebenen Attributs miteinander, und ermittelt ob das DO den grössten oder den kleinsten Wert der verglichenen Objekte besitzt. Alle DO Typen, welchen den gleichen Attributsnamen besitzen, werden für den Vergleich herbeigezogen. 
Die Hierarchiestufe der Objekte kann, ausgehend vom Objekt eingeschränkt werden. 

Pflicht: Metadatumsname, Hierarchieebene 
Optional: Metadatumsname2 (Ohne Metadatumsname2 werden allein die gefundenen Metadaten aus Metadatumsname verglichen, mit werden nur diejenigen Objekte welche den gleichen Wert in Metadatumsname2 haben verglichen). 

§istMax(Metadatumsname,Hierachieebene,Metadatumsname2)
§istMax(Metadatumsname,../-2/-1/0/1/2/..,Metadatumsname2)
§istMin(Metadatumsname,../-2/-1/0/1/2/..,Metadatumsname2)

Bsp.:
'''§istMax('AnzahlDok',1,'Büronummer')''' Gibt 1 zurück, wenn das Objekt den grössten Wert im Attribut 'AnzahlDok' hat, innerhalb der eigenen Tranche und der gleichen Büronummer.

'''Parameter'''

Metadatumsname: Der Name des Metadatums

Hierachieebene: (Einschränkung)
* 0 = Alle DO des Auftrages (=keine Einschränkung)
* 1 = Alle DO mit dem selben Vorfahren auf Ebene 1 (typischerweise alle Objekte einer Tranche, inklusive der Tranche)
* 2 = Alle DO mit dem selben Vorfahren auf Ebene 2
* 3 = Alle DO mit dem selben Vorfahren auf Ebene 3
* etc.
* -1 = Alle auf der gleichen Ebene wie das DO Objekt, inklusive des Vorfahren
* -2 = Alle 2 Ebenen höher als das DO Objekt

Metadatumsname2: Schränkt die betrachteten Dos ein. Es werden nur die DO angesehen, die den gleichen Wert im Attribut '''Metadatumsname2''' haben.

Wenn für das Metadatum das sortiert werden soll ein Datentyp angegeben wurde, dann muss der Datentyp mit den vorhandenen Werten in den Feldern übereinstimmen sonst gibt es einen Fehler.

'''Merke:''' Number ist z.B. nicht gleich Integer, für Number wird mindestens eine Nachkommastelle erwartet. Wenn Integer angegeben wurde, darf z.B. kein Buchstabe in einem der Felder vorkommen.

Wenn im Resultat Negative Werte stehen, dann deutet dies auf einen Verarbeitungsfehler.
-2 = SQL Fehler bei der Abfrage
-3 = falscher Datentyp
-4 = mindestens ein Feld vom Typ Character/String war leer

===§sortierung===

Gibt die Sortierreihenfolge des Objektes zurück. Analog zu verwenden wie $min/$max. Wird der letzte Parameter nicht angegeben wird automatisch aufsteigend sortiert.

§sortierung(Metadatumsname,../-2/-1/0/1/2/.., Metadatumsname2,0/1)

Bsp:
§sortierung('Büronummer',-1,'Vorname',0)

'''Parameter'''

Metadatumsname: Der Name des Metadatums

Hierachieebene: (Einschränkung)
* 0 = Alle DO des Auftrages (=keine Einschränkung)
* 1 = Alle DO mit dem selben Vorfahren auf Ebene 1 (typischerweise alle Objekte einer Tranche, inklusive der Tranche)
* 2 = Alle DO mit dem selben Vorfahren auf Ebene 2
* 3 = Alle DO mit dem selben Vorfahren auf Ebene 3
* etc.
* -1 = Alle auf der gleichen Ebene wie das DO Objekt, inklusive des Vorfahren
* -2 = Alle 2 Ebenen höher als das DO Objekt

Metadatumsname2: Schränkt die betrachteten Dos ein. Es werden nur die DO angesehen, die den gleichen Wert im Attribut '''Metadatumsname2''' haben.

Sortierreihenfolge: 0 = Aufwärts, 1 = Abwärts

Wenn für das Metadatum das sortiert werden soll ein Datentyp angegeben wurde, dann muss der Datentyp mit den vorhandenen Werten in den Feldern übereinstimmen sonst gibt es einen Fehler.

'''Merke:''' Number ist z.B. nicht gleich Integer, für Number wird mindestens eine Nachkommastelle erwartet. Wenn Integer angegeben wurde, darf z.B. kein Buchstabe in einem der Felder vorkommen.

Wenn im Resultat Negative Werte stehen, dann deutet dies auf einen Verarbeitungsfehler.
-2 = SQL Fehler bei der Abfrage
-3 = falscher Datentyp
-4 = mindestens ein Feld vom Typ Character/String war leer

===§istEindeutig===

Prüft ob für ein DO Objekt ein bestimmtes Metadatum im Vergleich zu weiteren DOs eindeutig ist. Vergleiche sind mit DOs auf wählbarer Hierarchieebene sowie mit gleichem oder abweichendem DO Typ möglich.

§istEindeutig(Metadatumsname, 0/1/2, 0/1/2[,DO Typen])
§istEindeutig(Metadatumsname, Hierarchieebene, Typ-Einschränkung[,'Typ1,Typ2,..'])

'''Parameter'''
Metadatumsname: Der Name des Metadatums
Bereich: 0 = Ganzer Auftrag, alle DO dieses Auftrages, 1 = Alle DO auf Ebene 1, 2 = Alle DO auf Ebene 2
Typ-Einschränkung: 0 = Alle Typen mit dem gleichen Metadatumsname, 1 = Gleicher Typ wie das Vergleichsobjekt, 2 = Alle im zwingend folgenden Parameter angegebenen Typen

'''Anwendung'''
§istEindeutig('Verlag',0,0) Alle DO des Auftrages, welche bei einem beliebiegen DO Typ und dem Attribut 'Verlag' das selbe Metadatum besitzen
§istEindeutig('Verlag',1,1) Alle DO auf Ebene 1, welche zum gleichen Typ und dem Attribut 'Verlag' das selbe Metadatum besitzen
§istEindeutig('Verlag',2,0) Alle DO auf Ebene 2, welche bei einem beliebiegen Typ und dem Attribut 'Verlag' das selbe Metadatum besitzen
§istEindeutig('Verlag',2,1) Alle DO auf Ebene 2, welche zum gleichen Typ und dem Attribut 'Verlag' das selbe Metadatum besitzen
§istEindeutig('Verlag',2,2,'Buch, Magazin, Zeitung') Alle DO auf Ebene 2, welche zu den angegebenen Typen 'Buch, Magazin, Zeitung' und dem Attribut 'Verlag' das selbe Metadatum besitzen

Fehleingabe vermeiden:
§istEindeutig('Verlag',2,2) Es wird eine Typeinschränkung (Parameter drei = 2) verlangt, ohne nachfolgende die gesuchten Typen zu nennen.

===§KindNr===

Diese Methode gibt zurück, das wievielte Kind das Objekt ist.

§KindNr()

Bsp:
Das Objekt hat 5 Geschwister und ist als viertes erstellt worden. Somit gibt die Methode §KindNr 4 zurück.

===§sortierungSignatur===

Diese Methode gibt zurück, die Position des Objektes von allen Objekten mit der gleichen Signatur.

§sortierungSignatur()

Bsp:
Gegeben:
Objekt 1 mit Signatur 'A'
Objekt 2 mit Signatur 'B'
Objekt 3 mit Sigantur 'A'
Objekt 4 mit Signatur 'A'
Objekt 5 mit Signatur 'C'

Wird zurückgegeben:
Objekt 1 -> 1 (weil es das erste Objekt ist mit Signatur 'A')
Objekt 2 -> 1 (weil es das erste Objekt ist mit Signatur 'B')
Objekt 3 -> 2 (weil es das zweite Objekt ist mit Signatur 'A')
Objekt 4 -> 3 (weil es das dritte Objekt ist mit Signatur 'A')
Objekt 5 -> 1 (weil es das erste Objekt ist mit Signatur 'C')

===§minX===

Bevor diese Methode ausgeführt werden kann, muss der Schritt [[Files messen]] gemacht werden.
Diese Methode gibt die kleinstmögliche Breite des Objektes nachdem die [[Files messen|Files gemessen]] wurden an, grösser oder gleich dem Parameter.
Es werden alle Files ausgewertet ausser PDFs.
Die Methode erwartet eine Zahl als Pixel-Wert.

§minX(minimumPixel)

Bsp:
Objekt mit folgenden Files: auto.jpg (Breite: 100), baum.jpg (Breite:200), clown.jpg (Breite:110)
Methode §minX(105) gibt 110 zurück
Methode §minX(110) gibt 110 zurück
Methode §minX(150) gibt 200 zurück

===§minY===

Bevor diese Methode ausgeführt werden kann, muss der Schritt [[Files messen]] gemacht werden.
Diese Methode gibt die kleinstmögliche Höhe des Objektes nachdem die [[Files messen|Files gemessen]] wurden an, grösser oder gleich dem Parameter.
Es werden alle Files ausgewertet ausser PDFs.
Die Methode erwartet eine Zahl als Pixel-Wert.

§minY(minimumPixel)

Bsp:
Objekt mit folgenden Files: auto.jpg (Höhe: 100), baum.jpg (Höhe:200), clown.jpg (Höhe:110)
Methode §minY(105) gibt 110 zurück
Methode §minY(110) gibt 110 zurück
Methode §minY(150) gibt 200 zurück

===§OCRTextRegion===

Führt OCR auf einer bestimmen Seitennummer (einzelne Bild Datei!) in einer bestimmten Region aus, und gibt als Resultat den gefundenen Text zurück. Dieser Text lässt sich dann z.B. in ein Metadatum übertragen.

Die Seitennummer wird über die Sortierreihenfolge der Dateinamen im Dateisystem bestimmt. Es werden TIFF, JPG und PNG als Dateiformate unterstützt.

Die wählbare Region, welche eine rechteckige Selektion ist, wird über die Koordinaten X1,X2,Y1,Y2 in Pixel definiert. Wobei X1=linker Rand, X2=rechter Rand, Y1=oberer Rand, Y2=unterer Rand.

'''Wenn für die Koordinaten negative Werte eingesetzt werden, so werden die Positionen relativ zur Bildgrösse und ausgehend vom rechten oder unteren Bildrand berechnet!'''

§OCRTextRegion(Seite,X1,X2,Y1,Y2)

Bsp: Seite Nummer 5 (entspricht Datei Nummer 5). Bilddimensionen: 2663 Breite x 3603 Höhe

§OCRTextRegion(5,359,709,631,690) -> entspricht einem Auswahlrechteck mit Abstand Links=359, Abstand oben=631, Breite=350, Höhe=59

§OCRTextRegion(5,-2304,709,-2972,690) -> entspricht genau dem gleichen Auswahlrechteck mit Abstand Links=359, Abstand oben=631, Breite=350, Höhe=59 ''' weil das Bild die gleiche Dimension besitzt!'''

§OCRTextRegion(5,-2304,-1954,-2972,-2913) -> entspricht genau dem gleichen Auswahlrechteck mit Abstand Links=359, Abstand oben=631, Breite=350, Höhe=59 '''weil das Bild die gleiche Dimension besitzt!'''

===§FileAnzahl===

Diese Methode gibt dir Anzahl Dateien am aktuellen Datenschritt des Objektes zurück. Dabei werden alle Dateien auch in allen Unterordnern gezählt. Unsichtbare Dateien sowie die Ordner selbst zählen nicht.

§FileAnzahl()

===§Hausnummer===
Diese Methode formatiert einen Hausnummer.
§Hausnummer(Wert)

Beispiele:
12 -> 012
123 -> 123
12a -> 012a
2a -> 002a

===§KinderSummeAT===
Gibt die Summe der Werte des Attributs aller Kinder zurück, nicht rekursiv, also nur der direkten Kinder.
§KinderSummeAT('Attribut')

===§KinderWertAT===
Gibt den Wert des Attributs des ersten Kindes zurück. Idealerweise hat es nur ein Kind. Sonst wir das erste genommen.
§KinderWertAT('Attribut')

===§isJSONValid===
Prüft ob ein Attribut ein valides JSON ist. Gibt Wahr (true) oder Falsch (false) zurück.
§isJSONValid('JSON')

===§StrasseAusschreiben===
Diese Methode prüft ob ein Strassennamen (mit oder ohne Hausnummer) schön formatiert ist. Dabei wird jeder Anfangsbuchstabe in einen Grossbuchstaben geändert. "str" und "str." werden zu "strasse" ausgeschrieben.

§StrasseAusschreiben('Strasse')

====Beispiele====
Teststr 58A => Teststrasse 58A
zUr lindENstr. => Zur Lindenstrasse
Hofweg 68 => Hofweg 68

==Weitere Beispiele==
§OCRMatchCount('Bericht')>0 ==> Falls das Wort Bericht mindestens 1 Mal gefunden wurde ist der Ausdruck wahr 
§OCRMatchCount('[0-9][0-9][.]')=0 ==> Falls KEINE 2 stellige Zahl mit einem Punkt gefunden wird ist der Ausdruck wahr 
§OCRMatchCount('[BelegName]')>2 ==> Falls der Wert des Attributes BelegName mehr als 2 mal gefunden wird ist der Ausdruck wahr 
§OCRMatchCount('[BelegName]',1)>0 ==> Falls der Wert des Attributes BelegName mindestens einmal im OCR der Kindern gefunden wurde.

Verfügbare Funktionen

2025-10-23T15:17:53Z

Stefan: /* §sortierung */

Die hier gelisteten Funktionen lassen sich bei allen Workflowschritten anwenden, welche einen Link zu dieser Seite besitzen.

==Funktionen==

'''Beachte:''' Die Metadatumsfelder sind hier unbedingt als String ('Metadatum') zu übergeben und nicht wie andersweitig in eckigen Klammern.

===§getQuittungsFeld===

Holt den Wert aus einem Quittungsfeld. Das Objekt muss dazu eine Quittung besitzen. Es wird immer auf die letzte erstellte Quittung zurückgegriffen. Aktuell werden Quittungsdetail im JSON Format unterstützt.

Die Funktion erwartet einen gültigen Pfad zu einem JSON Member, oder anderst gesagt den Schlüssel zu einem Attribut in dem JSON. (JSON Pfade der Quittung finden: Siehe [[Warten auf Rückmeldung]])

§getQuittungsFeld('pfad.zu.dem.gewünschten.feld')

===§istInWortliste===

Ermittelt ob ein Metadatum in einer Wortliste vorkommt; wobei 1 = kommt vor, 0 = kommt nicht vor.

Die Wortliste ist als [https://helper.ch/wiki/index.php?title=Konfiguration Konfigurationsdatensatz] zu erstellen. Der Name der erstellen Wortliste wird als Parameter zum finden der Liste benötigt.

§istInWortliste(Metadatumsname,Wortlistenname,Suchtyp,Zeilenumbruchtyp)

;Metadatumsname: Wert des Metadatums, zB 'Eugen' oder [Vorname]
;Wortlistenname: Name der Wortliste, also des Konfigurationsdatensatzes.
;Suchtyp: 0=Es wird genau nach dem Wert gesucht (Standard), 1=Findet auch 'Hans', wenn in der Wortliste 'Eugen Hans' oder 'Hans-Peter' steht
;Zeilenumbruchtyp: Welcher Zeilenumbruch wird in der Wortliste verwendet: 0=Zeilenumbruch ist 'CR' (Standard), 1=Zeilenumbruch ist 'CRLF'

Bsp.: Es wurde eine Liste mit Vornamen in der Konfiguration erstellt. Diese Liste lautet auf den Namen "Vornamenkonfiguration". Ein Metadatum "Vorname" wurde erstellt, dort wurden zuvor Vornamen gespeichert.

§istInWortliste('Vorname','Vornamenkonfiguration')

===§getConfidenceOfWordInRegionXML===

Gibt die vom OCR ermittelte Konfidenz zu einem gefundenen Begriff zurück und schreibt den Wert in ein Metadatum. Erlaubt optional die Angabe eines Einschräkungsbereiches, in welchem der gesuchte Begriff vorkommen muss.

Der Bereich ist als Row(left,top,width,height) anzugeben: §getConfidenceOfWordInRegionXML('Suchwort',row(left,top,width,height))

Bsp.:
§getConfidenceOfWordInRegionXML('London',row(57,154,75,25))

0 = Begriff nicht gefunden
0.1 - 100 = Konfidenz des gefundenen Begriffes

===§KinderWertATMin(AttributName) und §KinderWertATMax(AttributName)===

Gibt den kleinsten oder den grössten Wert eines Metadatums mit dem gegebenen Atrributnamen von den direkten Nachfahren des Objektes zurück.

Berücktichtigt den Datentyp für die Sortierung, falls dieser beim Attribut angegeben wurde. Bei Datumstypen ist Min das jüngste und Max das älteste.

Gibt das ermittelte Metadatum zurück.

===§KinderWertATStetig(AttributName,Min,Max)===

Prüft ob ein Nachfahre des Objektes mit dem gegebenen Attributnamen im Bereich Min-Max eine stetige Zahlenfolge besitzt.

Eignet sich z.B. um zu ermitteln, ob die Seitenzahlen der Kindobjekte im Metadatum mit dem Attributsnamen "Seitenzahl" zwischen den Werten 1-20 alle vorhanden sind.

Gibt wahr oder falsch zurück.

===§istMin und §istMax===

Vergleicht von DO Objekten die Attributswerte des angegebenen Attributs miteinander, und ermittelt ob das DO den grössten oder den kleinsten Wert der verglichenen Objekte besitzt. Alle DO Typen, welchen den gleichen Attributsnamen besitzen, werden für den Vergleich herbeigezogen. 
Die Hierarchiestufe der Objekte kann, ausgehend vom Objekt eingeschränkt werden. 

Pflicht: Metadatumsname, Hierarchieebene 
Optional: Metadatumsname2 (Ohne Metadatumsname2 werden allein die gefundenen Metadaten aus Metadatumsname verglichen, mit werden nur diejenigen Objekte welche den gleichen Wert in Metadatumsname2 haben verglichen). 

§istMax(Metadatumsname,Hierachieebene,Metadatumsname2)
§istMax(Metadatumsname,../-2/-1/0/1/2/..,Metadatumsname2)
§istMin(Metadatumsname,../-2/-1/0/1/2/..,Metadatumsname2)

Bsp.:
'''§istMax('AnzahlDok',1,'Büronummer')''' Gibt 1 zurück, wenn das Objekt den grössten Wert im Attribut 'AnzahlDok' hat, innerhalb der eigenen Tranche und der gleichen Büronummer.

'''Parameter'''

Metadatumsname: Der Name des Metadatums

Hierachieebene: (Einschränkung)
* 0 = Alle DO des Auftrages (=keine Einschränkung)
* 1 = Alle DO mit dem selben Vorfahren auf Ebene 1 (typischerweise alle Objekte einer Tranche, inklusive der Tranche)
* 2 = Alle DO mit dem selben Vorfahren auf Ebene 2
* 3 = Alle DO mit dem selben Vorfahren auf Ebene 3
* etc.
* -1 = Alle auf der gleichen Ebene wie das DO Objekt, inklusive des Vorfahren
* -2 = Alle 2 Ebenen höher als das DO Objekt

Metadatumsname2: Schränkt die betrachteten Dos ein. Es werden nur die DO angesehen, die den gleichen Wert im Attribut '''Metadatumsname2''' haben.

===§sortierung===

Gibt die Sortierreihenfolge des Objektes zurück. Analog zu verwenden wie $min/$max. Wird der letzte Parameter nicht angegeben wird automatisch aufsteigend sortiert.

§sortierung(Metadatumsname,../-2/-1/0/1/2/.., Metadatumsname2,0/1)

Bsp:
§sortierung('Büronummer',-1,'Vorname',0)

'''Parameter'''

Metadatumsname: Der Name des Metadatums

Hierachieebene: (Einschränkung)
* 0 = Alle DO des Auftrages (=keine Einschränkung)
* 1 = Alle DO mit dem selben Vorfahren auf Ebene 1 (typischerweise alle Objekte einer Tranche, inklusive der Tranche)
* 2 = Alle DO mit dem selben Vorfahren auf Ebene 2
* 3 = Alle DO mit dem selben Vorfahren auf Ebene 3
* etc.
* -1 = Alle auf der gleichen Ebene wie das DO Objekt, inklusive des Vorfahren
* -2 = Alle 2 Ebenen höher als das DO Objekt

Metadatumsname2: Schränkt die betrachteten Dos ein. Es werden nur die DO angesehen, die den gleichen Wert im Attribut '''Metadatumsname2''' haben.

Sortierreihenfolge: 0 = Aufwärts, 1 = Abwärts

Wenn für das Metadatum das sortiert werden soll ein Datentyp angegeben wurde, dann muss der Datentyp mit den vorhandenen Werten in den Feldern übereinstimmen sonst gibt es einen Fehler.

'''Merke:''' Number ist z.B. nicht gleich Integer, für Number wird mindestens eine Nachkommastelle erwartet. Wenn Integer angegeben wurde, darf z.B. kein Buchstabe in einem der Felder vorkommen.

Wenn im Resultat Negative Werte stehen, dann deutet dies auf einen Verarbeitungsfehler.
-2 = SQL Fehler bei der Abfrage
-3 = falscher Datentyp
-4 = mindestens ein Feld vom Typ Character/String war leer

===§istEindeutig===

Prüft ob für ein DO Objekt ein bestimmtes Metadatum im Vergleich zu weiteren DOs eindeutig ist. Vergleiche sind mit DOs auf wählbarer Hierarchieebene sowie mit gleichem oder abweichendem DO Typ möglich.

§istEindeutig(Metadatumsname, 0/1/2, 0/1/2[,DO Typen])
§istEindeutig(Metadatumsname, Hierarchieebene, Typ-Einschränkung[,'Typ1,Typ2,..'])

'''Parameter'''
Metadatumsname: Der Name des Metadatums
Bereich: 0 = Ganzer Auftrag, alle DO dieses Auftrages, 1 = Alle DO auf Ebene 1, 2 = Alle DO auf Ebene 2
Typ-Einschränkung: 0 = Alle Typen mit dem gleichen Metadatumsname, 1 = Gleicher Typ wie das Vergleichsobjekt, 2 = Alle im zwingend folgenden Parameter angegebenen Typen

'''Anwendung'''
§istEindeutig('Verlag',0,0) Alle DO des Auftrages, welche bei einem beliebiegen DO Typ und dem Attribut 'Verlag' das selbe Metadatum besitzen
§istEindeutig('Verlag',1,1) Alle DO auf Ebene 1, welche zum gleichen Typ und dem Attribut 'Verlag' das selbe Metadatum besitzen
§istEindeutig('Verlag',2,0) Alle DO auf Ebene 2, welche bei einem beliebiegen Typ und dem Attribut 'Verlag' das selbe Metadatum besitzen
§istEindeutig('Verlag',2,1) Alle DO auf Ebene 2, welche zum gleichen Typ und dem Attribut 'Verlag' das selbe Metadatum besitzen
§istEindeutig('Verlag',2,2,'Buch, Magazin, Zeitung') Alle DO auf Ebene 2, welche zu den angegebenen Typen 'Buch, Magazin, Zeitung' und dem Attribut 'Verlag' das selbe Metadatum besitzen

Fehleingabe vermeiden:
§istEindeutig('Verlag',2,2) Es wird eine Typeinschränkung (Parameter drei = 2) verlangt, ohne nachfolgende die gesuchten Typen zu nennen.

===§KindNr===

Diese Methode gibt zurück, das wievielte Kind das Objekt ist.

§KindNr()

Bsp:
Das Objekt hat 5 Geschwister und ist als viertes erstellt worden. Somit gibt die Methode §KindNr 4 zurück.

===§sortierungSignatur===

Diese Methode gibt zurück, die Position des Objektes von allen Objekten mit der gleichen Signatur.

§sortierungSignatur()

Bsp:
Gegeben:
Objekt 1 mit Signatur 'A'
Objekt 2 mit Signatur 'B'
Objekt 3 mit Sigantur 'A'
Objekt 4 mit Signatur 'A'
Objekt 5 mit Signatur 'C'

Wird zurückgegeben:
Objekt 1 -> 1 (weil es das erste Objekt ist mit Signatur 'A')
Objekt 2 -> 1 (weil es das erste Objekt ist mit Signatur 'B')
Objekt 3 -> 2 (weil es das zweite Objekt ist mit Signatur 'A')
Objekt 4 -> 3 (weil es das dritte Objekt ist mit Signatur 'A')
Objekt 5 -> 1 (weil es das erste Objekt ist mit Signatur 'C')

===§minX===

Bevor diese Methode ausgeführt werden kann, muss der Schritt [[Files messen]] gemacht werden.
Diese Methode gibt die kleinstmögliche Breite des Objektes nachdem die [[Files messen|Files gemessen]] wurden an, grösser oder gleich dem Parameter.
Es werden alle Files ausgewertet ausser PDFs.
Die Methode erwartet eine Zahl als Pixel-Wert.

§minX(minimumPixel)

Bsp:
Objekt mit folgenden Files: auto.jpg (Breite: 100), baum.jpg (Breite:200), clown.jpg (Breite:110)
Methode §minX(105) gibt 110 zurück
Methode §minX(110) gibt 110 zurück
Methode §minX(150) gibt 200 zurück

===§minY===

Bevor diese Methode ausgeführt werden kann, muss der Schritt [[Files messen]] gemacht werden.
Diese Methode gibt die kleinstmögliche Höhe des Objektes nachdem die [[Files messen|Files gemessen]] wurden an, grösser oder gleich dem Parameter.
Es werden alle Files ausgewertet ausser PDFs.
Die Methode erwartet eine Zahl als Pixel-Wert.

§minY(minimumPixel)

Bsp:
Objekt mit folgenden Files: auto.jpg (Höhe: 100), baum.jpg (Höhe:200), clown.jpg (Höhe:110)
Methode §minY(105) gibt 110 zurück
Methode §minY(110) gibt 110 zurück
Methode §minY(150) gibt 200 zurück

===§OCRTextRegion===

Führt OCR auf einer bestimmen Seitennummer (einzelne Bild Datei!) in einer bestimmten Region aus, und gibt als Resultat den gefundenen Text zurück. Dieser Text lässt sich dann z.B. in ein Metadatum übertragen.

Die Seitennummer wird über die Sortierreihenfolge der Dateinamen im Dateisystem bestimmt. Es werden TIFF, JPG und PNG als Dateiformate unterstützt.

Die wählbare Region, welche eine rechteckige Selektion ist, wird über die Koordinaten X1,X2,Y1,Y2 in Pixel definiert. Wobei X1=linker Rand, X2=rechter Rand, Y1=oberer Rand, Y2=unterer Rand.

'''Wenn für die Koordinaten negative Werte eingesetzt werden, so werden die Positionen relativ zur Bildgrösse und ausgehend vom rechten oder unteren Bildrand berechnet!'''

§OCRTextRegion(Seite,X1,X2,Y1,Y2)

Bsp: Seite Nummer 5 (entspricht Datei Nummer 5). Bilddimensionen: 2663 Breite x 3603 Höhe

§OCRTextRegion(5,359,709,631,690) -> entspricht einem Auswahlrechteck mit Abstand Links=359, Abstand oben=631, Breite=350, Höhe=59

§OCRTextRegion(5,-2304,709,-2972,690) -> entspricht genau dem gleichen Auswahlrechteck mit Abstand Links=359, Abstand oben=631, Breite=350, Höhe=59 ''' weil das Bild die gleiche Dimension besitzt!'''

§OCRTextRegion(5,-2304,-1954,-2972,-2913) -> entspricht genau dem gleichen Auswahlrechteck mit Abstand Links=359, Abstand oben=631, Breite=350, Höhe=59 '''weil das Bild die gleiche Dimension besitzt!'''

===§FileAnzahl===

Diese Methode gibt dir Anzahl Dateien am aktuellen Datenschritt des Objektes zurück. Dabei werden alle Dateien auch in allen Unterordnern gezählt. Unsichtbare Dateien sowie die Ordner selbst zählen nicht.

§FileAnzahl()

===§Hausnummer===
Diese Methode formatiert einen Hausnummer.
§Hausnummer(Wert)

Beispiele:
12 -> 012
123 -> 123
12a -> 012a
2a -> 002a

===§KinderSummeAT===
Gibt die Summe der Werte des Attributs aller Kinder zurück, nicht rekursiv, also nur der direkten Kinder.
§KinderSummeAT('Attribut')

===§KinderWertAT===
Gibt den Wert des Attributs des ersten Kindes zurück. Idealerweise hat es nur ein Kind. Sonst wir das erste genommen.
§KinderWertAT('Attribut')

===§isJSONValid===
Prüft ob ein Attribut ein valides JSON ist. Gibt Wahr (true) oder Falsch (false) zurück.
§isJSONValid('JSON')

===§StrasseAusschreiben===
Diese Methode prüft ob ein Strassennamen (mit oder ohne Hausnummer) schön formatiert ist. Dabei wird jeder Anfangsbuchstabe in einen Grossbuchstaben geändert. "str" und "str." werden zu "strasse" ausgeschrieben.

§StrasseAusschreiben('Strasse')

====Beispiele====
Teststr 58A => Teststrasse 58A
zUr lindENstr. => Zur Lindenstrasse
Hofweg 68 => Hofweg 68

==Weitere Beispiele==
§OCRMatchCount('Bericht')>0 ==> Falls das Wort Bericht mindestens 1 Mal gefunden wurde ist der Ausdruck wahr 
§OCRMatchCount('[0-9][0-9][.]')=0 ==> Falls KEINE 2 stellige Zahl mit einem Punkt gefunden wird ist der Ausdruck wahr 
§OCRMatchCount('[BelegName]')>2 ==> Falls der Wert des Attributes BelegName mehr als 2 mal gefunden wird ist der Ausdruck wahr 
§OCRMatchCount('[BelegName]',1)>0 ==> Falls der Wert des Attributes BelegName mindestens einmal im OCR der Kindern gefunden wurde.

Verfügbare Funktionen

2025-10-23T15:17:01Z

Stefan: /* §sortierung */

Die hier gelisteten Funktionen lassen sich bei allen Workflowschritten anwenden, welche einen Link zu dieser Seite besitzen.

==Funktionen==

'''Beachte:''' Die Metadatumsfelder sind hier unbedingt als String ('Metadatum') zu übergeben und nicht wie andersweitig in eckigen Klammern.

===§getQuittungsFeld===

Holt den Wert aus einem Quittungsfeld. Das Objekt muss dazu eine Quittung besitzen. Es wird immer auf die letzte erstellte Quittung zurückgegriffen. Aktuell werden Quittungsdetail im JSON Format unterstützt.

Die Funktion erwartet einen gültigen Pfad zu einem JSON Member, oder anderst gesagt den Schlüssel zu einem Attribut in dem JSON. (JSON Pfade der Quittung finden: Siehe [[Warten auf Rückmeldung]])

§getQuittungsFeld('pfad.zu.dem.gewünschten.feld')

===§istInWortliste===

Ermittelt ob ein Metadatum in einer Wortliste vorkommt; wobei 1 = kommt vor, 0 = kommt nicht vor.

Die Wortliste ist als [https://helper.ch/wiki/index.php?title=Konfiguration Konfigurationsdatensatz] zu erstellen. Der Name der erstellen Wortliste wird als Parameter zum finden der Liste benötigt.

§istInWortliste(Metadatumsname,Wortlistenname,Suchtyp,Zeilenumbruchtyp)

;Metadatumsname: Wert des Metadatums, zB 'Eugen' oder [Vorname]
;Wortlistenname: Name der Wortliste, also des Konfigurationsdatensatzes.
;Suchtyp: 0=Es wird genau nach dem Wert gesucht (Standard), 1=Findet auch 'Hans', wenn in der Wortliste 'Eugen Hans' oder 'Hans-Peter' steht
;Zeilenumbruchtyp: Welcher Zeilenumbruch wird in der Wortliste verwendet: 0=Zeilenumbruch ist 'CR' (Standard), 1=Zeilenumbruch ist 'CRLF'

Bsp.: Es wurde eine Liste mit Vornamen in der Konfiguration erstellt. Diese Liste lautet auf den Namen "Vornamenkonfiguration". Ein Metadatum "Vorname" wurde erstellt, dort wurden zuvor Vornamen gespeichert.

§istInWortliste('Vorname','Vornamenkonfiguration')

===§getConfidenceOfWordInRegionXML===

Gibt die vom OCR ermittelte Konfidenz zu einem gefundenen Begriff zurück und schreibt den Wert in ein Metadatum. Erlaubt optional die Angabe eines Einschräkungsbereiches, in welchem der gesuchte Begriff vorkommen muss.

Der Bereich ist als Row(left,top,width,height) anzugeben: §getConfidenceOfWordInRegionXML('Suchwort',row(left,top,width,height))

Bsp.:
§getConfidenceOfWordInRegionXML('London',row(57,154,75,25))

0 = Begriff nicht gefunden
0.1 - 100 = Konfidenz des gefundenen Begriffes

===§KinderWertATMin(AttributName) und §KinderWertATMax(AttributName)===

Gibt den kleinsten oder den grössten Wert eines Metadatums mit dem gegebenen Atrributnamen von den direkten Nachfahren des Objektes zurück.

Berücktichtigt den Datentyp für die Sortierung, falls dieser beim Attribut angegeben wurde. Bei Datumstypen ist Min das jüngste und Max das älteste.

Gibt das ermittelte Metadatum zurück.

===§KinderWertATStetig(AttributName,Min,Max)===

Prüft ob ein Nachfahre des Objektes mit dem gegebenen Attributnamen im Bereich Min-Max eine stetige Zahlenfolge besitzt.

Eignet sich z.B. um zu ermitteln, ob die Seitenzahlen der Kindobjekte im Metadatum mit dem Attributsnamen "Seitenzahl" zwischen den Werten 1-20 alle vorhanden sind.

Gibt wahr oder falsch zurück.

===§istMin und §istMax===

Vergleicht von DO Objekten die Attributswerte des angegebenen Attributs miteinander, und ermittelt ob das DO den grössten oder den kleinsten Wert der verglichenen Objekte besitzt. Alle DO Typen, welchen den gleichen Attributsnamen besitzen, werden für den Vergleich herbeigezogen. 
Die Hierarchiestufe der Objekte kann, ausgehend vom Objekt eingeschränkt werden. 

Pflicht: Metadatumsname, Hierarchieebene 
Optional: Metadatumsname2 (Ohne Metadatumsname2 werden allein die gefundenen Metadaten aus Metadatumsname verglichen, mit werden nur diejenigen Objekte welche den gleichen Wert in Metadatumsname2 haben verglichen). 

§istMax(Metadatumsname,Hierachieebene,Metadatumsname2)
§istMax(Metadatumsname,../-2/-1/0/1/2/..,Metadatumsname2)
§istMin(Metadatumsname,../-2/-1/0/1/2/..,Metadatumsname2)

Bsp.:
'''§istMax('AnzahlDok',1,'Büronummer')''' Gibt 1 zurück, wenn das Objekt den grössten Wert im Attribut 'AnzahlDok' hat, innerhalb der eigenen Tranche und der gleichen Büronummer.

'''Parameter'''

Metadatumsname: Der Name des Metadatums

Hierachieebene: (Einschränkung)
* 0 = Alle DO des Auftrages (=keine Einschränkung)
* 1 = Alle DO mit dem selben Vorfahren auf Ebene 1 (typischerweise alle Objekte einer Tranche, inklusive der Tranche)
* 2 = Alle DO mit dem selben Vorfahren auf Ebene 2
* 3 = Alle DO mit dem selben Vorfahren auf Ebene 3
* etc.
* -1 = Alle auf der gleichen Ebene wie das DO Objekt, inklusive des Vorfahren
* -2 = Alle 2 Ebenen höher als das DO Objekt

Metadatumsname2: Schränkt die betrachteten Dos ein. Es werden nur die DO angesehen, die den gleichen Wert im Attribut '''Metadatumsname2''' haben.

===§sortierung===

Gibt die Sortierreihenfolge des Objektes zurück. Analog zu verwenden wie $min/$max. Wird der letzte Parameter nicht angegeben wird automatisch aufsteigend sortiert.

§sortierung(Metadatumsname,../-2/-1/0/1/2/.., Metadatumsname2,0/1)

Bsp:
§sortierung('Büronummer',-1,'Vorname',0)

'''Parameter'''

Metadatumsname: Der Name des Metadatums

Hierachieebene: (Einschränkung)
* 0 = Alle DO des Auftrages (=keine Einschränkung)
* 1 = Alle DO mit dem selben Vorfahren auf Ebene 1 (typischerweise alle Objekte einer Tranche, inklusive der Tranche)
* 2 = Alle DO mit dem selben Vorfahren auf Ebene 2
* 3 = Alle DO mit dem selben Vorfahren auf Ebene 3
* etc.
* -1 = Alle auf der gleichen Ebene wie das DO Objekt, inklusive des Vorfahren
* -2 = Alle 2 Ebenen höher als das DO Objekt

Metadatumsname2: Schränkt die betrachteten Dos ein. Es werden nur die DO angesehen, die den gleichen Wert im Attribut '''Metadatumsname2''' haben.

Sortierreihenfolge: 0 = Aufwärts, 1 = Abwärts

Wenn für das Metadatum das sortiert werden soll ein Datentyp angegeben wurde, dann muss der Datentyp mit den vorhandenen Werten in den Feldern übereinstimmen sonst gibt es einen Fehler.
Merke: Number ist z.B. nicht gleich Integer, für Number wird mindestens eine Nachkommastelle erwartet. Wenn Integer angegeben wurde, darf z.B. kein Buchstabe in einem der Felder vorkommen.

Wenn im Resultat Negative Werte stehen, dann deutet dies auf einen Verarbeitungsfehler.
-2 = SQL Fehler bei der Abfrage
-3 = falscher Datentyp
-4 = mindestens ein Feld vom Typ Character/String war leer

===§istEindeutig===

Prüft ob für ein DO Objekt ein bestimmtes Metadatum im Vergleich zu weiteren DOs eindeutig ist. Vergleiche sind mit DOs auf wählbarer Hierarchieebene sowie mit gleichem oder abweichendem DO Typ möglich.

§istEindeutig(Metadatumsname, 0/1/2, 0/1/2[,DO Typen])
§istEindeutig(Metadatumsname, Hierarchieebene, Typ-Einschränkung[,'Typ1,Typ2,..'])

'''Parameter'''
Metadatumsname: Der Name des Metadatums
Bereich: 0 = Ganzer Auftrag, alle DO dieses Auftrages, 1 = Alle DO auf Ebene 1, 2 = Alle DO auf Ebene 2
Typ-Einschränkung: 0 = Alle Typen mit dem gleichen Metadatumsname, 1 = Gleicher Typ wie das Vergleichsobjekt, 2 = Alle im zwingend folgenden Parameter angegebenen Typen

'''Anwendung'''
§istEindeutig('Verlag',0,0) Alle DO des Auftrages, welche bei einem beliebiegen DO Typ und dem Attribut 'Verlag' das selbe Metadatum besitzen
§istEindeutig('Verlag',1,1) Alle DO auf Ebene 1, welche zum gleichen Typ und dem Attribut 'Verlag' das selbe Metadatum besitzen
§istEindeutig('Verlag',2,0) Alle DO auf Ebene 2, welche bei einem beliebiegen Typ und dem Attribut 'Verlag' das selbe Metadatum besitzen
§istEindeutig('Verlag',2,1) Alle DO auf Ebene 2, welche zum gleichen Typ und dem Attribut 'Verlag' das selbe Metadatum besitzen
§istEindeutig('Verlag',2,2,'Buch, Magazin, Zeitung') Alle DO auf Ebene 2, welche zu den angegebenen Typen 'Buch, Magazin, Zeitung' und dem Attribut 'Verlag' das selbe Metadatum besitzen

Fehleingabe vermeiden:
§istEindeutig('Verlag',2,2) Es wird eine Typeinschränkung (Parameter drei = 2) verlangt, ohne nachfolgende die gesuchten Typen zu nennen.

===§KindNr===

Diese Methode gibt zurück, das wievielte Kind das Objekt ist.

§KindNr()

Bsp:
Das Objekt hat 5 Geschwister und ist als viertes erstellt worden. Somit gibt die Methode §KindNr 4 zurück.

===§sortierungSignatur===

Diese Methode gibt zurück, die Position des Objektes von allen Objekten mit der gleichen Signatur.

§sortierungSignatur()

Bsp:
Gegeben:
Objekt 1 mit Signatur 'A'
Objekt 2 mit Signatur 'B'
Objekt 3 mit Sigantur 'A'
Objekt 4 mit Signatur 'A'
Objekt 5 mit Signatur 'C'

Wird zurückgegeben:
Objekt 1 -> 1 (weil es das erste Objekt ist mit Signatur 'A')
Objekt 2 -> 1 (weil es das erste Objekt ist mit Signatur 'B')
Objekt 3 -> 2 (weil es das zweite Objekt ist mit Signatur 'A')
Objekt 4 -> 3 (weil es das dritte Objekt ist mit Signatur 'A')
Objekt 5 -> 1 (weil es das erste Objekt ist mit Signatur 'C')

===§minX===

Bevor diese Methode ausgeführt werden kann, muss der Schritt [[Files messen]] gemacht werden.
Diese Methode gibt die kleinstmögliche Breite des Objektes nachdem die [[Files messen|Files gemessen]] wurden an, grösser oder gleich dem Parameter.
Es werden alle Files ausgewertet ausser PDFs.
Die Methode erwartet eine Zahl als Pixel-Wert.

§minX(minimumPixel)

Bsp:
Objekt mit folgenden Files: auto.jpg (Breite: 100), baum.jpg (Breite:200), clown.jpg (Breite:110)
Methode §minX(105) gibt 110 zurück
Methode §minX(110) gibt 110 zurück
Methode §minX(150) gibt 200 zurück

===§minY===

Bevor diese Methode ausgeführt werden kann, muss der Schritt [[Files messen]] gemacht werden.
Diese Methode gibt die kleinstmögliche Höhe des Objektes nachdem die [[Files messen|Files gemessen]] wurden an, grösser oder gleich dem Parameter.
Es werden alle Files ausgewertet ausser PDFs.
Die Methode erwartet eine Zahl als Pixel-Wert.

§minY(minimumPixel)

Bsp:
Objekt mit folgenden Files: auto.jpg (Höhe: 100), baum.jpg (Höhe:200), clown.jpg (Höhe:110)
Methode §minY(105) gibt 110 zurück
Methode §minY(110) gibt 110 zurück
Methode §minY(150) gibt 200 zurück

===§OCRTextRegion===

Führt OCR auf einer bestimmen Seitennummer (einzelne Bild Datei!) in einer bestimmten Region aus, und gibt als Resultat den gefundenen Text zurück. Dieser Text lässt sich dann z.B. in ein Metadatum übertragen.

Die Seitennummer wird über die Sortierreihenfolge der Dateinamen im Dateisystem bestimmt. Es werden TIFF, JPG und PNG als Dateiformate unterstützt.

Die wählbare Region, welche eine rechteckige Selektion ist, wird über die Koordinaten X1,X2,Y1,Y2 in Pixel definiert. Wobei X1=linker Rand, X2=rechter Rand, Y1=oberer Rand, Y2=unterer Rand.

'''Wenn für die Koordinaten negative Werte eingesetzt werden, so werden die Positionen relativ zur Bildgrösse und ausgehend vom rechten oder unteren Bildrand berechnet!'''

§OCRTextRegion(Seite,X1,X2,Y1,Y2)

Bsp: Seite Nummer 5 (entspricht Datei Nummer 5). Bilddimensionen: 2663 Breite x 3603 Höhe

§OCRTextRegion(5,359,709,631,690) -> entspricht einem Auswahlrechteck mit Abstand Links=359, Abstand oben=631, Breite=350, Höhe=59

§OCRTextRegion(5,-2304,709,-2972,690) -> entspricht genau dem gleichen Auswahlrechteck mit Abstand Links=359, Abstand oben=631, Breite=350, Höhe=59 ''' weil das Bild die gleiche Dimension besitzt!'''

§OCRTextRegion(5,-2304,-1954,-2972,-2913) -> entspricht genau dem gleichen Auswahlrechteck mit Abstand Links=359, Abstand oben=631, Breite=350, Höhe=59 '''weil das Bild die gleiche Dimension besitzt!'''

===§FileAnzahl===

Diese Methode gibt dir Anzahl Dateien am aktuellen Datenschritt des Objektes zurück. Dabei werden alle Dateien auch in allen Unterordnern gezählt. Unsichtbare Dateien sowie die Ordner selbst zählen nicht.

§FileAnzahl()

===§Hausnummer===
Diese Methode formatiert einen Hausnummer.
§Hausnummer(Wert)

Beispiele:
12 -> 012
123 -> 123
12a -> 012a
2a -> 002a

===§KinderSummeAT===
Gibt die Summe der Werte des Attributs aller Kinder zurück, nicht rekursiv, also nur der direkten Kinder.
§KinderSummeAT('Attribut')

===§KinderWertAT===
Gibt den Wert des Attributs des ersten Kindes zurück. Idealerweise hat es nur ein Kind. Sonst wir das erste genommen.
§KinderWertAT('Attribut')

===§isJSONValid===
Prüft ob ein Attribut ein valides JSON ist. Gibt Wahr (true) oder Falsch (false) zurück.
§isJSONValid('JSON')

===§StrasseAusschreiben===
Diese Methode prüft ob ein Strassennamen (mit oder ohne Hausnummer) schön formatiert ist. Dabei wird jeder Anfangsbuchstabe in einen Grossbuchstaben geändert. "str" und "str." werden zu "strasse" ausgeschrieben.

§StrasseAusschreiben('Strasse')

====Beispiele====
Teststr 58A => Teststrasse 58A
zUr lindENstr. => Zur Lindenstrasse
Hofweg 68 => Hofweg 68

==Weitere Beispiele==
§OCRMatchCount('Bericht')>0 ==> Falls das Wort Bericht mindestens 1 Mal gefunden wurde ist der Ausdruck wahr 
§OCRMatchCount('[0-9][0-9][.]')=0 ==> Falls KEINE 2 stellige Zahl mit einem Punkt gefunden wird ist der Ausdruck wahr 
§OCRMatchCount('[BelegName]')>2 ==> Falls der Wert des Attributes BelegName mehr als 2 mal gefunden wird ist der Ausdruck wahr 
§OCRMatchCount('[BelegName]',1)>0 ==> Falls der Wert des Attributes BelegName mindestens einmal im OCR der Kindern gefunden wurde.

Archivierung von Metadaten

2025-10-14T16:38:31Z

Stefan: * überarbeitung des textes und verweis auf Einstellungen

==Beschreibung==

Um zu gewährleisten, dass keine Datensätze in der Tabelle DAdressattribut (Metadaten) versehentlich verändert oder gelöscht werden können, bzw. dass für den gegebenen Fall die Daten nicht aus der Datensicherung zurückgespielt werden müssen, wurde die fortlaufende archivierung jedes DAdressattribut Datensatzes ermöglicht. Die Archivierung wird über die Installationsmaske konfiguriert.

Jegliche Änderungen, und damit auch eine Löschung, werden fortlaufend als Duplikat des aktuellen Datensatzes im Zustand vor der Veränderung in der Tabelle DArchiv protokolliert. 

Es ist dabei unerheblich, über welche Schnittstelle eine Änderung gemacht wurde. Die Datenbank selbst überwacht die Tabelle und kümmert sich ebenso um die archivierung.

Um die Daten aus dem Archiv zu betrachten oder wiederherzustellen, wurde ein Fenster im Helper verfügbar gemacht.

==Archivierte Metadaten==

Über dieses Fenster lassen sich die Archivierten Metadaten durchsuchen und wiederherstellen. 
Dazu sind die Objektnummer der gesuchten DO Objekte erforderlich.

Die Suche ist Auftragsabhängig und auf genau einen Objekt- & Attributstyp bezogen. 
Es muss daher zuerst ein Auftrag und dazu der entsprechende gesuchte Attributstyp ausgewählt werden.

Weiter muss nach Datum / Uhrzeit eingegrenzt werden, um Zeitpunktabhängig nach der gesuchten Archiv Version zu Filtern. 
Es wird jeweils nur die letzte Version vor dem gegebenen Zeitpunkt angezeigt.

'''Wenn ein zugehöriger Metadaten Datensatz gelöscht wurde, und nicht nur geleert, wenden Sie sich bitte für eine Wiederherstellung an Profile GmbH.'''

==Laden und wiederherstellen von archivierten Metadaten==

Sie erreichen das Fenster über die Hauptmaske, über das Objektdetailfenster sowie über das Produktionsauftragsfenster unter dem Reiter 'Objekte'.

* Wählen Sie den zugehörigen Produktionsauftrag
* Wählen Sie den Typ des Objektes
* Wählen Sie den gesuchten Attributstyp
* Geben Sie eine oder mehrere Kommagetrennte Objektnummern (DO_SEQ) ein
* Geben Sie das Datum / die Uhrzeit des letzten bekannten Standes an, oder geben Sie das aktuelle Datum ein um alle Versionen über den Taster 'Archivdaten laden' zu laden.
* Wählen Sie eine oder mehrere Datensätze aus der Liste aus und klicken Sie auf 'Selektierte wiederherstellen'

[[Datei:Darchivmetadaten2.png]]

Generischer CMD Code

2025-08-29T07:25:40Z

Stefan: /* Multipage PDF-Dateien aus JPEG2000 Dateien erzeugen */

;Mantiseinträge:
Keine
;Systemtyp:
25
;Eintrittsinvarianz: JA

==Beschreibung==
Besteht aus einem Serverjob OJOHZDOGenerischerCode. Ermöglicht dem Benutzer ein Skript ausführen zu lassen.

Der Pfad zum Batchskript muss vollständig angegeben werden.

Zusätzlich werden [Quellordner] sowie [Zielordner] hierbei ersetzt.

Der Rückgabewert bei positiver/erfolgreicher Skriptausführung beachtet neu (04.09.2024) keine Gross-/Kleinschreibung mehr! Bei der Eingabe des Parameters muss nicht mehr unterschieden werden -> ok = Ok = OK = oK

==Essentielle Felder==
HZ_SKRIPT ''Das auszuführende Skript. z.B 'c:\skripts\multipagepdf.bat [Quellordner] [Zielordner]'''

HZ_SKRIPTOK ''Resultierender Wert bei positiver Durchführung''

==Pane im Produktionsauftrag (FHK_Maske)==

[[Datei:skripteintrag.png]]

==Batchfiles==

Einige Serverjobs bedienen sich externer Applikationen um ihre Aufgaben erledigen zu können.

Da eine API meist fehlt, oder noch nicht über Omnis implementiert wurde, steuern wir solche externen Anwendungen gelegentlich über Windows Batch Skripte.

Damit wir eine Übersicht zu den verwendeten Skripten haben, wollen wir diese hier in dieses Dokument aufnehmen und kurz umschreiben. Wir gehen dabei nicht auf die Anwendungen ein, diese werden in einem separaten Kapitel beschrieben.

===Multipage TIFF Dateien aus TIFF Dateien erzeugen===

Erzeugt in der Sortierreihenfolge der Dateienamen nach aus allen gefundenen TIF Dateien im Quellordner mit der Endung *.tif eine Multipage TIFF Datei im Zielordner mit dem Namen 0001.tif.

;Skript
multipage_tiff.bat [Quellordner] [Zielordner]

;Rückgabewert für erfolgereiche Ausführung = Ok

===Multipage PDF Dateien aus TIFF-Dateien erzeugen===

TIF '''—>''' create JPG '''—>''' create multipage PDF

Ein For Loop über eine Liste aller TIF Bilddateien aus einem Ordner ruft ImageMagick auf und übergibt den Namen der Datei und die Parameter für die Umwandlung. Die JPG werden im Quellordner der TIF Dateien erzeugt.

Kommt es bei der Umwandlung zu JPG zu Fehlern, bricht das Skript ab und löscht die bereits erstellen JPG Dateien wieder. Der Name der fehlerverursachenden TIF Datei wir in errfile.txt im Quellordner gespeichert.

Wurden alle Dateien umgewandelt wird im zweiten Schritt aus diesen wieder mit ImageMagick ein PDF erstellt. Das PDF wird im Zielpfad gespeichert.

Bei Fehlern beim Erzeugen der PDF Datei werden alle bisher erzeugten Dateien gelöscht und der Name der verursachenden JPG Datei in errfile.txt im Quellordner gespeichert.

;Skript - Multipagepdf.bat Quellpfad Zielpfad (Standard JPG Qualität = 70)

::parameter für Pfade setzten
set pathfrom=%1
set pathto=%2

:convert_to_jpg,
FOR /F "tokens=*" %%G IN ('dir /b %pathfrom%\*.tif') DO (
magick mogrify -format jpg -quality 70 %pathfrom%\%%G 2>%pathfrom%\errlog.txt
if errorlevel 1 (
set err=1
ECHO %%G >> %pathfrom%\errfile.txt ) )
If "%err%"=="1" (
del %pathfrom%\*.jpg
echo Fehler beim JPG erstellen
exit )

:create_pdf
magick convert -define registry:temporary-path=d:\tmp %pathfrom%\*.jpg %pathto%\0001.pdf 2>>%pathfrom%\errlog.txt
if errorlevel 1 (
del %pathfrom%\*.jpg
del %pathto%\0001.pdf
echo Fehler beim PDF erstellen
exit )
:end
del %pathfrom%\*.jpg
del %pathfrom%\*.txt
echo Ok
exit

Alternativ dazu gibt es das Skript '''multipagepdf100.bat'''. HIer wird die Qualität des JPG auf 100% gesetzt

Alternativ dazu gibt es das Skript '''multipagepdf75.bat'''. HIer wird die Qualität des JPG auf 75% gesetzt

Alternativ dazu gibt es das Skript '''tiffzip2pdf.bat'''. Hier werden die Tiff-Dateien mit Zip-Kompression in das PDF eingesetzt. Es findet keine zwischenzeitliche Umwandlung in JPG statt.

Alternativ dazu gibt es das Skript '''multipagepdf2k40.bat'''. Hier werden die Tiff-Dateien in JPEG2000 Dateien umgewandelt mit Qualitätseinstellung 40.

Alternativ dazu gibt es das Skript '''multipagepdf_lonza_backq.bat'''. Ist identisch mit '''multipagepdf.bat''', es ist jedoch stabliler hinsichtlich Sonderzeichen in den Pfadnamen (Wie z.B. Klammern () ). Der aktuelle Name wurde gewählt, weil es z.Z. nur für einen Auftrag mit Klammern im Produktionspfad erstellt wurde, jedoch noch nicht endgültig als Ersatz für '''multipagepdf.bat''' freigegeben wurde.

===Multipage PDF-Dateien aus JPG-Dateien erzeugen===
Mit diesem Skript wird die Orientierung in den EXIF nicht berücksichtigt:

;Skript - Multipagepdf2.bat Quellpfad Zielpfad:

In den EXIF gespeicherte Orientierung berücksichtigen (= Bild automatisch drehen):

;Skript - Multipagepdf2o.bat Quellpfad Zielpfad:

===Umwandeln von TIFF-Dateien in JPG2000-Dateien===
;Skript - tif2jp2.bat Quellpfad Zielpfad:

===Umwandeln von TIFF-Dateien in JPG-Dateien===
;Skript - tif2jpg.bat Quellpfad Zielpfad:

=== Multipage PDF-Dateien aus JPEG2000 Dateien erzeugen===

Da beim erzeugen des PDF die JPEG2000 Dateien dekomprimiert und ggf. nochmals neu komprimiert werden, empfiehlt es sich beim konvertieren von Ausgangsmaterial (z.B. TIF Dateien) zu JPEG2000, verlustfrei vor zu gehen. 
Es ist zwar von minimsten Verlusten auszugehen, wenn das Material zwei mal mit der gleichen kompressionrate verarbeitet wird. 
Da ein möglicher zusätzlicher Verlust an Bildinformation (und auch Rechenzeit) so vermeidbar ist, wäre dies der optimalste Weg. 

;Skript
Multipagepdf2k40.bat [pfadVon] [pfadZu] pixeldensity quality(0-100)
Bsp.: Multipagepdf2k40.bat [Quellordner] [Zieordner] 300 75

::parameter für Pfade setzten

set pathfrom=%~1
set pathto=%~2
set density=%3
::set resample=%4
set quality=%4

IF NOT DEFINED pathfrom exit
IF NOT DEFINED pathto exit
IF NOT DEFINED density set density=300
IF NOT DEFINED quality set quality=40

:convert_to_jpg
FOR /F "tokens=*" %%G IN ('dir /b %pathfrom%\*.tif') DO (

magick "%pathfrom%\%%G" -format jp2 -quality 0 "%pathfrom%\%%G.jp2" 2>%pathfrom%\errlog.txt

if errorlevel 1 (
pause
set err=1
ECHO %%G >> %pathfrom%\errfile.txt
)
)

If "%err%"=="1" (
del %pathfrom%\*.jp2
echo Fehler beim JP2 erstellen
exit
)

:create_pdf
magick -define registry:temporary-path=d:\tmp %pathfrom%\*.jp2 -density %density% -resample %density%x%density% -compress JPEG2000 -quality %quality% %pathto%\0001.pdf 2>>%pathfrom%\errlog.txt
if errorlevel 1 (
del %pathfrom%\*.jp2
del %pathto%\0001.pdf
echo Fehler beim PDF erstellen
exit
)

:end
del %pathfrom%\*.jp2
del %pathfrom%\*.txt
echo Ok
::exit

Beim umwandeln zum Format JPEG2000 kann die DPI Auflösung nicht gesteuert werden, bzw. wird immer auf 72DPI gerechnet und daraus die Dokumentengrösse abgeleitet in cm in die Datei eingebettet. 
Dies hat zur Folge, dass die Dokumente welche z.B. von 300DPI runtergerechnet wurden, anschliessend im PDF zu gross (Dokumentgrösse) erscheinen falls die gewünschten Einstellungen nicht korrekt gesetzt werden. 
Mit der Option -Density kann beim erzeugen des PDF's der DPI Wert angegeben werden. Mit der Option -resample kann das eingehende Format auf das Ausgangsformat umgerechnet werden.
-density 200 -resample 98x98
-density 300 -resample 300x300

Beim konvertieren zu PDF werden die JPEG2000 Datei ohne Paramter nicht komprimiert eingebettet was ggf. zu grossen PDF Dateien führt. 
Deshalb geben wir folgende Parameter mit:
-compress JPEG2000 -quality 0 (verlustfrei)
-compress JPEG2000 -quality 40 (gutes verhältniss kompression / verlust)

===JPG2000 zu PDF Dateien verbinden===
; Skript - multipagepdf2k.bat source destination density quality:
Das Skript wandelt jpg2000 Dateien zu PDFs.
Parameter:
* source
* destination
* density: Die Auflösung, Standard ist 300 dpi
* quality: Die Qualität, Standard ist 40

===Zwei PDF Dateien zu einer verbinden und umbenennen===

Das Skript kann nur gestartet werden, wenn [Quellordner] und [Zielordner] mitgegeben wurden.

Beachte: '''Die Deckblätter müssen zwingend auf '_Beleg.PDF' lauten.'''

; Skript - mergePDF.bat source destination:

@echo off
::Randbedingungen: Es darf nur 2 Files im Ordner haben, der Beleg muss Namentlich vor der Zielpdf im Dateisystem sein
::Wurden 2 Parameter übergeben?

IF [%1] == [] (exit -1)
IF [%2] == [] (exit -1)
:: Vars setzten
set source=%1
set destination=%2
set fixedPDF=_Beleg.pdf
set pdftkPath=C:\Program Files (x86)\PDFtk Server\bin\pdftk.exe

::Existiern diese beiden Ordner?
IF NOT EXIST %source% (exit -2)
IF NOT EXIST %destination% (exit -3)

::Source so setzten, dass alle PDF's im Verzeichnis aufgelistet werden
set sourceSearch=%source:~0,-1%
set sourceSearch=%sourceSearch%\*.pdf

::Name des 2. PDF's herausfinden
for /f %%a IN ('dir /b /s "%sourceSearch%"') do (
set targetPDF=%%a
GOTO mergePDF )

:mergePDF
::Pfad des Beleg PDF
set firstPDF=%source:~0,-1%
set firstPDF=%firstPDF%\%fixedPDF%

::Pfad des Output PDF's festlegen
for %%b in (%targetPDF:\= %) do set targetPDFName=%%b
set destinationPath=%destination:~0,-1%
set destinationPath=%destination%\%targetPDFName%

::PDF mergen
"%pdftkPath%" A=%firstPDF% B=%targetPDF% cat A B output %destinationPath% 2> err.txt
for /f %%i in (err.txt) do (exit -4)
echo ok
exit

===Erste Seite eines PDF Dokumentes in ein TIF Bild extrahieren===

;Skript
pdf2tif.bat [Quellordner] [Zielordner] [density (default 300)]

Kopiert alle Dateien ausser PDFs von [Quellordner] nach [Zielordner].

Erwartet genau eine PDF Datei in [pfadVon] und extrahiert daraus die erste Seite in ein TIF mit dem selben Namen wie das ursprungs PDF unter [Zielordner].

Sind mehrere PDF's vorhanden, wird alphabetisch geordnet das erste davon genommen.

===Bekannte Fehlermeldungen===

2500 - Die Skriptdatei wurde nicht gefunden. Prüfe ob die Datei am genannten Pfad vorhanden ist, oder ob der Korrekte Pfad/Name zu dem Skript im Arbeitsschritt eingerichtet wurde.

2501 - Bei der Ausführung des Skriptes sind Fehler aufgetreten. Siehe weitere Infos im Fehlertext.

==Image Magick - Parameter und Optionen ==

-auto-orient (Berücksichtigt EXIF Orientierungsinformationen und dreht das Bild entsprechend.)

[[Kategorie:Workflowschritt]]

Verfügbare Funktionen

2025-08-01T09:27:10Z

Stefan: 3524 Neue Funktion

Die hier gelisteten Funktionen lassen sich bei allen Workflowschritten anwenden, welche einen Link zu dieser Seite besitzen.

==Funktionen==

'''Beachte:''' Die Metadatumsfelder sind hier unbedingt als String ('Metadatum') zu übergeben und nicht wie andersweitig in eckigen Klammern.

===§getQuittungsFeld===

Holt den Wert aus einem Quittungsfeld. Das Objekt muss dazu eine Quittung besitzen. Es wird immer auf die letzte erstellte Quittung zurückgegriffen. Aktuell werden Quittungsdetail im JSON Format unterstützt.

Die Funktion erwartet einen gültigen Pfad zu einem JSON Member, oder anderst gesagt den Schlüssel zu einem Attribut in dem JSON. (JSON Pfade der Quittung finden: Siehe [[Warten auf Rückmeldung]])

§getQuittungsFeld('pfad.zu.dem.gewünschten.feld')

===§istInWortliste===

Ermittelt ob ein Metadatum in einer Wortliste vorkommt; wobei 1 = kommt vor, 0 = kommt nicht vor.

Die Wortliste ist als [https://helper.ch/wiki/index.php?title=Konfiguration Konfigurationsdatensatz] zu erstellen. Der Name der erstellen Wortliste wird als Parameter zum finden der Liste benötigt.

§istInWortliste(Metadatumsname,Wortlistenname,Suchtyp,Zeilenumbruchtyp)

;Metadatumsname: Wert des Metadatums, zB 'Eugen' oder [Vorname]
;Wortlistenname: Name der Wortliste, also des Konfigurationsdatensatzes.
;Suchtyp: 0=Es wird genau nach dem Wert gesucht (Standard), 1=Findet auch 'Hans', wenn in der Wortliste 'Eugen Hans' oder 'Hans-Peter' steht
;Zeilenumbruchtyp: Welcher Zeilenumbruch wird in der Wortliste verwendet: 0=Zeilenumbruch ist 'CR' (Standard), 1=Zeilenumbruch ist 'CRLF'

Bsp.: Es wurde eine Liste mit Vornamen in der Konfiguration erstellt. Diese Liste lautet auf den Namen "Vornamenkonfiguration". Ein Metadatum "Vorname" wurde erstellt, dort wurden zuvor Vornamen gespeichert.

§istInWortliste('Vorname','Vornamenkonfiguration')

===§getConfidenceOfWordInRegionXML===

Gibt die vom OCR ermittelte Konfidenz zu einem gefundenen Begriff zurück und schreibt den Wert in ein Metadatum. Erlaubt optional die Angabe eines Einschräkungsbereiches, in welchem der gesuchte Begriff vorkommen muss.

Der Bereich ist als Row(left,top,width,height) anzugeben: §getConfidenceOfWordInRegionXML('Suchwort',row(left,top,width,height))

Bsp.:
§getConfidenceOfWordInRegionXML('London',row(57,154,75,25))

0 = Begriff nicht gefunden
0.1 - 100 = Konfidenz des gefundenen Begriffes

===§KinderWertATMin(AttributName) und §KinderWertATMax(AttributName)===

Gibt den kleinsten oder den grössten Wert eines Metadatums mit dem gegebenen Atrributnamen von den direkten Nachfahren des Objektes zurück.

Berücktichtigt den Datentyp für die Sortierung, falls dieser beim Attribut angegeben wurde. Bei Datumstypen ist Min das jüngste und Max das älteste.

Gibt das ermittelte Metadatum zurück.

===§KinderWertATStetig(AttributName,Min,Max)===

Prüft ob ein Nachfahre des Objektes mit dem gegebenen Attributnamen im Bereich Min-Max eine stetige Zahlenfolge besitzt.

Eignet sich z.B. um zu ermitteln, ob die Seitenzahlen der Kindobjekte im Metadatum mit dem Attributsnamen "Seitenzahl" zwischen den Werten 1-20 alle vorhanden sind.

Gibt wahr oder falsch zurück.

===§istMin und §istMax===

Vergleicht von DO Objekten die Attributswerte des angegebenen Attributs miteinander, und ermittelt ob das DO den grössten oder den kleinsten Wert der verglichenen Objekte besitzt. Alle DO Typen, welchen den gleichen Attributsnamen besitzen, werden für den Vergleich herbeigezogen. 
Die Hierarchiestufe der Objekte kann, ausgehend vom Objekt eingeschränkt werden. 

Pflicht: Metadatumsname, Hierarchieebene 
Optional: Metadatumsname2 (Ohne Metadatumsname2 werden allein die gefundenen Metadaten aus Metadatumsname verglichen, mit werden nur diejenigen Objekte welche den gleichen Wert in Metadatumsname2 haben verglichen). 

§istMax(Metadatumsname,Hierachieebene,Metadatumsname2)
§istMax(Metadatumsname,../-2/-1/0/1/2/..,Metadatumsname2)
§istMin(Metadatumsname,../-2/-1/0/1/2/..,Metadatumsname2)

Bsp.:
'''§istMax('AnzahlDok',1,'Büronummer')''' Gibt 1 zurück, wenn das Objekt den grössten Wert im Attribut 'AnzahlDok' hat, innerhalb der eigenen Tranche und der gleichen Büronummer.

'''Parameter'''

Metadatumsname: Der Name des Metadatums

Hierachieebene: (Einschränkung)
* 0 = Alle DO des Auftrages (=keine Einschränkung)
* 1 = Alle DO mit dem selben Vorfahren auf Ebene 1 (typischerweise alle Objekte einer Tranche, inklusive der Tranche)
* 2 = Alle DO mit dem selben Vorfahren auf Ebene 2
* 3 = Alle DO mit dem selben Vorfahren auf Ebene 3
* etc.
* -1 = Alle auf der gleichen Ebene wie das DO Objekt, inklusive des Vorfahren
* -2 = Alle 2 Ebenen höher als das DO Objekt

Metadatumsname2: Schränkt die betrachteten Dos ein. Es werden nur die DO angesehen, die den gleichen Wert im Attribut '''Metadatumsname2''' haben.

===§sortierung===

Gibt die Sortierreihenfolge des Objektes zurück. Analog zu verwenden wie $min/$max.

§sortierung(Metadatumsname,../-2/-1/0/1/2/.., Metadatumsname2,0/1)

Bsp:
§sortierung('Büronummer',-1,'Metadatumsname2',0)

'''Parameter'''

Metadatumsname: Der Name des Metadatums

Hierachieebene: (Einschränkung)
* 0 = Alle DO des Auftrages (=keine Einschränkung)
* 1 = Alle DO mit dem selben Vorfahren auf Ebene 1 (typischerweise alle Objekte einer Tranche, inklusive der Tranche)
* 2 = Alle DO mit dem selben Vorfahren auf Ebene 2
* 3 = Alle DO mit dem selben Vorfahren auf Ebene 3
* etc.
* -1 = Alle auf der gleichen Ebene wie das DO Objekt, inklusive des Vorfahren
* -2 = Alle 2 Ebenen höher als das DO Objekt

Metadatumsname2: Schränkt die betrachteten Dos ein. Es werden nur die DO angesehen, die den gleichen Wert im Attribut '''Metadatumsname2''' haben.

Sortierreihenfolge: 0 = Aufwärts, 1 = Abwärts

===§istEindeutig===

Prüft ob für ein DO Objekt ein bestimmtes Metadatum im Vergleich zu weiteren DOs eindeutig ist. Vergleiche sind mit DOs auf wählbarer Hierarchieebene sowie mit gleichem oder abweichendem DO Typ möglich.

§istEindeutig(Metadatumsname, 0/1/2, 0/1/2[,DO Typen])
§istEindeutig(Metadatumsname, Hierarchieebene, Typ-Einschränkung[,'Typ1,Typ2,..'])

'''Parameter'''
Metadatumsname: Der Name des Metadatums
Bereich: 0 = Ganzer Auftrag, alle DO dieses Auftrages, 1 = Alle DO auf Ebene 1, 2 = Alle DO auf Ebene 2
Typ-Einschränkung: 0 = Alle Typen mit dem gleichen Metadatumsname, 1 = Gleicher Typ wie das Vergleichsobjekt, 2 = Alle im zwingend folgenden Parameter angegebenen Typen

'''Anwendung'''
§istEindeutig('Verlag',0,0) Alle DO des Auftrages, welche bei einem beliebiegen DO Typ und dem Attribut 'Verlag' das selbe Metadatum besitzen
§istEindeutig('Verlag',1,1) Alle DO auf Ebene 1, welche zum gleichen Typ und dem Attribut 'Verlag' das selbe Metadatum besitzen
§istEindeutig('Verlag',2,0) Alle DO auf Ebene 2, welche bei einem beliebiegen Typ und dem Attribut 'Verlag' das selbe Metadatum besitzen
§istEindeutig('Verlag',2,1) Alle DO auf Ebene 2, welche zum gleichen Typ und dem Attribut 'Verlag' das selbe Metadatum besitzen
§istEindeutig('Verlag',2,2,'Buch, Magazin, Zeitung') Alle DO auf Ebene 2, welche zu den angegebenen Typen 'Buch, Magazin, Zeitung' und dem Attribut 'Verlag' das selbe Metadatum besitzen

Fehleingabe vermeiden:
§istEindeutig('Verlag',2,2) Es wird eine Typeinschränkung (Parameter drei = 2) verlangt, ohne nachfolgende die gesuchten Typen zu nennen.

===§KindNr===

Diese Methode gibt zurück, das wievielte Kind das Objekt ist.

§KindNr()

Bsp:
Das Objekt hat 5 Geschwister und ist als viertes erstellt worden. Somit gibt die Methode §KindNr 4 zurück.

===§sortierungSignatur===

Diese Methode gibt zurück, die Position des Objektes von allen Objekten mit der gleichen Signatur.

§sortierungSignatur()

Bsp:
Gegeben:
Objekt 1 mit Signatur 'A'
Objekt 2 mit Signatur 'B'
Objekt 3 mit Sigantur 'A'
Objekt 4 mit Signatur 'A'
Objekt 5 mit Signatur 'C'

Wird zurückgegeben:
Objekt 1 -> 1 (weil es das erste Objekt ist mit Signatur 'A')
Objekt 2 -> 1 (weil es das erste Objekt ist mit Signatur 'B')
Objekt 3 -> 2 (weil es das zweite Objekt ist mit Signatur 'A')
Objekt 4 -> 3 (weil es das dritte Objekt ist mit Signatur 'A')
Objekt 5 -> 1 (weil es das erste Objekt ist mit Signatur 'C')

===§minX===

Bevor diese Methode ausgeführt werden kann, muss der Schritt [[Files messen]] gemacht werden.
Diese Methode gibt die kleinstmögliche Breite des Objektes nachdem die [[Files messen|Files gemessen]] wurden an, grösser oder gleich dem Parameter.
Es werden alle Files ausgewertet ausser PDFs.
Die Methode erwartet eine Zahl als Pixel-Wert.

§minX(minimumPixel)

Bsp:
Objekt mit folgenden Files: auto.jpg (Breite: 100), baum.jpg (Breite:200), clown.jpg (Breite:110)
Methode §minX(105) gibt 110 zurück
Methode §minX(110) gibt 110 zurück
Methode §minX(150) gibt 200 zurück

===§minY===

Bevor diese Methode ausgeführt werden kann, muss der Schritt [[Files messen]] gemacht werden.
Diese Methode gibt die kleinstmögliche Höhe des Objektes nachdem die [[Files messen|Files gemessen]] wurden an, grösser oder gleich dem Parameter.
Es werden alle Files ausgewertet ausser PDFs.
Die Methode erwartet eine Zahl als Pixel-Wert.

§minY(minimumPixel)

Bsp:
Objekt mit folgenden Files: auto.jpg (Höhe: 100), baum.jpg (Höhe:200), clown.jpg (Höhe:110)
Methode §minY(105) gibt 110 zurück
Methode §minY(110) gibt 110 zurück
Methode §minY(150) gibt 200 zurück

===§OCRTextRegion===

Führt OCR auf einer bestimmen Seitennummer (einzelne Bild Datei!) in einer bestimmten Region aus, und gibt als Resultat den gefundenen Text zurück. Dieser Text lässt sich dann z.B. in ein Metadatum übertragen.

Die Seitennummer wird über die Sortierreihenfolge der Dateinamen im Dateisystem bestimmt. Es werden TIFF, JPG und PNG als Dateiformate unterstützt.

Die wählbare Region, welche eine rechteckige Selektion ist, wird über die Koordinaten X1,X2,Y1,Y2 in Pixel definiert. Wobei X1=linker Rand, X2=rechter Rand, Y1=oberer Rand, Y2=unterer Rand.

'''Wenn für die Koordinaten negative Werte eingesetzt werden, so werden die Positionen relativ zur Bildgrösse und ausgehend vom rechten oder unteren Bildrand berechnet!'''

§OCRTextRegion(Seite,X1,X2,Y1,Y2)

Bsp: Seite Nummer 5 (entspricht Datei Nummer 5). Bilddimensionen: 2663 Breite x 3603 Höhe

§OCRTextRegion(5,359,709,631,690) -> entspricht einem Auswahlrechteck mit Abstand Links=359, Abstand oben=631, Breite=350, Höhe=59

§OCRTextRegion(5,-2304,709,-2972,690) -> entspricht genau dem gleichen Auswahlrechteck mit Abstand Links=359, Abstand oben=631, Breite=350, Höhe=59 ''' weil das Bild die gleiche Dimension besitzt!'''

§OCRTextRegion(5,-2304,-1954,-2972,-2913) -> entspricht genau dem gleichen Auswahlrechteck mit Abstand Links=359, Abstand oben=631, Breite=350, Höhe=59 '''weil das Bild die gleiche Dimension besitzt!'''

===§FileAnzahl===

Diese Methode gibt dir Anzahl Dateien am aktuellen Datenschritt des Objektes zurück. Dabei werden alle Dateien auch in allen Unterordnern gezählt. Unsichtbare Dateien sowie die Ordner selbst zählen nicht.

§FileAnzahl()

===§Hausnummer===
Diese Methode formatiert einen Hausnummer.
§Hausnummer(Wert)

Beispiele:
12 -> 012
123 -> 123
12a -> 012a
2a -> 002a

===§KinderSummeAT===
Gibt die Summe der Werte des Attributs aller Kinder zurück, nicht rekursiv, also nur der direkten Kinder.
§KinderSummeAT('Attribut')

===§KinderWertAT===
Gibt den Wert des Attributs des ersten Kindes zurück. Idealerweise hat es nur ein Kind. Sonst wir das erste genommen.
§KinderWertAT('Attribut')

===§isJSONValid===
Prüft ob ein Attribut ein valides JSON ist. Gibt Wahr (true) oder Falsch (false) zurück.
§isJSONValid('JSON')

===§StrasseAusschreiben===
Diese Methode prüft ob ein Strassennamen (mit oder ohne Hausnummer) schön formatiert ist. Dabei wird jeder Anfangsbuchstabe in einen Grossbuchstaben geändert. "str" und "str." werden zu "strasse" ausgeschrieben.

§StrasseAusschreiben('Strasse')

====Beispiele====
Teststr 58A => Teststrasse 58A
zUr lindENstr. => Zur Lindenstrasse
Hofweg 68 => Hofweg 68

==Weitere Beispiele==
§OCRMatchCount('Bericht')>0 ==> Falls das Wort Bericht mindestens 1 Mal gefunden wurde ist der Ausdruck wahr 
§OCRMatchCount('[0-9][0-9][.]')=0 ==> Falls KEINE 2 stellige Zahl mit einem Punkt gefunden wird ist der Ausdruck wahr 
§OCRMatchCount('[BelegName]')>2 ==> Falls der Wert des Attributes BelegName mehr als 2 mal gefunden wird ist der Ausdruck wahr 
§OCRMatchCount('[BelegName]',1)>0 ==> Falls der Wert des Attributes BelegName mindestens einmal im OCR der Kindern gefunden wurde.

RestAPI Services Up-/Download

2025-07-25T13:21:27Z

Stefan: 3518 /* Verfügbare Anbieter */

;Mantiseinträge:
3518
;Systemtyp:
77
;Eintrittsinvarianz: JA

==Beschreibung==

Besteht aus zwei Serverjobs, analog zum Schritt [[Files kopieren]]. Lädt Dateien oder weitere Daten zur Bearbeitung zu einer REST Schnittstelle hoch und lädt dies anschliessend wieder zurück.

Es können unterschiedliche Anbieter und deren Dienste damit angebunden werden.

Das Hoch- und das Herunterladen werden in ein und dem selben Arbeitsschritt dargestellt und ausgeführt. Die Objekte welche bereits hochgeladen wurden behalten den Status "In Arbeit", bis diese erfolgreich abgeholt wurden. Danach gehen sie zum nächsten Arbeitsschritt.

Für die Serverjobkonfiguration sind die Schritte auf zwei Unterschiedliche Jobs verteilt.

'''OJOHZDORestApiUpload'''

Sendet Daten zu einem REST Dienst.

'''OJOHZDORestApiDownload'''

Empfängt Daten von einem REST Dienst.

==Konfiguration==

Das Konfigurationsfenster besteht jeweils aus zwei Teilen:

* Auswahl und Konfiguration des API Anbieter
* Auswahl und Konfiguration eines verfügbaren API Befehls

Die Konfiguration ist je nach Anbieter unterschiedlich. In der Regel verlangt jeder Anbieter eine Authentifizierung und Authorisierung. Dies wird meistens in Form einers API-Keys (Token) gehandhabt.

Ein Wechsel zwischen Anbieter und/oder Befehlen hat die Löschung der aktuellen Konfiguration zur Folge und muss deshalb zusätzlich bestätigt werden.

Der Schritt hat genau einen Ausgang.

==Verfügbare Anbieter==

=== Azure AI Services ===

Dies ist eine Cognitive Service Anwendung von Microsoft Azure zur AI unterstützen Erkennung von Dokumenteninhalten.

==== '''API Konfiguration''' ====

Die API verlangt den Endpunkt URL (API Pfad) und den API Key der zugehörigen Document Intelligence Resource in Azure.

[[Datei:AzureAPIServices.png]]

==== '''API Befehle''' ====

===== ''Durchsuchbares PDF (OCR)'' =====

Aktuell wird nur die Verarbeitung von PDF Dateien unterstützt. Es wird nur eine PDF Datei verarbeitet. Falls sich mehrere Dateien im Quellordner befinden, so wird entsprechend der Dateisystemsortierung die erste davon genommen.

Die API Version 4.0 ist die Standardversion.

[[Datei:SearchPDF.png]]

Datei:SearchPDF.png

2025-07-25T13:19:06Z

Stefan:

Datei:AzureAPIServices.png

2025-07-25T13:17:20Z

Stefan:

RestAPI Services Up-/Download

2025-07-25T13:12:26Z

Stefan:

;Mantiseinträge:
3518
;Systemtyp:
77
;Eintrittsinvarianz: JA

==Beschreibung==

Besteht aus zwei Serverjobs, analog zum Schritt [[Files kopieren]]. Lädt Dateien oder weitere Daten zur Bearbeitung zu einer REST Schnittstelle hoch und lädt dies anschliessend wieder zurück.

Es können unterschiedliche Anbieter und deren Dienste damit angebunden werden.

Das Hoch- und das Herunterladen werden in ein und dem selben Arbeitsschritt dargestellt und ausgeführt. Die Objekte welche bereits hochgeladen wurden behalten den Status "In Arbeit", bis diese erfolgreich abgeholt wurden. Danach gehen sie zum nächsten Arbeitsschritt.

Für die Serverjobkonfiguration sind die Schritte auf zwei Unterschiedliche Jobs verteilt.

'''OJOHZDORestApiUpload'''

Sendet Daten zu einem REST Dienst.

'''OJOHZDORestApiDownload'''

Empfängt Daten von einem REST Dienst.

==Konfiguration==

Das Konfigurationsfenster besteht jeweils aus zwei Teilen:

* Auswahl und Konfiguration des API Anbieter
* Auswahl und Konfiguration eines verfügbaren API Befehls

Die Konfiguration ist je nach Anbieter unterschiedlich. In der Regel verlangt jeder Anbieter eine Authentifizierung und Authorisierung. Dies wird meistens in Form einers API-Keys (Token) gehandhabt.

Ein Wechsel zwischen Anbieter und/oder Befehlen hat die Löschung der aktuellen Konfiguration zur Folge und muss deshalb zusätzlich bestätigt werden.

Der Schritt hat genau einen Ausgang.

==Verfügbare Anbieter==

=== Azure AI Services ===

Dies ist eine Cognitive Service Anwendung von Microsoft Azure zur AI unterstützen Erkennung von Dokumenteninhalten.

==== '''API Konfiguration''' ====

Die API verlangt den Endpunkt URL (API Pfad) und den API Key der zugehörigen Document Intelligence Resource in Azure.

[[Datei:azure_api.png]]

==== '''API Befehle''' ====

===== ''Durchsuchbares PDF (OCR)'' =====

RestAPI Services Up-/Download

2025-07-25T12:57:38Z

Stefan: /* Beschreibung */

RestAPI Services Up-/Download

2025-07-25T12:57:26Z

Stefan: Neue Seite für REST API Services

Übersicht über alle Workflowschritte

2025-07-25T12:39:35Z

Stefan: Neue Schritte

{|class="sortable wikitable zebra toptextcells"
! SYSTEMTYP !! BEZEICHNUNG
|-
| 0 || [[Normaler Arbeitsschritt]]
|-
| 1 || [[Bedingung]]
|-
| 2 || [[Kontrollieren]]
|-
| 3 || [[Korrigieren]]
|-
| 4 || [[Interaktion]]
|-
| 5 || [[Files kopieren]]
|-
| 6 || [[Objekterstellung]]
|-
| 7 || [[Objekterstellung2]]
|-
| 8 || [[SFTP-Upload]]
|-
| 9 || [[Formatvergrösserung]]
|-
| 10 || [[Bildbearbeitung (Client)]]
|-
| 11 || [[Verzweigung nach Zufall]]
|-
| 12 || [[Filenamen ändern Metadaten]]
|-
| 13 || [[CheckIn]]
|-
| 14 || [[CheckOut]]
|-
| 15 || [[Daten löschen]]
|-
| 16 || [[Zusammenführen von Daten]] und [[Assistiertes Metadatieren]]
|-
| 17 || [[SFTP-Quittierung]]
|-
| 18 || [[Filetest]]
|-
| 19 || [[PDF-Metadaten]]
|-
| 20 || [[Auf Unterobjekte warten]]
|-
| 21 || [[Objekt Umwandlung/Verdoppelung]]
|-
| 22 || [[Verzweigung nach Metadaten]]
|-
| 23 || [[Metadaten umwandeln]]
|-
| 24 || [[Daten bewegen]]
|-
| 25 || [[Generischer CMD Code]]
|-
| 26 || [[Files messen]]
|-
| 27 || [[Bedingung nach Metadaten]]
|-
| 28 || [[Warte bestimmte Zeit]]
|-
| 29 || [[Serverjob zur Auftrennung von Objekten nach Barcodeblättern]]
|-
| 30 || [[Bild freistellen]]
|-
| 31 || [[Metadaten mit Anzeige des Files]]
|-
| 32 || [[Sammelblätter aufteilen]]
|-
| 33 || [[Bilder freistellen]]
|-
| 34 || [[Metadaten Datenbank]]
|-
| 35 || [[XML Metadaten File-Export]]
|-
| 36 || [[Beleg erstellen]]
|-
| 37 || [[WIA extern Kontrolle]]
|-
| 38 || [[Vorerfassung]]
|-
| 39 || [[Metadaten aus Bildfile lesen]]
|-
| 40 || [[QR-Code-File erstellen]]
|-
| 41 || [[Photoshop Skript verarbeiten]]
|-
| 42 || [[Bilder löschen]]
|-
| 43 || [[Objekttyp ändern]]
|-
| 44 || [[Objekthierarchie ändern]]
|-
| 45 || [[Duplikate auflösen]]
|-
| 46 || [[Hashfile erstellen]]
|-
| 47 || [[Files hinzufügen]]
|-
| 48 || [[Word Interaktiv]]
|-
| 49 || [[Word automatisch bearbeiten]]
|-
| 50 || [[Word File Info]]
|-
| 51 || [[Word konvertieren]]
|-
| 52 || [[Kunde Informieren]]
|-
| 53 || [[Dokument versenden]]
|-
| 54 || [[Kinder/Enkel zuweisen]]
|-
| 55 || [[PDF Bearbeitung]]
|-
| 56 || [[PDF Lesezeichen schreiben]]
|-
| 57 || [[Generische Verzweigung]]
|-
| 58 || [[GBA Auftragsübersicht]]
|-
| 59 || [[Filehandling]]
|-
| 60 || [[Barcode ersetzen]]
|-
| 61 || [[OCR Texterkennung]]
|-
| 62 || [[ICC-Profil Bearbeiten]]
|-
| 63 || [[KOST-Val Validierung]]
|-
| 64 || [[REST-Service]] (Server)
|-
| 65 || [[Bildbearbeitung (serverseitig)]]
|-
| 66 || [[Rahmen setzen]] (Client)
|-
| 67 || [[Bilderstellung]] (Server)
|-
| 68 || [[Metadaten Einlesen]] (Server)
|-
| 69 || [[REST API]] (Server)
|-
| 70 || [[Warten auf Rückmeldung]] (Server)
|-
| kein || [[Geleistete Arbeit]]
|-
| 71 || [[Seitenrahmen finden]] (Server)
|-
| 72 || [[Seitenrahmen kontrollieren]]
|-
| 73 || [[Bilderstellung aus Rahmen]] (Server)
|-
| 74 || [[Warten nach Objekttyp]] (Server)
|-
| 75 || [[Format anpassen]]
|-
| 76 || [[Generische Vorerfassung]]
|-
| 77 || [[RestAPI Services Up-/Download]] (Server)
|}
[[Kategorie:Workflowschritt]]
[[Kategorie:Workflowschritt]]

Übersicht über alle Workflowschritte

2025-07-25T12:37:34Z

Stefan:

{|class="sortable wikitable zebra toptextcells"
! SYSTEMTYP !! BEZEICHNUNG
|-
| 0 || [[Normaler Arbeitsschritt]]
|-
| 1 || [[Bedingung]]
|-
| 2 || [[Kontrollieren]]
|-
| 3 || [[Korrigieren]]
|-
| 4 || [[Interaktion]]
|-
| 5 || [[Files kopieren]]
|-
| 6 || [[Objekterstellung]]
|-
| 7 || [[Objekterstellung2]]
|-
| 8 || [[SFTP-Upload]]
|-
| 9 || [[Formatvergrösserung]]
|-
| 10 || [[Bildbearbeitung (Client)]]
|-
| 11 || [[Verzweigung nach Zufall]]
|-
| 12 || [[Filenamen ändern Metadaten]]
|-
| 13 || [[CheckIn]]
|-
| 14 || [[CheckOut]]
|-
| 15 || [[Daten löschen]]
|-
| 16 || [[Zusammenführen von Daten]] und [[Assistiertes Metadatieren]]
|-
| 17 || [[SFTP-Quittierung]]
|-
| 18 || [[Filetest]]
|-
| 19 || [[PDF-Metadaten]]
|-
| 20 || [[Auf Unterobjekte warten]]
|-
| 21 || [[Objekt Umwandlung/Verdoppelung]]
|-
| 22 || [[Verzweigung nach Metadaten]]
|-
| 23 || [[Metadaten umwandeln]]
|-
| 24 || [[Daten bewegen]]
|-
| 25 || [[Generischer CMD Code]]
|-
| 26 || [[Files messen]]
|-
| 27 || [[Bedingung nach Metadaten]]
|-
| 28 || [[Warte bestimmte Zeit]]
|-
| 29 || [[Serverjob zur Auftrennung von Objekten nach Barcodeblättern]]
|-
| 30 || [[Bild freistellen]]
|-
| 31 || [[Metadaten mit Anzeige des Files]]
|-
| 32 || [[Sammelblätter aufteilen]]
|-
| 33 || [[Bilder freistellen]]
|-
| 34 || [[Metadaten Datenbank]]
|-
| 35 || [[XML Metadaten File-Export]]
|-
| 36 || [[Beleg erstellen]]
|-
| 37 || [[WIA extern Kontrolle]]
|-
| 38 || [[Vorerfassung]]
|-
| 39 || [[Metadaten aus Bildfile lesen]]
|-
| 40 || [[QR-Code-File erstellen]]
|-
| 41 || [[Photoshop Skript verarbeiten]]
|-
| 42 || [[Bilder löschen]]
|-
| 43 || [[Objekttyp ändern]]
|-
| 44 || [[Objekthierarchie ändern]]
|-
| 45 || [[Duplikate auflösen]]
|-
| 46 || [[Hashfile erstellen]]
|-
| 47 || [[Files hinzufügen]]
|-
| 48 || [[Word Interaktiv]]
|-
| 49 || [[Word automatisch bearbeiten]]
|-
| 50 || [[Word File Info]]
|-
| 51 || [[Word konvertieren]]
|-
| 52 || [[Kunde Informieren]]
|-
| 53 || [[Dokument versenden]]
|-
| 54 || [[Kinder/Enkel zuweisen]]
|-
| 55 || [[PDF Bearbeitung]]
|-
| 56 || [[PDF Lesezeichen schreiben]]
|-
| 57 || [[Generische Verzweigung]]
|-
| 58 || [[GBA Auftragsübersicht]]
|-
| 59 || [[Filehandling]]
|-
| 60 || [[Barcode ersetzen]]
|-
| 61 || [[OCR Texterkennung]]
|-
| 62 || [[ICC-Profil Bearbeiten]]
|-
| 63 || [[KOST-Val Validierung]]
|-
| 64 || [[REST-Service]] (Server)
|-
| 65 || [[Bildbearbeitung (serverseitig)]]
|-
| 66 || [[Rahmen setzen]] (Client)
|-
| 67 || [[Bilderstellung]] (Server)
|-
| 68 || [[Metadaten Einlesen]] (Server)
|-
| 69 || [[REST API]] (Server)
|-
| 70 || [[Warten auf Rückmeldung]] (Server)
|-
| kein || [[Geleistete Arbeit]]
|-
| 71 || [[Seitenrahmen finden]] (Server)
|-
| 72 || [[Seitenrahmen kontrollieren]]
|-
| 73 || [[Bilderstellung aus Rahmen]]
|-
| 74 || [[Warten nach Objekttyp]]
|-
| 75 || [[Format anpassen]]
|-
| 76 || [[Generische Vorerfassung]]
|-
| 77 || [[RestAPI Services Up-/Download]]
|}
[[Kategorie:Workflowschritt]]
[[Kategorie:Workflowschritt]]

Datei:Digitalisierungssoftware.png

2025-05-28T13:45:27Z

Stefan: Stefan lud eine neue Version von Datei:Digitalisierungssoftware.png hoch

Normaler Arbeitsschritt

2025-05-28T13:44:02Z

Stefan: /* Digitalisierungssoftware */

;Mantiseinträge:
2237
;Systemtyp:
0

==Beschreibung==
Dieser Arbeitsschritt wird zB fürs Digitalisieren oder andere manuelle Tätigkeiten an Files verwendet. Er legt die Daten des vorherigen Arbeitschrittes eines Objektes in C:\Work\Input und erwartet die Daten nach der manuellen Bearbeitung in C:\Work\Output.
===Digitalisieren===
Digitalisieren Sie alles in C:\Work\Output.
===Manuelle Bearbeitung von Files===

===Leistungen===
Beim Starten des Schrittes wird Name und Änderungsdatum der Files im Ordner C:\Work\Output in einer Liste gespeichert. Am Beenden wird die Liste mit dem dann aktuellen Inhalt verglichen. Es können folgenden Leistungen vorkommen:
;Datei, Create: Eine Datei mit diesem Namen existierte beim Start noch nicht.
;Datei, Update: Eine Datei mit diesem Namen existierte beim Start schon, hat am Ende aber ein anderes Änderungsdatum.
;Datei, Delete: Eine Datei mit diesem Namen existierte beim Start, fehlt aber am Ende.
;Sonderobjekte: Ein Sonderobjekt wurde erstellt.

=Konfiguration=

* Generell

* File Test, Die Filetests sind hier nicht rekursiv. Es werden nur die Files auf der obersten Ebene im Arbeitsordner kontrolliert.

* Metadaten

* Ausgänge: Ermöglicht das Einrichten zusätzlicher Ausgänge für nachfolgende Arbeitsschritte

* Ausgang für hier erstellte Sonderobjekte: Sonderobjekte im Fenster Typ0 (nicht Typ0abc), die an diesem Schritt erstellt werden, nehmen nicht einen der im Workflow konfigurierten Ausgänge. Sie werden zu dem Schritt geleitet, den Sie im Fenster Produktionsauftrage im Register Produktionsschritte (unten rechts) eingeben können: '''Arbeitschritt für Sonderobjekte'''.

* Serien Nr. Scanner: Schreibt die Seriennummer eines Scanners in die Bilddatei. Ermöglicht die zwingende Angabe der Seriennummer eines verwendeten Eingabegerätes / Scanners beim starten des Arbeitsfensters.

==Einstellungsfenster==

[[File:FHZ_STyp000_1.png]]

===Serien Nr. Scanner===

Verlangt die Eingabe des Namens eines EXIF Feldes. '''Wenn dieses Feld hier gefüllt wurde, dann muss bei dem Arbeitsschritt beim starten zwingend eine Seriennummer angegeben werden.'''
Ohne die Eingabe einer gültigen Seriennummer wird das Arbeitsfenster nicht laufen.

Das EXIF Standard Feld für die Seriennummer lautet: '''SerialNumber'''

Die Seriennummern der Scanner werden beim beenden der Arbeit automatisch in alle Bilddateien geschrieben, bei welchen nicht bereits eine Seriennummer in dem angegebenen EXIF Feld enthalten ist.

'''Validierung der Geräteseriennummern'''

Es werden nur Seriennummer akzeptiert, welche entweder:

*in der Liste unterhalb erfasst wurden (Die Seriennummern sind Zeilenweise (Zeilenumbruch) zu trennen!)
*in den Anlagen erfasst, mit einer Maschine verknüpft, einem Maschinentyp zugeordnet und dieser Maschinentyp beim Arbeitsschritt unter "benötigter Maschinentyp" konfiguriert wurde.

[[File:FHZ_STyp000_snc.png]]

==Digitalisierungssoftware==

Ermöglicht die Angabe einer für den Job zum Einsatz kommenden Digitalisierungsoftware und ggf. von spezifischen Software Voreinstellungen.

Die Auswahl der benötigten Software über das Dropdown Menu lädt die dazugehörenden Einstellungsmöglichkeiten.

'''Die Checkbox "Bearbeitung ohne Digitalsierungssoftware erlauben" erlaubt den Start des Arbeitsfensters auch für den Fall, dass auf dem Arbeitsplatz PC die konfigurierte Software nicht verfügbar ist.'''

===Software: Tocosa===

=====Jobkonfiguration über job.ini=====

Wird der Pfad zu einer zuvor in Tocosa vorbereiteten Job.ini Konfigurationsdatei angegeben, dann öffnet sich die Tocosa Applikation beim starten eines Auftragsobjektes mit den entsprechenden Job Einstellungen.

Die job.ini Datei kann im gewählten Ablageordner von solchen ini Dateien beliebig benannt werden, z.B. '''meinScanJobNr15.ini'''.

Der Dateipfad bei der Einstellung "Pfad zur Jobkonfig." muss immer vollständig, inklusive Dateiname, angegeben werden. E.g. '''O:\ordner\unterordner\job.ini''' oder '''O:\ordner\unterordner\meinScanJobNr15.ini'''

====Tocosa Grundeinstellungen über Tocosa7.ini====

Unabhängig von den Job Einstellungen, können die Grundeinstellungen von Tocosa, welche in der Datei Tocosa7.ini gespeichert sind, geändert werden.

Diese Datei findet sich unter C:\ProgramData\Business Graphics\Tocosa\Tocosa7.ini und sie wird mit den hier gemachten Einstellungen aktualisiert. Sollte dieser Pfad sich in einer zukünftigen Tocosa Version ändern, dann muss der Helper von der Profile dafür angepasst werden.

In der Tocosa7.ini finden sich Konfigurationsblöcke, deren Namen mit eckigen Klammern umfasst sind. Darunter finden sich die Schlüssel mit ihren Werten.

[Settings]
LanguageFile=C:\Program Files\Tocosa\Language7.lan
ShowOnScreenKeyboard=1
WriteProtocol=0
ThumbWidthOffset=196

Um einen Wert zu überschreiben, muss eine entsprechende Zeile dafür in das Textfeld eingegeben werden.

Die Formatierung für eine Zeile ist: 
'''Konfigurationsblock''':''Schlüssel''=Wert

Settings:WriteProtocol=1
Settings:ThumbWidthOffset=250

''Konfigurationsbeispiel in der Einstellungsmaske''

[[Datei: Digitalisierungssoftware.png]]

==Essentielle Felder==
HZ_TESTERGEBNISS Metadaten- Tagname um Entscheidung zu speichern.

HZ_DY_SEQ Sonder- und Kinderobjekte: Typen, welche bei der Einstellung zugelassen sind. Zu den hier angegebenen Attributstypen können Sonder- oder Kinderobjekte erstellt werden. Wenn leer, keine Sonderobjekterstellung möglich.

HZ_METAWERTFELD Sonder- und Kinderobjekte: Formel zur Berechnung der Signatur für Kindesobjekte. Leer lassen, wenn der Name / die Signatur manuell eingegeben werden muss.

HZ_XMPSCHEMANAME Name des EXIF Feldes der Bilddatei, in welche die Seriennummer des Eingabegerätes / Scanners geschrieben werden soll

HZ_BARCODEWERT Valide Seriennummern von Eingabegeräten, welche beim start des Arbeitsfenster eingegeben werden müssen und über diese Einträge hier validiert werden.

HZ_FORMEL Hält den Checkboxstatus der anzuzeigenden Metadaten durch speichern der zugehörigen AT_SEQ (YES:2454, NO:2455, ...)

=Zugehörige Eingabemasken / Fenstertypen=

Aktuell sind vier Fenstermasken / Untersystemtyp für einen Digitalisierungsarbeitschritt konfigurierbar.

;FDO_SHZTyp0 - Standardfenster mit Eingabe von Metadaten und Sonderobjekterzeugung zum Bearbeiteten Hauptobjekt

[[File:FDO_SHZTyp0.png]]

;FDO_SHZTyp0a - Wie Typ0, jedoch zusätzlich mit Dateierzeugung zu den Sonderobjekten

[[File:FDO_SHZTyp0a.png]]

;FDO_SHZTyp0b - Wie Typ0a, jedoch zusätzlich mit Datei- und Unterordnererzeugung zu den Sonderobjekten

[[File:FDO_SHZTyp0b.png]]

;FDO_SHZTyp0c - Zur Erstellung von Kindsobjekten mit Metadaten und Dateien. Das Hauptobjekt (Vater) kann nicht bearbeitet werden.

'''HZ Konfiguration: Die Daten dürfen nicht auf dem Server gespeichert werden! '''

Zeigt die Metadaten des Hauptobjektes im oberen Teil an. Diese können nicht verändert werden.

Wenn für Kindesobjekte der Typ angegeben wurde, wird "Unterobjekte erzeugen" angezeigt. Die verfügbaren Typen finden sich im Dropdown Menu "Typ".

Befinden sich zum Zeitpunkt der Erstellung eines Kindobjektes Dateien im Ordner c:\work\output, dann werden diese dem Kindobjekt zugeordnet und auf den Server kopiert.

Alle Kinder des Hauptobjektes werden in der untersten Liste angezeigt.

Die Signatur des Kindobjektes kann im Einstellungsfenster vorgegeben werden. Das Eingabefeld wird dann zu einem Anzeigefeld und kann nicht mehr überschrieben werden.

Sie können die üblichen [[Omnisgrundlagen|Omnis-Funktionen]] benutzen. Das Feld kennt die Variable 'Zähler', welche ein automatisches hochzählen ermöglich.

Auf die Signatur des Vaterobjektes kann nicht zugegriffen werden. Der Name für die Signatur muss hier festgelegt werden.

con('MeineSignatur',[Zähler])

[[File:FDO_SHZTyp0c.png]]

[[Kategorie:Workflowschritt]]

Normaler Arbeitsschritt

2025-05-28T13:39:21Z

Stefan: /* Digitalisierungssoftware */

;Mantiseinträge:
2237
;Systemtyp:
0

==Beschreibung==
Dieser Arbeitsschritt wird zB fürs Digitalisieren oder andere manuelle Tätigkeiten an Files verwendet. Er legt die Daten des vorherigen Arbeitschrittes eines Objektes in C:\Work\Input und erwartet die Daten nach der manuellen Bearbeitung in C:\Work\Output.
===Digitalisieren===
Digitalisieren Sie alles in C:\Work\Output.
===Manuelle Bearbeitung von Files===

===Leistungen===
Beim Starten des Schrittes wird Name und Änderungsdatum der Files im Ordner C:\Work\Output in einer Liste gespeichert. Am Beenden wird die Liste mit dem dann aktuellen Inhalt verglichen. Es können folgenden Leistungen vorkommen:
;Datei, Create: Eine Datei mit diesem Namen existierte beim Start noch nicht.
;Datei, Update: Eine Datei mit diesem Namen existierte beim Start schon, hat am Ende aber ein anderes Änderungsdatum.
;Datei, Delete: Eine Datei mit diesem Namen existierte beim Start, fehlt aber am Ende.
;Sonderobjekte: Ein Sonderobjekt wurde erstellt.

=Konfiguration=

* Generell

* File Test, Die Filetests sind hier nicht rekursiv. Es werden nur die Files auf der obersten Ebene im Arbeitsordner kontrolliert.

* Metadaten

* Ausgänge: Ermöglicht das Einrichten zusätzlicher Ausgänge für nachfolgende Arbeitsschritte

* Ausgang für hier erstellte Sonderobjekte: Sonderobjekte im Fenster Typ0 (nicht Typ0abc), die an diesem Schritt erstellt werden, nehmen nicht einen der im Workflow konfigurierten Ausgänge. Sie werden zu dem Schritt geleitet, den Sie im Fenster Produktionsauftrage im Register Produktionsschritte (unten rechts) eingeben können: '''Arbeitschritt für Sonderobjekte'''.

* Serien Nr. Scanner: Schreibt die Seriennummer eines Scanners in die Bilddatei. Ermöglicht die zwingende Angabe der Seriennummer eines verwendeten Eingabegerätes / Scanners beim starten des Arbeitsfensters.

==Einstellungsfenster==

[[File:FHZ_STyp000_1.png]]

===Serien Nr. Scanner===

Verlangt die Eingabe des Namens eines EXIF Feldes. '''Wenn dieses Feld hier gefüllt wurde, dann muss bei dem Arbeitsschritt beim starten zwingend eine Seriennummer angegeben werden.'''
Ohne die Eingabe einer gültigen Seriennummer wird das Arbeitsfenster nicht laufen.

Das EXIF Standard Feld für die Seriennummer lautet: '''SerialNumber'''

Die Seriennummern der Scanner werden beim beenden der Arbeit automatisch in alle Bilddateien geschrieben, bei welchen nicht bereits eine Seriennummer in dem angegebenen EXIF Feld enthalten ist.

'''Validierung der Geräteseriennummern'''

Es werden nur Seriennummer akzeptiert, welche entweder:

*in der Liste unterhalb erfasst wurden (Die Seriennummern sind Zeilenweise (Zeilenumbruch) zu trennen!)
*in den Anlagen erfasst, mit einer Maschine verknüpft, einem Maschinentyp zugeordnet und dieser Maschinentyp beim Arbeitsschritt unter "benötigter Maschinentyp" konfiguriert wurde.

[[File:FHZ_STyp000_snc.png]]

==Digitalisierungssoftware==

Ermöglicht die Angabe einer für den Job zum Einsatz kommenden Digitalisierungsoftware und ggf. von spezifischen Software Voreinstellungen.

Die Auswahl der benötigten Software über das Dropdown Menu lädt die dazugehörenden Einstellungsmöglichkeiten.

Die Checkbox "Bearbeitung ohne Digitalsierungssoftware erlauben" erlaubt den Start des Arbeitsfensters auch für den Fall, dass auf dem Arbeitsplatz PC die konfigurierte Software nicht verfügbar ist.

===Software: Tocosa===

=====Jobkonfiguration über job.ini=====

Wird der Pfad zu einer zuvor in Tocosa vorbereiteten Job.ini Konfigurationsdatei angegeben, dann öffnet sich die Tocosa Applikation beim starten eines Auftragsobjektes mit den entsprechenden Job Einstellungen.

Die job.ini Datei kann im gewählten Ablageordner von solchen ini Dateien beliebig benannt werden, z.B. '''meinScanJobNr15.ini'''.

Der Dateipfad bei der Einstellung "Pfad zur Jobkonfig." muss immer vollständig, inklusive Dateiname, angegeben werden. E.g. '''O:\ordner\unterordner\job.ini''' oder '''O:\ordner\unterordner\meinScanJobNr15.ini'''

====Tocosa Grundeinstellungen über Tocosa7.ini====

Unabhängig von den Job Einstellungen, können die Grundeinstellungen von Tocosa, welche in der Datei Tocosa7.ini gespeichert sind, geändert werden.

Diese Datei findet sich unter C:\ProgramData\Business Graphics\Tocosa\Tocosa7.ini und sie wird mit den hier gemachten Einstellungen aktualisiert. Sollte dieser Pfad sich in einer zukünftigen Tocosa Version ändern, dann muss der Helper von der Profile dafür angepasst werden.

In der Tocosa7.ini finden sich Konfigurationsblöcke, deren Namen mit eckigen Klammern umfasst sind. Darunter finden sich die Schlüssel mit ihren Werten.

[Settings]
LanguageFile=C:\Program Files\Tocosa\Language7.lan
ShowOnScreenKeyboard=1
WriteProtocol=0
ThumbWidthOffset=196

Um einen Wert zu überschreiben, muss eine entsprechende Zeile dafür in das Textfeld eingegeben werden.

Die Formatierung für eine Zeile ist: 
'''Konfigurationsblock''':''Schlüssel''=Wert

Settings:WriteProtocol=1
Settings:ThumbWidthOffset=250

''Konfigurationsbeispiel in der Einstellungsmaske''

[[Datei: Digitalisierungssoftware.png]]

==Essentielle Felder==
HZ_TESTERGEBNISS Metadaten- Tagname um Entscheidung zu speichern.

HZ_DY_SEQ Sonder- und Kinderobjekte: Typen, welche bei der Einstellung zugelassen sind. Zu den hier angegebenen Attributstypen können Sonder- oder Kinderobjekte erstellt werden. Wenn leer, keine Sonderobjekterstellung möglich.

HZ_METAWERTFELD Sonder- und Kinderobjekte: Formel zur Berechnung der Signatur für Kindesobjekte. Leer lassen, wenn der Name / die Signatur manuell eingegeben werden muss.

HZ_XMPSCHEMANAME Name des EXIF Feldes der Bilddatei, in welche die Seriennummer des Eingabegerätes / Scanners geschrieben werden soll

HZ_BARCODEWERT Valide Seriennummern von Eingabegeräten, welche beim start des Arbeitsfenster eingegeben werden müssen und über diese Einträge hier validiert werden.

HZ_FORMEL Hält den Checkboxstatus der anzuzeigenden Metadaten durch speichern der zugehörigen AT_SEQ (YES:2454, NO:2455, ...)

=Zugehörige Eingabemasken / Fenstertypen=

Aktuell sind vier Fenstermasken / Untersystemtyp für einen Digitalisierungsarbeitschritt konfigurierbar.

;FDO_SHZTyp0 - Standardfenster mit Eingabe von Metadaten und Sonderobjekterzeugung zum Bearbeiteten Hauptobjekt

[[File:FDO_SHZTyp0.png]]

;FDO_SHZTyp0a - Wie Typ0, jedoch zusätzlich mit Dateierzeugung zu den Sonderobjekten

[[File:FDO_SHZTyp0a.png]]

;FDO_SHZTyp0b - Wie Typ0a, jedoch zusätzlich mit Datei- und Unterordnererzeugung zu den Sonderobjekten

[[File:FDO_SHZTyp0b.png]]

;FDO_SHZTyp0c - Zur Erstellung von Kindsobjekten mit Metadaten und Dateien. Das Hauptobjekt (Vater) kann nicht bearbeitet werden.

'''HZ Konfiguration: Die Daten dürfen nicht auf dem Server gespeichert werden! '''

Zeigt die Metadaten des Hauptobjektes im oberen Teil an. Diese können nicht verändert werden.

Wenn für Kindesobjekte der Typ angegeben wurde, wird "Unterobjekte erzeugen" angezeigt. Die verfügbaren Typen finden sich im Dropdown Menu "Typ".

Befinden sich zum Zeitpunkt der Erstellung eines Kindobjektes Dateien im Ordner c:\work\output, dann werden diese dem Kindobjekt zugeordnet und auf den Server kopiert.

Alle Kinder des Hauptobjektes werden in der untersten Liste angezeigt.

Die Signatur des Kindobjektes kann im Einstellungsfenster vorgegeben werden. Das Eingabefeld wird dann zu einem Anzeigefeld und kann nicht mehr überschrieben werden.

Sie können die üblichen [[Omnisgrundlagen|Omnis-Funktionen]] benutzen. Das Feld kennt die Variable 'Zähler', welche ein automatisches hochzählen ermöglich.

Auf die Signatur des Vaterobjektes kann nicht zugegriffen werden. Der Name für die Signatur muss hier festgelegt werden.

con('MeineSignatur',[Zähler])

[[File:FDO_SHZTyp0c.png]]

[[Kategorie:Workflowschritt]]

Datei:Digitalisierungssoftware.png

2025-05-28T13:37:21Z

Stefan: Stefan lud eine neue Version von Datei:Digitalisierungssoftware.png hoch

Zusammenführen von Daten

2025-05-07T13:58:42Z

Stefan: /* FDO_SHZTyp16b */

;Mantiseinträge:
1815
;Systemtyp:
16

==Beschreibung==
Inhaltszuweisung zu Objekten oder Metadatenerfassung.

===FDO_SHZTyp16===
Fenster für Grundbuchamt.

===FDO_SHZTyp16a===
Generisches Fenster.

===FDO_SHZTyp16b===
Fenster für Assistiertes Metadatieren über Dateien welche durch die Texterkennung (OCR) gelaufen sind.

Das Fenster wird mittlerweile auch für andere Aufträge verwendet, welche nicht zwangsläufig OCR Erkennung hatten.

Mit diesem Fenster kann zudem Konfiguriert werden, dass ein bestimmtes Metadatum in der Treeliste der Objekte mit angezeigt wird.

Die Einstellung dazu findet sich im Tab "erweitert" der Konfigurationsmaske.

[[Datei:Bildschirmfoto 2025-05-07 um 14.49.28.png]]

===Leistungen===
Es werden die Anzahl der Knopfdrücke im Fenster gezählt, um die Menge von Aktionen zählen zu können. Es können folgenden Leistungen vorkommen:
;Zuweisung_Beleg, Create: Ein Beleg wurde zugeordnet.
;Zuweisung_Beleg, Delete: Eine Belegzuordnung wurde wieder aufgelöst.
;Beleg, Create: Ein neuer Beleg wurde erstellt.
;Beleg, Update: Der Name eines bestehenden Beleges wurde angepasst.
;Duplikat_Beleg, Create: Ein Duplikat wurde erstellt.
;Zuweisung_Sonderobjekt, Create: Ein Sonderobjekt wurde zugeordnet.
;Zuweisung_Sonderobjekt, Delete: Eine Sonderobjektzuordnung wurde wieder aufgelöst.
;Duplikat_Sonderobjekt, Create: Ein Sonderobjekt Duplikat wurde erstellt.

==Essentielle Felder==
DO_FEHLT ''1=Das Objekt fehlt''

[[Kategorie:Workflowschritt]]

Zusammenführen von Daten

2025-05-07T13:55:52Z

Stefan: /* Beschreibung */

;Mantiseinträge:
1815
;Systemtyp:
16

==Beschreibung==
Inhaltszuweisung zu Objekten oder Metadatenerfassung.

===FDO_SHZTyp16===
Fenster für Grundbuchamt.

===FDO_SHZTyp16a===
Generisches Fenster.

===FDO_SHZTyp16b===
Fenster für Assistiertes Metadatieren über Dateien welche durch die Texterkennung (OCR) gelaufen sind.

Mit diesem Fenster kann ausserdem Konfiguriert werden, dass ein bestimmtes Metadatum in der Treeliste der Objekte mit angezeigt wird.

Die Einstellung dazu findet sich im Tab "erweitert" der Konfigurationsmaske.

[[Datei:Bildschirmfoto 2025-05-07 um 14.49.28.png]]

===Leistungen===
Es werden die Anzahl der Knopfdrücke im Fenster gezählt, um die Menge von Aktionen zählen zu können. Es können folgenden Leistungen vorkommen:
;Zuweisung_Beleg, Create: Ein Beleg wurde zugeordnet.
;Zuweisung_Beleg, Delete: Eine Belegzuordnung wurde wieder aufgelöst.
;Beleg, Create: Ein neuer Beleg wurde erstellt.
;Beleg, Update: Der Name eines bestehenden Beleges wurde angepasst.
;Duplikat_Beleg, Create: Ein Duplikat wurde erstellt.
;Zuweisung_Sonderobjekt, Create: Ein Sonderobjekt wurde zugeordnet.
;Zuweisung_Sonderobjekt, Delete: Eine Sonderobjektzuordnung wurde wieder aufgelöst.
;Duplikat_Sonderobjekt, Create: Ein Sonderobjekt Duplikat wurde erstellt.

==Essentielle Felder==
DO_FEHLT ''1=Das Objekt fehlt''

[[Kategorie:Workflowschritt]]

Datei:Bildschirmfoto 2025-05-07 um 14.49.28.png

2025-05-07T13:55:41Z

Stefan:

Neues feature

Assistiertes Metadatieren

2025-05-07T13:52:22Z

Stefan: /* Konfiguration der Suchformeln */

;Mantiseinträge:
2972
;Systemtyp:
16

==Beschreibung==
Erlaubt das automatische Markieren von Textstellen in einem angezeigten Scanbild über die Angabe Suchbegriffen / Schlagwörtern sowie deren Folgebegriffen über einen REGEX Suchfilter.

Begriffe können auch nur über REGEX gesucht werden.

Suchbegriffe werden im Text Grün markiert. Folgebegriffe, oder Begriffe welche rein über REGEX gefunden werden, werden im Text Gelb markiert.

Es kann nur nach einzelnen Wörtern, jedoch nicht nach Wortfolgen gesucht werden.

Gefundene Folgewörter (Regex Begriff 2) können automatisch in das entsprechende angegebene Metadatum gefüllt werden. Das Metadatum für das Objekt muss entsprechend lautend vorkonfiguriert werden.

==Benötigte Subwindows==

Das automatische abfüllen der Metadaten funktioniert nur mit folgenden Subwindows: FAA_SMaske16a, FAA_SMaske16b und FAA_SMaske16c

==Konfiguration der Suchformeln==

Suchbegriffe werden in die erste Spalte eingetragen. Es ist möglich nach mehreren Begriffen zu suchen sofern diese sich auf einer Textzeile befinden.

Soll nach einem Folgebegriff gesucht werden, dann muss in der zweiten Spalte (Pos. Begriff 2) ein "F" eingetragen werden. Weiter muss für den Begriff im Feld "Regex Suchfilter für Begriff 2" ein Regex Filter angegeben werden.

Falls nur über Regex gesucht werden soll, dann muss in der spalte "Nur Regex" eine "1" eingetragen werden.

Steht im Feld Metadatum ein vorhandener Metadatum Name, dann werden die über REGEX gefundenen Begriffe automatisch in das entsprechende Feld übertragen (Siehe benötigte Subwindows).

===Erweitertes finden von Daten===
Es ist möglich mit minimaler Konfiguration ein erweitertes finden eines Datums zu aktivieren. Dazu schreiben Sie in die Konfiguration unter der Spalte "Regex Suchbegriff Begriff 2" einfach "[Datum]" (mit Anführungszeichen!). Natürlich muss weiterhin im Feld Metadatum ein Attribut definiert werden, wo das Datum gespeichert werden soll.

Welche Datumstypen werden gefunden (Der Helper markiert alle gefundenen Daten. Das Datum welches ins Metadatenfeld kommt, wird in der unterstehenden Reihenfolge gesucht):
====Simple Daten====
* 01.12.2020 / 1.12.2020 / 01.01.2022 / 01.1.2022 / 01.12.22 / 1.12.22 / 01.01.22 / 01.1.22
* 1 oder 2 stelliger Monat / Tag
* 2 oder 4 stelliges Jahr
 
* 01-05-2020 / 01-5-2020 / 01/08/2020 / 1/8/2019
* 1 oder 2 stelliger Monat / Tag
* 4 stelliges Jahr
 
* 01-Jan-2022 / 1-FEB-22 / 12-MrZ-99
* 1 oder 2 stelliger Tag
* 2 oder 4 stelliges Jahr

====Ausgeschriebene Monate====
* 1. Januar 2015 / 03. Dezember 15 / 15 März 2020
* Punkte Optional
* 2 oder 1 stelliger Monat
* 2 oder 4 stelliges Jahr

====Abgekürzte Monate====
* 1. Jan 2015 / 03. Dez. 15 / 1 JAN 2015 / 12 FeBr. 99
* Punkte Optional
* 1 oder 2 stelliger Tag
* Gross/Kleinschreibung ignoriert
* 2 oder 4 stelliges Jahr

====Ausgeschriebene Monate ohne Tag====
* Januar 2015 / Dezember 15 / März 2020
* 2 oder 4 stelliges Jahr

====Abgekürzte Monate ohne Tag====
* Jan 2020 / Jan. 20 / JAN 20
* Optionale Punkt
* 2 oder 4 stelliges Jahr

Falls sich in einer Zeile 2 exakt gleich formatierte Daten befinden wird nur eins davon erkannt. Die gilt nicht für Daten welche zwar auf den gleichen Tag verweisen aber anders formatiert sind zB. 9. Januar 22 und 9. Januar 2022.

===Erweitertes finden von Text mit Attributvorlagen===
Es ist möglich, basierend auf Attributvorlagen, Text markieren zu lassen. Dazu schreiben Sie in die Konfiguration unter der Spalte "Regex Suchbegriff Begriff 2" einfach "[Attributvorlage]" (mit Anführungszeichen!). Natürlich muss weiterhin im Feld Metadatum ein Attribut definiert werden, wo der gefundene Text gespeichert werden soll. Die gefunden Textstellen werden nicht automatisch in das konfigurierte Metawertfeld übertragen, sondern müssen vom User manuell via Doppelklick zugewiesen werden. Es ist möglich Begriffe mit mehreren Wörtern finden zu lassen. Jedoch werden diese nur gefunden, falls sie sich auf einer Textzeile befinden! Zudem werden doppelte Textstellen nur einmal pro Zeile markiert.

==Pane im Produktionsauftrag (FHK_Maske)==
[[File:Assist_Meta.png]]

[[Kategorie:Workflowschritt]]

Assistiertes Metadatieren

2025-05-07T13:51:47Z

Stefan: /* Beschreibung */

;Mantiseinträge:
2972
;Systemtyp:
16

==Beschreibung==
Erlaubt das automatische Markieren von Textstellen in einem angezeigten Scanbild über die Angabe Suchbegriffen / Schlagwörtern sowie deren Folgebegriffen über einen REGEX Suchfilter.

Begriffe können auch nur über REGEX gesucht werden.

Suchbegriffe werden im Text Grün markiert. Folgebegriffe, oder Begriffe welche rein über REGEX gefunden werden, werden im Text Gelb markiert.

Es kann nur nach einzelnen Wörtern, jedoch nicht nach Wortfolgen gesucht werden.

Gefundene Folgewörter (Regex Begriff 2) können automatisch in das entsprechende angegebene Metadatum gefüllt werden. Das Metadatum für das Objekt muss entsprechend lautend vorkonfiguriert werden.

==Benötigte Subwindows==

Das automatische abfüllen der Metadaten funktioniert nur mit folgenden Subwindows: FAA_SMaske16a, FAA_SMaske16b und FAA_SMaske16c

==Konfiguration der Suchformeln==

Suchbegriffe werden in die erste Spalte eingetragen. Es ist möglich nach mehreren Begriffen zu suchen sofern diese sich auf einer Textzeile befinden.

Soll nach einem Folgebegriff gesucht werden, dann muss in der zweiten Spalte (Pos. Begriff 2) ein "F" eingetragen werden. Weiter muss für den Begriff im Feld "Regex Suchfilter für Begriff 2" ein Regex Filter angegeben werden.

Falls nur über Regex gesucht werden soll, dann muss in der spalte "Nur Regex" eine "1" eingetragen werden.

Steht im Feld Metadatum ein vorhandener Metadatum Name, dann werden die über REGEX gefundenen Begriffe automatisch in das entsprechende Feld übertragen.

===Erweitertes finden von Daten===
Es ist möglich mit minimaler Konfiguration ein erweitertes finden eines Datums zu aktivieren. Dazu schreiben Sie in die Konfiguration unter der Spalte "Regex Suchbegriff Begriff 2" einfach "[Datum]" (mit Anführungszeichen!). Natürlich muss weiterhin im Feld Metadatum ein Attribut definiert werden, wo das Datum gespeichert werden soll.

Welche Datumstypen werden gefunden (Der Helper markiert alle gefundenen Daten. Das Datum welches ins Metadatenfeld kommt, wird in der unterstehenden Reihenfolge gesucht):
====Simple Daten====
* 01.12.2020 / 1.12.2020 / 01.01.2022 / 01.1.2022 / 01.12.22 / 1.12.22 / 01.01.22 / 01.1.22
* 1 oder 2 stelliger Monat / Tag
* 2 oder 4 stelliges Jahr
 
* 01-05-2020 / 01-5-2020 / 01/08/2020 / 1/8/2019
* 1 oder 2 stelliger Monat / Tag
* 4 stelliges Jahr
 
* 01-Jan-2022 / 1-FEB-22 / 12-MrZ-99
* 1 oder 2 stelliger Tag
* 2 oder 4 stelliges Jahr

====Ausgeschriebene Monate====
* 1. Januar 2015 / 03. Dezember 15 / 15 März 2020
* Punkte Optional
* 2 oder 1 stelliger Monat
* 2 oder 4 stelliges Jahr

====Abgekürzte Monate====
* 1. Jan 2015 / 03. Dez. 15 / 1 JAN 2015 / 12 FeBr. 99
* Punkte Optional
* 1 oder 2 stelliger Tag
* Gross/Kleinschreibung ignoriert
* 2 oder 4 stelliges Jahr

====Ausgeschriebene Monate ohne Tag====
* Januar 2015 / Dezember 15 / März 2020
* 2 oder 4 stelliges Jahr

====Abgekürzte Monate ohne Tag====
* Jan 2020 / Jan. 20 / JAN 20
* Optionale Punkt
* 2 oder 4 stelliges Jahr

Falls sich in einer Zeile 2 exakt gleich formatierte Daten befinden wird nur eins davon erkannt. Die gilt nicht für Daten welche zwar auf den gleichen Tag verweisen aber anders formatiert sind zB. 9. Januar 22 und 9. Januar 2022.

===Erweitertes finden von Text mit Attributvorlagen===
Es ist möglich, basierend auf Attributvorlagen, Text markieren zu lassen. Dazu schreiben Sie in die Konfiguration unter der Spalte "Regex Suchbegriff Begriff 2" einfach "[Attributvorlage]" (mit Anführungszeichen!). Natürlich muss weiterhin im Feld Metadatum ein Attribut definiert werden, wo der gefundene Text gespeichert werden soll. Die gefunden Textstellen werden nicht automatisch in das konfigurierte Metawertfeld übertragen, sondern müssen vom User manuell via Doppelklick zugewiesen werden. Es ist möglich Begriffe mit mehreren Wörtern finden zu lassen. Jedoch werden diese nur gefunden, falls sie sich auf einer Textzeile befinden! Zudem werden doppelte Textstellen nur einmal pro Zeile markiert.

==Pane im Produktionsauftrag (FHK_Maske)==
[[File:Assist_Meta.png]]

[[Kategorie:Workflowschritt]]

InfoScreens

2025-05-02T11:51:12Z

Stefan: /* Allgemeine Funktionsbeschreibung */

== Allgemeine Funktionsbeschreibung ==

Auf Grossbildschirmen können verschiedenste Informationen rund um den Betrieb der Mikrografie in die Arbeitsräume übermittelt werden.

Dies wird über fortlaufend generierte HMTL Seiten bewerkstelligt, welche in definierten Zeitabständen neu geladen werden. Der Job kann dies zudem über die Periodizität ansteuern.

Die HTML Seiten werden von einem HLI Serverjob gerendert.

Als Webserver wird NGINX verwendet.

Aktuell muss der Job auf dem Server laufen, welcher auch den Webserver bereit stellt.

Die neu generierten HTML Dateien werden dort direkt in den root Pfad des Webservers geschrieben.

=== MIDHLP04N ===

Einfache NGINX installation im Pfad c:\nginx

Webroot in c:\nginx\html

Der Serverjob wir ebenfalls hier ausgeführt.

=== Jobkonfiguration ===

Der Job verwendet benötigt die IP Adresse des Servers, auf welchem er läuft. Diese wird über jo_param1 konfiguriert. Es gibt keine Maske dazu, dies muss direkt auf der DB in entsprechenden Job Tuple gesetzt werden.

=== Raspberry Satelliten ===

Die Geräte greifen über eine Fix eingestellte IP-Adresse auf den Webserver zu. Wird die Serveradresse geändert, müssen alle Rasperry neu konfiguriert werden.

[[Kategorie:Workflowschritt]]

InfoScreens

2025-05-02T11:27:58Z

Stefan: neue Seite für die InfoScreens

== Allgemeine Funktionsbeschreibung ==

Auf Grossbildschirmen können verschiedenste Informationen rund um den Betrieb der Mikrografie in die Arbeitsräume übermittelt werden.

Dies wird über fortlaufend generierte HMTL Seiten bewerkstelligt, welche in definierten Zeitabständen neu geladen werden. Der Job kann dies zudem - glaube ich - über die Periodizität ansteuern.

Die Seiten werden von einem HLI Serverjob erzeugt.

Als Webserver wird NGINX verwendet.

Aktuell muss der Job auf dem Server laufen, welcher auch den Webserver bereit stellt.

Die neu generierten HTML Dateien werden dort direkt in den root Pfad des Webservers geschrieben.

=== MIDHLP04N ===

Einfache NGINX installation im Pfad c:\nginx

Webroot in c:\nginx\html

Der Serverjob wir ebenfalls hier ausgeführt.

=== Jobkonfiguration ===

Der Job verwendet benötigt die IP Adresse des Servers, auf welchem er läuft. Diese wird über jo_param1 konfiguriert. Es gibt keine Maske dazu, dies muss direkt auf der DB in entsprechenden Job Tuple gesetzt werden.

=== Raspberry Satelliten ===

Die Geräte greifen über eine Fix eingestellte IP-Adresse auf den Webserver zu. Wird die Serveradresse geändert, müssen alle Rasperry neu konfiguriert werden.

[[Kategorie:Workflowschritt]]

Datei:Konfidenzbewertung.png

2025-04-09T14:41:40Z

Stefan: Stefan lud eine neue Version von Datei:Konfidenzbewertung.png hoch

übersicht

Datei:Konfidenzbewertung.png

2025-04-09T13:26:11Z

Stefan: Stefan lud eine neue Version von Datei:Konfidenzbewertung.png hoch

übersicht

Filehandling

2025-04-01T09:18:40Z

Stefan: 3498 /* Befehle: */

;Mantiseinträge:
2377
;Systemtyp:
59

==Beschreibung==
Dieser Arbeitsschritt kann verschiedene Aktionen wie zB. Files bewegen, Ordner erstellen etc. im DO Ordner vornehmen.

Mögliche Befehle:
* Erstelle Ordner
* Lösche Ordner
* Kopiere Dateien von XX nach XX
* Bewege Dateien von XX nach XX
* Lösche Datei(en) nach Name
* Lösche Datei(en) nach Position
* Kopiere Dateien des Vaters von XX nach XX
* Kopiere Dateien des Grossvaters von XX nach XX
 
Befehle können 2 Varianten von Errorhandling vorweisen:
 
'''zwingend erfolgreich [!]:''' Jeder Fehler wirft ein DO Fehler. Auch wenn zB. konfiguriert ist, dass ein File test.txt von A nach B kopiert werden soll und das File jedoch nicht gefunden wurde.
 
'''nicht zwingend erfolgreich:''' Ziemlich schwaches Errorhandling. Nur schwere Fehler verursachen einene DO Fehler. Sollte zB. benutzt werden "falls" ein File von A nach B kopiert werden soll, sofern es existiert.

==Essentielle Felder==
HZ_FORMEL ''Konfiguration welche Befehle ausgeführt werden sollen''

HZ_DATENHOLEN ''0 = Daten bleiben beim letzten Datenschritt. Somit wird die letzte vorhandene Version Ihrer Daten bearbeitet (!), 1 = Daten werden vor dem Ausführen der Befehle an den aktuellen Schritt kopiert. Somit werden die Befehle auf einer Kopie der Daten durchgeführt (Normalfall), 2 = Es wird ein neuer, leerer DO Ordner erstellt''

==Erlaubte Werte für die Konfiguration:==
Beim Auswählen von Files kann entweder genau 1 File via Name angegeben werden, oder es können "*" im Dateinamen eingebunden werden um mehrere Files anzusprechen.

;Beispiel:

Alle TIF's in einem Ordner: "*.tif"
Alle Dateien welche mit "a" starten: "a*.*"
Alle Dateien welche mit "a" starten, mit "e" enden und vom Typ txt sind: "a*e.txt"

==Verhalten Daten holen:==

''Aktion am letzten Datenschritt ausführen:'' 
Die Aktionen werden im Ordner des letzten Datenschrittes des DO Objektes ausgeführt. Die Daten an diesem Schritt werden damit z.B. unwiederruflich gelöscht.
Vermeidet das unnötige duplizieren der Daten an einen neuen Schritt, wenn zum bsp. die Ordnerstruktur geändert werden soll.

''Daten an diesen Schritt kopieren und Aktionen ausführen:'' 
Kopiert und dupliziert damit alle Daten des letzten Datenschrittes des DO an den aktuellen Datenschritt dieses Arbeitsschrittes.

''Neuen DO Ordner erstellen:'' 
Erstellt einen Ordner für das Do Objekt am Datenschritt dieses Arbeitsschrittes. Wird zwingend benötigt, für die kopieren Schritte der Daten des Vaters oder des Grossvaters, wenn für das DO Objekt selbst keine Daten aus einem früheren Arbeitsschritt exisitieren oder diese nicht mit den Daten der Ahnen zusammengeführt werden sollen!

===Version 0===
Hier werden die Parameter, wie der Dateiname/Ordnername nicht evaluiert. Sie können keine Metadaten verwenden.
===Version 1===
Hier können Sie Metadaten verwenden in den Parametern. Die Parameter müssen korrekte Formeln sein und einfache Zeichenfolgen sind in Anführungszeichen einzugeben.

z.B.:
con([^DOSignatur],'_komprimiert')
'*.tif'
Sie können die üblichen Platzhalter verwenden. Somit ist es möglich in jedem DO einen anderen Unterordner zu erstellen.

==Befehle:==

===Erstelle Ordner===

===Lösche Ordner===

===Kopiere Dateien von XX nach XX===

===Bewege Dateien von XX nach XX===

===Lösche Datei(en) nach Name===

===Lösche Datei(en) nach Position===

Dateien können anhand ihrer Sortierposition inerhalb des Dateisystems gelöscht werden. Die zu löschenden Positionen werden hier als Kommagetrennte Zahlenfolge eingegeben.

Die verwendung der Literale "U" und "G" ermöglichen das löschen aller '''G'''eraden oder aller '''U'''ngeraden Positionen. Die Literale dürfen jedoch nicht beide gleichzeitig verwendet werden, um damit z.B. alle Dateien zu löschen.

Es sind positive und negative Zahlen als Positionswerte möglich.

Negative Werte zählen von der letzten Datei ausgehend rückwarts. '''Wobei -1 = letzte Datei, -2 = vorletzte Datei.'''

Positive Werte zählen von der ersten Datei ausgehend vorwärts.

''Die Reihenfolge der Positionseingabe'' '''ist nicht relevant.'''

Bsp.:

Lösche die Dateien nummer drei, fünfzehn sowie die drittletzte -> '3,15,-3' (ist gleich wie '15,-3,3')

Lösche alle geraden, die nummern 7, 17 und die letzte -> 'G,7,17,-1' (ist gleich wie '-1,7,17,G')

Lösche alle ungeraden -> 'U'

Das Verhalten bei angewählter Option 'zwingend erforderlich' verlangt, dass alle genannten Dateipositionen vorhanden sein müssen!:

* Sollen gerade Dateien (G) gelöscht werden, und es gibt bloss eine einzige Datei, erzeugt dies einen DO Fehler.
* Soll die Datei -15 gelöscht werden, und es gibt bloss 14 Dateien, erzeugt dies einen DO Fehler.

===Kopiere Dateien des Vaters von XX nach XX===

===Kopiere Dateien des Grossvaters von XX nach XX===

===Erstelle Kindsordner===

Erstellt im aktuellen Ordner des Objektes Unterordner mit den Namen der Signaturen seiner Kindesobjekte.

Bsp.: Das Objekt hat fünf Kindobjekte mit den Signaturen A1, A2, A3, A4, A5.
Wenn das Objekt den Befehl durchlaufen hat, befinden sich im aktuellen Ordner des Objektes, nebst bereits vorhandenen Ordnern oder Dateien, fünf neue Ordner mit den Namen A1, A2, A3, A4, A5.

==Pane im Produktionsauftrag (FHK_Maske)==

[[File:Filehandling.png|500px]]

[[Kategorie:Workflowschritt]]

Datei:HZBerichteinstellung.png

2025-03-26T15:21:49Z

Stefan: Stefan lud eine neue Version von Datei:HZBerichteinstellung.png hoch