Helper - Benutzerbeiträge [de]

Seitenrahmen finden

2026-03-03T12:30:01Z

Mirko Pepa: /* Drehung finden aus OCR */

;Mantiseinträge:
3256

;Systemtyp:
71

==Beschreibung==
Siehe auch: [[Erstellung von Seitenrahmen|Zusätzliche Worklfow Informationen]]

Ermöglicht die Ermittlung von Seitenrahmen, welche als Bild Regionen von Interesse zu verstehen sind.
Ist eine Vorstufe für die Schritte "Seitenrahmen Kontrollieren" und "Bilderstellung aus Rahmen".

Nutzt dafür Funktionen aus den GDPicture Komponenten, welche ebenfalls über das Testfenster "Fenstername" zur Verfügung stehen.

Nebst dem erkennen von Seitenrahmen, stehen Befehle für die Ausrichtung der Bilder und für die Erkennung von Leerseiten bereit.

'''Merke:''' Der Befehl Doppelseite teilen darf nur einmal angewendet werden!

Vertikales teilen ist aktuell noch nicht implementiert.

===HZ Versionen===

HZ Version >= 2.00

Erlaubt die ermittlung einer Region Of Interest (ROI) und teilt die Seiten über diese Region und nicht zwingend über die Seitenhälfte

HZ Version = 1.00

Teilt Seiten über die halbierung der Seitenlänge.

==Zugehörige Arbeitsschritte==

[[Seitenrahmen kontrollieren]]

[[Bilderstellung aus Rahmen]]

==Konfigurationsfenster==

[[Datei: Hauptmaske_71.png]]

==Grundeinstellungen==

Die Seitenrahmen müssen einen Namen erhalten. Dieser wird in späteren Arbeitschritte zur Identifikation verwendet.

Rahmenname - Die Bezeichnung für den Seitenrahmen
Reduzierte JPG-Dateien erstellen in Qualität XX Prozent

Zudem können Thumbnails erstellt werden mit der Option 'Reduzierte JPG-Dateien erstellen'. Diese Thumbnails werden in den Hilfsdatenordner gelegt. Die Originale werden nicht verändert.

==Befehle einrichten==

Neue Befehle werden über die grüne + Taste rechts unter der Liste hinzugefügt, welche beim drücken ein Kontextmenu mit den verfügbaren Befehlen anzeigt.

[[Datei: Befehle_71.png]]

Sind bereits Befehle in der Liste vorhanden, so wird ein neuer Befehl jeweils unter einem bereits markierten Befehl angefügt.

Über die rote Kreuz (X) Taste lässt sich ein Befehl, welcher dabei in der Befehlsliste ausgewählt sein muss, wieder entfernen.

Die Befehlsreihenfolge kann über die grünen Pfeiltasten geändert werden.

Das Markieren eines Befehls in der Liste lädt automatisch unter der Liste die zugehörigen Parameter.

==Verfügbare Befehle==

===Region of interest===

Ermittel einen Bildbereich von Interesse für die weitere Bearbeitung. Funktionalität ist analog wie der Befehl "Ränder finden", es wird jedoch kein Rahmen daraus erzeugt.

Der Befehl eignet sich z.B. um einen ersten groben Randbereich zu erkennen und diesen für die folgenden Befehle auszuschliessen.

Referenzrand - Referenzpunkt auf dem Bild, welcher aus Ausgangslage für das finden von Rändern genommen werden soll.
Typ - Handelt es sich um ein Bild oder um ein TextDokument
Konfidenz - Schwellenwert 0-99 für die Erkennung. Standard = 75. Der geeignetste Wert sollte mit dem Testfenster zuvor approximiert werden!

[[Datei: bvi.png]]

===Drehung finden aus Bild===

Ermittelt den Drehwinkel eines Bildes und speichert diesen. Aus der Dokumentation ist leider nicht ersichtlich welcher Algorithmus dem zu Grunde liegt.

Max Suchwinkel - Setzen Sie zB auf 10, dann werden Winkel bis +-10° gesucht. Ein Wert unter 15 wird empfohlen.
Min Suchwinkel - Bestimmt den kleinsten Winkel der gefunden wird. 0.25 wird empfohlen. Grössere Werte haben schnellere Ergebnisse zur Folge.
Optimistisch - Sollte gesetzt werden, wenn Sie sicher sind, dass alle Bilder schrägen Text enthalten.
Rotationsart - Standard = Bildgrösse beibehalten. Optional = Bild vergrössern. Sollte nur angewendet werden wenn,
Füllfarbe - Farbe mit welchen die entstehenden Spickel oder zusätzliche Bildbereiche gefüllt werden sollen. Sollte der Hintergrundsfarbe der Bilder entsprechen. Standard = Schwarz.

[[Datei: DrehungBild_71.png]]

[[Datei: Drehwinkel_option1_71.png]]

===Drehung finden aus OCR===

Analog zu Drehung finden aus Bild. Der Drehwinkel wird hier durch Auswerten der OCR Daten ermittelt: Es wird der Winkel des breitesten Textblocks genommen.

[[Datei: DrehungOCR_71.png]]

===Doppelseite teilen===

Erstellt aus einer Seite zwei getrennte Seiten, z.B. um Bücher in linke und rechte Seite zu splitten. Dieser Befehl führt zu einer getrennten Anwendung aller Folgebefehle auf die jeweilige Seite.

Die Seiten werden nur im Speicher getrennt weiter bearbeitet. Dabei wird das Bild nicht beschnitten, sondern die wegzuschneidende Fläche wird farblich aufgefüllt.

Unterstützt aktuell nur das Vertikale teilen (Option: Typ)

Typ - Auf welcher Achse soll die Datei geteilt werden. Standard = Vertikal teilen
Overlap - Anzahl Pixel um welche sich die Teilung überschneiden soll.
SuffixA - Suffix welcher der linke / obere Seitenrahmenname erhalten soll.
SuffixB - Suffix welcher der rechte / untere Seitenrahmenname erhalten soll.

[[Datei: Seiteteilen_71.png]]

===Ränder finden===

Hauptfunktion des Schrittes, welcher damit die Koordinaten für die Seitenrahmen festlegt.

Sucht nach Seitenränder, z.B. um weisse oder schwarze Bereiche rund um Text zu entfernen.

Referenzrand - Referenzpunkt auf dem Bild, welcher aus Ausgangslage für das finden von Rändern genommen werden soll. Bei zuvor geteilten Bildern sind ggf. die erweiterten, kombinierten Referenzen zu verwenden.
Typ - Handelt es sich um ein Bild oder um ein TextDokument
Konfidenz - Schwellenwert 0-99 für die Erkennung. Standard = 75. Der geeignetste Wert sollte mit dem Testfenster zuvor approximiert werden!
Rahmenfarbe - Farbe mit welcher der ermittelte Seitenrahmen später dargestellt wird.

====Randzugabe====

Falls beim Befehl Region of Interest die ermittelten Ränder nicht exakt genug sind, kann zu diesen zusätzlicher Rand angefügt werden. Die Randermittlung wird damit um diesen Bereich erweitert.

Oben / Links / Rechts / Unten - Randbereiche

[[Datei: Seitenränderfinden_71.png]]

[[Datei: Referenzranz_71.png]]

===Leere Seiten finden===

Versucht zu erkennen, ob eine Seite Inhalt hat. Speichert das Ergebniss beim zugehörigen Seitenrahmen. Ermöglicht das voraus bestimmen von leeren Seiten.

Links / Rechts ist leer - Markiert die ausgewählten Seiten alle als leere Seiten.
Konfidenz - Schwellenwert für die Unterscheidung. Der Wert sollte mit dem Testfenster auf dem Ausgangsmaterial ermittelt werden!
Stanzung - Versucht Stanzungen zu erkennen und schliesst diese für die Ermittlung aus.
Ränder - Versucht Ränder zu erkennen und schliesst diese für die Ermittlung aus.
[[Datei: Leerseitenfinden_71.png]]

== Nur Thumbnails erstellen==
Mit diesem Schritt können Sie auch Thumbnails, also reduzierte Bilddateien erstellen. Diese Dateien werden werden im Hilfsdatenordner abgelegt. Sie können in einem folgenden Schritt, zB Metadaten erfassen, dann auf diese Thumbnails zugreifen, indem sie dort konfigurieren, dass der Schritt 'Daten aus dem Hilfsordner beziehen soll'.
Im Seitenrahmen-Finden-Schritt muss ein 'sinnloser' Befehl konfiguriert werden, damit Helper den Schritt als gültig zulässt. Geben Sie zB eine Kontrasterhöhung um 0 ein.

[[Kategorie:Workflowschritt]]

Seitenrahmen finden

2026-03-03T12:26:09Z

Mirko Pepa: /* Drehung finden aus OCR */

;Mantiseinträge:
3256

;Systemtyp:
71

==Beschreibung==
Siehe auch: [[Erstellung von Seitenrahmen|Zusätzliche Worklfow Informationen]]

Ermöglicht die Ermittlung von Seitenrahmen, welche als Bild Regionen von Interesse zu verstehen sind.
Ist eine Vorstufe für die Schritte "Seitenrahmen Kontrollieren" und "Bilderstellung aus Rahmen".

Nutzt dafür Funktionen aus den GDPicture Komponenten, welche ebenfalls über das Testfenster "Fenstername" zur Verfügung stehen.

Nebst dem erkennen von Seitenrahmen, stehen Befehle für die Ausrichtung der Bilder und für die Erkennung von Leerseiten bereit.

'''Merke:''' Der Befehl Doppelseite teilen darf nur einmal angewendet werden!

Vertikales teilen ist aktuell noch nicht implementiert.

===HZ Versionen===

HZ Version >= 2.00

Erlaubt die ermittlung einer Region Of Interest (ROI) und teilt die Seiten über diese Region und nicht zwingend über die Seitenhälfte

HZ Version = 1.00

Teilt Seiten über die halbierung der Seitenlänge.

==Zugehörige Arbeitsschritte==

[[Seitenrahmen kontrollieren]]

[[Bilderstellung aus Rahmen]]

==Konfigurationsfenster==

[[Datei: Hauptmaske_71.png]]

==Grundeinstellungen==

Die Seitenrahmen müssen einen Namen erhalten. Dieser wird in späteren Arbeitschritte zur Identifikation verwendet.

Rahmenname - Die Bezeichnung für den Seitenrahmen
Reduzierte JPG-Dateien erstellen in Qualität XX Prozent

Zudem können Thumbnails erstellt werden mit der Option 'Reduzierte JPG-Dateien erstellen'. Diese Thumbnails werden in den Hilfsdatenordner gelegt. Die Originale werden nicht verändert.

==Befehle einrichten==

Neue Befehle werden über die grüne + Taste rechts unter der Liste hinzugefügt, welche beim drücken ein Kontextmenu mit den verfügbaren Befehlen anzeigt.

[[Datei: Befehle_71.png]]

Sind bereits Befehle in der Liste vorhanden, so wird ein neuer Befehl jeweils unter einem bereits markierten Befehl angefügt.

Über die rote Kreuz (X) Taste lässt sich ein Befehl, welcher dabei in der Befehlsliste ausgewählt sein muss, wieder entfernen.

Die Befehlsreihenfolge kann über die grünen Pfeiltasten geändert werden.

Das Markieren eines Befehls in der Liste lädt automatisch unter der Liste die zugehörigen Parameter.

==Verfügbare Befehle==

===Region of interest===

Ermittel einen Bildbereich von Interesse für die weitere Bearbeitung. Funktionalität ist analog wie der Befehl "Ränder finden", es wird jedoch kein Rahmen daraus erzeugt.

Der Befehl eignet sich z.B. um einen ersten groben Randbereich zu erkennen und diesen für die folgenden Befehle auszuschliessen.

Referenzrand - Referenzpunkt auf dem Bild, welcher aus Ausgangslage für das finden von Rändern genommen werden soll.
Typ - Handelt es sich um ein Bild oder um ein TextDokument
Konfidenz - Schwellenwert 0-99 für die Erkennung. Standard = 75. Der geeignetste Wert sollte mit dem Testfenster zuvor approximiert werden!

[[Datei: bvi.png]]

===Drehung finden aus Bild===

Ermittelt den Drehwinkel eines Bildes und speichert diesen. Aus der Dokumentation ist leider nicht ersichtlich welcher Algorithmus dem zu Grunde liegt.

Max Suchwinkel - Setzen Sie zB auf 10, dann werden Winkel bis +-10° gesucht. Ein Wert unter 15 wird empfohlen.
Min Suchwinkel - Bestimmt den kleinsten Winkel der gefunden wird. 0.25 wird empfohlen. Grössere Werte haben schnellere Ergebnisse zur Folge.
Optimistisch - Sollte gesetzt werden, wenn Sie sicher sind, dass alle Bilder schrägen Text enthalten.
Rotationsart - Standard = Bildgrösse beibehalten. Optional = Bild vergrössern. Sollte nur angewendet werden wenn,
Füllfarbe - Farbe mit welchen die entstehenden Spickel oder zusätzliche Bildbereiche gefüllt werden sollen. Sollte der Hintergrundsfarbe der Bilder entsprechen. Standard = Schwarz.

[[Datei: DrehungBild_71.png]]

[[Datei: Drehwinkel_option1_71.png]]

===Drehung finden aus OCR===

Ananlog zu Drehung finden aus Bild. Der Drehwinkel wird hier durch Auswerten der OCR Daten ermittelt: Es wird der Winkel des breitesten Textblocks genommen.

[[Datei: DrehungOCR_71.png]]

===Doppelseite teilen===

Erstellt aus einer Seite zwei getrennte Seiten, z.B. um Bücher in linke und rechte Seite zu splitten. Dieser Befehl führt zu einer getrennten Anwendung aller Folgebefehle auf die jeweilige Seite.

Die Seiten werden nur im Speicher getrennt weiter bearbeitet. Dabei wird das Bild nicht beschnitten, sondern die wegzuschneidende Fläche wird farblich aufgefüllt.

Unterstützt aktuell nur das Vertikale teilen (Option: Typ)

Typ - Auf welcher Achse soll die Datei geteilt werden. Standard = Vertikal teilen
Overlap - Anzahl Pixel um welche sich die Teilung überschneiden soll.
SuffixA - Suffix welcher der linke / obere Seitenrahmenname erhalten soll.
SuffixB - Suffix welcher der rechte / untere Seitenrahmenname erhalten soll.

[[Datei: Seiteteilen_71.png]]

===Ränder finden===

Hauptfunktion des Schrittes, welcher damit die Koordinaten für die Seitenrahmen festlegt.

Sucht nach Seitenränder, z.B. um weisse oder schwarze Bereiche rund um Text zu entfernen.

Referenzrand - Referenzpunkt auf dem Bild, welcher aus Ausgangslage für das finden von Rändern genommen werden soll. Bei zuvor geteilten Bildern sind ggf. die erweiterten, kombinierten Referenzen zu verwenden.
Typ - Handelt es sich um ein Bild oder um ein TextDokument
Konfidenz - Schwellenwert 0-99 für die Erkennung. Standard = 75. Der geeignetste Wert sollte mit dem Testfenster zuvor approximiert werden!
Rahmenfarbe - Farbe mit welcher der ermittelte Seitenrahmen später dargestellt wird.

====Randzugabe====

Falls beim Befehl Region of Interest die ermittelten Ränder nicht exakt genug sind, kann zu diesen zusätzlicher Rand angefügt werden. Die Randermittlung wird damit um diesen Bereich erweitert.

Oben / Links / Rechts / Unten - Randbereiche

[[Datei: Seitenränderfinden_71.png]]

[[Datei: Referenzranz_71.png]]

===Leere Seiten finden===

Versucht zu erkennen, ob eine Seite Inhalt hat. Speichert das Ergebniss beim zugehörigen Seitenrahmen. Ermöglicht das voraus bestimmen von leeren Seiten.

Links / Rechts ist leer - Markiert die ausgewählten Seiten alle als leere Seiten.
Konfidenz - Schwellenwert für die Unterscheidung. Der Wert sollte mit dem Testfenster auf dem Ausgangsmaterial ermittelt werden!
Stanzung - Versucht Stanzungen zu erkennen und schliesst diese für die Ermittlung aus.
Ränder - Versucht Ränder zu erkennen und schliesst diese für die Ermittlung aus.
[[Datei: Leerseitenfinden_71.png]]

== Nur Thumbnails erstellen==
Mit diesem Schritt können Sie auch Thumbnails, also reduzierte Bilddateien erstellen. Diese Dateien werden werden im Hilfsdatenordner abgelegt. Sie können in einem folgenden Schritt, zB Metadaten erfassen, dann auf diese Thumbnails zugreifen, indem sie dort konfigurieren, dass der Schritt 'Daten aus dem Hilfsordner beziehen soll'.
Im Seitenrahmen-Finden-Schritt muss ein 'sinnloser' Befehl konfiguriert werden, damit Helper den Schritt als gültig zulässt. Geben Sie zB eine Kontrasterhöhung um 0 ein.

[[Kategorie:Workflowschritt]]

Seitenrahmen finden

2026-03-03T12:23:24Z

Mirko Pepa: /* Drehung finden aus Bild */

;Mantiseinträge:
3256

;Systemtyp:
71

==Beschreibung==
Siehe auch: [[Erstellung von Seitenrahmen|Zusätzliche Worklfow Informationen]]

Ermöglicht die Ermittlung von Seitenrahmen, welche als Bild Regionen von Interesse zu verstehen sind.
Ist eine Vorstufe für die Schritte "Seitenrahmen Kontrollieren" und "Bilderstellung aus Rahmen".

Nutzt dafür Funktionen aus den GDPicture Komponenten, welche ebenfalls über das Testfenster "Fenstername" zur Verfügung stehen.

Nebst dem erkennen von Seitenrahmen, stehen Befehle für die Ausrichtung der Bilder und für die Erkennung von Leerseiten bereit.

'''Merke:''' Der Befehl Doppelseite teilen darf nur einmal angewendet werden!

Vertikales teilen ist aktuell noch nicht implementiert.

===HZ Versionen===

HZ Version >= 2.00

Erlaubt die ermittlung einer Region Of Interest (ROI) und teilt die Seiten über diese Region und nicht zwingend über die Seitenhälfte

HZ Version = 1.00

Teilt Seiten über die halbierung der Seitenlänge.

==Zugehörige Arbeitsschritte==

[[Seitenrahmen kontrollieren]]

[[Bilderstellung aus Rahmen]]

==Konfigurationsfenster==

[[Datei: Hauptmaske_71.png]]

==Grundeinstellungen==

Die Seitenrahmen müssen einen Namen erhalten. Dieser wird in späteren Arbeitschritte zur Identifikation verwendet.

Rahmenname - Die Bezeichnung für den Seitenrahmen
Reduzierte JPG-Dateien erstellen in Qualität XX Prozent

Zudem können Thumbnails erstellt werden mit der Option 'Reduzierte JPG-Dateien erstellen'. Diese Thumbnails werden in den Hilfsdatenordner gelegt. Die Originale werden nicht verändert.

==Befehle einrichten==

Neue Befehle werden über die grüne + Taste rechts unter der Liste hinzugefügt, welche beim drücken ein Kontextmenu mit den verfügbaren Befehlen anzeigt.

[[Datei: Befehle_71.png]]

Sind bereits Befehle in der Liste vorhanden, so wird ein neuer Befehl jeweils unter einem bereits markierten Befehl angefügt.

Über die rote Kreuz (X) Taste lässt sich ein Befehl, welcher dabei in der Befehlsliste ausgewählt sein muss, wieder entfernen.

Die Befehlsreihenfolge kann über die grünen Pfeiltasten geändert werden.

Das Markieren eines Befehls in der Liste lädt automatisch unter der Liste die zugehörigen Parameter.

==Verfügbare Befehle==

===Region of interest===

Ermittel einen Bildbereich von Interesse für die weitere Bearbeitung. Funktionalität ist analog wie der Befehl "Ränder finden", es wird jedoch kein Rahmen daraus erzeugt.

Der Befehl eignet sich z.B. um einen ersten groben Randbereich zu erkennen und diesen für die folgenden Befehle auszuschliessen.

Referenzrand - Referenzpunkt auf dem Bild, welcher aus Ausgangslage für das finden von Rändern genommen werden soll.
Typ - Handelt es sich um ein Bild oder um ein TextDokument
Konfidenz - Schwellenwert 0-99 für die Erkennung. Standard = 75. Der geeignetste Wert sollte mit dem Testfenster zuvor approximiert werden!

[[Datei: bvi.png]]

===Drehung finden aus Bild===

Ermittelt den Drehwinkel eines Bildes und speichert diesen. Aus der Dokumentation ist leider nicht ersichtlich welcher Algorithmus dem zu Grunde liegt.

Max Suchwinkel - Setzen Sie zB auf 10, dann werden Winkel bis +-10° gesucht. Ein Wert unter 15 wird empfohlen.
Min Suchwinkel - Bestimmt den kleinsten Winkel der gefunden wird. 0.25 wird empfohlen. Grössere Werte haben schnellere Ergebnisse zur Folge.
Optimistisch - Sollte gesetzt werden, wenn Sie sicher sind, dass alle Bilder schrägen Text enthalten.
Rotationsart - Standard = Bildgrösse beibehalten. Optional = Bild vergrössern. Sollte nur angewendet werden wenn,
Füllfarbe - Farbe mit welchen die entstehenden Spickel oder zusätzliche Bildbereiche gefüllt werden sollen. Sollte der Hintergrundsfarbe der Bilder entsprechen. Standard = Schwarz.

[[Datei: DrehungBild_71.png]]

[[Datei: Drehwinkel_option1_71.png]]

===Drehung finden aus OCR===

Ananlog zu Drehung finden aus Bild. Der Drehwinkel wird hier durch auswerten der OCR Daten ermittel.

[[Datei: DrehungOCR_71.png]]

===Doppelseite teilen===

Erstellt aus einer Seite zwei getrennte Seiten, z.B. um Bücher in linke und rechte Seite zu splitten. Dieser Befehl führt zu einer getrennten Anwendung aller Folgebefehle auf die jeweilige Seite.

Die Seiten werden nur im Speicher getrennt weiter bearbeitet. Dabei wird das Bild nicht beschnitten, sondern die wegzuschneidende Fläche wird farblich aufgefüllt.

Unterstützt aktuell nur das Vertikale teilen (Option: Typ)

Typ - Auf welcher Achse soll die Datei geteilt werden. Standard = Vertikal teilen
Overlap - Anzahl Pixel um welche sich die Teilung überschneiden soll.
SuffixA - Suffix welcher der linke / obere Seitenrahmenname erhalten soll.
SuffixB - Suffix welcher der rechte / untere Seitenrahmenname erhalten soll.

[[Datei: Seiteteilen_71.png]]

===Ränder finden===

Hauptfunktion des Schrittes, welcher damit die Koordinaten für die Seitenrahmen festlegt.

Sucht nach Seitenränder, z.B. um weisse oder schwarze Bereiche rund um Text zu entfernen.

Referenzrand - Referenzpunkt auf dem Bild, welcher aus Ausgangslage für das finden von Rändern genommen werden soll. Bei zuvor geteilten Bildern sind ggf. die erweiterten, kombinierten Referenzen zu verwenden.
Typ - Handelt es sich um ein Bild oder um ein TextDokument
Konfidenz - Schwellenwert 0-99 für die Erkennung. Standard = 75. Der geeignetste Wert sollte mit dem Testfenster zuvor approximiert werden!
Rahmenfarbe - Farbe mit welcher der ermittelte Seitenrahmen später dargestellt wird.

====Randzugabe====

Falls beim Befehl Region of Interest die ermittelten Ränder nicht exakt genug sind, kann zu diesen zusätzlicher Rand angefügt werden. Die Randermittlung wird damit um diesen Bereich erweitert.

Oben / Links / Rechts / Unten - Randbereiche

[[Datei: Seitenränderfinden_71.png]]

[[Datei: Referenzranz_71.png]]

===Leere Seiten finden===

Versucht zu erkennen, ob eine Seite Inhalt hat. Speichert das Ergebniss beim zugehörigen Seitenrahmen. Ermöglicht das voraus bestimmen von leeren Seiten.

Links / Rechts ist leer - Markiert die ausgewählten Seiten alle als leere Seiten.
Konfidenz - Schwellenwert für die Unterscheidung. Der Wert sollte mit dem Testfenster auf dem Ausgangsmaterial ermittelt werden!
Stanzung - Versucht Stanzungen zu erkennen und schliesst diese für die Ermittlung aus.
Ränder - Versucht Ränder zu erkennen und schliesst diese für die Ermittlung aus.
[[Datei: Leerseitenfinden_71.png]]

== Nur Thumbnails erstellen==
Mit diesem Schritt können Sie auch Thumbnails, also reduzierte Bilddateien erstellen. Diese Dateien werden werden im Hilfsdatenordner abgelegt. Sie können in einem folgenden Schritt, zB Metadaten erfassen, dann auf diese Thumbnails zugreifen, indem sie dort konfigurieren, dass der Schritt 'Daten aus dem Hilfsordner beziehen soll'.
Im Seitenrahmen-Finden-Schritt muss ein 'sinnloser' Befehl konfiguriert werden, damit Helper den Schritt als gültig zulässt. Geben Sie zB eine Kontrasterhöhung um 0 ein.

[[Kategorie:Workflowschritt]]

Seitenrahmen finden

2026-03-03T12:02:31Z

Mirko Pepa:

;Mantiseinträge:
3256

;Systemtyp:
71

==Beschreibung==
Siehe auch: [[Erstellung von Seitenrahmen|Zusätzliche Worklfow Informationen]]

Ermöglicht die Ermittlung von Seitenrahmen, welche als Bild Regionen von Interesse zu verstehen sind.
Ist eine Vorstufe für die Schritte "Seitenrahmen Kontrollieren" und "Bilderstellung aus Rahmen".

Nutzt dafür Funktionen aus den GDPicture Komponenten, welche ebenfalls über das Testfenster "Fenstername" zur Verfügung stehen.

Nebst dem erkennen von Seitenrahmen, stehen Befehle für die Ausrichtung der Bilder und für die Erkennung von Leerseiten bereit.

'''Merke:''' Der Befehl Doppelseite teilen darf nur einmal angewendet werden!

Vertikales teilen ist aktuell noch nicht implementiert.

===HZ Versionen===

HZ Version >= 2.00

Erlaubt die ermittlung einer Region Of Interest (ROI) und teilt die Seiten über diese Region und nicht zwingend über die Seitenhälfte

HZ Version = 1.00

Teilt Seiten über die halbierung der Seitenlänge.

==Zugehörige Arbeitsschritte==

[[Seitenrahmen kontrollieren]]

[[Bilderstellung aus Rahmen]]

==Konfigurationsfenster==

[[Datei: Hauptmaske_71.png]]

==Grundeinstellungen==

Die Seitenrahmen müssen einen Namen erhalten. Dieser wird in späteren Arbeitschritte zur Identifikation verwendet.

Rahmenname - Die Bezeichnung für den Seitenrahmen
Reduzierte JPG-Dateien erstellen in Qualität XX Prozent

Zudem können Thumbnails erstellt werden mit der Option 'Reduzierte JPG-Dateien erstellen'. Diese Thumbnails werden in den Hilfsdatenordner gelegt. Die Originale werden nicht verändert.

==Befehle einrichten==

Neue Befehle werden über die grüne + Taste rechts unter der Liste hinzugefügt, welche beim drücken ein Kontextmenu mit den verfügbaren Befehlen anzeigt.

[[Datei: Befehle_71.png]]

Sind bereits Befehle in der Liste vorhanden, so wird ein neuer Befehl jeweils unter einem bereits markierten Befehl angefügt.

Über die rote Kreuz (X) Taste lässt sich ein Befehl, welcher dabei in der Befehlsliste ausgewählt sein muss, wieder entfernen.

Die Befehlsreihenfolge kann über die grünen Pfeiltasten geändert werden.

Das Markieren eines Befehls in der Liste lädt automatisch unter der Liste die zugehörigen Parameter.

==Verfügbare Befehle==

===Region of interest===

Ermittel einen Bildbereich von Interesse für die weitere Bearbeitung. Funktionalität ist analog wie der Befehl "Ränder finden", es wird jedoch kein Rahmen daraus erzeugt.

Der Befehl eignet sich z.B. um einen ersten groben Randbereich zu erkennen und diesen für die folgenden Befehle auszuschliessen.

Referenzrand - Referenzpunkt auf dem Bild, welcher aus Ausgangslage für das finden von Rändern genommen werden soll.
Typ - Handelt es sich um ein Bild oder um ein TextDokument
Konfidenz - Schwellenwert 0-99 für die Erkennung. Standard = 75. Der geeignetste Wert sollte mit dem Testfenster zuvor approximiert werden!

[[Datei: bvi.png]]

===Drehung finden aus Bild===

Ermittelt den Drehwinkel von nicht horizontal ausgerichtetem Text und speichert diesen.

Max Suchwinkel - Setzen Sie zB auf 10, dann werden Winkel bis +-10° gesucht. Ein Wert unter 15 wird empfohlen.
Min Suchwinkel - Bestimmt den kleinsten Winkel der gefunden wird. 0.25 wird empfohlen. Grössere Werte haben schnellere Ergebnisse zur Folge.
Optimistisch - Sollte gesetzt werden, wenn Sie sicher sind, dass alle Bilder schrägen Text enthalten.
Rotationsart - Standard = Bildgrösse beibehalten. Optional = Bild vergrössern. Sollte nur angewendet werden wenn,
Füllfarbe - Farbe mit welchen die entstehenden Spickel oder zusätzliche Bildbereiche gefüllt werden sollen. Sollte der Hintergrundsfarbe der Bilder entsprechen. Standard = Schwarz.

[[Datei: DrehungBild_71.png]]

[[Datei: Drehwinkel_option1_71.png]]

===Drehung finden aus OCR===

Ananlog zu Drehung finden aus Bild. Der Drehwinkel wird hier durch auswerten der OCR Daten ermittel.

[[Datei: DrehungOCR_71.png]]

===Doppelseite teilen===

Erstellt aus einer Seite zwei getrennte Seiten, z.B. um Bücher in linke und rechte Seite zu splitten. Dieser Befehl führt zu einer getrennten Anwendung aller Folgebefehle auf die jeweilige Seite.

Die Seiten werden nur im Speicher getrennt weiter bearbeitet. Dabei wird das Bild nicht beschnitten, sondern die wegzuschneidende Fläche wird farblich aufgefüllt.

Unterstützt aktuell nur das Vertikale teilen (Option: Typ)

Typ - Auf welcher Achse soll die Datei geteilt werden. Standard = Vertikal teilen
Overlap - Anzahl Pixel um welche sich die Teilung überschneiden soll.
SuffixA - Suffix welcher der linke / obere Seitenrahmenname erhalten soll.
SuffixB - Suffix welcher der rechte / untere Seitenrahmenname erhalten soll.

[[Datei: Seiteteilen_71.png]]

===Ränder finden===

Hauptfunktion des Schrittes, welcher damit die Koordinaten für die Seitenrahmen festlegt.

Sucht nach Seitenränder, z.B. um weisse oder schwarze Bereiche rund um Text zu entfernen.

Referenzrand - Referenzpunkt auf dem Bild, welcher aus Ausgangslage für das finden von Rändern genommen werden soll. Bei zuvor geteilten Bildern sind ggf. die erweiterten, kombinierten Referenzen zu verwenden.
Typ - Handelt es sich um ein Bild oder um ein TextDokument
Konfidenz - Schwellenwert 0-99 für die Erkennung. Standard = 75. Der geeignetste Wert sollte mit dem Testfenster zuvor approximiert werden!
Rahmenfarbe - Farbe mit welcher der ermittelte Seitenrahmen später dargestellt wird.

====Randzugabe====

Falls beim Befehl Region of Interest die ermittelten Ränder nicht exakt genug sind, kann zu diesen zusätzlicher Rand angefügt werden. Die Randermittlung wird damit um diesen Bereich erweitert.

Oben / Links / Rechts / Unten - Randbereiche

[[Datei: Seitenränderfinden_71.png]]

[[Datei: Referenzranz_71.png]]

===Leere Seiten finden===

Versucht zu erkennen, ob eine Seite Inhalt hat. Speichert das Ergebniss beim zugehörigen Seitenrahmen. Ermöglicht das voraus bestimmen von leeren Seiten.

Links / Rechts ist leer - Markiert die ausgewählten Seiten alle als leere Seiten.
Konfidenz - Schwellenwert für die Unterscheidung. Der Wert sollte mit dem Testfenster auf dem Ausgangsmaterial ermittelt werden!
Stanzung - Versucht Stanzungen zu erkennen und schliesst diese für die Ermittlung aus.
Ränder - Versucht Ränder zu erkennen und schliesst diese für die Ermittlung aus.
[[Datei: Leerseitenfinden_71.png]]

== Nur Thumbnails erstellen==
Mit diesem Schritt können Sie auch Thumbnails, also reduzierte Bilddateien erstellen. Diese Dateien werden werden im Hilfsdatenordner abgelegt. Sie können in einem folgenden Schritt, zB Metadaten erfassen, dann auf diese Thumbnails zugreifen, indem sie dort konfigurieren, dass der Schritt 'Daten aus dem Hilfsordner beziehen soll'.
Im Seitenrahmen-Finden-Schritt muss ein 'sinnloser' Befehl konfiguriert werden, damit Helper den Schritt als gültig zulässt. Geben Sie zB eine Kontrasterhöhung um 0 ein.

[[Kategorie:Workflowschritt]]

Seitenrahmen finden

2026-03-03T10:34:03Z

Mirko Pepa: /* Drehung finden aus Bild */

;Mantiseinträge:
3256

;Systemtyp:
71

==Beschreibung==
Siehe auch: [[Erstellung von Seitenrahmen|Zusätzliche Worklfow Informationen]]

Ermöglicht die Ermittlung von Seitenrahmen, welche als Bild Regionen von Interesse zu verstehen sind.
Ist eine Vorstufe für die Schritte "Seitenrahmen Kontrollieren" und "Bilderstellung aus Rahmen".

Nutzt dafür Funktionen aus den GDPicture Komponenten, welche ebenfalls über das Testfenster "Fenstername" zur Verfügung stehen.

Nebst dem erkennen von Seitenrahmen, stehen Befehle für die Ausrichtung der Bilder und für die Erkennung von Leerseiten bereit.

'''Merke:''' Der Befehl Doppelseite teilen darf nur einmal angewendet werden!

Vertikales teilen ist aktuell noch nicht implementiert.

===HZ Versionen===

HZ Version >= 2.00

Erlaubt die ermittlung einer Region Of Interest (ROI) und teilt die Seiten über diese Region und nicht zwingend über die Seitenhälfte

HZ Version = 1.00

Teilt Seiten über die halbierung der Seitenlänge.

==Zugehörige Arbeitsschritte==

[[Seitenrahmen kontrollieren]]

[[Bilderstellung aus Rahmen]]

==Konfigurationsfenster==

[[Datei: Hauptmaske_71.png]]

==Grundeinstellungen==

Die Seitenrahmen müssen einen Namen erhalten. Dieser wird in späteren Arbeitschritte zur Identifikation verwendet.

Rahmenname - Die Bezeichnung für den Seitenrahmen
Reduzierte JPG-Dateien erstellen in Qualität XX Prozent

Zudem können Thumbnails erstellt werden mit der Option 'Reduzierte JPG-Dateien erstellen'. Diese Thumbnails werden in den Hilfsdatenordner gelegt. Die Originale werden nicht verändert.

==Befehle einrichten==

Neue Befehle werden über die grüne + Taste rechts unter der Liste hinzugefügt, welche beim drücken ein Kontextmenu mit den verfügbaren Befehlen anzeigt.

[[Datei: Befehle_71.png]]

Sind bereits Befehle in der Liste vorhanden, so wird ein neuer Befehl jeweils unter einem bereits markierten Befehl angefügt.

Über die rote Kreuz (X) Taste lässt sich ein Befehl, welcher dabei in der Befehlsliste ausgewählt sein muss, wieder entfernen.

Die Befehlsreihenfolge kann über die grünen Pfeiltasten geändert werden.

Das Markieren eines Befehls in der Liste lädt automatisch unter der Liste die zugehörigen Parameter.

==Verfügbare Befehle==

===Region of interest===

Ermittel einen Bildbereich von Interesse für die weitere Bearbeitung. Funktionalität ist analog wie der Befehl "Ränder finden", es wird jedoch kein Rahmen daraus erzeugt.

Der Befehl eignet sich z.B. um einen ersten groben Randbereich zu erkennen und diesen für die folgenden Befehle auszuschliessen.

Referenzrand - Referenzpunkt auf dem Bild, welcher aus Ausgangslage für das finden von Rändern genommen werden soll.
Typ - Handelt es sich um ein Bild oder um ein TextDokument
Konfidenz - Schwellenwert 0-99 für die Erkennung. Standard = 75. Der geeignetste Wert sollte mit dem Testfenster zuvor approximiert werden!

[[Datei: bvi.png]]

===Drehung finden aus Bild===

Ermittelt den Drehwinkel von nicht horizontal ausgerichtetem Text und speichert diesen.

Max Suchwinkel - Setzen Sie zB auf 10, dann werden Winkel bis +-10° gesucht. Ein Wert unter 15 wird empfohlen.
Min Suchwinkel - Bestimmt den kleinsten Winkel der gefunden wird. 0.25 wird empfohlen
Optimistisch - Sollte gesetzt werden, wenn alle Bilder schrägen Text enthalten.
Rotationsart - Standard = Bildgrösse beibehalten. Optional = Bild vergrössern. Sollte nur angewendet werden wenn,
Füllfarbe - Farbe mit welchen die entstehenden Spickel oder zusätzliche Bildbereiche gefüllt werden sollen. Sollte der Hintergrundsfarbe der Bilder entsprechen. Standard = Schwarz.

[[Datei: DrehungBild_71.png]]

[[Datei: Drehwinkel_option1_71.png]]

===Drehung finden aus OCR===

Ananlog zu Drehung finden aus Bild. Der Drehwinkel wird hier durch auswerten der OCR Daten ermittel.

[[Datei: DrehungOCR_71.png]]

===Doppelseite teilen===

Erstellt aus einer Seite zwei getrennte Seiten, z.B. um Bücher in linke und rechte Seite zu splitten. Dieser Befehl führt zu einer getrennten Anwendung aller Folgebefehle auf die jeweilige Seite.

Die Seiten werden nur im Speicher getrennt weiter bearbeitet. Dabei wird das Bild nicht beschnitten, sondern die wegzuschneidende Fläche wird farblich aufgefüllt.

Unterstützt aktuell nur das Vertikale teilen (Option: Typ)

Typ - Auf welcher Achse soll die Datei geteilt werden. Standard = Vertikal teilen
Overlap - Anzahl Pixel um welche sich die Teilung überschneiden soll.
SuffixA - Suffix welcher der linke / obere Seitenrahmenname erhalten soll.
SuffixB - Suffix welcher der rechte / untere Seitenrahmenname erhalten soll.

[[Datei: Seiteteilen_71.png]]

===Ränder finden===

Hauptfunktion des Schrittes, welcher damit die Koordinaten für die Seitenrahmen festlegt.

Sucht nach Seitenränder, z.B. um weisse oder schwarze Bereiche rund um Text zu entfernen.

Referenzrand - Referenzpunkt auf dem Bild, welcher aus Ausgangslage für das finden von Rändern genommen werden soll. Bei zuvor geteilten Bildern sind ggf. die erweiterten, kombinierten Referenzen zu verwenden.
Typ - Handelt es sich um ein Bild oder um ein TextDokument
Konfidenz - Schwellenwert 0-99 für die Erkennung. Standard = 75. Der geeignetste Wert sollte mit dem Testfenster zuvor approximiert werden!
Rahmenfarbe - Farbe mit welcher der ermittelte Seitenrahmen später dargestellt wird.

====Ranzugabe====

Falls beim Befehl Region of Interest die ermittelten Ränder nicht exakt genug sind, kann zu diesen zusätzlicher Rand angefügt werden. Die Randermittlung wird damit um diesen Bereich erweitert.

Oben / Links / Rechts / Unten - Randbereiche

[[Datei: Seitenränderfinden_71.png]]

[[Datei: Referenzranz_71.png]]

===Leere Seiten finden===

Versucht zu erkennen, ob eine Seite Inhalt hat. Speichert das Ergebniss beim zugehörigen Seitenrahmen. Ermöglicht das voraus bestimmen von leeren Seiten.

Links / Rechts ist leer - Markiert die ausgewählten Seiten alle als leere Seiten.
Konfidenz - Schwellenwert für die Unterscheidung. Der Wert sollte mit dem Testfenster auf dem Ausgangsmaterial ermittelt werden!
Stanzung - Versucht Stanzungen zu erkennen und schliesst diese für die Ermittlung aus.
Ränder - Versucht Ränder zu erkennen und schliesst diese für die Ermittlung aus.
[[Datei: Leerseitenfinden_71.png]]

== Nur Thumbnails erstellen==
Mit diesem Schritt können Sie auch Thumbnails, also reduzierte Bilddateien erstellen. Diese Dateien werden werden im Hilfsdatenordner abgelegt. Sie können in einem folgenden Schritt, zB Metadaten erfassen, dann auf diese Thumbnails zugreifen, indem sie dort konfigurieren, dass der Schritt 'Daten aus dem Hilfsordner beziehen soll'.
Im Seitenrahmen-Finden-Schritt muss ein 'sinnloser' Befehl konfiguriert werden, damit Helper den Schritt als gültig zulässt. Geben Sie zB eine Kontrasterhöhung um 0 ein.

[[Kategorie:Workflowschritt]]

Hauptseite

2026-02-16T15:50:15Z

Mirko Pepa: /* Aktuelles */

Herzlich willkommen im Support-Wiki zum «'''Helper'''»

«'''Helper'''» ist eine moderne '''ERP-Bürolösung''' speziell für das '''grafische Gewerbe''' mit Modulen für Druck- und Flexodruckvorstufenbetriebe, kleine Offset-, Digital-, und Siebdruckereien, sowie für Produktionsagenturen. 
«Helper» wird von '''[https://www.profile.ch Profile GmbH]''' in Winterthur ständig weiterentwickelt und ist seit mehr als 25 Jahren auf dem Markt gut eingeführt. 
«Helper» ist datenbankbasierend und als flexibles und modulares Programmsystem sowohl unter '''macOS''' wie auch unter '''Windows''' lauffähig und zudem auch als Webapplikation einsetzbar.

{|- valign="top" width="100%"
|valign="top" style="border: 1px solid gray;padding-left:1em;padding-right:0.5em;" width="40%"|

==Handbuch «Helper»==
[[:Kategorie:Handbuch Helper|Alle Handbuchseiten | Inhaltsübersicht]] | [[Kurse]]

===Bedienung===
[[Grundlegende Bildschirmelemente]], [[Help-Taste]], [[Grundmaske]]

===Stammdaten===
[[Kunden]], [[Lieferanten]], [[Artikel]], [[Personal]]

===Anwendungsmodule===
[[Aufträge]], [[Aufträge – Auftragszeilen|Auftragszeilen]], [[Offerten]], [[Verkauf]], [[Debitoren]], [[Einkauf]], [[Kreditoren]], [[Buchhaltung]], [[Gutschriften]], [[Korrespondenz]], [[CRM-Zentrale]], [[Listen]], [[Leistungsauswertung]], [[OCR-Suche]], [[MetaStar]], [[Cockpit]]

==Einrichten von «Helper»==

===Einstellungen===
[[Einstellungen |Alle Einstellungen | Übersicht]]

===Drucker- und Belegsteuerung===
[[Einrichten der Druckersteuerung]], [[Drucker]], [[Belegzuordnung]], [[Druckstapel]]

==Installation «Helper»==
[[Empfohlene Systemanforderungen]], [[Installation]], [[Helper als webbasierte Applikation]], [[Demo-Installation]]

===Technische Beschriebe===
[[:Kategorie:Hardware|Hardware]], [[LDAP einrichten]], [[Rechnungen signieren]], [[EBill]]

===Handbuch Serverarbeitsschritte===
[[Überblick]], [[Administrationsfenster für Jobs]], [[HLI Executoren]], [[Watchdog]], [[:Kategorie:Workflowschritt|Serverarbeitsschritte]], [[Übersicht über alle Workflowschritte]], [[:Kategorie:Workflowbeschreibungen|Workflowbeschreibungen]], [[Omnisgrundlagen]], [[Verfügbare Funktionen]], [[Archivierung von Metadaten]], [[Azure Document Intelligence]]

==Handbuch Leistungserfassung «LEFA»==
[[Installation LEFA|Installation]], [[Leistungserfassungsfenster]]

|valign="top" bgcolor="#E8F1FF" width="30%" style="border-style:solid;border-width:1px;border-color:gray;padding-left:1em;padding-right:1em;padding-top:0.5em;"|

==QuickSupport für macOS und Windows==

Falls wir uns auf Ihr System verbinden sollen:

*Kontaktieren Sie uns telefonisch unter '''+41 52 213 63 33'''.
*Klicken Sie auf den '''untenstehenden Link''' zum Starten des Fernsupport-Tools '''erst nach unserer Aufforderung'''.
*Geben Sie uns die '''Sitzungs-ID''' und das '''Kennwort''' für den Verbindungsaufbau bekannt.

[https://get.teamviewer.com/648xqq2 Fernwartung starten]
 
 
 

==FAQ/Troubleshooting==
*[[Helper startet nicht mehr]]
*[[Grundmaske|Ich möchte die Grundmaske anpassen/Die Grundmaske ist schwarz.]] 
*[[Grundlegende_Bildschirmelemente#Menü «Bearbeiten»|Ich möchte die Ausrichtung und Grösse der einzelnen Arbeitsfenster speichern.]] 
*[[Buchungsjahre|Ich möchte ab Oktober das folgende Buchungsjahr eröffnen.]]
*[https://shop.crealogix.com/scanner.html/?___store=de&___from_store=en| Ich suche einen QR-Code-Belegleser (externer Link)]
*[[Einstellungen Nummernkreise|Ich möchte das Aussehen der automatischen Belegnummerierungen zum neuen Jahr hin anpassen.]]
*[[:Kategorie:Troubleshooting]]
 
 

==Inhaltsübersicht==
>> [[:Kategorie:Handbuch Helper|Weiter zu «Alle Handbuchseiten»]] 

>> [[Einstellungen|Weiter zu «Alle Einstellungen»]]

|valign="top" bgcolor="#E8F1FF" style="border-style:solid;border-width:1px;border-color:gray;padding-left:1em;padding-right:1em;padding-top:0.5em;"|

== Aktuelles ==
[[Personal – Lohnbeiträge ändern|Höherer AHV-Beitragssatz ab 01. Januar 2020]]

[[Systemvoraussetzungen| MacOS 14/15/26/M1/M2/M3/M4]]

[[Buchungsjahre|Neues Buchungsjahr 2026 eröffnen]]

[[QR-Rechnung]]

[[Bankkonten|Umstellen auf den neuen ISO-20022-Zahlungsstandard]]

[[Anpassung des MwSt-Satzes|Neuer MwSt-Satz 8.1%]]

 
 

==Über Profile GmbH==
[https://www.profile.ch Homepage] 
[http://www.site.helper.ch/ Helper vorgestellt]
 
 

==Kontakt==

'''Profile GmbH''' 
Schaffhauserstr. 103 
Ruhtalstrasse 12 
8400 Winterthur 
Schweiz

Tel. +41 52 213 63 33 
[mailto:support@profile.ch?subject=Supportanfrage support@profile.ch]

__NOTOC__

Verfügbare Funktionen

2026-02-16T15:48:59Z

Mirko Pepa: /* Tips und Tricks zu Omnis Funktionen */

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. 

==Tips und Tricks zu Omnis Funktionen==
;jst: Teilweise muss man jst helfen, welcher Typ eine Ergebnis ist.
jst([DoSignatur]+0,...) So wird es sicher zu einer Zahl
jst("[DOSignatur]",...) So wird es sicher zu einem Text

Verfügbare Funktionen

2026-02-16T15:48:01Z

Mirko Pepa:

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. 

==Tips und Tricks zu Omnis Funktionen==
;jst: Teilweise muss man jst helfen, welcher Typ eine Ergbenis ist.
jst([DoSignatur]+0,...) So wird es sicher zu einer Zahl
jst("[DOSignatur]",...) So wird es sicher zu einem Text

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

2026-02-12T09:38:08Z

Mirko Pepa:

;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 [DOSignatur] 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]]

Seitenrahmen finden

2026-01-27T09:36:26Z

Mirko Pepa: /* Leere Seiten finden */

;Mantiseinträge:
3256

;Systemtyp:
71

==Beschreibung==
Siehe auch: [[Erstellung von Seitenrahmen|Zusätzliche Worklfow Informationen]]

Ermöglicht die Ermittlung von Seitenrahmen, welche als Bild Regionen von Interesse zu verstehen sind.
Ist eine Vorstufe für die Schritte "Seitenrahmen Kontrollieren" und "Bilderstellung aus Rahmen".

Nutzt dafür Funktionen aus den GDPicture Komponenten, welche ebenfalls über das Testfenster "Fenstername" zur Verfügung stehen.

Nebst dem erkennen von Seitenrahmen, stehen Befehle für die Ausrichtung der Bilder und für die Erkennung von Leerseiten bereit.

'''Merke:''' Der Befehl Doppelseite teilen darf nur einmal angewendet werden!

Vertikales teilen ist aktuell noch nicht implementiert.

===HZ Versionen===

HZ Version >= 2.00

Erlaubt die ermittlung einer Region Of Interest (ROI) und teilt die Seiten über diese Region und nicht zwingend über die Seitenhälfte

HZ Version = 1.00

Teilt Seiten über die halbierung der Seitenlänge.

==Zugehörige Arbeitsschritte==

[[Seitenrahmen kontrollieren]]

[[Bilderstellung aus Rahmen]]

==Konfigurationsfenster==

[[Datei: Hauptmaske_71.png]]

==Grundeinstellungen==

Die Seitenrahmen müssen einen Namen erhalten. Dieser wird in späteren Arbeitschritte zur Identifikation verwendet.

Rahmenname - Die Bezeichnung für den Seitenrahmen
Reduzierte JPG-Dateien erstellen in Qualität XX Prozent

Zudem können Thumbnails erstellt werden mit der Option 'Reduzierte JPG-Dateien erstellen'. Diese Thumbnails werden in den Hilfsdatenordner gelegt. Die Originale werden nicht verändert.

==Befehle einrichten==

Neue Befehle werden über die grüne + Taste rechts unter der Liste hinzugefügt, welche beim drücken ein Kontextmenu mit den verfügbaren Befehlen anzeigt.

[[Datei: Befehle_71.png]]

Sind bereits Befehle in der Liste vorhanden, so wird ein neuer Befehl jeweils unter einem bereits markierten Befehl angefügt.

Über die rote Kreuz (X) Taste lässt sich ein Befehl, welcher dabei in der Befehlsliste ausgewählt sein muss, wieder entfernen.

Die Befehlsreihenfolge kann über die grünen Pfeiltasten geändert werden.

Das Markieren eines Befehls in der Liste lädt automatisch unter der Liste die zugehörigen Parameter.

==Verfügbare Befehle==

===Region of interest===

Ermittel einen Bildbereich von Interesse für die weitere Bearbeitung. Funktionalität ist analog wie der Befehl "Ränder finden", es wird jedoch kein Rahmen daraus erzeugt.

Der Befehl eignet sich z.B. um einen ersten groben Randbereich zu erkennen und diesen für die folgenden Befehle auszuschliessen.

Referenzrand - Referenzpunkt auf dem Bild, welcher aus Ausgangslage für das finden von Rändern genommen werden soll.
Typ - Handelt es sich um ein Bild oder um ein TextDokument
Konfidenz - Schwellenwert 0-99 für die Erkennung. Standard = 75. Der geeignetste Wert sollte mit dem Testfenster zuvor approximiert werden!

[[Datei: bvi.png]]

===Drehung finden aus Bild===

Ermittelt den Drehwinkel von nicht horizontal ausgerichtetem Text und speichert diesen.

MaxSuchwinkel - Alles darüber wird nicht berücksichtig
Min Suchwinkel - Alles darunter wird nicht berücksichtigt
Optimistisch - Sollte gesetzt werden, wenn alle Bilder schrägen Text enthalten.
Rotationsart - Standard = Bildgrösse beibehalten. Optional = Bild vergrössern. Sollte nur angewendet werden wenn,
Füllfarbe - Farbe mit welchen die entstehenden Spickel oder zusätzliche Bildbereiche gefüllt werden sollen. Sollte der Hintergrundsfarbe der Bilder entsprechen. Standard = Schwarz.

[[Datei: DrehungBild_71.png]]

[[Datei: Drehwinkel_option1_71.png]]

===Drehung finden aus OCR===

Ananlog zu Drehung finden aus Bild. Der Drehwinkel wird hier durch auswerten der OCR Daten ermittel.

[[Datei: DrehungOCR_71.png]]

===Doppelseite teilen===

Erstellt aus einer Seite zwei getrennte Seiten, z.B. um Bücher in linke und rechte Seite zu splitten. Dieser Befehl führt zu einer getrennten Anwendung aller Folgebefehle auf die jeweilige Seite.

Die Seiten werden nur im Speicher getrennt weiter bearbeitet. Dabei wird das Bild nicht beschnitten, sondern die wegzuschneidende Fläche wird farblich aufgefüllt.

Unterstützt aktuell nur das Vertikale teilen (Option: Typ)

Typ - Auf welcher Achse soll die Datei geteilt werden. Standard = Vertikal teilen
Overlap - Anzahl Pixel um welche sich die Teilung überschneiden soll.
SuffixA - Suffix welcher der linke / obere Seitenrahmenname erhalten soll.
SuffixB - Suffix welcher der rechte / untere Seitenrahmenname erhalten soll.

[[Datei: Seiteteilen_71.png]]

===Ränder finden===

Hauptfunktion des Schrittes, welcher damit die Koordinaten für die Seitenrahmen festlegt.

Sucht nach Seitenränder, z.B. um weisse oder schwarze Bereiche rund um Text zu entfernen.

Referenzrand - Referenzpunkt auf dem Bild, welcher aus Ausgangslage für das finden von Rändern genommen werden soll. Bei zuvor geteilten Bildern sind ggf. die erweiterten, kombinierten Referenzen zu verwenden.
Typ - Handelt es sich um ein Bild oder um ein TextDokument
Konfidenz - Schwellenwert 0-99 für die Erkennung. Standard = 75. Der geeignetste Wert sollte mit dem Testfenster zuvor approximiert werden!
Rahmenfarbe - Farbe mit welcher der ermittelte Seitenrahmen später dargestellt wird.

====Ranzugabe====

Falls beim Befehl Region of Interest die ermittelten Ränder nicht exakt genug sind, kann zu diesen zusätzlicher Rand angefügt werden. Die Randermittlung wird damit um diesen Bereich erweitert.

Oben / Links / Rechts / Unten - Randbereiche

[[Datei: Seitenränderfinden_71.png]]

[[Datei: Referenzranz_71.png]]

===Leere Seiten finden===

Versucht zu erkennen, ob eine Seite Inhalt hat. Speichert das Ergebniss beim zugehörigen Seitenrahmen. Ermöglicht das voraus bestimmen von leeren Seiten.

Links / Rechts ist leer - Markiert die ausgewählten Seiten alle als leere Seiten.
Konfidenz - Schwellenwert für die Unterscheidung. Der Wert sollte mit dem Testfenster auf dem Ausgangsmaterial ermittelt werden!
Stanzung - Versucht Stanzungen zu erkennen und schliesst diese für die Ermittlung aus.
Ränder - Versucht Ränder zu erkennen und schliesst diese für die Ermittlung aus.
[[Datei: Leerseitenfinden_71.png]]

== Nur Thumbnails erstellen==
Mit diesem Schritt können Sie auch Thumbnails, also reduzierte Bilddateien erstellen. Diese Dateien werden werden im Hilfsdatenordner abgelegt. Sie können in einem folgenden Schritt, zB Metadaten erfassen, dann auf diese Thumbnails zugreifen, indem sie dort konfigurieren, dass der Schritt 'Daten aus dem Hilfsordner beziehen soll'.
Im Seitenrahmen-Finden-Schritt muss ein 'sinnloser' Befehl konfiguriert werden, damit Helper den Schritt als gültig zulässt. Geben Sie zB eine Kontrasterhöhung um 0 ein.

[[Kategorie:Workflowschritt]]

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

2026-01-20T13:56:12Z

Mirko Pepa: /* Essentielle Felder */

;Mantiseinträge:
1973, 2980
;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.

==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")

==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-20T13:50:58Z

Mirko Pepa: /* Essentielle Felder */

;Mantiseinträge:
1973, 2980
;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.

==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")

==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 gesucht werden soll im Fall 'Trennen nach OCR-Text' ''

;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]]

Metadaten umwandeln

2026-01-20T08:41:15Z

Mirko Pepa: /* Version 0 */

;Mantiseinträge:
1878
;Systemtyp:
23

==Beschreibung==
Besteht aus einem Serverjob OJOHZDOMetadatenUmwandeln. Wandelt die einzelnen Metadaten eines Objektes um.

===Version 0===
'''Metadatenfelder müssen Anführungszeichen haben!'''

Die Bedingung kommt in das Feld Bezeichnung und ist in Omnis Code zu schreiben. Einige Beispiele hier:
Name=len('[Belegnummer]')> 5
Vorname=not(isclear(len('[MurdockCode]')))

===Version 1===
'''Um den Namen eines Metadatenfeldes darf kein Anführungszeichen stehen!'''

Die Bedingung kommt in das Feld HZ_FORMEL und HZ_VERSION muss 1.00 sein
Name=len([Sprache])<1

Wenn es in den Werten des Metadatums Anführungszeichen hat, dann funktioniert das hier.

==Konfiguration==

Formel:

Unterstützt die Eingabe von mehreren Formelzeilen (durch Zeilenumbruch getrennt) im Format "Metadatum=Formel".

Bsp.:
Jahr=2*[Monat]+left([Gugus],2)
Büronummer=pos('2',[Büronummer])

Spezielle Platzhalter:
* [DOSignatur] für Zugriff auf Signatur
* [DOOberSignatur] für Zugriff auf Signatur des Vaters
* [^MetaFeld] für Zugriff auf Metadaten des Vaters
* [^^MetaFeld] für Zugriff auf Metadaten des Grossvaters
* [*MetaFeld] für Zugriff auf Metadaten eines Vorfahren (Vater, Grossvater etc.)

Weitere Beispiele
* Typ="PDF"

Funktionsverzeichnis:
https://www.omnis.net/developers/resources/onlinedocs/index.jsp?detail=FunctionRef/index.html

==Funktionen==
[https://helper.ch/wiki/index.php?title=Verfügbare_Funktionen Siehe: Verfügbare Funktionen]

==Essentielle Felder==
HZ_FORMEL ''Dient der Formel für die Metadaten Zuweisung/Umwandlung''

==Pane im Produktionsauftrag==

[[Datei:MetadatenUmwandelnKonfig.png]]

[[Kategorie:Workflowschritt]]

Metadaten umwandeln

2026-01-20T08:40:45Z

Mirko Pepa: /* Version 1 */

;Mantiseinträge:
1878
;Systemtyp:
23

==Beschreibung==
Besteht aus einem Serverjob OJOHZDOMetadatenUmwandeln. Wandelt die einzelnen Metadaten eines Objektes um.

===Version 0===
'''Metadatenfelder müssen Anführungszeichen haben!'''

Die Bedingung kommt in das Feld Bezeichnung und ist in Omnis Code zu schreiben. Einige Beispiele hier:
:- len('[Belegnummer]')> 5
:- not(isclear(len('[MurdockCode]')))

===Version 1===
'''Um den Namen eines Metadatenfeldes darf kein Anführungszeichen stehen!'''

Die Bedingung kommt in das Feld HZ_FORMEL und HZ_VERSION muss 1.00 sein
Name=len([Sprache])<1

Wenn es in den Werten des Metadatums Anführungszeichen hat, dann funktioniert das hier.

==Konfiguration==

Formel:

Unterstützt die Eingabe von mehreren Formelzeilen (durch Zeilenumbruch getrennt) im Format "Metadatum=Formel".

Bsp.:
Jahr=2*[Monat]+left([Gugus],2)
Büronummer=pos('2',[Büronummer])

Spezielle Platzhalter:
* [DOSignatur] für Zugriff auf Signatur
* [DOOberSignatur] für Zugriff auf Signatur des Vaters
* [^MetaFeld] für Zugriff auf Metadaten des Vaters
* [^^MetaFeld] für Zugriff auf Metadaten des Grossvaters
* [*MetaFeld] für Zugriff auf Metadaten eines Vorfahren (Vater, Grossvater etc.)

Weitere Beispiele
* Typ="PDF"

Funktionsverzeichnis:
https://www.omnis.net/developers/resources/onlinedocs/index.jsp?detail=FunctionRef/index.html

==Funktionen==
[https://helper.ch/wiki/index.php?title=Verfügbare_Funktionen Siehe: Verfügbare Funktionen]

==Essentielle Felder==
HZ_FORMEL ''Dient der Formel für die Metadaten Zuweisung/Umwandlung''

==Pane im Produktionsauftrag==

[[Datei:MetadatenUmwandelnKonfig.png]]

[[Kategorie:Workflowschritt]]

Metadaten umwandeln

2026-01-20T08:40:13Z

Mirko Pepa: /* Version 1 */

;Mantiseinträge:
1878
;Systemtyp:
23

==Beschreibung==
Besteht aus einem Serverjob OJOHZDOMetadatenUmwandeln. Wandelt die einzelnen Metadaten eines Objektes um.

===Version 0===
'''Metadatenfelder müssen Anführungszeichen haben!'''

Die Bedingung kommt in das Feld Bezeichnung und ist in Omnis Code zu schreiben. Einige Beispiele hier:
:- len('[Belegnummer]')> 5
:- not(isclear(len('[MurdockCode]')))

===Version 1===
'''Um den Namen eines Metadatenfeldes darf kein Anführungszeichen stehen!'''

Die Bedingung kommt in das Feld HZ_FORMEL und HZ_VERSION muss 1.00 sein
:- len([Sprache])<1

Wenn es in den Werten des Metadatums Anführungszeichen hat, dann funktioniert das hier.

==Konfiguration==

Formel:

Unterstützt die Eingabe von mehreren Formelzeilen (durch Zeilenumbruch getrennt) im Format "Metadatum=Formel".

Bsp.:
Jahr=2*[Monat]+left([Gugus],2)
Büronummer=pos('2',[Büronummer])

Spezielle Platzhalter:
* [DOSignatur] für Zugriff auf Signatur
* [DOOberSignatur] für Zugriff auf Signatur des Vaters
* [^MetaFeld] für Zugriff auf Metadaten des Vaters
* [^^MetaFeld] für Zugriff auf Metadaten des Grossvaters
* [*MetaFeld] für Zugriff auf Metadaten eines Vorfahren (Vater, Grossvater etc.)

Weitere Beispiele
* Typ="PDF"

Funktionsverzeichnis:
https://www.omnis.net/developers/resources/onlinedocs/index.jsp?detail=FunctionRef/index.html

==Funktionen==
[https://helper.ch/wiki/index.php?title=Verfügbare_Funktionen Siehe: Verfügbare Funktionen]

==Essentielle Felder==
HZ_FORMEL ''Dient der Formel für die Metadaten Zuweisung/Umwandlung''

==Pane im Produktionsauftrag==

[[Datei:MetadatenUmwandelnKonfig.png]]

[[Kategorie:Workflowschritt]]

Postversand

2026-01-16T13:53:25Z

Mirko Pepa:

==Allgemeines==
Mit diesem Fenster können Sie eine Paketnummer mehreren Aufträgen zuweisen. Sie finden es unter 'Hauptmaske > Archiv > Postversand'.

==Vorbereitung==
===Scanner===
Sie benötigen einen Strichcodescanner, um die Codes einzulesen. Ein Beispiel für einen solchen Scanner ist der [https://www.digitec.ch/de/s1/product/datalogic-quickscan-qbt2101-1d-barcodes-barcode-scanner-10127817 Quickscan 2100 von Datalogic (bzw. Nachfolger)] oder der [https://www.digitec.ch/de/s1/product/manhattan-ccd-long-range-1d-barcodes-barcode-scanner-2402457 Manhattan 177672].

===Laufzettel===
Idealerweise haben Sie auf dem Laufzettel einen Barcode. Wir können Ihnen das sehr einfach darauf layouten. Fragen Sie uns.

===Definieren===
Im Lieferanten Fenster, unter Bestellung, suchen Sie diejenigen heraus, die als Paketdienst verwendet werden und setzen das Häkchen bei 'Ist ein Paketdienst'. Definieren Sie danach die URL, die im Email an die Kunden verwendet wird, um die Tracking Seite aufzurufen.
<div>
http://www.helper.ch/bilder/Barcode.png
</div>
===Text Baustein definieren===
Definieren Sie unter Einstellungen > Tabellen > Text > Textbausteine (formatierbar)den Textblock für das Informationsmail definieren. Er sollten den Namen 'Emailtexte:AK:Paketmail' haben. Wenn Sie dies nicht tun, dann erstellt der Helper automatisch einen mit folgendem Text, den Sie später noch bearbeiten können:
<pre>
[Anrede]

Folgende Positionen sind unterwegs zu Ihnen:

[Aufträge]

Sie können den Status Ihren Pakets hier überprüfen:
[Sendungsnummer]

Freundliche Grüsse
[Firma]
</pre>
'''Mögliche Elemente:'''
* '''Anrede:''' Die Anrede ist im Kunden oder der Ansprechsperson des Auftrags definiert.
* '''Aufträge:''' Liste mit den Aufträge, die in diesem Paket an den Kunden/die Ansprechsperson gehen.
* '''Sendungsnummer:''' Link zur Tracking Seite.
* '''Firma:''' Name Ihrer Firma.

Alternativ zum Element 'Aufträge', können Sie diesen Block auch selbst definieren:
* '''Start Aufträge:''' Beginn des Blocks.
* '''Ende Aufträge:''' Ende des Blocks.
* '''Auftragsnummer:''' Die Auftragsnummer.
* '''Sujet:''' Das Sujet.
* '''Auftragsnummer:''' Die Auftragsnummer.
* '''Auftrag Kunde:''' Ihr Zeichen/Bestellnummer.
* '''Artikelnummer:''' Artikelnummer (Individueller Text 2).
* '''Endkunde:''' Endkunde (Individueller Text 3).

==Arbeit mit dem Fenster==
===Scannen===
# '''Aufträge:''' Bekannte Auftragsnummern erfasst der Helper als Aufträge und fügt sie zur Liste hinzu.
# '''Paketdienste:''' Zahlen zwischen 1 und 99 interpretiert der Helper als Paketdienst und der entsprechende Anbieter wird ausgewählt.
# '''Sendungsnummer:''' Die Sendungsnummer auf dem Paket müssen Sie als letztes scannen, damit der Helper sie dann zu allen Aufträgen hinzugefügen kann.
'''Beispiel:'''
Zuerst schiessen Sie drei Aufträge ab, dann können Sie die Paketnummer einlesen. Nachdem Sie kontrolliert haben, dass alles stimmt, können Sie speichern.

==Mails==
Wenn Sie die Liste speichern und bei 'Kein Email schicken' kein Häkchen gesetzt haben, dann werden Emails generiert, um die Kunden über den Paketstatus zu informieren. 
Bei den Mails wird zuerst geschaut, ob eine Ansprechsperson vorhanden ist. Wenn dem Auftrag hingegen keine zugewiesen wurde, dann geht das Mail direkt an den Kunden. 
''Das Mail wird nicht sofort geschickt, sondern ein Fenster Ihres Mailprogramms geht auf.''

==Weblinks==
Der Font für die Barcodes ist [http://www.dafont.com/3of9-barcode.font 3 of 9 Barcode]

[[Kategorie:Handbuch Helper]]

Postversand

2026-01-16T13:51:58Z

Mirko Pepa:

==Allgemeines==
Mit diesem Fenster können Sie eine Paketnummer mehreren Aufträgen zuweisen. Sie finden es unter 'Hauptmaske > Archiv > Postversand'.

==Vorbereitung==
===Scanner===
Sie benötigen einen Strichcodescanner, um die Codes einzulesen. Ein Beispiel für einen solchen Scanner ist der [https://www.digitec.ch/de/s1/product/datalogic-quickscan-qbt2101-1d-barcodes-barcode-scanner-10127817 Quickscan 2100 von Datalogic (bzw. Nachfolger)] oder der [https://www.digitec.ch/de/s1/product/manhattan-ccd-long-range-1d-barcodes-barcode-scanner-2402457 Manhattan 177672].

===Definieren===
Im Lieferanten Fenster, unter Bestellung, suchen Sie diejenigen heraus, die als Paketdienst verwendet werden und setzen das Häkchen bei 'Ist ein Paketdienst'. Definieren Sie danach die URL, die im Email an die Kunden verwendet wird, um die Tracking Seite aufzurufen.
<div>
http://www.helper.ch/bilder/Barcode.png
</div>
===Text Baustein definieren===
Definieren Sie unter Einstellungen > Tabellen > Text > Textbausteine (formatierbar)den Textblock für das Informationsmail definieren. Er sollten den Namen 'Emailtexte:AK:Paketmail' haben. Wenn Sie dies nicht tun, dann erstellt der Helper automatisch einen mit folgendem Text, den Sie später noch bearbeiten können:
<pre>
[Anrede]

Folgende Positionen sind unterwegs zu Ihnen:

[Aufträge]

Sie können den Status Ihren Pakets hier überprüfen:
[Sendungsnummer]

Freundliche Grüsse
[Firma]
</pre>
'''Mögliche Elemente:'''
* '''Anrede:''' Die Anrede ist im Kunden oder der Ansprechsperson des Auftrags definiert.
* '''Aufträge:''' Liste mit den Aufträge, die in diesem Paket an den Kunden/die Ansprechsperson gehen.
* '''Sendungsnummer:''' Link zur Tracking Seite.
* '''Firma:''' Name Ihrer Firma.

Alternativ zum Element 'Aufträge', können Sie diesen Block auch selbst definieren:
* '''Start Aufträge:''' Beginn des Blocks.
* '''Ende Aufträge:''' Ende des Blocks.
* '''Auftragsnummer:''' Die Auftragsnummer.
* '''Sujet:''' Das Sujet.
* '''Auftragsnummer:''' Die Auftragsnummer.
* '''Auftrag Kunde:''' Ihr Zeichen/Bestellnummer.
* '''Artikelnummer:''' Artikelnummer (Individueller Text 2).
* '''Endkunde:''' Endkunde (Individueller Text 3).

==Arbeit mit dem Fenster==
===Scannen===
# '''Aufträge:''' Bekannte Auftragsnummern erfasst der Helper als Aufträge und fügt sie zur Liste hinzu.
# '''Paketdienste:''' Zahlen zwischen 1 und 99 interpretiert der Helper als Paketdienst und der entsprechende Anbieter wird ausgewählt.
# '''Sendungsnummer:''' Die Sendungsnummer auf dem Paket müssen Sie als letztes scannen, damit der Helper sie dann zu allen Aufträgen hinzugefügen kann.
'''Beispiel:'''
Zuerst schiessen Sie drei Aufträge ab, dann können Sie die Paketnummer einlesen. Nachdem Sie kontrolliert haben, dass alles stimmt, können Sie speichern.

==Mails==
Wenn Sie die Liste speichern und bei 'Kein Email schicken' kein Häkchen gesetzt haben, dann werden Emails generiert, um die Kunden über den Paketstatus zu informieren. 
Bei den Mails wird zuerst geschaut, ob eine Ansprechsperson vorhanden ist. Wenn dem Auftrag hingegen keine zugewiesen wurde, dann geht das Mail direkt an den Kunden. 
''Das Mail wird nicht sofort geschickt, sondern ein Fenster Ihres Mailprogramms geht auf.''

==Weblinks==
Der Font für die Barcodes ist [http://www.dafont.com/3of9-barcode.font 3 of 9 Barcode]

[[Kategorie:Handbuch Helper]]

Postversand

2026-01-16T13:44:31Z

Mirko Pepa: /* Scanner */

==Allgemeines==
Mit diesem Fenster können Sie eine Paketnummer mehreren Aufträgen zuweisen. Sie finden es unter 'Hauptmaske > Archiv > Postversand'.

==Vorbereitung==
===Scanner===
Sie benötigen einen Strichcodescanner, um die Codes einzulesen. Ein Beispiel für einen solchen Scanner ist der [http://www.adc.datalogic.com/QuickScan-I-QM2100_prd_prd165_10.html Quickscan 2100 von Datalogic]

===Definieren===
Im Lieferanten Fenster, unter Bestellung, suchen Sie diejenigen heraus, die als Paketdienst verwendet werden und setzen das Häkchen bei 'Ist ein Paketdienst'. Definieren Sie danach die URL, die im Email an die Kunden verwendet wird, um die Tracking Seite aufzurufen.
<div>
http://www.helper.ch/bilder/Barcode.png
</div>
===Text Baustein definieren===
Definieren Sie unter Einstellungen > Tabellen > Text > Textbausteine (formatierbar)den Textblock für das Informationsmail definieren. Er sollten den Namen 'Emailtexte:AK:Paketmail' haben. Wenn Sie dies nicht tun, dann erstellt der Helper automatisch einen mit folgendem Text, den Sie später noch bearbeiten können:
<pre>
[Anrede]

Folgende Positionen sind unterwegs zu Ihnen:

[Aufträge]

Sie können den Status Ihren Pakets hier überprüfen:
[Sendungsnummer]

Freundliche Grüsse
[Firma]
</pre>
'''Mögliche Elemente:'''
* '''Anrede:''' Die Anrede ist im Kunden oder der Ansprechsperson des Auftrags definiert.
* '''Aufträge:''' Liste mit den Aufträge, die in diesem Paket an den Kunden/die Ansprechsperson gehen.
* '''Sendungsnummer:''' Link zur Tracking Seite.
* '''Firma:''' Name Ihrer Firma.

Alternativ zum Element 'Aufträge', können Sie diesen Block auch selbst definieren:
* '''Start Aufträge:''' Beginn des Blocks.
* '''Ende Aufträge:''' Ende des Blocks.
* '''Auftragsnummer:''' Die Auftragsnummer.
* '''Sujet:''' Das Sujet.
* '''Auftragsnummer:''' Die Auftragsnummer.
* '''Auftrag Kunde:''' Ihr Zeichen/Bestellnummer.
* '''Artikelnummer:''' Artikelnummer (Individueller Text 2).
* '''Endkunde:''' Endkunde (Individueller Text 3).

==Arbeit mit dem Fenster==
===Scannen===
# '''Aufträge:''' Bekannte Auftragsnummern erfasst der Helper als Aufträge und fügt sie zur Liste hinzu.
# '''Paketdienste:''' Zahlen zwischen 1 und 99 interpretiert der Helper als Paketdienst und der entsprechende Anbieter wird ausgewählt.
# '''Sendungsnummer:''' Die Sendungsnummer auf dem Paket müssen Sie als letztes scannen, damit der Helper sie dann zu allen Aufträgen hinzugefügen kann.
'''Beispiel:'''
Zuerst schiessen Sie drei Aufträge ab, dann können Sie die Paketnummer einlesen. Nachdem Sie kontrolliert haben, dass alles stimmt, können Sie speichern.

==Mails==
Wenn Sie die Liste speichern und bei 'Kein Email schicken' kein Häkchen gesetzt haben, dann werden Emails generiert, um die Kunden über den Paketstatus zu informieren. 
Bei den Mails wird zuerst geschaut, ob eine Ansprechsperson vorhanden ist. Wenn dem Auftrag hingegen keine zugewiesen wurde, dann geht das Mail direkt an den Kunden. 
''Das Mail wird nicht sofort geschickt, sondern ein Fenster Ihres Mailprogramms geht auf.''

==Weblinks==
Der Font für die Barcodes ist [http://www.dafont.com/3of9-barcode.font 3 of 9 Barcode]

[[Kategorie:Handbuch Helper]]

Barcodeleser

2026-01-16T13:40:01Z

Mirko Pepa:

Der Einsatz eines Barcodeleser (Strichcodeleser) hilft Ihnen im betrieblichen Ablauf, effizient bestehende Daten in ein anderes System zu übertragen.

Wir haben folgendes Modell auf macOS und Windows getestet:
* Manhattan 177672 [https://www.digitec.ch/de/s1/product/manhattan-ccd-long-range-1d-barcodes-barcode-scanner-2402457 Link zu digitec]

Vermutlich gehen aber alle Geräte, die für das entsprechende Betriebssystem zertifiziert sind und sich dort wie eine Tastatur verhalten.

===Barcodeschrift===
Meistens verwenden wir den Barcode 39 [[https://de.wikipedia.org/wiki/Code_39]], den es auch als frei verfügbaren Font gibt.

===Anwendungsbeispiel===

Der Produkte-Laufzettel im Auftragsmodul wird mit einem Barcode ausgegeben.

[[Datei:Barcode Laufzettel.png]]

''Abbildung: Barcode-Beispiel auf Laufzettel''

[[Kategorie:Handbuch Helper]] [[Kategorie:Hardware]]

Barcodeleser

2026-01-16T13:37:55Z

Mirko Pepa:

Der Einsatz eines Barcodeleser (Strichcodeleser) hilft Ihnen im betrieblichen Ablauf, effizient bestehende Daten in ein anderes System zu übertragen.

Wir haben folgendes Modell auf macOS und Windows getestet:
* Manhattan 177672 [https://www.digitec.ch/de/s1/product/manhattan-ccd-long-range-1d-barcodes-barcode-scanner-2402457|Link zu digitec]

Vermutlich gehen aber alle Geräte, die für das entsprechende Betriebssystem zertifiziert sind und sich dort wie eine Tastatur verhalten.

===Barcodeschrift===
Meistens verwenden wir den Barcode 39 [[https://de.wikipedia.org/wiki/Code_39]], den es auch als frei verfügbaren Font gibt.

===Anwendungsbeispiel===

Der Produkte-Laufzettel im Auftragsmodul wird mit einem Barcode ausgegeben.

[[Datei:Barcode Laufzettel.png]]

''Abbildung: Barcode-Beispiel auf Laufzettel''

[[Kategorie:Handbuch Helper]] [[Kategorie:Hardware]]

Barcodeleser

2026-01-16T13:37:16Z

Mirko Pepa:

Der Einsatz eines Barcodeleser (Strichcodeleser) hilft Ihnen im betrieblichen Ablauf, effizient bestehende Daten in ein anderes System zu übertragen.

Wir haben folgendes Modell auf macOS und Windows getestet:
* Manhattan 177672 [https://www.digitec.ch/de/s1/product/manhattan-ccd-long-range-1d-barcodes-barcode-scanner-2402457]

Vermutlich gehen aber alle Geräte, die für das entsprechende Betriebssystem zertifiziert sind und sich dort wie eine Tastatur verhalten.

===Barcodeschrift===
Meistens verwenden wir den Barcode 39 [[https://de.wikipedia.org/wiki/Code_39]], den es auch als frei verfügbaren Font gibt.

===Anwendungsbeispiel===

Der Produkte-Laufzettel im Auftragsmodul wird mit einem Barcode ausgegeben.

[[Datei:Barcode Laufzettel.png]]

''Abbildung: Barcode-Beispiel auf Laufzettel''

[[Kategorie:Handbuch Helper]] [[Kategorie:Hardware]]

Systemvoraussetzungen

2025-11-28T08:40:35Z

Mirko Pepa:

==Windows 10==
Alle Versionen von Helper laufen auf Windows 10.

==Windows 11 auf Intel/AMD==
Alle Versionen von Helper laufen auf Windows 11.

==Windows 11 auf ARM==
Wir haben Version 32 getestet und Helper läuft auf einem Windows 11 auf ARM. Auf jeden Fall läuft der Helper hier in einer Intel/AMD-Emulation. Das bedeutet, dass er etwas langsamer läuft, aber auf dem getesteten Gerät (Microsoft Surface von 2024) war die Geschwindigkeit vollkommen genügend.

==MacOS 14 "Sonoma"==
Mit den Versionen bis und mit 29 gibt es einen mühsamen Bug (Texte werden teils auf dem Kopf dargestellt). Ab Version 32 läuft der Helper auf MacOS Sonoma.

==MacOS 15 "Sequoia"==
Mit den Versionen bis und mit 29 gibt es einen mühsamen Bug (Texte werden teils auf dem Kopf dargestellt). Ab Version 32 läuft der Helper auf MacOS Sequoia.

==MacOS 26 "Tahoe"==
Ab Version 32 läuft der Helper auf MacOS Tahoe.

==Apple-Hardware mit M-Prozessor (ARM)==
Versionen ab 28 laufen sicher darauf, zur Zeit noch im Emulations-Modus 'Rosetta'. Ab Version 29 läuft Helper nativ auf M1/M2/M3/M4-Prozessoren.

==MacOS vor 14 "Sonoma"==
Diese Versionen werden von Apple und uns nicht mehr unterstützt.

===MacOS 13 "Ventura"===
Die Helper-Versionen bis und mit 24 laufen nicht auf Ventura. Version 25 und folgende (basierend auf Omnis 10) laufen. Idealerweise benutzen Sie Version 29 oder 32.

===MacOS 12 "Monterey"===
Die Helper-Versionen bis und mit 24 laufen nicht auf Monterey. Version 25 und folgende (basierend auf Omnis 10) laufen. Idealerweise benutzen Sie Version 29 oder 32.

===MacOS 11 "Big Sur"===
Die Helper-Versionen bis und mit 24 laufen nicht auf Big Sur. Versionen 25 bis 32 (basierend auf Omnis 10) laufen.

===Mac OS 10.15 Catalina===
MacOS 10.15 Catalina schneidet einige alte Zöpfe ab:
* Die Carbon-Schnittstelle wurde abgeschafft
* 32bit-Anwendungen laufen nicht mehr
und bringt einige Neuerungen im Bereich der Sicherheit:
* Mehr Warnungen beim Zugriff auf Systemressourcen, wie Netzwerklaufwerke.

Das hat zur Folge, dass folgende Helper-Versionen überhaupt '''nicht mehr laufen''':
* Versionen, die auf Omnis Studio 4.x basieren (aus den Jahren 2008 bis 2016)
* Versionen, die auf Omnis Studio 6.x basieren (ca. aus dem Jahr 2017)

So finden Sie heraus, welche Version Sie haben:
* Öffnen Sie im Apfel-Menu '''Über diesen Macintosh'''
* Klicken Sie auf Systembericht …, ein Fenster öffnet sich.
* Wählen Sie links in der Gruppe '''Software''' den Punkt '''Programme'''
* Suchen Sie in der oberen Liste nach dem Helper (oder Omnis je nachdem wie der Helper auf Ihrem System heisst)
* Beachten Sie nun die letzte Spalte '64-Bit (Intel)'. Steht dort '''Nein''', läuft Ihre Version nicht auf Catalina. '''Hier benötigen Sie einen grösseren Update der detailliert geplant werden muss. Melden Sie sich bitte rechtzeitig bei uns.'''

Helper Version 22 und 23, die auf Omnis Studio 8.1.3 bzw. 8.1.6 basieren, '''laufen noch eingeschränkt'''. Nach Datei-Auswahldialogen kommt es zu Abstürzen.
Hier benötigen Sie einen Update auf Version 24 (das auf Omnis Studio 8.1.7.1 basiert). '''Dieses Update (von 22 auf 24) ist nicht so aufwändig und kann ca. innerhalb einer Woche vorbereitet und ausgeliefert werden.'''

==Windows-Versionen vor 10/Server 2016==
Ältere Windows-Versionen werden von Microsoft und uns nicht mehr unterstützt. Der Helper läuft aber vermutlich noch darauf. Helper 37 benötigt mindestens Windows 10/Server 2016.

Systemvoraussetzungen

2025-11-28T08:39:29Z

Mirko Pepa:

==Windows 10==
Alle Versionen von Helper laufen auf Windows 10.

==Windows 11 auf Intel/AMD==
Alle Versionen von Helper laufen auf Windows 11.

==Windows 11 auf ARM==
Wir haben Version 32 getestet und Helper läuft auf einem Windows 11 auf ARM. Auf jeden Fall läuft der Helper hier in einer Intel/AMD-Emulation. Das bedeutet, dass er etwas langsamer läuft, aber auf dem getesteten Gerät (Microsoft Surface von 2024) war die Geschwindigkeit vollkommen genügend.

==MacOS 14 "Sonoma"==
Mit den Versionen bis und mit 29 gibt es einen mühsamen Bug (Texte werden teils auf dem Kopf dargestellt). Ab Version 32 läuft der Helper auf MacOS Sonoma.

==MacOS 15 "Sequoia"==
Mit den Versionen bis und mit 29 gibt es einen mühsamen Bug (Texte werden teils auf dem Kopf dargestellt). Ab Version 32 läuft der Helper auf MacOS Sequoia.

==MacOS 26 "Tahoe"==
Ab Version 32 läuft der Helper auf MacOS Tahoe.

==Apple-Hardware mit M-Prozessor (ARM)==
Versionen ab 28 laufen sicher darauf, zur Zeit noch im Emulations-Modus 'Rosetta'. Ab Version 29 läuft Helper nativ auf M1/M2/M3/M4-Prozessoren.

==MacOS vor 13 "Sonoma"==
Diese Versionen werden von Apple und uns nicht mehr unterstützt.

==MacOS 13 "Ventura"==
Die Helper-Versionen bis und mit 24 laufen nicht auf Ventura. Version 25 und folgende (basierend auf Omnis 10) laufen. Idealerweise benutzen Sie Version 29 oder 32.

===MacOS 12 "Monterey"===
Die Helper-Versionen bis und mit 24 laufen nicht auf Monterey. Version 25 und folgende (basierend auf Omnis 10) laufen. Idealerweise benutzen Sie Version 29 oder 32.

===MacOS 11 "Big Sur"===
Die Helper-Versionen bis und mit 24 laufen nicht auf Big Sur. Versionen 25 bis 32 (basierend auf Omnis 10) laufen.

===Mac OS 10.15 Catalina===
MacOS 10.15 Catalina schneidet einige alte Zöpfe ab:
* Die Carbon-Schnittstelle wurde abgeschafft
* 32bit-Anwendungen laufen nicht mehr
und bringt einige Neuerungen im Bereich der Sicherheit:
* Mehr Warnungen beim Zugriff auf Systemressourcen, wie Netzwerklaufwerke.

Das hat zur Folge, dass folgende Helper-Versionen überhaupt '''nicht mehr laufen''':
* Versionen, die auf Omnis Studio 4.x basieren (aus den Jahren 2008 bis 2016)
* Versionen, die auf Omnis Studio 6.x basieren (ca. aus dem Jahr 2017)

So finden Sie heraus, welche Version Sie haben:
* Öffnen Sie im Apfel-Menu '''Über diesen Macintosh'''
* Klicken Sie auf Systembericht …, ein Fenster öffnet sich.
* Wählen Sie links in der Gruppe '''Software''' den Punkt '''Programme'''
* Suchen Sie in der oberen Liste nach dem Helper (oder Omnis je nachdem wie der Helper auf Ihrem System heisst)
* Beachten Sie nun die letzte Spalte '64-Bit (Intel)'. Steht dort '''Nein''', läuft Ihre Version nicht auf Catalina. '''Hier benötigen Sie einen grösseren Update der detailliert geplant werden muss. Melden Sie sich bitte rechtzeitig bei uns.'''

Helper Version 22 und 23, die auf Omnis Studio 8.1.3 bzw. 8.1.6 basieren, '''laufen noch eingeschränkt'''. Nach Datei-Auswahldialogen kommt es zu Abstürzen.
Hier benötigen Sie einen Update auf Version 24 (das auf Omnis Studio 8.1.7.1 basiert). '''Dieses Update (von 22 auf 24) ist nicht so aufwändig und kann ca. innerhalb einer Woche vorbereitet und ausgeliefert werden.'''

==Windows-Versionen vor 10/Server 2016==
Ältere Windows-Versionen werden von Microsoft und uns nicht mehr unterstützt. Der Helper läuft aber vermutlich noch darauf. Helper 37 benötigt mindestens Windows 10/Server 2016.

Buchhaltungseinstellungen – MWST-Sätze

2025-11-26T15:50:35Z

Mirko Pepa: /* Alle Sätze */

Das Fenster zum Anlegen von MWST-Sätzen finden Sie unter «'''Einstellungen -> MWST -> Taste MWST-Sätze»'''» oder unter «'''Einstellungen -> Tabellen -> Buchhaltung -> MWST-Sätze'''».

[[Datei:Fenster_MWST-Sätze.png]]

''Abbildung: Fenster zum Anlegen von MWST-Sätzen''

==Alle Sätze==
Hier finden Sie eine Liste aktuellen und historischen Schweizer MWST-Sätze: [https://www.estv.admin.ch/estv/de/home/mehrwertsteuer/mwst-steuersaetze/mwst-steuersaetze-entwicklung.html]

==Feldreferenzen==

;Liste:Hier sehen Sie die bereits erfassten MWST-Sätze.

;Name:Geben Sie dem MWST-Satz einen aussagekräftigen Namen, z. B. «MWST Normalsatz», «MWST Reduzierter Satz», «keine MWST».

;Satz in %:Geben Sie hier den entsprechenden MWST-Satz als Prozentwert ein.

;Kürzel:Der Kürzel kann später in den unterschiedlichsten Modulen aufgegriffen werden (Auftragsverwaltung, Artikeln usw.) und erstellt die Verbindung zum hinterlegten Satz.

;Code:Hier können Sie einen Code eingeben, der auf der MWST-Abrechnung neben den Umsätzen mit diesem MWST-Satz erscheint.
:Dieser Code dient als Referenz und soll der Nummer des Feldes auf dem Formular der Eidg. Steuerverwaltung entsprechen (z. B. 070), in welches Sie den Betrag eingeben müssen.

;Code extern:Dieses Feld muss befüllt sein, sofern Sie die Buchhaltungsdaten über einen Filetransfer in eine externe Finanzbuchhaltung übertragen wollen (z. B. beim Treuhänder).
:Fragen Sie nach allen relevanten Codes für die exakte Übernahme im Zielsystem und tragen Sie diese hier ein.

;Land:Wählen Sie hier das Land aus, in welchem der MWST-Satz gilt.

;MWST inklusive:Setzen Sie hier ein Häkchen, damit dieser MWST-Satz für Artikel verwendet wir, deren Preis inkl. MWST hinterlegt ist.

;Alt:Setzen Sie hier ein Häkchen, wenn dieser MWST-Satz nicht mehr gültig ist. Beim Duplizieren eines alten Auftrages, wird der veraltete Satz mit dem aktuellen überschrieben.

'''Konten'''

Benutzen bei den folgenden Eingabefeldern für Konten die [[Help-Taste]] für das Aufrufen des Auswahlfensters mit den bestehenden Buchhaltungskonten (siehe auch [[Kontenrahmen]]).

;Umsatzsteuerkonto:Geben Sie hier die Nummer des Buchhaltungskontos ein, auf das die Umsatzsteuer mit diesem Satz für Auftragszeilen gebucht werden soll.

;Vorsteuer Waren und Dienstleistungen:Geben Sie hier die Nummer des Buchhaltungskontos ein, das für die Vorsteuer mit diesem Satz bei Kreditoren von Lieferanten verwendet werden soll.

;Vorsteuer andere Aufwände:Geben Sie hier die Nummer des Buchhaltungskontos ein, das für die Vorsteuer mit diesem Satz für andere Aufwände verwendet werden soll.

;Taste «Liste drucken»:Hier können Sie eine Liste aller erfassten MWST-Sätze ausgeben.

;Taste «Alle Kredis zuweisen»:Nur für den erfahrenen Anwender: Hier können Sie Kreditoren ohne Landesbezug ein solches mitsamt MWST-Satz zuweisen. Bitte nehmen Sie zur Sicherheit Kontakt mit [mailto:support@profile.ch?subject=Supportanfrage support@profile.ch] auf.

==Neuer Mehrwertsteuersatz==
Damit im Helper der neue Steuersatz automatisch übernommen wird, müssen Sie zuerst in das Feld "Gültig bis" im aktuellen Mehrwertsteuersatz das Enddatum des Steuersatzes eingeben. Danach erstellen Sie den neuen Mehrwertsteuersatz wie folgt:
:- lassen Sie das Feld "Gültig bis" leer
:- wählen Sie beim "Staat" das gleiche Land aus, wie beim vorherigen Steuersatz
:- wählen Sie bei der "Klasse" die gleiche Klasse aus, wie beim vorherigen Steuersatz

Die restlichen Angaben können Sie wie im Abschnitt "Feldreferenzen" beschrieben, füllen.

==Verwandte Themen==
[[Einstellungen MWST]]

[[Kategorie:Handbuch Helper]]

Buchhaltungseinstellungen – MWST-Sätze

2025-11-26T15:49:50Z

Mirko Pepa: /* Alle Sätze */

Das Fenster zum Anlegen von MWST-Sätzen finden Sie unter «'''Einstellungen -> MWST -> Taste MWST-Sätze»'''» oder unter «'''Einstellungen -> Tabellen -> Buchhaltung -> MWST-Sätze'''».

[[Datei:Fenster_MWST-Sätze.png]]

''Abbildung: Fenster zum Anlegen von MWST-Sätzen''

==Alle Sätze==
Hier finden Sie eine Liste der gültigen MWST-Sätze: [https://www.estv.admin.ch/estv/de/home/mehrwertsteuer/mwst-steuersaetze/mwst-steuersaetze-entwicklung.html]

==Feldreferenzen==

;Liste:Hier sehen Sie die bereits erfassten MWST-Sätze.

;Name:Geben Sie dem MWST-Satz einen aussagekräftigen Namen, z. B. «MWST Normalsatz», «MWST Reduzierter Satz», «keine MWST».

;Satz in %:Geben Sie hier den entsprechenden MWST-Satz als Prozentwert ein.

;Kürzel:Der Kürzel kann später in den unterschiedlichsten Modulen aufgegriffen werden (Auftragsverwaltung, Artikeln usw.) und erstellt die Verbindung zum hinterlegten Satz.

;Code:Hier können Sie einen Code eingeben, der auf der MWST-Abrechnung neben den Umsätzen mit diesem MWST-Satz erscheint.
:Dieser Code dient als Referenz und soll der Nummer des Feldes auf dem Formular der Eidg. Steuerverwaltung entsprechen (z. B. 070), in welches Sie den Betrag eingeben müssen.

;Code extern:Dieses Feld muss befüllt sein, sofern Sie die Buchhaltungsdaten über einen Filetransfer in eine externe Finanzbuchhaltung übertragen wollen (z. B. beim Treuhänder).
:Fragen Sie nach allen relevanten Codes für die exakte Übernahme im Zielsystem und tragen Sie diese hier ein.

;Land:Wählen Sie hier das Land aus, in welchem der MWST-Satz gilt.

;MWST inklusive:Setzen Sie hier ein Häkchen, damit dieser MWST-Satz für Artikel verwendet wir, deren Preis inkl. MWST hinterlegt ist.

;Alt:Setzen Sie hier ein Häkchen, wenn dieser MWST-Satz nicht mehr gültig ist. Beim Duplizieren eines alten Auftrages, wird der veraltete Satz mit dem aktuellen überschrieben.

'''Konten'''

Benutzen bei den folgenden Eingabefeldern für Konten die [[Help-Taste]] für das Aufrufen des Auswahlfensters mit den bestehenden Buchhaltungskonten (siehe auch [[Kontenrahmen]]).

;Umsatzsteuerkonto:Geben Sie hier die Nummer des Buchhaltungskontos ein, auf das die Umsatzsteuer mit diesem Satz für Auftragszeilen gebucht werden soll.

;Vorsteuer Waren und Dienstleistungen:Geben Sie hier die Nummer des Buchhaltungskontos ein, das für die Vorsteuer mit diesem Satz bei Kreditoren von Lieferanten verwendet werden soll.

;Vorsteuer andere Aufwände:Geben Sie hier die Nummer des Buchhaltungskontos ein, das für die Vorsteuer mit diesem Satz für andere Aufwände verwendet werden soll.

;Taste «Liste drucken»:Hier können Sie eine Liste aller erfassten MWST-Sätze ausgeben.

;Taste «Alle Kredis zuweisen»:Nur für den erfahrenen Anwender: Hier können Sie Kreditoren ohne Landesbezug ein solches mitsamt MWST-Satz zuweisen. Bitte nehmen Sie zur Sicherheit Kontakt mit [mailto:support@profile.ch?subject=Supportanfrage support@profile.ch] auf.

==Neuer Mehrwertsteuersatz==
Damit im Helper der neue Steuersatz automatisch übernommen wird, müssen Sie zuerst in das Feld "Gültig bis" im aktuellen Mehrwertsteuersatz das Enddatum des Steuersatzes eingeben. Danach erstellen Sie den neuen Mehrwertsteuersatz wie folgt:
:- lassen Sie das Feld "Gültig bis" leer
:- wählen Sie beim "Staat" das gleiche Land aus, wie beim vorherigen Steuersatz
:- wählen Sie bei der "Klasse" die gleiche Klasse aus, wie beim vorherigen Steuersatz

Die restlichen Angaben können Sie wie im Abschnitt "Feldreferenzen" beschrieben, füllen.

==Verwandte Themen==
[[Einstellungen MWST]]

[[Kategorie:Handbuch Helper]]

Buchhaltungseinstellungen – MWST-Sätze

2025-11-26T15:49:27Z

Mirko Pepa:

Das Fenster zum Anlegen von MWST-Sätzen finden Sie unter «'''Einstellungen -> MWST -> Taste MWST-Sätze»'''» oder unter «'''Einstellungen -> Tabellen -> Buchhaltung -> MWST-Sätze'''».

[[Datei:Fenster_MWST-Sätze.png]]

''Abbildung: Fenster zum Anlegen von MWST-Sätzen''

==Alle Sätze==
Hier finden Sie eine Liste der gültigen MWST-Sätze: [[https://www.estv.admin.ch/estv/de/home/mehrwertsteuer/mwst-steuersaetze/mwst-steuersaetze-entwicklung.html]]

==Feldreferenzen==

;Liste:Hier sehen Sie die bereits erfassten MWST-Sätze.

;Name:Geben Sie dem MWST-Satz einen aussagekräftigen Namen, z. B. «MWST Normalsatz», «MWST Reduzierter Satz», «keine MWST».

;Satz in %:Geben Sie hier den entsprechenden MWST-Satz als Prozentwert ein.

;Kürzel:Der Kürzel kann später in den unterschiedlichsten Modulen aufgegriffen werden (Auftragsverwaltung, Artikeln usw.) und erstellt die Verbindung zum hinterlegten Satz.

;Code:Hier können Sie einen Code eingeben, der auf der MWST-Abrechnung neben den Umsätzen mit diesem MWST-Satz erscheint.
:Dieser Code dient als Referenz und soll der Nummer des Feldes auf dem Formular der Eidg. Steuerverwaltung entsprechen (z. B. 070), in welches Sie den Betrag eingeben müssen.

;Code extern:Dieses Feld muss befüllt sein, sofern Sie die Buchhaltungsdaten über einen Filetransfer in eine externe Finanzbuchhaltung übertragen wollen (z. B. beim Treuhänder).
:Fragen Sie nach allen relevanten Codes für die exakte Übernahme im Zielsystem und tragen Sie diese hier ein.

;Land:Wählen Sie hier das Land aus, in welchem der MWST-Satz gilt.

;MWST inklusive:Setzen Sie hier ein Häkchen, damit dieser MWST-Satz für Artikel verwendet wir, deren Preis inkl. MWST hinterlegt ist.

;Alt:Setzen Sie hier ein Häkchen, wenn dieser MWST-Satz nicht mehr gültig ist. Beim Duplizieren eines alten Auftrages, wird der veraltete Satz mit dem aktuellen überschrieben.

'''Konten'''

Benutzen bei den folgenden Eingabefeldern für Konten die [[Help-Taste]] für das Aufrufen des Auswahlfensters mit den bestehenden Buchhaltungskonten (siehe auch [[Kontenrahmen]]).

;Umsatzsteuerkonto:Geben Sie hier die Nummer des Buchhaltungskontos ein, auf das die Umsatzsteuer mit diesem Satz für Auftragszeilen gebucht werden soll.

;Vorsteuer Waren und Dienstleistungen:Geben Sie hier die Nummer des Buchhaltungskontos ein, das für die Vorsteuer mit diesem Satz bei Kreditoren von Lieferanten verwendet werden soll.

;Vorsteuer andere Aufwände:Geben Sie hier die Nummer des Buchhaltungskontos ein, das für die Vorsteuer mit diesem Satz für andere Aufwände verwendet werden soll.

;Taste «Liste drucken»:Hier können Sie eine Liste aller erfassten MWST-Sätze ausgeben.

;Taste «Alle Kredis zuweisen»:Nur für den erfahrenen Anwender: Hier können Sie Kreditoren ohne Landesbezug ein solches mitsamt MWST-Satz zuweisen. Bitte nehmen Sie zur Sicherheit Kontakt mit [mailto:support@profile.ch?subject=Supportanfrage support@profile.ch] auf.

==Neuer Mehrwertsteuersatz==
Damit im Helper der neue Steuersatz automatisch übernommen wird, müssen Sie zuerst in das Feld "Gültig bis" im aktuellen Mehrwertsteuersatz das Enddatum des Steuersatzes eingeben. Danach erstellen Sie den neuen Mehrwertsteuersatz wie folgt:
:- lassen Sie das Feld "Gültig bis" leer
:- wählen Sie beim "Staat" das gleiche Land aus, wie beim vorherigen Steuersatz
:- wählen Sie bei der "Klasse" die gleiche Klasse aus, wie beim vorherigen Steuersatz

Die restlichen Angaben können Sie wie im Abschnitt "Feldreferenzen" beschrieben, füllen.

==Verwandte Themen==
[[Einstellungen MWST]]

[[Kategorie:Handbuch Helper]]

Einrichten der Druckersteuerung

2025-11-13T09:15:09Z

Mirko Pepa: /* Erstellen der Drucker im Betriebssystem */

«Helper» bietet Ihnen eine gute Unterstützung beim Ansteuern des Druckers und der gewünschten Papierquelle, selbst in einer komplexen Umgebung. 
Voraussetzung ist, dass Technik und Druckertreiber mitspielen. Verwenden Sie von diesem jeweils die aktuelle Version des Herstellers. 
Für einen störungsfreien und wartungsarmen Betrieb ist der Einsatz von typengleichen Druckgeräten aus demselben Haus empfohlen.

==Typische Prozesse==
[[Drucker|Einbinden der Betriebssystem-Drucker in Helper]] 
[[Belegzuordnung|Belege aus Helper an den richtigen Drucker schicken]]

==individuelle Druckziele==

In «Helper» kann jedem druckfähigen Beleg das richtige Druckziel hinterlegt werden, und dies bei Bedarf für jeden Benutzer individuell.

Wesentlich Definitionselemente für die Belegsteuerung in Helper sind:

*Betriebssystem (macOS oder Windows)
*Arbeitsstation (z. B. PC Buchhaltung, Abteilung Avor)
*Beleg (z. B. Rechnung, Laufzettel, Etikette)
*Drucker (z. B. Farblaser, Etikettendrucker, PDF-Dokument)
*Papierfach (Papierfach 1, Papierfach 2 usw.)
*Anzahl Exemplare und Ausrichtung

== Definitionselemente ==

===Betriebssystem===
*macOS: Alle Varianten von OS X
*Windows: Windows 7 bis 10, Windows Server ab Version 2008

===[[Arbeitsstationen|Arbeitsstation]]===
«Arbeitsstation» meint eigentlich ein definiertes Arbeitsumgebungsprofil in Helper. Dieses kann einem einzelnen Computer zugeordnet werden oder aber auch mehreren Geräten einer Bürogemeinschaft.
Neben den Druckeinstellungen gelten für Geräte mit demselben Profil auch dieselben individuell abgespeicherten Fensterkoordinaten.

===Drucker===
Wir unterscheiden zwischen
*Druckgerät (physischer Drucker mit evtl. mehreren Papierfächern)
*Drucker im System (Druckernamen im Betriebssystem, z. B. «HP Laser Buchhaltung»)
*Druckernamen in Helper (beim Einrichten von Helper zu definierendes Druckziel)

===Druckziel===
Hier ist nicht bloss das angesteuerte Druckgerät, sondern auch die Einstellung der Papierzufuhr, Druckauflösung usw. gemeint.
In «Helper» muss für jedes Druckziel mit eigener Voreinstellung ein aussagekräftiger Druckername erstellt werden (z. B. «A4_hoch», «A4_quer_farbig», «Briefpapier_Fach_2»)

===Beleg (Report)===
Ein Beleg in «Helper» ist ein «ausdruckbares Objekt», wie eine Rechnung, ein Laufzettel, eine Umsatzliste usw. Für jeden einzelnen Beleg kann die Druckerzuordnung und das Papierformat festgelegt werde.

===Papierformat===
Das Papierformat ist der standardisierte Wert für Breite und Höhe von Papierblättern (z. B. A4 oder A5). Zum Layout gehört noch die Wahl zwischen Quer- und Hochformat. Unter Windows wird hier in der Regel auch der Papier-Schacht eingestellt.

===Druckdialog===
Das Druckdialog-Fenster erscheint vor dem Ausdrucken und ermöglicht die Einstellung vor dem Druckauftrag noch anzupassen und z.B. die Anzahl der zu druckenden Exemplare zu erhöhen.

== Vorbemerkungen ==
Mit einer guten Planung lassen sich mögliche Anforderungen im Voraus erkennen (z. B. Kapazitätsengpässe, Laufdistanz zum Druckgerät, Verzicht auf Farb- und hochauflösenden Druck bei internen Belegen usw.). 
Um gewisse systembedingte Problemene auszuschliessen, verwenden Sie anstelle von Leerzeichen in Druckernamen Unterstriche (z. B. A4_hoch_farbig).

== Erstellen der Drucker im Betriebssystem ==
Installieren Sie unter «Drucker und Scanner» alle möglichen Druckziele mit den notwendigen Einstellungen. (z. B. HP Farblaser mit der Einstellung Fach 2, wo Briefbogen mit Logo eingefüllt sind) 
Geben Sie jedem Druckziel einen sinnvollen Namen (z. B. Brief_farbig).

=== MacOS ===
In macOS müssen Sie unter Umständen Druckstandards über die Weboberfläche des Druckdienstes CUPS festlegen. 
(Aktivieren über Terminalbefehl «cupsctl WebInterface=yes» und in Browser über «http://127.0.0.1:631/printers» aufrufen)

=== Windows 11 ===
Wenn Sie mehrere Schächte eines Druckers aus dem Helper einzeln ansteiern wollen, müssen Sie hier mehrere Ducker installieren. Geben Sie jedem Drucker unterschiedliche Standardpapierquellen (Schacht 1,2,3). Windows 11 gruppiert die Drucker. Sie sehen also in der Liste nur zB den Drucker 'Brief'. Wenn Sie ihn öffnen, dann erscheinen 3 Reiter 'Brief, Weiss und EZS'. Da können Sie dann zu jedem Drucker den Schacht einstellen unter Druckeigenschaften.

Wir haben schlechte Erfahrungen gemacht mit
* dem IPP-Port von Windows 11. Der Port hat jeweils eine UID als Namen.
* mit dem Generischen Windows IPP-Druckertreiber. Es liessen sich nicht mehrere Drucker mit unterschiedlichen Schächten definieren.

Wir haben gute Erfahrungen gemacht mit
* einem echten TCP-IP-Port auf die IP-Adresse des Druckers (sofern er im Netzwerk war)
* dem Druckertreiber des Herstellers (Zb HP Generic PCL Driver)

== Helper mit den Systemdruckern bekannt machen ==
Über '''«Einstellungen -> Belegzuordnung -> Taste Drucker»''' gelangen Sie in ein Fenster, in welchem Sie für jedes mögliche Druckziel einen helperinternen Drucker erstellen können.

Mehr dazu unter [[Drucker]].

===[[Belegzuordnung]]===
«Helper» wird mit den beiden Belege-Libraries '''«Replib»''' und '''«Individuell»''' ausgeliefert. Nur Belege aus «Individuell» sind im Layout speziell für Sie vorbereitet (z. B. mit Logo, eigenen Textblöcken usw.). Belege aus «Replib» sind so gestaltet, dass das Druckergebnis unter jeder Kundeninstallation ordentlich aber nicht perfekt aussieht (z. B. Listen, Auswertungen). Es fehlen jegliche Firmenhinweise wie Logo oder Fusszeile.

Unter '''«Einstellungen -> Belegzuordnung»''' können Sie in «Helper» für jeden einzelnen Beleg bestimmen, an welches Druckziel er ausgegeben werden soll.

===Zu beachten unter macOS===
[[Bild:JobSetup MacOSX.png|thumb|right|450px|Druck-Dialog unter macOS mit eigener Voreinstellung]]

Unter macOS ab Version 10.3 ist es möglich via Applescript dem Standard-Drucker programmatisch umzustellen. Für die richtige Papierfachwahl muss allerdings eine Vorarbeit gemacht werden: Für jedes einzelne Druckziel müssen im Druckdialog-Fenster die gemachten Voreinstellungen unter einem sinnvollen Namen abgespeichert werden. Diese sind danach in einem XML-Dokument im Homeverzeichnis des angemeldeten Benutzers in "Library: Preferences: com.apple.print.custompresets.plist" abgelegt. Diese Datei beinhaltet auch den Namen der zuletzt benutzten Einstellung, die dann beim nächsten Druck-Job auch wieder die voreingestellte Einstellung ist. Der Helper legt beim Aufstarten ein Alias mit dem Namen "ch.helper.custompresets.plist" zu dieser Datei im gleichen Ordner an, da der Name der Datei zu lang ist, um aus dem Helper heraus verwendet zu werden. Um das richtige Papierfach anzusteuern, ändert Helper den Namen der letztbenutzten Einstellung in der Datei.

Es müssen folgende Schritte durchgeführt werden, um die Drucker/Fächer automatisch anzusteuern.
*Definieren Sie alle Drucker im Betriebssystem mit dem passenden Druckertreiber.
*Geben Sie dem Drucker einen Namen ohne Leerzeichen, da das zu Problemen mit der automatischen Fachansteuerung führen kann. Benutzen Sie stattdessen "_".
*Speichern Sie im Druckdialog-Fenster eine Einstellung für jedes Papierfach, das Sie aus Helper verwenden wollen mit einem aussagekräftigen Namen (z. B. weiss, Brief, EZS)

Testen Sie anschliessend, ob Sie aus Textedit mit reinem Umstellen der Einstellung im Druckdialog-Fenster die richtigen Papierfächer ansteuern können.

== Fehlerbehebung beim Drucken ==
Falls Probleme mit einem Druckgerät auftreten, lässt sich deren Ursache möglicherweise anhand der folgenden Checkliste aufdecken.

*Massnahmen für erste Analyse: Drucker-Reboot, Testdruck, Druck von anderem Gerät
*Befindet sich der Drucker im Status Bereit (evtl. einschalten, Kabel prüfen)?
*Ist der Drucker über das Netzwerk erreichbar (Netzwerkproblem, Printserverproblem)?
*Werden Meldungen im Bedienfeld angezeigt?
*Blockiert ein hängender Druckauftrag die Druckwarteschlange? Entfernen Sie den Druckauftrag.
*Drucken Sie über einen Printserver und Ihre Werte aus dem Druckdialog werden immer wieder übersteuert? Versuchen Sie direkt auf den Drucker zu drucken.
*Funktioniert der Druck aus einer Office-Anwendung aber nicht aus Helper? Starten Sie Helper neu und prüfen Sie die Druck-Einstellungen in Helper.
*Gibt es vom Druckerhersteller einen aktuellen Treiber? In der Regel ist der Treiber des Geräteherstellers dem Treiber aus dem Betriebssystem vorzuziehen.
*Versuchen Sie das Problem mithilfe des Handbuches zu lösen.

==Verwandte Themen==
[[Belegzuordnung|Belege aus Helper an den richtigen Drucker schicken]] 
[[Drucker|Einbinden der Betriebssystem-Drucker in Helper]] 
[[Druckstapel]]

[[Kategorie:Handbuch Helper]]

Einrichten der Druckersteuerung

2025-11-13T09:12:07Z

Mirko Pepa: /* Windows 11 */

«Helper» bietet Ihnen eine gute Unterstützung beim Ansteuern des Druckers und der gewünschten Papierquelle, selbst in einer komplexen Umgebung. 
Voraussetzung ist, dass Technik und Druckertreiber mitspielen. Verwenden Sie von diesem jeweils die aktuelle Version des Herstellers. 
Für einen störungsfreien und wartungsarmen Betrieb ist der Einsatz von typengleichen Druckgeräten aus demselben Haus empfohlen.

==Typische Prozesse==
[[Drucker|Einbinden der Betriebssystem-Drucker in Helper]] 
[[Belegzuordnung|Belege aus Helper an den richtigen Drucker schicken]]

==individuelle Druckziele==

In «Helper» kann jedem druckfähigen Beleg das richtige Druckziel hinterlegt werden, und dies bei Bedarf für jeden Benutzer individuell.

Wesentlich Definitionselemente für die Belegsteuerung in Helper sind:

*Betriebssystem (macOS oder Windows)
*Arbeitsstation (z. B. PC Buchhaltung, Abteilung Avor)
*Beleg (z. B. Rechnung, Laufzettel, Etikette)
*Drucker (z. B. Farblaser, Etikettendrucker, PDF-Dokument)
*Papierfach (Papierfach 1, Papierfach 2 usw.)
*Anzahl Exemplare und Ausrichtung

== Definitionselemente ==

===Betriebssystem===
*macOS: Alle Varianten von OS X
*Windows: Windows 7 bis 10, Windows Server ab Version 2008

===[[Arbeitsstationen|Arbeitsstation]]===
«Arbeitsstation» meint eigentlich ein definiertes Arbeitsumgebungsprofil in Helper. Dieses kann einem einzelnen Computer zugeordnet werden oder aber auch mehreren Geräten einer Bürogemeinschaft.
Neben den Druckeinstellungen gelten für Geräte mit demselben Profil auch dieselben individuell abgespeicherten Fensterkoordinaten.

===Drucker===
Wir unterscheiden zwischen
*Druckgerät (physischer Drucker mit evtl. mehreren Papierfächern)
*Drucker im System (Druckernamen im Betriebssystem, z. B. «HP Laser Buchhaltung»)
*Druckernamen in Helper (beim Einrichten von Helper zu definierendes Druckziel)

===Druckziel===
Hier ist nicht bloss das angesteuerte Druckgerät, sondern auch die Einstellung der Papierzufuhr, Druckauflösung usw. gemeint.
In «Helper» muss für jedes Druckziel mit eigener Voreinstellung ein aussagekräftiger Druckername erstellt werden (z. B. «A4_hoch», «A4_quer_farbig», «Briefpapier_Fach_2»)

===Beleg (Report)===
Ein Beleg in «Helper» ist ein «ausdruckbares Objekt», wie eine Rechnung, ein Laufzettel, eine Umsatzliste usw. Für jeden einzelnen Beleg kann die Druckerzuordnung und das Papierformat festgelegt werde.

===Papierformat===
Das Papierformat ist der standardisierte Wert für Breite und Höhe von Papierblättern (z. B. A4 oder A5). Zum Layout gehört noch die Wahl zwischen Quer- und Hochformat. Unter Windows wird hier in der Regel auch der Papier-Schacht eingestellt.

===Druckdialog===
Das Druckdialog-Fenster erscheint vor dem Ausdrucken und ermöglicht die Einstellung vor dem Druckauftrag noch anzupassen und z.B. die Anzahl der zu druckenden Exemplare zu erhöhen.

== Vorbemerkungen ==
Mit einer guten Planung lassen sich mögliche Anforderungen im Voraus erkennen (z. B. Kapazitätsengpässe, Laufdistanz zum Druckgerät, Verzicht auf Farb- und hochauflösenden Druck bei internen Belegen usw.). 
Um gewisse systembedingte Problemene auszuschliessen, verwenden Sie anstelle von Leerzeichen in Druckernamen Unterstriche (z. B. A4_hoch_farbig).

== Erstellen der Drucker im Betriebssystem ==
Installieren Sie unter «Drucker und Scanner» alle möglichen Druckziele mit den notwendigen Einstellungen. (z. B. HP Farblaser mit der Einstellung Fach 2, wo Briefbogen mit Logo eingefüllt sind) 
Geben Sie jedem Druckziel einen sinnvollen Namen (z. B. Brief_farbig).

'''Hinweis:''' In macOS müssen Sie unter Umständen Druckstandards über die Weboberfläche des Druckdienstes CUPS festlegen. 
(Aktivieren über Terminalbefehl «cupsctl WebInterface=yes» und in Browser über «http://127.0.0.1:631/printers» aufrufen)

=== Windows 11 ===
Wenn Sie mehrere Schächte eines Druckers aus dem Helper einzeln ansteiern wollen, müssen Sie hier mehrere Ducker installieren. Geben Sie jedem Drucker unterschiedliche Standardpapierquellen (Schacht 1,2,3). Windows 11 gruppiert die Drucker. Sie sehen also in der Liste nur zB den Drucker 'Brief'. Wenn Sie ihn öffnen, dann erscheinen 3 Reiter 'Brief, Weiss und EZS'. Da können Sie dann zu jedem Drucker den Schacht einstellen unter Druckeigenschaften.

Wir haben schlechte Erfahrungen gemacht mit
* dem IPP-Port von Windows 11. Der Port hat jeweils eine UID als Namen.
* mit dem Generischen Windows IPP-Druckertreiber. Es liessen sich nicht mehrere Drucker mit unterschiedlichen Schächten definieren.

Wir haben gute Erfahrungen gemacht mit
* einem echten TCP-IP-Port auf die IP-Adresse des Druckers (sofern er im Netzwerk war)
* dem Druckertreiber des Herstellers (Zb HP Generic PCL Driver)

== Helper mit den Systemdruckern bekannt machen ==
Über '''«Einstellungen -> Belegzuordnung -> Taste Drucker»''' gelangen Sie in ein Fenster, in welchem Sie für jedes mögliche Druckziel einen helperinternen Drucker erstellen können.

Mehr dazu unter [[Drucker]].

===[[Belegzuordnung]]===
«Helper» wird mit den beiden Belege-Libraries '''«Replib»''' und '''«Individuell»''' ausgeliefert. Nur Belege aus «Individuell» sind im Layout speziell für Sie vorbereitet (z. B. mit Logo, eigenen Textblöcken usw.). Belege aus «Replib» sind so gestaltet, dass das Druckergebnis unter jeder Kundeninstallation ordentlich aber nicht perfekt aussieht (z. B. Listen, Auswertungen). Es fehlen jegliche Firmenhinweise wie Logo oder Fusszeile.

Unter '''«Einstellungen -> Belegzuordnung»''' können Sie in «Helper» für jeden einzelnen Beleg bestimmen, an welches Druckziel er ausgegeben werden soll.

===Zu beachten unter macOS===
[[Bild:JobSetup MacOSX.png|thumb|right|450px|Druck-Dialog unter macOS mit eigener Voreinstellung]]

Unter macOS ab Version 10.3 ist es möglich via Applescript dem Standard-Drucker programmatisch umzustellen. Für die richtige Papierfachwahl muss allerdings eine Vorarbeit gemacht werden: Für jedes einzelne Druckziel müssen im Druckdialog-Fenster die gemachten Voreinstellungen unter einem sinnvollen Namen abgespeichert werden. Diese sind danach in einem XML-Dokument im Homeverzeichnis des angemeldeten Benutzers in "Library: Preferences: com.apple.print.custompresets.plist" abgelegt. Diese Datei beinhaltet auch den Namen der zuletzt benutzten Einstellung, die dann beim nächsten Druck-Job auch wieder die voreingestellte Einstellung ist. Der Helper legt beim Aufstarten ein Alias mit dem Namen "ch.helper.custompresets.plist" zu dieser Datei im gleichen Ordner an, da der Name der Datei zu lang ist, um aus dem Helper heraus verwendet zu werden. Um das richtige Papierfach anzusteuern, ändert Helper den Namen der letztbenutzten Einstellung in der Datei.

Es müssen folgende Schritte durchgeführt werden, um die Drucker/Fächer automatisch anzusteuern.
*Definieren Sie alle Drucker im Betriebssystem mit dem passenden Druckertreiber.
*Geben Sie dem Drucker einen Namen ohne Leerzeichen, da das zu Problemen mit der automatischen Fachansteuerung führen kann. Benutzen Sie stattdessen "_".
*Speichern Sie im Druckdialog-Fenster eine Einstellung für jedes Papierfach, das Sie aus Helper verwenden wollen mit einem aussagekräftigen Namen (z. B. weiss, Brief, EZS)

Testen Sie anschliessend, ob Sie aus Textedit mit reinem Umstellen der Einstellung im Druckdialog-Fenster die richtigen Papierfächer ansteuern können.

== Fehlerbehebung beim Drucken ==
Falls Probleme mit einem Druckgerät auftreten, lässt sich deren Ursache möglicherweise anhand der folgenden Checkliste aufdecken.

*Massnahmen für erste Analyse: Drucker-Reboot, Testdruck, Druck von anderem Gerät
*Befindet sich der Drucker im Status Bereit (evtl. einschalten, Kabel prüfen)?
*Ist der Drucker über das Netzwerk erreichbar (Netzwerkproblem, Printserverproblem)?
*Werden Meldungen im Bedienfeld angezeigt?
*Blockiert ein hängender Druckauftrag die Druckwarteschlange? Entfernen Sie den Druckauftrag.
*Drucken Sie über einen Printserver und Ihre Werte aus dem Druckdialog werden immer wieder übersteuert? Versuchen Sie direkt auf den Drucker zu drucken.
*Funktioniert der Druck aus einer Office-Anwendung aber nicht aus Helper? Starten Sie Helper neu und prüfen Sie die Druck-Einstellungen in Helper.
*Gibt es vom Druckerhersteller einen aktuellen Treiber? In der Regel ist der Treiber des Geräteherstellers dem Treiber aus dem Betriebssystem vorzuziehen.
*Versuchen Sie das Problem mithilfe des Handbuches zu lösen.

==Verwandte Themen==
[[Belegzuordnung|Belege aus Helper an den richtigen Drucker schicken]] 
[[Drucker|Einbinden der Betriebssystem-Drucker in Helper]] 
[[Druckstapel]]

[[Kategorie:Handbuch Helper]]

Einrichten der Druckersteuerung

2025-11-13T09:06:53Z

Mirko Pepa: /* Erstellen der Drucker im Betriebssystem */

«Helper» bietet Ihnen eine gute Unterstützung beim Ansteuern des Druckers und der gewünschten Papierquelle, selbst in einer komplexen Umgebung. 
Voraussetzung ist, dass Technik und Druckertreiber mitspielen. Verwenden Sie von diesem jeweils die aktuelle Version des Herstellers. 
Für einen störungsfreien und wartungsarmen Betrieb ist der Einsatz von typengleichen Druckgeräten aus demselben Haus empfohlen.

==Typische Prozesse==
[[Drucker|Einbinden der Betriebssystem-Drucker in Helper]] 
[[Belegzuordnung|Belege aus Helper an den richtigen Drucker schicken]]

==individuelle Druckziele==

In «Helper» kann jedem druckfähigen Beleg das richtige Druckziel hinterlegt werden, und dies bei Bedarf für jeden Benutzer individuell.

Wesentlich Definitionselemente für die Belegsteuerung in Helper sind:

*Betriebssystem (macOS oder Windows)
*Arbeitsstation (z. B. PC Buchhaltung, Abteilung Avor)
*Beleg (z. B. Rechnung, Laufzettel, Etikette)
*Drucker (z. B. Farblaser, Etikettendrucker, PDF-Dokument)
*Papierfach (Papierfach 1, Papierfach 2 usw.)
*Anzahl Exemplare und Ausrichtung

== Definitionselemente ==

===Betriebssystem===
*macOS: Alle Varianten von OS X
*Windows: Windows 7 bis 10, Windows Server ab Version 2008

===[[Arbeitsstationen|Arbeitsstation]]===
«Arbeitsstation» meint eigentlich ein definiertes Arbeitsumgebungsprofil in Helper. Dieses kann einem einzelnen Computer zugeordnet werden oder aber auch mehreren Geräten einer Bürogemeinschaft.
Neben den Druckeinstellungen gelten für Geräte mit demselben Profil auch dieselben individuell abgespeicherten Fensterkoordinaten.

===Drucker===
Wir unterscheiden zwischen
*Druckgerät (physischer Drucker mit evtl. mehreren Papierfächern)
*Drucker im System (Druckernamen im Betriebssystem, z. B. «HP Laser Buchhaltung»)
*Druckernamen in Helper (beim Einrichten von Helper zu definierendes Druckziel)

===Druckziel===
Hier ist nicht bloss das angesteuerte Druckgerät, sondern auch die Einstellung der Papierzufuhr, Druckauflösung usw. gemeint.
In «Helper» muss für jedes Druckziel mit eigener Voreinstellung ein aussagekräftiger Druckername erstellt werden (z. B. «A4_hoch», «A4_quer_farbig», «Briefpapier_Fach_2»)

===Beleg (Report)===
Ein Beleg in «Helper» ist ein «ausdruckbares Objekt», wie eine Rechnung, ein Laufzettel, eine Umsatzliste usw. Für jeden einzelnen Beleg kann die Druckerzuordnung und das Papierformat festgelegt werde.

===Papierformat===
Das Papierformat ist der standardisierte Wert für Breite und Höhe von Papierblättern (z. B. A4 oder A5). Zum Layout gehört noch die Wahl zwischen Quer- und Hochformat. Unter Windows wird hier in der Regel auch der Papier-Schacht eingestellt.

===Druckdialog===
Das Druckdialog-Fenster erscheint vor dem Ausdrucken und ermöglicht die Einstellung vor dem Druckauftrag noch anzupassen und z.B. die Anzahl der zu druckenden Exemplare zu erhöhen.

== Vorbemerkungen ==
Mit einer guten Planung lassen sich mögliche Anforderungen im Voraus erkennen (z. B. Kapazitätsengpässe, Laufdistanz zum Druckgerät, Verzicht auf Farb- und hochauflösenden Druck bei internen Belegen usw.). 
Um gewisse systembedingte Problemene auszuschliessen, verwenden Sie anstelle von Leerzeichen in Druckernamen Unterstriche (z. B. A4_hoch_farbig).

== Erstellen der Drucker im Betriebssystem ==
Installieren Sie unter «Drucker und Scanner» alle möglichen Druckziele mit den notwendigen Einstellungen. (z. B. HP Farblaser mit der Einstellung Fach 2, wo Briefbogen mit Logo eingefüllt sind) 
Geben Sie jedem Druckziel einen sinnvollen Namen (z. B. Brief_farbig).

'''Hinweis:''' In macOS müssen Sie unter Umständen Druckstandards über die Weboberfläche des Druckdienstes CUPS festlegen. 
(Aktivieren über Terminalbefehl «cupsctl WebInterface=yes» und in Browser über «http://127.0.0.1:631/printers» aufrufen)

=== Windows 11 ===
Wenn Sie mehrere Schachte eines Druckers aus dem Helper einzeln ansteiern wollen, müssen Sie hier mehrere Ducker installieren. Geben Sie jedem Drucker unterschiedliche Standardpapierquellen (Schacht 1,2,3).

Wir haben schlechte Erfahrungen gemacht mit
* dem IPP-Port von Windows 11. Der Port hat jeweils eine UID als Namen.
* mit dem Generischen Windows IPP-Druckertreiber. Es liessen sich nicht mehrere Drucker mit unterschiedlichen Schächten definieren.

Wir haben gute Erfahrungen gemacht mit
* einem echten TCP-IP-Port auf die IP-Adresse des Druckers (sofern er im Netzwerk war)
* dem Druckertreiber des Herstellers (Zb HP Generic PCL Driver)

== Helper mit den Systemdruckern bekannt machen ==
Über '''«Einstellungen -> Belegzuordnung -> Taste Drucker»''' gelangen Sie in ein Fenster, in welchem Sie für jedes mögliche Druckziel einen helperinternen Drucker erstellen können.

Mehr dazu unter [[Drucker]].

===[[Belegzuordnung]]===
«Helper» wird mit den beiden Belege-Libraries '''«Replib»''' und '''«Individuell»''' ausgeliefert. Nur Belege aus «Individuell» sind im Layout speziell für Sie vorbereitet (z. B. mit Logo, eigenen Textblöcken usw.). Belege aus «Replib» sind so gestaltet, dass das Druckergebnis unter jeder Kundeninstallation ordentlich aber nicht perfekt aussieht (z. B. Listen, Auswertungen). Es fehlen jegliche Firmenhinweise wie Logo oder Fusszeile.

Unter '''«Einstellungen -> Belegzuordnung»''' können Sie in «Helper» für jeden einzelnen Beleg bestimmen, an welches Druckziel er ausgegeben werden soll.

===Zu beachten unter macOS===
[[Bild:JobSetup MacOSX.png|thumb|right|450px|Druck-Dialog unter macOS mit eigener Voreinstellung]]

Unter macOS ab Version 10.3 ist es möglich via Applescript dem Standard-Drucker programmatisch umzustellen. Für die richtige Papierfachwahl muss allerdings eine Vorarbeit gemacht werden: Für jedes einzelne Druckziel müssen im Druckdialog-Fenster die gemachten Voreinstellungen unter einem sinnvollen Namen abgespeichert werden. Diese sind danach in einem XML-Dokument im Homeverzeichnis des angemeldeten Benutzers in "Library: Preferences: com.apple.print.custompresets.plist" abgelegt. Diese Datei beinhaltet auch den Namen der zuletzt benutzten Einstellung, die dann beim nächsten Druck-Job auch wieder die voreingestellte Einstellung ist. Der Helper legt beim Aufstarten ein Alias mit dem Namen "ch.helper.custompresets.plist" zu dieser Datei im gleichen Ordner an, da der Name der Datei zu lang ist, um aus dem Helper heraus verwendet zu werden. Um das richtige Papierfach anzusteuern, ändert Helper den Namen der letztbenutzten Einstellung in der Datei.

Es müssen folgende Schritte durchgeführt werden, um die Drucker/Fächer automatisch anzusteuern.
*Definieren Sie alle Drucker im Betriebssystem mit dem passenden Druckertreiber.
*Geben Sie dem Drucker einen Namen ohne Leerzeichen, da das zu Problemen mit der automatischen Fachansteuerung führen kann. Benutzen Sie stattdessen "_".
*Speichern Sie im Druckdialog-Fenster eine Einstellung für jedes Papierfach, das Sie aus Helper verwenden wollen mit einem aussagekräftigen Namen (z. B. weiss, Brief, EZS)

Testen Sie anschliessend, ob Sie aus Textedit mit reinem Umstellen der Einstellung im Druckdialog-Fenster die richtigen Papierfächer ansteuern können.

== Fehlerbehebung beim Drucken ==
Falls Probleme mit einem Druckgerät auftreten, lässt sich deren Ursache möglicherweise anhand der folgenden Checkliste aufdecken.

*Massnahmen für erste Analyse: Drucker-Reboot, Testdruck, Druck von anderem Gerät
*Befindet sich der Drucker im Status Bereit (evtl. einschalten, Kabel prüfen)?
*Ist der Drucker über das Netzwerk erreichbar (Netzwerkproblem, Printserverproblem)?
*Werden Meldungen im Bedienfeld angezeigt?
*Blockiert ein hängender Druckauftrag die Druckwarteschlange? Entfernen Sie den Druckauftrag.
*Drucken Sie über einen Printserver und Ihre Werte aus dem Druckdialog werden immer wieder übersteuert? Versuchen Sie direkt auf den Drucker zu drucken.
*Funktioniert der Druck aus einer Office-Anwendung aber nicht aus Helper? Starten Sie Helper neu und prüfen Sie die Druck-Einstellungen in Helper.
*Gibt es vom Druckerhersteller einen aktuellen Treiber? In der Regel ist der Treiber des Geräteherstellers dem Treiber aus dem Betriebssystem vorzuziehen.
*Versuchen Sie das Problem mithilfe des Handbuches zu lösen.

==Verwandte Themen==
[[Belegzuordnung|Belege aus Helper an den richtigen Drucker schicken]] 
[[Drucker|Einbinden der Betriebssystem-Drucker in Helper]] 
[[Druckstapel]]

[[Kategorie:Handbuch Helper]]

Filetest

2025-10-24T15:14:48Z

Mirko Pepa: /* Unsichtbare Dateien */

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

'''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 (>,<,=,<>).

==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

2025-10-24T15:13:46Z

Mirko Pepa: 2077

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

'''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 (>,<,=,<>).

==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 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]]

Systemvoraussetzungen

2025-10-20T08:46:39Z

Mirko Pepa: /* Apple-Hardware mit M1/M2/M3-Prozessor */

==Windows 10==
Alle Versionen von Helper laufen auf Windows 10.

==Windows 11 auf Intel/AMD==
Alle Versionen von Helper laufen auf Windows 11.

==Windows 11 auf ARM==
Wir haben Version 32 getestet und Helper läuft auf einem Windows 11 auf ARM. Auf jeden Fall läuft der Helper hier in einer Intel/AMD-Emulation. Das bedeutet, dass er etwas langsamer läuft, aber auf dem getesteten Gerät (Microsoft Surface von 2024) war die Geschwindigkeit vollkommen genügend.

==MacOS 13 "Ventura"==
Die Helper-Versionen bis und mit 24 laufen nicht auf Ventura. Version 25 und folgende (basierend auf Omnis 10) laufen. Idealerweise benutzen Sie Version 29 oder 32.

==MacOS 14 "Sonoma"==
Mit den Versionen bis und mit 29 gibt es einen mühsamen Bug (Texte werden teils auf dem Kopf dargestellt). Ab Version 32 läuft der Helper auf MacOS Sonoma.

==MacOS 15 "Sequoia"==
Mit den Versionen bis und mit 29 gibt es einen mühsamen Bug (Texte werden teils auf dem Kopf dargestellt). Ab Version 32 läuft der Helper auf MacOS Sequoia.

==MacOS 26 "Tahoe"==
Sobald wir diese Version getestet haben, informieren wir Sie hier über die Kompatibilität.

==Apple-Hardware mit M-Prozessor (ARM)==
Versionen ab 28 laufen sicher darauf, zur Zeit noch im Emulations-Modus 'Rosetta'. Ab Version 29 läuft Helper nativ auf M1/M2/M3/M4-Prozessoren.

==MacOS vor 13 "Ventura"==
Diese Versionen werden von Apple und uns nicht mehr unterstützt.

===MacOS 12 "Monterey"===
Die Helper-Versionen bis und mit 24 laufen nicht auf Monterey. Version 25 und folgende (basierend auf Omnis 10) laufen. Idealerweise benutzen Sie Version 29 oder 32.

===MacOS 11 "Big Sur"===
Die Helper-Versionen bis und mit 24 laufen nicht auf Big Sur. Versionen 25 bis 32 (basierend auf Omnis 10) laufen.

===Mac OS 10.15 Catalina===
MacOS 10.15 Catalina schneidet einige alte Zöpfe ab:
* Die Carbon-Schnittstelle wurde abgeschafft
* 32bit-Anwendungen laufen nicht mehr
und bringt einige Neuerungen im Bereich der Sicherheit:
* Mehr Warnungen beim Zugriff auf Systemressourcen, wie Netzwerklaufwerke.

Das hat zur Folge, dass folgende Helper-Versionen überhaupt '''nicht mehr laufen''':
* Versionen, die auf Omnis Studio 4.x basieren (aus den Jahren 2008 bis 2016)
* Versionen, die auf Omnis Studio 6.x basieren (ca. aus dem Jahr 2017)

So finden Sie heraus, welche Version Sie haben:
* Öffnen Sie im Apfel-Menu '''Über diesen Macintosh'''
* Klicken Sie auf Systembericht …, ein Fenster öffnet sich.
* Wählen Sie links in der Gruppe '''Software''' den Punkt '''Programme'''
* Suchen Sie in der oberen Liste nach dem Helper (oder Omnis je nachdem wie der Helper auf Ihrem System heisst)
* Beachten Sie nun die letzte Spalte '64-Bit (Intel)'. Steht dort '''Nein''', läuft Ihre Version nicht auf Catalina. '''Hier benötigen Sie einen grösseren Update der detailliert geplant werden muss. Melden Sie sich bitte rechtzeitig bei uns.'''

Helper Version 22 und 23, die auf Omnis Studio 8.1.3 bzw. 8.1.6 basieren, '''laufen noch eingeschränkt'''. Nach Datei-Auswahldialogen kommt es zu Abstürzen.
Hier benötigen Sie einen Update auf Version 24 (das auf Omnis Studio 8.1.7.1 basiert). '''Dieses Update (von 22 auf 24) ist nicht so aufwändig und kann ca. innerhalb einer Woche vorbereitet und ausgeliefert werden.'''

==Windows-Versionen vor 10/Server 2016==
Ältere Windows-Versionen werden von Microsoft und uns nicht mehr unterstützt. Der Helper läuft aber vermutlich noch darauf. Helper 37 benötigt mindestens Windows 10/Server 2016.

Seitenrahmen finden

2025-10-03T09:02:33Z

Mirko Pepa:

;Mantiseinträge:
3256

;Systemtyp:
71

==Beschreibung==
Siehe auch: [[Erstellung von Seitenrahmen|Zusätzliche Worklfow Informationen]]

Ermöglicht die Ermittlung von Seitenrahmen, welche als Bild Regionen von Interesse zu verstehen sind.
Ist eine Vorstufe für die Schritte "Seitenrahmen Kontrollieren" und "Bilderstellung aus Rahmen".

Nutzt dafür Funktionen aus den GDPicture Komponenten, welche ebenfalls über das Testfenster "Fenstername" zur Verfügung stehen.

Nebst dem erkennen von Seitenrahmen, stehen Befehle für die Ausrichtung der Bilder und für die Erkennung von Leerseiten bereit.

'''Merke:''' Der Befehl Doppelseite teilen darf nur einmal angewendet werden!

Vertikales teilen ist aktuell noch nicht implementiert.

===HZ Versionen===

HZ Version >= 2.00

Erlaubt die ermittlung einer Region Of Interest (ROI) und teilt die Seiten über diese Region und nicht zwingend über die Seitenhälfte

HZ Version = 1.00

Teilt Seiten über die halbierung der Seitenlänge.

==Zugehörige Arbeitsschritte==

[[Seitenrahmen kontrollieren]]

[[Bilderstellung aus Rahmen]]

==Konfigurationsfenster==

[[Datei: Hauptmaske_71.png]]

==Grundeinstellungen==

Die Seitenrahmen müssen einen Namen erhalten. Dieser wird in späteren Arbeitschritte zur Identifikation verwendet.

Rahmenname - Die Bezeichnung für den Seitenrahmen
Reduzierte JPG-Dateien erstellen in Qualität XX Prozent

Zudem können Thumbnails erstellt werden mit der Option 'Reduzierte JPG-Dateien erstellen'. Diese Thumbnails werden in den Hilfsdatenordner gelegt. Die Originale werden nicht verändert.

==Befehle einrichten==

Neue Befehle werden über die grüne + Taste rechts unter der Liste hinzugefügt, welche beim drücken ein Kontextmenu mit den verfügbaren Befehlen anzeigt.

[[Datei: Befehle_71.png]]

Sind bereits Befehle in der Liste vorhanden, so wird ein neuer Befehl jeweils unter einem bereits markierten Befehl angefügt.

Über die rote Kreuz (X) Taste lässt sich ein Befehl, welcher dabei in der Befehlsliste ausgewählt sein muss, wieder entfernen.

Die Befehlsreihenfolge kann über die grünen Pfeiltasten geändert werden.

Das Markieren eines Befehls in der Liste lädt automatisch unter der Liste die zugehörigen Parameter.

==Verfügbare Befehle==

===Region of interest===

Ermittel einen Bildbereich von Interesse für die weitere Bearbeitung. Funktionalität ist analog wie der Befehl "Ränder finden", es wird jedoch kein Rahmen daraus erzeugt.

Der Befehl eignet sich z.B. um einen ersten groben Randbereich zu erkennen und diesen für die folgenden Befehle auszuschliessen.

Referenzrand - Referenzpunkt auf dem Bild, welcher aus Ausgangslage für das finden von Rändern genommen werden soll.
Typ - Handelt es sich um ein Bild oder um ein TextDokument
Konfidenz - Schwellenwert 0-99 für die Erkennung. Standard = 75. Der geeignetste Wert sollte mit dem Testfenster zuvor approximiert werden!

[[Datei: bvi.png]]

===Drehung finden aus Bild===

Ermittelt den Drehwinkel von nicht horizontal ausgerichtetem Text und speichert diesen.

MaxSuchwinkel - Alles darüber wird nicht berücksichtig
Min Suchwinkel - Alles darunter wird nicht berücksichtigt
Optimistisch - Sollte gesetzt werden, wenn alle Bilder schrägen Text enthalten.
Rotationsart - Standard = Bildgrösse beibehalten. Optional = Bild vergrössern. Sollte nur angewendet werden wenn,
Füllfarbe - Farbe mit welchen die entstehenden Spickel oder zusätzliche Bildbereiche gefüllt werden sollen. Sollte der Hintergrundsfarbe der Bilder entsprechen. Standard = Schwarz.

[[Datei: DrehungBild_71.png]]

[[Datei: Drehwinkel_option1_71.png]]

===Drehung finden aus OCR===

Ananlog zu Drehung finden aus Bild. Der Drehwinkel wird hier durch auswerten der OCR Daten ermittel.

[[Datei: DrehungOCR_71.png]]

===Doppelseite teilen===

Erstellt aus einer Seite zwei getrennte Seiten, z.B. um Bücher in linke und rechte Seite zu splitten. Dieser Befehl führt zu einer getrennten Anwendung aller Folgebefehle auf die jeweilige Seite.

Die Seiten werden nur im Speicher getrennt weiter bearbeitet. Dabei wird das Bild nicht beschnitten, sondern die wegzuschneidende Fläche wird farblich aufgefüllt.

Unterstützt aktuell nur das Vertikale teilen (Option: Typ)

Typ - Auf welcher Achse soll die Datei geteilt werden. Standard = Vertikal teilen
Overlap - Anzahl Pixel um welche sich die Teilung überschneiden soll.
SuffixA - Suffix welcher der linke / obere Seitenrahmenname erhalten soll.
SuffixB - Suffix welcher der rechte / untere Seitenrahmenname erhalten soll.

[[Datei: Seiteteilen_71.png]]

===Ränder finden===

Hauptfunktion des Schrittes, welcher damit die Koordinaten für die Seitenrahmen festlegt.

Sucht nach Seitenränder, z.B. um weisse oder schwarze Bereiche rund um Text zu entfernen.

Referenzrand - Referenzpunkt auf dem Bild, welcher aus Ausgangslage für das finden von Rändern genommen werden soll. Bei zuvor geteilten Bildern sind ggf. die erweiterten, kombinierten Referenzen zu verwenden.
Typ - Handelt es sich um ein Bild oder um ein TextDokument
Konfidenz - Schwellenwert 0-99 für die Erkennung. Standard = 75. Der geeignetste Wert sollte mit dem Testfenster zuvor approximiert werden!
Rahmenfarbe - Farbe mit welcher der ermittelte Seitenrahmen später dargestellt wird.

====Ranzugabe====

Falls beim Befehl Region of Interest die ermittelten Ränder nicht exakt genug sind, kann zu diesen zusätzlicher Rand angefügt werden. Die Randermittlung wird damit um diesen Bereich erweitert.

Oben / Links / Rechts / Unten - Randbereiche

[[Datei: Seitenränderfinden_71.png]]

[[Datei: Referenzranz_71.png]]

===Leere Seiten finden===

Versucht zu erkennen, ob eine Seite Inhalt halt. Speichert das Ergebniss beim zugehörigen Seitenrahmen. Ermöglicht das voraus bestimmen von leeren Seiten.

Links / Rechts ist leer - Markiert die ausgewählten Seiten alle als leere Seiten.
Konfidenz - Schwellenwert für die Unterscheidung. Der Wert sollte mit dem Testfenster auf dem Ausgangsmaterial ermittelt werden!
Stanzung - Versucht Stanzungen zu erkennen und schliesst diese für die Ermittlung aus.
Ränder - Versucht Ränder zu erkennen und schliesst diese für die Ermittlung aus.
[[Datei: Leerseitenfinden_71.png]]

== Nur Thumbnails erstellen==
Mit diesem Schritt können Sie auch Thumbnails, also reduzierte Bilddateien erstellen. Diese Dateien werden werden im Hilfsdatenordner abgelegt. Sie können in einem folgenden Schritt, zB Metadaten erfassen, dann auf diese Thumbnails zugreifen, indem sie dort konfigurieren, dass der Schritt 'Daten aus dem Hilfsordner beziehen soll'.
Im Seitenrahmen-Finden-Schritt muss ein 'sinnloser' Befehl konfiguriert werden, damit Helper den Schritt als gültig zulässt. Geben Sie zB eine Kontrasterhöhung um 0 ein.

[[Kategorie:Workflowschritt]]

Seitenrahmen finden

2025-10-03T09:00:04Z

Mirko Pepa:

;Mantiseinträge:
3256

;Systemtyp:
71

==Beschreibung==
Siehe auch: [[Erstellung von Seitenrahmen|Zusätzliche Worklfow Informationen]]

Ermöglicht die Ermittlung von Seitenrahmen, welche als Bild Regionen von Interesse zu verstehen sind.
Ist eine Vorstufe für die Schritte "Seitenrahmen Kontrollieren" und "Bilderstellung aus Rahmen".

Nutzt dafür Funktionen aus den GDPicture Komponenten, welche ebenfalls über das Testfenster "Fenstername" zur Verfügung stehen.

Nebst dem erkennen von Seitenrahmen, stehen Befehle für die Ausrichtung der Bilder und für die Erkennung von Leerseiten bereit.

'''Merke:''' Der Befehl Doppelseite teilen darf nur einmal angewendet werden!

Vertikales teilen ist aktuell noch nicht implementiert.

===HZ Versionen===

HZ Version >= 2.00

Erlaubt die ermittlung einer Region Of Interest (ROI) und teilt die Seiten über diese Region und nicht zwingend über die Seitenhälfte

HZ Version = 1.00

Teilt Seiten über die halbierung der Seitenlänge.

==Zugehörige Arbeitsschritte==

[[Seitenrahmen kontrollieren]]

[[Bilderstellung aus Rahmen]]

==Konfigurationsfenster==

[[Datei: Hauptmaske_71.png]]

==Grundeinstellungen==

Die Seitenrahmen müssen einen Namen erhalten. Dieser wird in späteren Arbeitschritte zur Identifikation verwendet.

Rahmenname - Die Bezeichnung für den Seitenrahmen
Reduzierte JPG-Dateien erstellen in Qualität XX Prozent

Zudem können Thumbnails erstellt werden mit der Option 'Reduzierte JPG-Dateien erstellen'. Diese Thumbnails werden in den Hilfsdatenordner gelegt. Die Originale werden nicht verändert.

==Befehle einrichten==

Neue Befehle werden über die grüne + Taste rechts unter der Liste hinzugefügt, welche beim drücken ein Kontextmenu mit den verfügbaren Befehlen anzeigt.

[[Datei: Befehle_71.png]]

Sind bereits Befehle in der Liste vorhanden, so wird ein neuer Befehl jeweils unter einem bereits markierten Befehl angefügt.

Über die rote Kreuz (X) Taste lässt sich ein Befehl, welcher dabei in der Befehlsliste ausgewählt sein muss, wieder entfernen.

Die Befehlsreihenfolge kann über die grünen Pfeiltasten geändert werden.

Das Markieren eines Befehls in der Liste lädt automatisch unter der Liste die zugehörigen Parameter.

==Verfügbare Befehle==

===Region of interest===

Ermittel einen Bildbereich von Interesse für die weitere Bearbeitung. Funktionalität ist analog wie der Befehl "Ränder finden", es wird jedoch kein Rahmen daraus erzeugt.

Der Befehl eignet sich z.B. um einen ersten groben Randbereich zu erkennen und diesen für die folgenden Befehle auszuschliessen.

Referenzrand - Referenzpunkt auf dem Bild, welcher aus Ausgangslage für das finden von Rändern genommen werden soll.
Typ - Handelt es sich um ein Bild oder um ein TextDokument
Konfidenz - Schwellenwert 0-99 für die Erkennung. Standard = 75. Der geeignetste Wert sollte mit dem Testfenster zuvor approximiert werden!

[[Datei: bvi.png]]

===Drehung finden aus Bild===

Ermittelt den Drehwinkel von nicht horizontal ausgerichtetem Text und speichert diesen.

MaxSuchwinkel - Alles darüber wird nicht berücksichtig
Min Suchwinkel - Alles darunter wird nicht berücksichtigt
Optimistisch - Sollte gesetzt werden, wenn alle Bilder schrägen Text enthalten.
Rotationsart - Standard = Bildgrösse beibehalten. Optional = Bild vergrössern. Sollte nur angewendet werden wenn,
Füllfarbe - Farbe mit welchen die entstehenden Spickel oder zusätzliche Bildbereiche gefüllt werden sollen. Sollte der Hintergrundsfarbe der Bilder entsprechen. Standard = Schwarz.

[[Datei: DrehungBild_71.png]]

[[Datei: Drehwinkel_option1_71.png]]

===Drehung finden aus OCR===

Ananlog zu Drehung finden aus Bild. Der Drehwinkel wird hier durch auswerten der OCR Daten ermittel.

[[Datei: DrehungOCR_71.png]]

===Doppelseite teilen===

Erstellt aus einer Seite zwei getrennte Seiten, z.B. um Bücher in linke und rechte Seite zu splitten. Dieser Befehl führt zu einer getrennten Anwendung aller Folgebefehle auf die jeweilige Seite.

Die Seiten werden nur im Speicher getrennt weiter bearbeitet. Dabei wird das Bild nicht beschnitten, sondern die wegzuschneidende Fläche wird farblich aufgefüllt.

Unterstützt aktuell nur das Vertikale teilen (Option: Typ)

Typ - Auf welcher Achse soll die Datei geteilt werden. Standard = Vertikal teilen
Overlap - Anzahl Pixel um welche sich die Teilung überschneiden soll.
SuffixA - Suffix welcher der linke / obere Seitenrahmenname erhalten soll.
SuffixB - Suffix welcher der rechte / untere Seitenrahmenname erhalten soll.

[[Datei: Seiteteilen_71.png]]

===Ränder finden===

Hauptfunktion des Schrittes, welcher damit die Koordinaten für die Seitenrahmen festlegt.

Sucht nach Seitenränder, z.B. um weisse oder schwarze Bereiche rund um Text zu entfernen.

Referenzrand - Referenzpunkt auf dem Bild, welcher aus Ausgangslage für das finden von Rändern genommen werden soll. Bei zuvor geteilten Bildern sind ggf. die erweiterten, kombinierten Referenzen zu verwenden.
Typ - Handelt es sich um ein Bild oder um ein TextDokument
Konfidenz - Schwellenwert 0-99 für die Erkennung. Standard = 75. Der geeignetste Wert sollte mit dem Testfenster zuvor approximiert werden!
Rahmenfarbe - Farbe mit welcher der ermittelte Seitenrahmen später dargestellt wird.

====Ranzugabe====

Falls beim Befehl Region of Interest die ermittelten Ränder nicht exakt genug sind, kann zu diesen zusätzlicher Rand angefügt werden. Die Randermittlung wird damit um diesen Bereich erweitert.

Oben / Links / Rechts / Unten - Randbereiche

[[Datei: Seitenränderfinden_71.png]]

[[Datei: Referenzranz_71.png]]

===Leere Seiten finden===

Versucht zu erkennen, ob eine Seite Inhalt halt. Speichert das Ergebniss beim zugehörigen Seitenrahmen. Ermöglicht das voraus bestimmen von leeren Seiten.

Links / Rechts ist leer - Markiert die ausgewählten Seiten alle als leere Seiten.
Konfidenz - Schwellenwert für die Unterscheidung. Der Wert sollte mit dem Testfenster auf dem Ausgangsmaterial ermittelt werden!
Stanzung - Versucht Stanzungen zu erkennen und schliesst diese für die Ermittlung aus.
Ränder - Versucht Ränder zu erkennen und schliesst diese für die Ermittlung aus.

== Nur Thumbnails erstellen==
Mit diesem Schritt können Sie auch Thumbnails, also reduzierte Bilddateien erstellen. Diese Dateien werden werden im Hilfsdatenordner abgelegt. Sie können in einem folgenden Schritt, zB Metadaten erfassen, dann auf diese Thumbnails zugreifen, indem sie dort konfigurieren, dass der Schritt 'Daten aus dem Hilfsordner beziehen soll'.
Im Seitenrahmen-Finden-Schritt muss ein 'sinnloser' Befehl konfiguriert werden, damit Helper den Schritt als gültig zulässt. Geben Sie zB eine Kontrasterhöhung um 0 ein.

[[Datei: Leerseitenfinden_71.png]]

[[Kategorie:Workflowschritt]]

Seitenrahmen finden

2025-10-03T08:53:04Z

Mirko Pepa: /* Grundeinstellungen */

;Mantiseinträge:
3256

;Systemtyp:
71

==Beschreibung==
Siehe auch: [[Erstellung von Seitenrahmen|Zusätzliche Worklfow Informationen]]

Ermöglicht die Ermittlung von Seitenrahmen, welche als Bild Regionen von Interesse zu verstehen sind.
Ist eine Vorstufe für die Schritte "Seitenrahmen Kontrollieren" und "Bilderstellung aus Rahmen".

Nutzt dafür Funktionen aus den GDPicture Komponenten, welche ebenfalls über das Testfenster "Fenstername" zur Verfügung stehen.

Nebst dem erkennen von Seitenrahmen, stehen Befehle für die Ausrichtung der Bilder und für die Erkennung von Leerseiten bereit.

'''Merke:''' Der Befehl Doppelseite teilen darf nur einmal angewendet werden!

Vertikales teilen ist aktuell noch nicht implementiert.

===HZ Versionen===

HZ Version >= 2.00

Erlaubt die ermittlung einer Region Of Interest (ROI) und teilt die Seiten über diese Region und nicht zwingend über die Seitenhälfte

HZ Version = 1.00

Teilt Seiten über die halbierung der Seitenlänge.

==Zugehörige Arbeitsschritte==

[[Seitenrahmen kontrollieren]]

[[Bilderstellung aus Rahmen]]

==Konfigurationsfenster==

[[Datei: Hauptmaske_71.png]]

==Grundeinstellungen==

Die Seitenrahmen müssen einen Namen erhalten. Dieser wird in späteren Arbeitschritte zur Identifikation verwendet.

Rahmenname - Die Bezeichnung für den Seitenrahmen
Reduzierte JPG-Dateien erstellen in Qualität XX Prozent

Zudem können Thumbnails erstellt werden mit der Option 'Reduzierte JPG-Dateien erstellen'. Diese Thumbnails werden in den Hilfsdatenordner gelegt. Die Originale werden nicht verändert.

==Befehle einrichten==

Neue Befehle werden über die grüne + Taste rechts unter der Liste hinzugefügt, welche beim drücken ein Kontextmenu mit den verfügbaren Befehlen anzeigt.

[[Datei: Befehle_71.png]]

Sind bereits Befehle in der Liste vorhanden, so wird ein neuer Befehl jeweils unter einem bereits markierten Befehl angefügt.

Über die rote Kreuz (X) Taste lässt sich ein Befehl, welcher dabei in der Befehlsliste ausgewählt sein muss, wieder entfernen.

Die Befehlsreihenfolge kann über die grünen Pfeiltasten geändert werden.

Das Markieren eines Befehls in der Liste lädt automatisch unter der Liste die zugehörigen Parameter.

==Verfügbare Befehle==

===Region of interest===

Ermittel einen Bildbereich von Interesse für die weitere Bearbeitung. Funktionalität ist analog wie der Befehl "Ränder finden", es wird jedoch kein Rahmen daraus erzeugt.

Der Befehl eignet sich z.B. um einen ersten groben Randbereich zu erkennen und diesen für die folgenden Befehle auszuschliessen.

Referenzrand - Referenzpunkt auf dem Bild, welcher aus Ausgangslage für das finden von Rändern genommen werden soll.
Typ - Handelt es sich um ein Bild oder um ein TextDokument
Konfidenz - Schwellenwert 0-99 für die Erkennung. Standard = 75. Der geeignetste Wert sollte mit dem Testfenster zuvor approximiert werden!

[[Datei: bvi.png]]

===Drehung finden aus Bild===

Ermittelt den Drehwinkel von nicht horizontal ausgerichtetem Text und speichert diesen.

MaxSuchwinkel - Alles darüber wird nicht berücksichtig
Min Suchwinkel - Alles darunter wird nicht berücksichtigt
Optimistisch - Sollte gesetzt werden, wenn alle Bilder schrägen Text enthalten.
Rotationsart - Standard = Bildgrösse beibehalten. Optional = Bild vergrössern. Sollte nur angewendet werden wenn,
Füllfarbe - Farbe mit welchen die entstehenden Spickel oder zusätzliche Bildbereiche gefüllt werden sollen. Sollte der Hintergrundsfarbe der Bilder entsprechen. Standard = Schwarz.

[[Datei: DrehungBild_71.png]]

[[Datei: Drehwinkel_option1_71.png]]

===Drehung finden aus OCR===

Ananlog zu Drehung finden aus Bild. Der Drehwinkel wird hier durch auswerten der OCR Daten ermittel.

[[Datei: DrehungOCR_71.png]]

===Doppelseite teilen===

Erstellt aus einer Seite zwei getrennte Seiten, z.B. um Bücher in linke und rechte Seite zu splitten. Dieser Befehl führt zu einer getrennten Anwendung aller Folgebefehle auf die jeweilige Seite.

Die Seiten werden nur im Speicher getrennt weiter bearbeitet. Dabei wird das Bild nicht beschnitten, sondern die wegzuschneidende Fläche wird farblich aufgefüllt.

Unterstützt aktuell nur das Vertikale teilen (Option: Typ)

Typ - Auf welcher Achse soll die Datei geteilt werden. Standard = Vertikal teilen
Overlap - Anzahl Pixel um welche sich die Teilung überschneiden soll.
SuffixA - Suffix welcher der linke / obere Seitenrahmenname erhalten soll.
SuffixB - Suffix welcher der rechte / untere Seitenrahmenname erhalten soll.

[[Datei: Seiteteilen_71.png]]

===Ränder finden===

Hauptfunktion des Schrittes, welcher damit die Koordinaten für die Seitenrahmen festlegt.

Sucht nach Seitenränder, z.B. um weisse oder schwarze Bereiche rund um Text zu entfernen.

Referenzrand - Referenzpunkt auf dem Bild, welcher aus Ausgangslage für das finden von Rändern genommen werden soll. Bei zuvor geteilten Bildern sind ggf. die erweiterten, kombinierten Referenzen zu verwenden.
Typ - Handelt es sich um ein Bild oder um ein TextDokument
Konfidenz - Schwellenwert 0-99 für die Erkennung. Standard = 75. Der geeignetste Wert sollte mit dem Testfenster zuvor approximiert werden!
Rahmenfarbe - Farbe mit welcher der ermittelte Seitenrahmen später dargestellt wird.

====Ranzugabe====

Falls beim Befehl Region of Interest die ermittelten Ränder nicht exakt genug sind, kann zu diesen zusätzlicher Rand angefügt werden. Die Randermittlung wird damit um diesen Bereich erweitert.

Oben / Links / Rechts / Unten - Randbereiche

[[Datei: Seitenränderfinden_71.png]]

[[Datei: Referenzranz_71.png]]

===Leere Seiten finden===

Versucht zu erkennen, ob eine Seite Inhalt halt. Speichert das Ergebniss beim zugehörigen Seitenrahmen. Ermöglicht das voraus bestimmen von leeren Seiten.

Links / Rechts ist leer - Markiert die ausgewählten Seiten alle als leere Seiten.
Konfidenz - Schwellenwert für die Unterscheidung. Der Wert sollte mit dem Testfenster auf dem Ausgangsmaterial ermittelt werden!
Stanzung - Versucht Stanzungen zu erkennen und schliesst diese für die Ermittlung aus.
Ränder - Versucht Ränder zu erkennen und schliesst diese für die Ermittlung aus.

[[Datei: Leerseitenfinden_71.png]]

[[Kategorie:Workflowschritt]]

Systemvoraussetzungen

2025-07-03T07:24:46Z

Mirko Pepa: /* Apple-Hardware mit M1/M2/M3-Prozessor */

==Windows 10==
Alle Versionen von Helper laufen auf Windows 10.

==Windows 11 auf Intel/AMD==
Alle Versionen von Helper laufen auf Windows 11.

==Windows 11 auf ARM==
Wir haben Version 32 getestet und Helper läuft auf einem Windows 11 auf ARM. Auf jeden Fall läuft der Helper hier in einer Intel/AMD-Emulation. Das bedeutet, dass er etwas langsamer läuft, aber auf dem getesteten Gerät (Microsoft Surface von 2024) war die Geschwindigkeit vollkommen genügend.

==MacOS 13 "Ventura"==
Die Helper-Versionen bis und mit 24 laufen nicht auf Ventura. Version 25 und folgende (basierend auf Omnis 10) laufen. Idealerweise benutzen Sie Version 29 oder 32.

==MacOS 14 "Sonoma"==
Mit den Versionen bis und mit 29 gibt es einen mühsamen Bug (Texte werden teils auf dem Kopf dargestellt). Ab Version 32 läuft der Helper auf MacOS Sonoma.

==MacOS 15 "Sequoia"==
Mit den Versionen bis und mit 29 gibt es einen mühsamen Bug (Texte werden teils auf dem Kopf dargestellt). Ab Version 32 läuft der Helper auf MacOS Sequoia.

==MacOS 26 "Tahoe"==
Sobald wir diese Version getestet haben, informieren wir Sie hier über die Kompatibilität.

==Apple-Hardware mit M1/M2/M3-Prozessor==
Versionen ab 28 laufen sicher darauf, zur Zeit noch im Emulations-Modus 'Rosetta'. Ab Version 29 läuft Helper nativ auf M1/M2/M3/M4-Prozessoren.

==MacOS vor 13 "Ventura"==
Diese Versionen werden von Apple und uns nicht mehr unterstützt.

===MacOS 12 "Monterey"===
Die Helper-Versionen bis und mit 24 laufen nicht auf Monterey. Version 25 und folgende (basierend auf Omnis 10) laufen. Idealerweise benutzen Sie Version 29 oder 32.

===MacOS 11 "Big Sur"===
Die Helper-Versionen bis und mit 24 laufen nicht auf Big Sur. Versionen 25 bis 32 (basierend auf Omnis 10) laufen.

===Mac OS 10.15 Catalina===
MacOS 10.15 Catalina schneidet einige alte Zöpfe ab:
* Die Carbon-Schnittstelle wurde abgeschafft
* 32bit-Anwendungen laufen nicht mehr
und bringt einige Neuerungen im Bereich der Sicherheit:
* Mehr Warnungen beim Zugriff auf Systemressourcen, wie Netzwerklaufwerke.

Das hat zur Folge, dass folgende Helper-Versionen überhaupt '''nicht mehr laufen''':
* Versionen, die auf Omnis Studio 4.x basieren (aus den Jahren 2008 bis 2016)
* Versionen, die auf Omnis Studio 6.x basieren (ca. aus dem Jahr 2017)

So finden Sie heraus, welche Version Sie haben:
* Öffnen Sie im Apfel-Menu '''Über diesen Macintosh'''
* Klicken Sie auf Systembericht …, ein Fenster öffnet sich.
* Wählen Sie links in der Gruppe '''Software''' den Punkt '''Programme'''
* Suchen Sie in der oberen Liste nach dem Helper (oder Omnis je nachdem wie der Helper auf Ihrem System heisst)
* Beachten Sie nun die letzte Spalte '64-Bit (Intel)'. Steht dort '''Nein''', läuft Ihre Version nicht auf Catalina. '''Hier benötigen Sie einen grösseren Update der detailliert geplant werden muss. Melden Sie sich bitte rechtzeitig bei uns.'''

Helper Version 22 und 23, die auf Omnis Studio 8.1.3 bzw. 8.1.6 basieren, '''laufen noch eingeschränkt'''. Nach Datei-Auswahldialogen kommt es zu Abstürzen.
Hier benötigen Sie einen Update auf Version 24 (das auf Omnis Studio 8.1.7.1 basiert). '''Dieses Update (von 22 auf 24) ist nicht so aufwändig und kann ca. innerhalb einer Woche vorbereitet und ausgeliefert werden.'''

==Windows-Versionen vor 10/Server 2016==
Ältere Windows-Versionen werden von Microsoft und uns nicht mehr unterstützt. Der Helper läuft aber vermutlich noch darauf. Helper 37 benötigt mindestens Windows 10/Server 2016.

Systemvoraussetzungen

2025-07-03T07:24:17Z

Mirko Pepa:

==Windows 10==
Alle Versionen von Helper laufen auf Windows 10.

==Windows 11 auf Intel/AMD==
Alle Versionen von Helper laufen auf Windows 11.

==Windows 11 auf ARM==
Wir haben Version 32 getestet und Helper läuft auf einem Windows 11 auf ARM. Auf jeden Fall läuft der Helper hier in einer Intel/AMD-Emulation. Das bedeutet, dass er etwas langsamer läuft, aber auf dem getesteten Gerät (Microsoft Surface von 2024) war die Geschwindigkeit vollkommen genügend.

==MacOS 13 "Ventura"==
Die Helper-Versionen bis und mit 24 laufen nicht auf Ventura. Version 25 und folgende (basierend auf Omnis 10) laufen. Idealerweise benutzen Sie Version 29 oder 32.

==MacOS 14 "Sonoma"==
Mit den Versionen bis und mit 29 gibt es einen mühsamen Bug (Texte werden teils auf dem Kopf dargestellt). Ab Version 32 läuft der Helper auf MacOS Sonoma.

==MacOS 15 "Sequoia"==
Mit den Versionen bis und mit 29 gibt es einen mühsamen Bug (Texte werden teils auf dem Kopf dargestellt). Ab Version 32 läuft der Helper auf MacOS Sequoia.

==MacOS 26 "Tahoe"==
Sobald wir diese Version getestet haben, informieren wir Sie hier über die Kompatibilität.

==Apple-Hardware mit M1/M2/M3-Prozessor==
Versionen ab 28 laufen sicher darauf, zur Zeit noch im Emulations-Modus 'Rosetta'. Ab Version 29 läuft Helper nativ auf M1/M2/M3-Prozessoren.

==MacOS vor 13 "Ventura"==
Diese Versionen werden von Apple und uns nicht mehr unterstützt.

===MacOS 12 "Monterey"===
Die Helper-Versionen bis und mit 24 laufen nicht auf Monterey. Version 25 und folgende (basierend auf Omnis 10) laufen. Idealerweise benutzen Sie Version 29 oder 32.

===MacOS 11 "Big Sur"===
Die Helper-Versionen bis und mit 24 laufen nicht auf Big Sur. Versionen 25 bis 32 (basierend auf Omnis 10) laufen.

===Mac OS 10.15 Catalina===
MacOS 10.15 Catalina schneidet einige alte Zöpfe ab:
* Die Carbon-Schnittstelle wurde abgeschafft
* 32bit-Anwendungen laufen nicht mehr
und bringt einige Neuerungen im Bereich der Sicherheit:
* Mehr Warnungen beim Zugriff auf Systemressourcen, wie Netzwerklaufwerke.

Das hat zur Folge, dass folgende Helper-Versionen überhaupt '''nicht mehr laufen''':
* Versionen, die auf Omnis Studio 4.x basieren (aus den Jahren 2008 bis 2016)
* Versionen, die auf Omnis Studio 6.x basieren (ca. aus dem Jahr 2017)

So finden Sie heraus, welche Version Sie haben:
* Öffnen Sie im Apfel-Menu '''Über diesen Macintosh'''
* Klicken Sie auf Systembericht …, ein Fenster öffnet sich.
* Wählen Sie links in der Gruppe '''Software''' den Punkt '''Programme'''
* Suchen Sie in der oberen Liste nach dem Helper (oder Omnis je nachdem wie der Helper auf Ihrem System heisst)
* Beachten Sie nun die letzte Spalte '64-Bit (Intel)'. Steht dort '''Nein''', läuft Ihre Version nicht auf Catalina. '''Hier benötigen Sie einen grösseren Update der detailliert geplant werden muss. Melden Sie sich bitte rechtzeitig bei uns.'''

Helper Version 22 und 23, die auf Omnis Studio 8.1.3 bzw. 8.1.6 basieren, '''laufen noch eingeschränkt'''. Nach Datei-Auswahldialogen kommt es zu Abstürzen.
Hier benötigen Sie einen Update auf Version 24 (das auf Omnis Studio 8.1.7.1 basiert). '''Dieses Update (von 22 auf 24) ist nicht so aufwändig und kann ca. innerhalb einer Woche vorbereitet und ausgeliefert werden.'''

==Windows-Versionen vor 10/Server 2016==
Ältere Windows-Versionen werden von Microsoft und uns nicht mehr unterstützt. Der Helper läuft aber vermutlich noch darauf. Helper 37 benötigt mindestens Windows 10/Server 2016.

Hauptseite

2025-06-25T12:21:12Z

Mirko Pepa: /* Über Profile GmbH */

Herzlich willkommen im Support-Wiki zum «'''Helper'''»

«'''Helper'''» ist eine moderne '''ERP-Bürolösung''' speziell für das '''grafische Gewerbe''' mit Modulen für Druck- und Flexodruckvorstufenbetriebe, kleine Offset-, Digital-, und Siebdruckereien, sowie für Produktionsagenturen. 
«Helper» wird von '''[https://www.profile.ch Profile GmbH]''' in Winterthur ständig weiterentwickelt und ist seit mehr als 25 Jahren auf dem Markt gut eingeführt. 
«Helper» ist datenbankbasierend und als flexibles und modulares Programmsystem sowohl unter '''macOS''' wie auch unter '''Windows''' lauffähig und zudem auch als Webapplikation einsetzbar.

{|- valign="top" width="100%"
|valign="top" style="border: 1px solid gray;padding-left:1em;padding-right:0.5em;" width="40%"|

==Handbuch «Helper»==
[[:Kategorie:Handbuch Helper|Alle Handbuchseiten | Inhaltsübersicht]] | [[Kurse]]

===Bedienung===
[[Grundlegende Bildschirmelemente]], [[Help-Taste]], [[Grundmaske]]

===Stammdaten===
[[Kunden]], [[Lieferanten]], [[Artikel]], [[Personal]]

===Anwendungsmodule===
[[Aufträge]], [[Aufträge – Auftragszeilen|Auftragszeilen]], [[Offerten]], [[Verkauf]], [[Debitoren]], [[Einkauf]], [[Kreditoren]], [[Buchhaltung]], [[Gutschriften]], [[Korrespondenz]], [[CRM-Zentrale]], [[Listen]], [[Leistungsauswertung]], [[OCR-Suche]], [[MetaStar]], [[Cockpit]]

==Einrichten von «Helper»==

===Einstellungen===
[[Einstellungen |Alle Einstellungen | Übersicht]]

===Drucker- und Belegsteuerung===
[[Einrichten der Druckersteuerung]], [[Drucker]], [[Belegzuordnung]], [[Druckstapel]]

==Installation «Helper»==
[[Empfohlene Systemanforderungen]], [[Installation]], [[Helper als webbasierte Applikation]], [[Demo-Installation]]

===Technische Beschriebe===
[[:Kategorie:Hardware|Hardware]], [[LDAP einrichten]], [[Rechnungen signieren]], [[EBill]]

===Handbuch Serverarbeitsschritte===
[[Überblick]], [[Administrationsfenster für Jobs]], [[HLI Executoren]], [[Watchdog]], [[:Kategorie:Workflowschritt|Serverarbeitsschritte]], [[Übersicht über alle Workflowschritte]], [[:Kategorie:Workflowbeschreibungen|Workflowbeschreibungen]], [[Omnisgrundlagen]], [[Verfügbare Funktionen]], [[Archivierung von Metadaten]], [[Azure Document Intelligence]]

==Handbuch Leistungserfassung «LEFA»==
[[Installation LEFA|Installation]], [[Leistungserfassungsfenster]]

|valign="top" bgcolor="#E8F1FF" width="30%" style="border-style:solid;border-width:1px;border-color:gray;padding-left:1em;padding-right:1em;padding-top:0.5em;"|

==QuickSupport für macOS und Windows==

Falls wir uns auf Ihr System verbinden sollen:

*Kontaktieren Sie uns telefonisch unter '''+41 52 213 63 33'''.
*Klicken Sie auf den '''untenstehenden Link''' zum Starten des Fernsupport-Tools '''erst nach unserer Aufforderung'''.
*Geben Sie uns die '''Sitzungs-ID''' und das '''Kennwort''' für den Verbindungsaufbau bekannt.

[https://get.teamviewer.com/648xqq2 Fernwartung starten]
 
 
 

==FAQ/Troubleshooting==
*[[Helper startet nicht mehr]]
*[[Grundmaske|Ich möchte die Grundmaske anpassen/Die Grundmaske ist schwarz.]] 
*[[Grundlegende_Bildschirmelemente#Menü «Bearbeiten»|Ich möchte die Ausrichtung und Grösse der einzelnen Arbeitsfenster speichern.]] 
*[[Buchungsjahre|Ich möchte ab Oktober das folgende Buchungsjahr eröffnen.]]
*[https://shop.crealogix.com/scanner.html/?___store=de&___from_store=en| Ich suche einen QR-Code-Belegleser (externer Link)]
*[[Einstellungen Nummernkreise|Ich möchte das Aussehen der automatischen Belegnummerierungen zum neuen Jahr hin anpassen.]]
*[[:Kategorie:Troubleshooting]]
 
 

==Inhaltsübersicht==
>> [[:Kategorie:Handbuch Helper|Weiter zu «Alle Handbuchseiten»]] 

>> [[Einstellungen|Weiter zu «Alle Einstellungen»]]

|valign="top" bgcolor="#E8F1FF" style="border-style:solid;border-width:1px;border-color:gray;padding-left:1em;padding-right:1em;padding-top:0.5em;"|

== Aktuelles ==
[[Personal – Lohnbeiträge ändern|Höherer AHV-Beitragssatz ab 01. Januar 2020]]

[[Systemvoraussetzungen| MacOS 11/12/13/14/15/M1/M2/M3]]

[[Buchungsjahre|Neues Buchungsjahr 2026 eröffnen]]

[[QR-Rechnung]]

[[Bankkonten|Umstellen auf den neuen ISO-20022-Zahlungsstandard]]

[[Anpassung des MwSt-Satzes|Neuer MwSt-Satz 8.1%]]

 
 

==Über Profile GmbH==
[https://www.profile.ch Homepage] 
[http://www.site.helper.ch/ Helper vorgestellt]
 
 

==Kontakt==

'''Profile GmbH''' 
Schaffhauserstr. 103 
Ruhtalstrasse 12 
8400 Winterthur 
Schweiz

Tel. +41 52 213 63 33 
[mailto:support@profile.ch?subject=Supportanfrage support@profile.ch]

__NOTOC__

Hauptseite

2025-06-25T12:19:33Z

Mirko Pepa: /* Kontakt */

Herzlich willkommen im Support-Wiki zum «'''Helper'''»

«'''Helper'''» ist eine moderne '''ERP-Bürolösung''' speziell für das '''grafische Gewerbe''' mit Modulen für Druck- und Flexodruckvorstufenbetriebe, kleine Offset-, Digital-, und Siebdruckereien, sowie für Produktionsagenturen. 
«Helper» wird von '''[https://www.profile.ch Profile GmbH]''' in Winterthur ständig weiterentwickelt und ist seit mehr als 25 Jahren auf dem Markt gut eingeführt. 
«Helper» ist datenbankbasierend und als flexibles und modulares Programmsystem sowohl unter '''macOS''' wie auch unter '''Windows''' lauffähig und zudem auch als Webapplikation einsetzbar.

{|- valign="top" width="100%"
|valign="top" style="border: 1px solid gray;padding-left:1em;padding-right:0.5em;" width="40%"|

==Handbuch «Helper»==
[[:Kategorie:Handbuch Helper|Alle Handbuchseiten | Inhaltsübersicht]] | [[Kurse]]

===Bedienung===
[[Grundlegende Bildschirmelemente]], [[Help-Taste]], [[Grundmaske]]

===Stammdaten===
[[Kunden]], [[Lieferanten]], [[Artikel]], [[Personal]]

===Anwendungsmodule===
[[Aufträge]], [[Aufträge – Auftragszeilen|Auftragszeilen]], [[Offerten]], [[Verkauf]], [[Debitoren]], [[Einkauf]], [[Kreditoren]], [[Buchhaltung]], [[Gutschriften]], [[Korrespondenz]], [[CRM-Zentrale]], [[Listen]], [[Leistungsauswertung]], [[OCR-Suche]], [[MetaStar]], [[Cockpit]]

==Einrichten von «Helper»==

===Einstellungen===
[[Einstellungen |Alle Einstellungen | Übersicht]]

===Drucker- und Belegsteuerung===
[[Einrichten der Druckersteuerung]], [[Drucker]], [[Belegzuordnung]], [[Druckstapel]]

==Installation «Helper»==
[[Empfohlene Systemanforderungen]], [[Installation]], [[Helper als webbasierte Applikation]], [[Demo-Installation]]

===Technische Beschriebe===
[[:Kategorie:Hardware|Hardware]], [[LDAP einrichten]], [[Rechnungen signieren]], [[EBill]]

===Handbuch Serverarbeitsschritte===
[[Überblick]], [[Administrationsfenster für Jobs]], [[HLI Executoren]], [[Watchdog]], [[:Kategorie:Workflowschritt|Serverarbeitsschritte]], [[Übersicht über alle Workflowschritte]], [[:Kategorie:Workflowbeschreibungen|Workflowbeschreibungen]], [[Omnisgrundlagen]], [[Verfügbare Funktionen]], [[Archivierung von Metadaten]], [[Azure Document Intelligence]]

==Handbuch Leistungserfassung «LEFA»==
[[Installation LEFA|Installation]], [[Leistungserfassungsfenster]]

|valign="top" bgcolor="#E8F1FF" width="30%" style="border-style:solid;border-width:1px;border-color:gray;padding-left:1em;padding-right:1em;padding-top:0.5em;"|

==QuickSupport für macOS und Windows==

Falls wir uns auf Ihr System verbinden sollen:

*Kontaktieren Sie uns telefonisch unter '''+41 52 213 63 33'''.
*Klicken Sie auf den '''untenstehenden Link''' zum Starten des Fernsupport-Tools '''erst nach unserer Aufforderung'''.
*Geben Sie uns die '''Sitzungs-ID''' und das '''Kennwort''' für den Verbindungsaufbau bekannt.

[https://get.teamviewer.com/648xqq2 Fernwartung starten]
 
 
 

==FAQ/Troubleshooting==
*[[Helper startet nicht mehr]]
*[[Grundmaske|Ich möchte die Grundmaske anpassen/Die Grundmaske ist schwarz.]] 
*[[Grundlegende_Bildschirmelemente#Menü «Bearbeiten»|Ich möchte die Ausrichtung und Grösse der einzelnen Arbeitsfenster speichern.]] 
*[[Buchungsjahre|Ich möchte ab Oktober das folgende Buchungsjahr eröffnen.]]
*[https://shop.crealogix.com/scanner.html/?___store=de&___from_store=en| Ich suche einen QR-Code-Belegleser (externer Link)]
*[[Einstellungen Nummernkreise|Ich möchte das Aussehen der automatischen Belegnummerierungen zum neuen Jahr hin anpassen.]]
*[[:Kategorie:Troubleshooting]]
 
 

==Inhaltsübersicht==
>> [[:Kategorie:Handbuch Helper|Weiter zu «Alle Handbuchseiten»]] 

>> [[Einstellungen|Weiter zu «Alle Einstellungen»]]

|valign="top" bgcolor="#E8F1FF" style="border-style:solid;border-width:1px;border-color:gray;padding-left:1em;padding-right:1em;padding-top:0.5em;"|

== Aktuelles ==
[[Personal – Lohnbeiträge ändern|Höherer AHV-Beitragssatz ab 01. Januar 2020]]

[[Systemvoraussetzungen| MacOS 11/12/13/14/15/M1/M2/M3]]

[[Buchungsjahre|Neues Buchungsjahr 2026 eröffnen]]

[[QR-Rechnung]]

[[Bankkonten|Umstellen auf den neuen ISO-20022-Zahlungsstandard]]

[[Anpassung des MwSt-Satzes|Neuer MwSt-Satz 8.1%]]

 
 

==Über Profile GmbH==
[https://www.profile.ch Homepage] 
[http://www.site.helper.ch/ Helper vorgestellt]

[[Plan pro_File|Lageplan]]
 
 

==Kontakt==

'''Profile GmbH''' 
Schaffhauserstr. 103 
Ruhtalstrasse 12 
8400 Winterthur 
Schweiz

Tel. +41 52 213 63 33 
[mailto:support@profile.ch?subject=Supportanfrage support@profile.ch]

__NOTOC__

Hauptseite

2025-06-25T12:19:10Z

Mirko Pepa:

Herzlich willkommen im Support-Wiki zum «'''Helper'''»

«'''Helper'''» ist eine moderne '''ERP-Bürolösung''' speziell für das '''grafische Gewerbe''' mit Modulen für Druck- und Flexodruckvorstufenbetriebe, kleine Offset-, Digital-, und Siebdruckereien, sowie für Produktionsagenturen. 
«Helper» wird von '''[https://www.profile.ch Profile GmbH]''' in Winterthur ständig weiterentwickelt und ist seit mehr als 25 Jahren auf dem Markt gut eingeführt. 
«Helper» ist datenbankbasierend und als flexibles und modulares Programmsystem sowohl unter '''macOS''' wie auch unter '''Windows''' lauffähig und zudem auch als Webapplikation einsetzbar.

{|- valign="top" width="100%"
|valign="top" style="border: 1px solid gray;padding-left:1em;padding-right:0.5em;" width="40%"|

==Handbuch «Helper»==
[[:Kategorie:Handbuch Helper|Alle Handbuchseiten | Inhaltsübersicht]] | [[Kurse]]

===Bedienung===
[[Grundlegende Bildschirmelemente]], [[Help-Taste]], [[Grundmaske]]

===Stammdaten===
[[Kunden]], [[Lieferanten]], [[Artikel]], [[Personal]]

===Anwendungsmodule===
[[Aufträge]], [[Aufträge – Auftragszeilen|Auftragszeilen]], [[Offerten]], [[Verkauf]], [[Debitoren]], [[Einkauf]], [[Kreditoren]], [[Buchhaltung]], [[Gutschriften]], [[Korrespondenz]], [[CRM-Zentrale]], [[Listen]], [[Leistungsauswertung]], [[OCR-Suche]], [[MetaStar]], [[Cockpit]]

==Einrichten von «Helper»==

===Einstellungen===
[[Einstellungen |Alle Einstellungen | Übersicht]]

===Drucker- und Belegsteuerung===
[[Einrichten der Druckersteuerung]], [[Drucker]], [[Belegzuordnung]], [[Druckstapel]]

==Installation «Helper»==
[[Empfohlene Systemanforderungen]], [[Installation]], [[Helper als webbasierte Applikation]], [[Demo-Installation]]

===Technische Beschriebe===
[[:Kategorie:Hardware|Hardware]], [[LDAP einrichten]], [[Rechnungen signieren]], [[EBill]]

===Handbuch Serverarbeitsschritte===
[[Überblick]], [[Administrationsfenster für Jobs]], [[HLI Executoren]], [[Watchdog]], [[:Kategorie:Workflowschritt|Serverarbeitsschritte]], [[Übersicht über alle Workflowschritte]], [[:Kategorie:Workflowbeschreibungen|Workflowbeschreibungen]], [[Omnisgrundlagen]], [[Verfügbare Funktionen]], [[Archivierung von Metadaten]], [[Azure Document Intelligence]]

==Handbuch Leistungserfassung «LEFA»==
[[Installation LEFA|Installation]], [[Leistungserfassungsfenster]]

|valign="top" bgcolor="#E8F1FF" width="30%" style="border-style:solid;border-width:1px;border-color:gray;padding-left:1em;padding-right:1em;padding-top:0.5em;"|

==QuickSupport für macOS und Windows==

Falls wir uns auf Ihr System verbinden sollen:

*Kontaktieren Sie uns telefonisch unter '''+41 52 213 63 33'''.
*Klicken Sie auf den '''untenstehenden Link''' zum Starten des Fernsupport-Tools '''erst nach unserer Aufforderung'''.
*Geben Sie uns die '''Sitzungs-ID''' und das '''Kennwort''' für den Verbindungsaufbau bekannt.

[https://get.teamviewer.com/648xqq2 Fernwartung starten]
 
 
 

==FAQ/Troubleshooting==
*[[Helper startet nicht mehr]]
*[[Grundmaske|Ich möchte die Grundmaske anpassen/Die Grundmaske ist schwarz.]] 
*[[Grundlegende_Bildschirmelemente#Menü «Bearbeiten»|Ich möchte die Ausrichtung und Grösse der einzelnen Arbeitsfenster speichern.]] 
*[[Buchungsjahre|Ich möchte ab Oktober das folgende Buchungsjahr eröffnen.]]
*[https://shop.crealogix.com/scanner.html/?___store=de&___from_store=en| Ich suche einen QR-Code-Belegleser (externer Link)]
*[[Einstellungen Nummernkreise|Ich möchte das Aussehen der automatischen Belegnummerierungen zum neuen Jahr hin anpassen.]]
*[[:Kategorie:Troubleshooting]]
 
 

==Inhaltsübersicht==
>> [[:Kategorie:Handbuch Helper|Weiter zu «Alle Handbuchseiten»]] 

>> [[Einstellungen|Weiter zu «Alle Einstellungen»]]

|valign="top" bgcolor="#E8F1FF" style="border-style:solid;border-width:1px;border-color:gray;padding-left:1em;padding-right:1em;padding-top:0.5em;"|

== Aktuelles ==
[[Personal – Lohnbeiträge ändern|Höherer AHV-Beitragssatz ab 01. Januar 2020]]

[[Systemvoraussetzungen| MacOS 11/12/13/14/15/M1/M2/M3]]

[[Buchungsjahre|Neues Buchungsjahr 2026 eröffnen]]

[[QR-Rechnung]]

[[Bankkonten|Umstellen auf den neuen ISO-20022-Zahlungsstandard]]

[[Anpassung des MwSt-Satzes|Neuer MwSt-Satz 8.1%]]

 
 

==Über Profile GmbH==
[https://www.profile.ch Homepage] 
[http://www.site.helper.ch/ Helper vorgestellt]

[[Plan pro_File|Lageplan]]
 
 

==Kontakt==

'''Profile GmbH''' 
Schaffhauserstr. 103 
Ruhtalstrasse 12 (ab 25.9.2024) 
8400 Winterthur 
Schweiz

Tel. +41 52 213 63 33 
[mailto:support@profile.ch?subject=Supportanfrage support@profile.ch]

__NOTOC__

Buchungsjahre

2025-06-25T12:18:06Z

Mirko Pepa:

Alle Jahre wieder ab dem ''1. Oktober'' erinnert Helper mit einem Bildschirmhinweis, dass Sie ein neues Buchungsjahr eröffnen müssen. 
Dazu gehen Sie folgendermassen vor:

* Öffnen sie das entsprechende Fenster unter '''«Einstellungen -> Buchungsjahre»'''.
* Klicken Sie auf «'''Neu'''».
* Geben Sie den Namen des neuen Buchungsjahres ein, beispielsweise '''2026'''.
* Kontrollieren Sie das vorgeschlagene Anfangs- und Enddatum. Nehmen Sie hier nur Änderungen vor, falls Sie ein Über- oder Unterjahr erstellen möchten.
* Bestätigen Sie Ihre Eingaben mit «'''OK'''».
:Der Kontenrahmen des aktuellen Buchungsjahres 2025 wird für das neue Jahr 2026 dupliziert.
 
[[Datei:Buchungsjahre.png]]

''Abbildung: Fenster zum Erstellen eines neuen Buchungsjahres''

;Hinweis:Falls Sie '''nach dem Erstellen''' eines neuen Buchungsjahres im aktuellen Kontenrahmen '''nachträglich''' Umgestaltungen vornehmen müssen (z. B. Anlegen eines neuen Kontos), so müssen Sie parallel dazu im Kontenrahmen '''des bereits erstellten Folgejahres dieselben Änderungen''' vornehmen.

==Verwandte Themen==
[[Kontenrahmen]] 

↑ [[Buchhaltung]] 
↑ [[Einstellungen]]

[[Kategorie:Handbuch Helper]]

Systemvoraussetzungen

2025-06-19T09:02:15Z

Mirko Pepa: /* Windows-Versionen vor 10 */

==Windows 10==
Alle Versionen von Helper laufen auf Windows 10.

==Windows 11 auf Intel/AMD==
Alle Versionen von Helper laufen auf Windows 11.

==Windows 11 auf ARM==
Wir haben Version 32 getestet und Helper läuft auf einem Windows 11 auf ARM. Auf jeden Fall läuft der Helper hier in einer Intel/AMD-Emulation. Das bedeutet, dass er etwas langsamer läuft, aber auf dem getesteten Gerät (Microsoft Surface von 2024) war die Geschwindigkeit vollkommen genügend.

==MacOS 13 "Ventura"==
Die Helper-Versionen bis und mit 24 laufen nicht auf Ventura. Version 25 und folgende (basierend auf Omnis 10) laufen. Idealerweise benutzen Sie Version 29 oder 32.

==MacOS 14 "Sonoma"==
Mit den Versionen bis und mit 29 gibt es einen mühsamen Bug (Texte werden teils auf dem Kopf dargestellt). Ab Version 32 läuft der Helper auf MacOS Sonoma.

==MacOS 15 "Sequoia"==
Mit den Versionen bis und mit 29 gibt es einen mühsamen Bug (Texte werden teils auf dem Kopf dargestellt). Ab Version 32 läuft der Helper auf MacOS Sequoia.

==Apple-Hardware mit M1/M2/M3-Prozessor==
Versionen ab 28 laufen sicher darauf, zur Zeit noch im Emulations-Modus 'Rosetta'. Ab Version 29 läuft Helper nativ auf M1/M2/M3-Prozessoren.

==MacOS vor 13 "Ventura"==
Diese Versionen werden von Apple und uns nicht mehr unterstützt.

===MacOS 12 "Monterey"===
Die Helper-Versionen bis und mit 24 laufen nicht auf Monterey. Version 25 und folgende (basierend auf Omnis 10) laufen. Idealerweise benutzen Sie Version 29 oder 32.

===MacOS 11 "Big Sur"===
Die Helper-Versionen bis und mit 24 laufen nicht auf Big Sur. Versionen 25 bis 32 (basierend auf Omnis 10) laufen.

===Mac OS 10.15 Catalina===
MacOS 10.15 Catalina schneidet einige alte Zöpfe ab:
* Die Carbon-Schnittstelle wurde abgeschafft
* 32bit-Anwendungen laufen nicht mehr
und bringt einige Neuerungen im Bereich der Sicherheit:
* Mehr Warnungen beim Zugriff auf Systemressourcen, wie Netzwerklaufwerke.

Das hat zur Folge, dass folgende Helper-Versionen überhaupt '''nicht mehr laufen''':
* Versionen, die auf Omnis Studio 4.x basieren (aus den Jahren 2008 bis 2016)
* Versionen, die auf Omnis Studio 6.x basieren (ca. aus dem Jahr 2017)

So finden Sie heraus, welche Version Sie haben:
* Öffnen Sie im Apfel-Menu '''Über diesen Macintosh'''
* Klicken Sie auf Systembericht …, ein Fenster öffnet sich.
* Wählen Sie links in der Gruppe '''Software''' den Punkt '''Programme'''
* Suchen Sie in der oberen Liste nach dem Helper (oder Omnis je nachdem wie der Helper auf Ihrem System heisst)
* Beachten Sie nun die letzte Spalte '64-Bit (Intel)'. Steht dort '''Nein''', läuft Ihre Version nicht auf Catalina. '''Hier benötigen Sie einen grösseren Update der detailliert geplant werden muss. Melden Sie sich bitte rechtzeitig bei uns.'''

Helper Version 22 und 23, die auf Omnis Studio 8.1.3 bzw. 8.1.6 basieren, '''laufen noch eingeschränkt'''. Nach Datei-Auswahldialogen kommt es zu Abstürzen.
Hier benötigen Sie einen Update auf Version 24 (das auf Omnis Studio 8.1.7.1 basiert). '''Dieses Update (von 22 auf 24) ist nicht so aufwändig und kann ca. innerhalb einer Woche vorbereitet und ausgeliefert werden.'''

==Windows-Versionen vor 10/Server 2016==
Ältere Windows-Versionen werden von Microsoft und uns nicht mehr unterstützt. Der Helper läuft aber vermutlich noch darauf. Helper 37 benötigt mindestens Windows 10/Server 2016.

Raspberry Pi 2

2025-05-20T12:05:44Z

Mirko Pepa: /* Temperatur und Feuchtigkeitssensor */

Wir verwenden Rasperry Pi auf verschieden Arten im Zusammenhang mit dem Helper

==Temperatur und Feuchtigkeitssensor==
Hier verwenden am Raspi einen AM2315-Sensor.

Hier ein paar Seiten zu dem Gerät [https://www.switchdoc.com/2018/11/python-am2315-library-released/]

[https://learn.adafruit.com/am2315-encased-i2c-temperature-humidity-sensor/overview]

[https://mallimages.ofweek.com/Upload/guige/2025/03/20/6116/5b0bb55f20fc8.pdf ProductManual]

==Digital Signage==
Hier verwenden wir grosse Monitore, um Informationen für die Angestellten anzuzeigen.

Raspberry Pi 2

2025-05-20T12:05:10Z

Mirko Pepa: /* Temperatur und Feuchtigkeitssensor */

Wir verwenden Rasperry Pi auf verschieden Arten im Zusammenhang mit dem Helper

==Temperatur und Feuchtigkeitssensor==
Hier verwenden am Raspi einen AM2315-Sensor.

Hier ein paar Seiten zu dem Gerät [https://www.switchdoc.com/2018/11/python-am2315-library-released/]

[https://learn.adafruit.com/am2315-encased-i2c-temperature-humidity-sensor/overview]

[https://mallimages.ofweek.com/Upload/guige/2025/03/20/6116/5b0bb55f20fc8.pdf|Product Manual]

==Digital Signage==
Hier verwenden wir grosse Monitore, um Informationen für die Angestellten anzuzeigen.

Raspberry Pi 2

2025-05-20T11:59:09Z

Mirko Pepa: /* Temperatur und Feuchtigkeitssensor */

Wir verwenden Rasperry Pi auf verschieden Arten im Zusammenhang mit dem Helper

==Temperatur und Feuchtigkeitssensor==
Hier verwenden am Raspi einen AM2315-Sensor.

Hier ein paar Seiten zu dem Gerät [https://www.switchdoc.com/2018/11/python-am2315-library-released/]

[https://learn.adafruit.com/am2315-encased-i2c-temperature-humidity-sensor/overview]

==Digital Signage==
Hier verwenden wir grosse Monitore, um Informationen für die Angestellten anzuzeigen.

Raspberry Pi 2

2025-05-20T11:58:18Z

Mirko Pepa: /* Temperatur und Feuchtigkeitssensor */

Wir verwenden Rasperry Pi auf verschieden Arten im Zusammenhang mit dem Helper

==Temperatur und Feuchtigkeitssensor==
Hier verwenden am Raspi einen AM2315-Sensor.

Hier ein paar Seiten zu dem Gerät [[https://www.switchdoc.com/2018/11/python-am2315-library-released/]]

[[https://learn.adafruit.com/am2315-encased-i2c-temperature-humidity-sensor/overview]]

==Digital Signage==
Hier verwenden wir grosse Monitore, um Informationen für die Angestellten anzuzeigen.

Raspberry Pi 2

2025-05-20T11:50:15Z

Mirko Pepa: Die Seite wurde neu angelegt: „Wir verwenden Rasperry Pi auf verschieden Arten im Zusammenhang mit dem Helper ==Temperatur und Feuchtigkeitssensor== Hier verwenden am Raspi einen AM2315-Sensor. ==Digital Signage== Hier verwenden wir grosse Monitore, um Informationen für die Angestellten anzuzeigen.“

Wir verwenden Rasperry Pi auf verschieden Arten im Zusammenhang mit dem Helper

==Temperatur und Feuchtigkeitssensor==
Hier verwenden am Raspi einen AM2315-Sensor.

==Digital Signage==
Hier verwenden wir grosse Monitore, um Informationen für die Angestellten anzuzeigen.

Anlagen - Standorte und Lagerplätze

2025-05-20T11:48:03Z

Mirko Pepa:

In [[Anlagen|'''Anlagen''']] können Sie nebst Maschinen, Drucker und sonstigen Material und Geräten auch Lagerplätze und Standorte erfassen. In diesem Modul können Sie die Lagerplätze und Standorte auch verwalten.

== Anlagen als Lager kennzeichnen ==
Um Anlagen als Lager zu erfassen, müssen Sie im Fenster in der Gruppenbox Lager den Lagerplatztyp auf '''Lagerplatz''' oder '''Archivplatz''' stellen.

[[Datei:AnlagenAlsLagerplatz.png|500px]]

In diesem Screenshot sehen Sie die Felder, um Anlagen auf Lager zu stellen, im roten Bereich.

== Feldreferenzen ==

;Taste «Lagerübersicht»:Hier wird ein Fenster geöffnet, dass nur Anlagen, die Lagerplätze sind anzeigt. Auf Klick links in der Lagerplatzliste, können Sie ausserdem in der Liste rechts die eingelagerten Objekte einsehen.

;Taste «Lagerübersicht!»:Hier können Sie die Lagerübersicht zu einem Lagerplatz oder allen ausdrucken. Gefragt wird hier die Anzahl Ebenen, die gedruckt werden sollen. Hat das Lager weitere Lagerplätze zum Beispiel: im Raum stehen fünf Regale und jedes Regal hat drei Tablare. Wenn Sie dann die Anzahl Ebenen auf 2 stellen, dann werden nur die Objekte vom Raum und die Objekte von den fünf Regalen gedruckt.

;Taste «Logdaten»:Wenn das Lager Logdaten, wie zum Beispiel Temperaturmessungen, speichert, öffnet sich ein Fenster mit den Logdaten des Lagers auf. Hier haben sie dann einen Einblick auf die Logdaten für das Lager.

=== Gruppe Lager ===

;Standort:Im Feld Standort ist die Lagerverwaltung von Anlagen möglich. Geben Sie hier den Suchkürzel der Anlage. '''Achtung, die Anlage die Sie hier eingeben, muss ein Lagerplatz/Standort sein.'''

[[Datei:Anlagen RegalGelagertInRaum.png|400px]]

Im gezeigten Beispiel ist das «Regal 2» im «Raum 1».

;Lagerplatztyp:Hier definieren Sie, den Lagerplatztyp der Anlage:
:«kein Lagerplatz» - die Anlage ist '''kein''' Lagerplatz/Standort. Hier können weder Anlagen noch Objekte eingelagert werden.
:«Lagerplatz» - die Anlage ist '''ein''' Lagerplatz/Standort. Hier können Anlagen und Objekte eingelagert werden.
:«Archivplatz» - die Anlage ist '''ein''' Archivplatz. Hier können Anlagen und Objekte eingelagert werden. Zusätzlich können die Objekte auch archiviert werden.

;Sicherheitsstufe:Hier markieren Sie, ob die Anlage eine Sicherheitsstufe hat.

;klimatisiert:Hier markieren Sie, ob die Anlage klimatisiert wird.

== Lager mit Sensoren ==
Wenn es Lager gibt, in dem Messgrössen (z.B. das Klima) mit einem Sensor (z.B. einem Raspberry PI) gemessen werden, kann eine Anlage für den Sensor erstellt werden. Geben Sie in der Anlage des Sensors im Standortfeld (Gruppe Lager) das Suchkürzel des Lagers ein. Geben Sie ausserdem im Feld «Netzwerkadresse» den Pfad an, wo sich die Logdatei mit Messwerten (z.B. Klimadaten) befindet und bestätigen Sie in der Checkbox «ist ein Sensor», dass es sich um einen Sensor handelt.

[[Datei:AnlagenSensorBeispiel.png|500px]]

In diesem Beispiel wird das Klima von «Raum 1» mit dem «[[Raspberry Pi 2]]» gemessen. Die Felder «Standort» und «Netzwerkadresse», sowie die Checkbox «ist ein Sensor» sind im roten Bereich markiert.

== Objekt Einlagerung ==
Im Modul '''Obj. Einlagerung''' können Sie Objekte in Lagerplätze einlagern oder archivieren.

[[Datei:ObjektEinlagerung.png|500px]]

Im Bild sehen Sie das Fenster für die Objekteinlagerung. Objekte werden wie folgt eingelagert:

#Schritt: Wählen Sie den Produktionsauftrag. (blau markiert)
#Schritt: Erfassen Sie im Feld «Objekt/Lagerplatz» zuerst alle Objekte (Objektnummer) zum passenden Produktionsauftrag. Erfassen Sie danach im gleichen Feld den Lagerplatz (Suchkürzel der Anlage). Alle erfassten Objekte, die in der Liste noch an keinem Lagerplatz zugeteilt waren, werden dem neuen Lagerplatz zugeteilt. (rot markiert)
#Schritt: Wenn Sie noch weitere Objekte vom gleichen Produktionsauftrag haben, können Sie den 2. Schritt wiederholen.
#Schritt: Wenn der Lagerplatz ein Archivplatz ist, können Sie auswählen, ob Sie die Objekte archivieren möchten oder nur einlagern. (orange markiert)
#Schritt: Objekte, die Sie doch nicht einlagern möchten, können Sie wieder aus der Liste entfernen. Wählen Sie die Objekte in der Liste aus und drücken Sie dann die Taste «Markierte Löschen». (gelb markiert)
#Schritt: Wenn Sie zufrieden sind mit den erfassten Objekte und Anlagen, bestätigen Sie die Einlagerung durch Klicken auf die Taste «Einlagern» (grün markiert). Somit werden die Objekte eingelagert. Bei erfolgreicher Einlagerung werden die Objekte aus der Liste entfernt. Ansonsten werden die fehlerhaften Objekte in der Liste markiert.

Fehler während dem Erfassen und Einlagern werden in der Fehlermeldung ausgegeben. (lila markiert)

== Objekt Auslagerung ==
Im Modul '''Obj. Auslagerung''' können Sie Objekte von Lagerplätze wieder auslagern. Die Objekte mussten vorher eingelagert sein, damit man diese auslagern kann.

[[Datei:ObjektAuslagerung.png|500px]]

Im Bild sehen Sie die das Fenster für die Objektauslagerung. Objekte werden wie folgt ausgelagert:

#Schritt: Wählen Sie den Produktionsauftrag. (blau markiert)
#Schritt: Erfassen Sie im Feld «Objekt» alle Objekte (Objektnummer) zum passenden Produktionsauftrag. (rot markiert)
#Schritt: Schreiben Sie einen Text im Feld «Text/Grund Auslagerung». (orange markiert)
#Schritt: Objekte, die Sie doch nicht auslagern möchten, können Sie wieder aus der Liste entfernen. Wählen Sie die Objekte in der Liste aus und drücken Sie dann die Taste «Markierte Löschen». (gelb markiert)
#Schritt: Wenn Sie zufrieden sind mit den erfassten Objekten, bestätigen Sie die Auslagerung durch Klicken auf die Taste «Auslagern» (grün markiert). Somit werden die Objekte ausgelagert. Bei erfolgreicher Auslagerung werden die Objekte aus der Liste entfernt. Ansonsten werden die fehlerhaften Objekte in der Liste markiert.

Fehler während dem Erfassen und Auslagern werden in der Fehlermeldung ausgegeben. (lila markiert)

Verfügbare Funktionen

2025-05-06T12:53:24Z

Mirko Pepa:

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

===§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')

==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-05-06T12:51:26Z

Mirko Pepa:

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

===§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')

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