Vorschau · Entwicklungsstand 1.6.1

Punkte vergleichen

Wofür ist das gedacht?

Vergleiche eine oder mehrere Punktquellen entweder mit einem Referenzpunkt und erlaubten Versätzen oder mit Achsenbedingungen. „Alle“ und „Mindestens eine“ bestimmen, wie mehrere Prüfungen zusammengefasst werden. Der Vergleich erzeugt ein Ergebnis; er bewegt die Maus nicht.

Einstellungen in der Oberfläche

Beispielwerte dienen zur Orientierung. Passe Pfade, Quellen und Geräte an deinen Arbeitsplatz an. Ein ausgeschaltetes Häkchen und die Zahl 0 sind ebenfalls gültige Beispielwerte.

Einstellung	Bedeutung und Bedienung	Beispielwert
Modus	Offset vergleicht Punkte mit einer Referenz und erlaubten X-/Y-Abweichungen. Expression wertet die konfigurierten Achsenbedingungen aus. Nur die Einstellungen des gewählten Modus sind aktiv. Referenzpunkt mit Toleranz Punkte anhand einer Referenzposition und erlaubter Versätze vergleichen. Achsenbedingungen Punkte anhand expliziter Achsenbedingungen vergleichen.	Referenzpunkt mit Toleranz
Erforderliche Treffer	Legt fest, ob alle geprüften Punkte/Bedingungen oder wenigstens einer/eine die Prüfung bestehen müssen. Alle Bedingungen (UND) Alle betrachteten Bedingungen beziehungsweise Punkte müssen passen. Mindestens ein Punkt (ODER) Mindestens eine betrachtete Bedingung beziehungsweise ein Punkt muss passen.	Alle Bedingungen (UND)
ZU PRÜFENDE PUNKTE	Füge die zu prüfenden Punkte hinzu. Wähle pro Eintrag eine manuelle X-/Y-Koordinate oder die kompatible Punktquelle eines vorherigen Steps. Die Auswahl bestimmt, welche Unterfelder erscheinen.	X = 120, Y = 90
Referenzquelle	Manual verwendet die direkt angegebenen Referenzkoordinaten; JobResult verwendet reference_points_source. Sichtbar bei: Modus = Referenzpunkt mit Toleranz. Manuell eingeben Verwendet die manuell angegebenen Koordinaten. Aus Referenz Verwendet einen kompatiblen Ergebniswert eines Job-Steps.	Manuell eingeben
X	Horizontale Referenzkoordinate für den Offsetvergleich in Pixeln. Sichtbar bei: Modus = Referenzpunkt mit Toleranz.	0
Y	Vertikale Referenzkoordinate für den Offsetvergleich in Pixeln. Sichtbar bei: Modus = Referenzpunkt mit Toleranz.	0
Punktquelle	Typisierte Punktquelle als Referenz für den Punktvergleich. Sichtbar bei: Modus = Referenzpunkt mit Toleranz.	Farberkennung → Punkt
Versatz X (px)	Erlaubte horizontale Abweichung vom Referenzpunkt in Pixeln. Mit 10 besteht ein Punkt die X-Prüfung, wenn seine X-Koordinate höchstens 10 px von der Referenz abweicht. Sichtbar bei: Modus = Referenzpunkt mit Toleranz. Zulässiger Bereich: ab 0.	10
Versatz Y (px)	Erlaubte vertikale Abweichung vom Referenzpunkt in Pixeln. Mit 10 besteht ein Punkt die Y-Prüfung, wenn seine Y-Koordinate höchstens 10 px von der Referenz abweicht. Sichtbar bei: Modus = Referenzpunkt mit Toleranz. Zulässiger Bereich: ab 0.	10
Verknüpfung	Verknüpft Achsenbedingungen mit And (UND) oder Or (ODER). Sichtbar bei: Modus = Achsenbedingungen. Alle Ausdrücke (UND) Bedingungen mit logischem UND verknüpfen. Mindestens ein Ausdruck (ODER) Bedingungen mit logischem ODER verknüpfen.	Alle Ausdrücke (UND)
Achsenbedingungen	Liste von Achsenbedingungen. Jede Bedingung beschreibt Achse, Operator und Vergleichsausdruck. Sichtbar bei: Modus = Achsenbedingungen.	X < 500

Eingaben innerhalb zusammengesetzter Einstellungen

Diese Felder erscheinen innerhalb der jeweiligen Einstellung und je nach gewählter Aktion oder Quelle. Bei einer Ergebnisquelle wählst du den passenden vorherigen Step statt eines direkten Werts.

Einstellung / Unterfeld	Bedeutung und Bedienung	Beispielwert
Achsenbedingungen › Verknüpfung	Verknüpft Achsenbedingungen mit And (UND) oder Or (ODER). And Bedingungen mit logischem UND verknüpfen. Or Bedingungen mit logischem ODER verknüpfen.	And
Achsenbedingungen › Bedingungen › Achse	Zu prüfende Koordinatenachse, etwa X oder Y. Die Bedingung bezieht sich auf diese Komponente des Punktes.	X
Achsenbedingungen › Bedingungen › Operator	Vergleichsoperator. Wahrheits-/Leerheitsprüfungen benötigen keinen zusätzlichen Vergleichstext; andere Operatoren verlangen kompatible Werte. LessThan Linker Wert muss kleiner sein als der rechte Vergleichswert. LessThanOrEqual Linker Wert muss kleiner oder gleich dem Vergleichswert sein. GreaterThan Linker Wert muss größer sein als der rechte Vergleichswert. GreaterThanOrEqual Linker Wert muss größer oder gleich dem Vergleichswert sein. Equal Prüft die Achsenbedingung auf Gleichheit. NotEqual Prüft die Achsenbedingung auf Ungleichheit.	LessThan
Achsenbedingungen › Bedingungen › Wert	Gespeicherter Literal- oder Vergleichswert. Sein JSON-Typ muss zum angegebenen value_kind und zur Kardinalität passen; Zahlen und Booleans nicht versehentlich als Text speichern.	500
Abstandstoleranz › Versatz X (px)	Zusätzlicher horizontaler Versatz in Pixeln relativ zum ermittelten Punkt, Referenzpunkt oder Anzeigeursprung.	10
Abstandstoleranz › Versatz Y (px)	Zusätzlicher vertikaler Versatz in Pixeln relativ zum ermittelten Punkt, Referenzpunkt oder Anzeigeursprung.	10
Abstandstoleranz › Referenzquelle	Manual verwendet die direkt angegebenen Referenzkoordinaten; JobResult verwendet reference_points_source. Manual Verwendet die manuell angegebenen Koordinaten. JobResult Verwendet einen kompatiblen Ergebniswert eines Job-Steps.	Manual
Abstandstoleranz › Referenz X (px)	Horizontale Referenzkoordinate für den Offsetvergleich in Pixeln.	0
Abstandstoleranz › Referenz Y (px)	Vertikale Referenzkoordinate für den Offsetvergleich in Pixeln.	0
Punkte › X (px)	Direkt eingetragene horizontale Punktkoordinate in Pixeln.	100
Punkte › Y (px)	Direkt eingetragene vertikale Punktkoordinate in Pixeln.	100
Punkte › Quelle	Auswahl zwischen einem direkt angegebenen Wert und einem referenzierten Job-Ergebnis, soweit dieser Konfigurationstyp beide Varianten anbietet. Manual Verwendet die manuell angegebenen Koordinaten. JobResult Verwendet einen kompatiblen Ergebniswert eines Job-Steps.	Manual

Ergebniswerte verwenden

Ergebnis	Bedeutung
Matches	Einzelne OCR-/Punktvergleichstreffer mit ihren Detailwerten. Der Ergebnis-Typ bestimmt die Elementstruktur. Einzelwert dieses Ergebnisses.
Match Count	Anzahl passender Prozesse oder Merkmalszuordnungen im konkreten Ergebnis; der Ergebnis-Typ bestimmt, was gezählt wird. Einzelwert dieses Ergebnisses.
Total Count	Gesamtzahl der im konkreten Abfrageergebnis gelieferten Einträge. Einzelwert dieses Ergebnisses.

Beispiel

Prüfe, ob eine Erkennung in X höchstens zehn Pixel vom Referenzpunkt abweicht, bevor ein nachfolgender Step ausgeführt wird.

Vorbereitete Beispielabläufe ansehen

Fehler und Hinweise

Prüfe die in dieser Referenz beschriebenen aktiven Pflichtfelder, kompatible Wertequellen und die Voraussetzungen auf dem Zielrechner. Ungültige Quellen oder Typen sind Fehler; eine gültige, aber nicht verfügbare optionale Quelle kann gemäß Eingabevertrag zum Überspringen führen. Ein Fehler beendet die Start-/Hauptphase; die vorgesehene Endphase wird zum Aufräumen behandelt. Der Verlauf zeigt den tatsächlich belegten Status.

Entwickler- und Agenten-Doku JSON, Feldnamen, Typen und Verträge

Dieser Bereich erklärt die Bearbeitung von Textdateien und die technischen Verträge. Zur Entwickler-Doku

Identifier: point_comparison

Felder und Zusammenhänge auf einen Blick

1
Modusmode · Enum · Offset, Expression
Offset vergleicht Punkte mit einer Referenz und erlaubten X-/Y-Abweichungen
2
Erforderliche Treffermatch_requirement · Enum · All, Any
Legt fest, ob alle geprüften Punkte/Bedingungen oder wenigstens einer/eine die Prüfung bestehen müssen.
3
ZU PRÜFENDE PUNKTEpoints · Collection · [{"source": "Manual", "manual_x": 0, "manual_y": 0, "points_source": null}]
Füge die zu prüfenden Punkte hinzu
4
Referenzquellereference_source · Enum · Manual, JobResult
Manual verwendet die direkt angegebenen Referenzkoordinaten; JobResult verwendet reference_points_source.
5
Xreference_x · Integer · 0
Horizontale Referenzkoordinate für den Offsetvergleich in Pixeln.
6
Yreference_y · Integer · 0
Vertikale Referenzkoordinate für den Offsetvergleich in Pixeln.
7
Punktquellereference_points_source · ResultBinding · Nicht angegeben
Typisierte Punktquelle als Referenz für den Punktvergleich.
8
Versatz X (px)offset_x · Integer · 10
Erlaubte horizontale Abweichung vom Referenzpunkt in Pixeln
9
Versatz Y (px)offset_y · Integer · 10
Erlaubte vertikale Abweichung vom Referenzpunkt in Pixeln
10
Verknüpfungcombine_mode · Enum · And, Or
Verknüpft Achsenbedingungen mit And (UND) oder Or (ODER).
11
Achsenbedingungenexpressions · Collection · [{"axis": "X", "operator": "LessThan", "value": 0}]
Liste von Achsenbedingungen
12
MatchesErgebnis: matches · Wert
Einzelne OCR-/Punktvergleichstreffer mit ihren Detailwerten
13
Match CountErgebnis: match_count · Wert
Anzahl passender Prozesse oder Merkmalszuordnungen im konkreten Ergebnis; der Ergebnis-Typ bestimmt, was gezählt wird
14
Total CountErgebnis: total_count · Wert
Gesamtzahl der im konkreten Abfrageergebnis gelieferten Einträge

Schematische Übersicht: Beschriftungen und Werte aus der Referenz, keine nachgezeichnete Bedienoberfläche.

Feldtypen, Standards und Regeln

Wert	Typ	Standard laut Vertrag	Optionen und Regeln	Erklärung
Modus `mode`	`Enum`	`Offset`	Pflichtfeld `["Offset", "Expression"]`	Offset vergleicht Punkte mit einer Referenz und erlaubten X-/Y-Abweichungen. Expression wertet die konfigurierten Achsenbedingungen aus. Nur die Einstellungen des gewählten Modus sind aktiv. `Offset` Punkte anhand einer Referenzposition und erlaubter Versätze vergleichen. `Expression` Punkte anhand expliziter Achsenbedingungen vergleichen.
Erforderliche Treffer `match_requirement`	`Enum`	`All`	Pflichtfeld `["All", "Any"]`	Legt fest, ob alle geprüften Punkte/Bedingungen oder wenigstens einer/eine die Prüfung bestehen müssen. `All` Alle betrachteten Bedingungen beziehungsweise Punkte müssen passen. `Any` Mindestens eine betrachtete Bedingung beziehungsweise ein Punkt muss passen.
ZU PRÜFENDE PUNKTE `points`	`Collection`	`[{"source": "Manual", "manual_x": 0, "manual_y": 0, "points_source": null}]`	Pflichtfeld	Füge die zu prüfenden Punkte hinzu. Wähle pro Eintrag eine manuelle X-/Y-Koordinate oder die kompatible Punktquelle eines vorherigen Steps. Die Auswahl bestimmt, welche Unterfelder erscheinen.
Referenzquelle `reference_source`	`Enum`	`Manual`	Pflichtfeld `["Manual", "JobResult"]` Sichtbar wenn: `{"FieldId": "mode", "EqualsValue": "Offset", "AnyOfValues": null}`	Manual verwendet die direkt angegebenen Referenzkoordinaten; JobResult verwendet reference_points_source. `Manual` Verwendet die manuell angegebenen Koordinaten. `JobResult` Verwendet einen kompatiblen Ergebniswert eines Job-Steps.
X `reference_x`	`Integer`	`0`	Regeln siehe Erklärung Sichtbar wenn: `{"FieldId": "mode", "EqualsValue": "Offset", "AnyOfValues": null}`	Horizontale Referenzkoordinate für den Offsetvergleich in Pixeln.
Y `reference_y`	`Integer`	`0`	Regeln siehe Erklärung Sichtbar wenn: `{"FieldId": "mode", "EqualsValue": "Offset", "AnyOfValues": null}`	Vertikale Referenzkoordinate für den Offsetvergleich in Pixeln.
Punktquelle `reference_points_source`	`ResultBinding`	`Nicht angegeben`	Regeln siehe Erklärung Sichtbar wenn: `{"FieldId": "mode", "EqualsValue": "Offset", "AnyOfValues": null}`	Typisierte Punktquelle als Referenz für den Punktvergleich.
Versatz X (px) `offset_x`	`Integer`	`10`	Regeln siehe Erklärung Grenzen: `{"Minimum": 0}` Sichtbar wenn: `{"FieldId": "mode", "EqualsValue": "Offset", "AnyOfValues": null}`	Erlaubte horizontale Abweichung vom Referenzpunkt in Pixeln. Mit 10 besteht ein Punkt die X-Prüfung, wenn seine X-Koordinate höchstens 10 px von der Referenz abweicht.
Versatz Y (px) `offset_y`	`Integer`	`10`	Regeln siehe Erklärung Grenzen: `{"Minimum": 0}` Sichtbar wenn: `{"FieldId": "mode", "EqualsValue": "Offset", "AnyOfValues": null}`	Erlaubte vertikale Abweichung vom Referenzpunkt in Pixeln. Mit 10 besteht ein Punkt die Y-Prüfung, wenn seine Y-Koordinate höchstens 10 px von der Referenz abweicht.
Verknüpfung `combine_mode`	`Enum`	`And`	Pflichtfeld `["And", "Or"]` Sichtbar wenn: `{"FieldId": "mode", "EqualsValue": "Expression", "AnyOfValues": null}`	Verknüpft Achsenbedingungen mit And (UND) oder Or (ODER). `And` Bedingungen mit logischem UND verknüpfen. `Or` Bedingungen mit logischem ODER verknüpfen.
Achsenbedingungen `expressions`	`Collection`	`[{"axis": "X", "operator": "LessThan", "value": 0}]`	Pflichtfeld Sichtbar wenn: `{"FieldId": "mode", "EqualsValue": "Expression", "AnyOfValues": null}`	Liste von Achsenbedingungen. Jede Bedingung beschreibt Achse, Operator und Vergleichsausdruck.

JSON-Felder und verschachtelte Einstellungen

Technische Feldnamen des Modells. Die Einstellungsfelder oben beschreiben die UI; die JSON-Vorlage zeigt die tatsächliche Schreibweise. Bei aktuellen inputs/localValues stammen aktive Werte aus den Referenzen. Die Modell-Standardwerte und Enum-Namen sind keine universelle JSON-Schreibweise.

Feld	Modelltyp	Modell-Standard / Optionen	Erklärung
`id`	`String`	`Nicht angegeben`	Stabile Identität dieses Eintrags. In einem Job müssen Step-IDs eindeutig sein; beim Kopieren eines eigenständigen Jobs/Makros eine neue Objekt-GUID erzeugen und interne Referenzen gezielt anpassen.
`inputs`	Dictionary`2	`Nicht angegeben`	Zuordnung von UI-Feld-ID zu typisierter Wertequelle. Bei vorhandenen inputs serialisiert der kanonische Job-Serializer settings nicht zusätzlich. Leere inputs mit settings bleiben als Legacy-/direkte Konfiguration lesbar.
`inputs.items`	List`1	`Nicht angegeben`	Geordnete Unterbindungen einer Liste. Die Reihenfolge ist Teil der Eingabe; Elemente müssen das Listenelement-Schema erfüllen.
`inputs.property_id`	`String`	`Nicht angegeben`	Stabile Ergebnis-ID einer älteren Step-Referenz. Neue Dateien kodieren sie in source_id; nicht mit einem CLR-Propertynamen oder dem UI-Label verwechseln.
`inputs.property_path`	`String`	`Nicht angegeben`	Älterer Pfad zu einem Ergebnis-Unterwert. Bestehende Dateien bleiben lesbar; neue Referenzen verwenden stabile Ergebnis-IDs und gegebenenfalls value_path.
`inputs.source_step_id`	`String`	`Nicht angegeben`	Kompatibilitätsfeld älterer Referenzen. Neue Referenzen verwenden provider_id=step_result und die versionierte source_id.
`inputs.members`	Dictionary`2	`Nicht angegeben`	Benannte Unterbindungen eines strukturierten Werts. Jeder Schlüssel ist eine stabile Mitglied-ID des Feldschemas; Unterbindungen können Werte einer Basisquelle gezielt überschreiben.
`inputs.provider_id`	`String`	`Nicht angegeben`	Anbieter der Wertequelle: local_value, job_variable, step_result oder secret. Ein Quellwert benötigt zusätzlich source_id und muss zum Eingabetyp passen.
`inputs.schema_id`	`String`	`Nicht angegeben`	Versionierte Form eines zusammengesetzten Eingabewerts. Sie gehört zum Bindungsbaum, nicht als frei erfundener Schlüssel in die Variable. Übernimm die für dieses Feld exportierte Schema-ID.
`inputs.source_id`	`String`	`Nicht angegeben`	Anbieterbezogene Identität. Bei step_result: v1/<URI-kodierte-Step-ID>/<URI-kodierte-stabile-Ergebnis-ID>; bei lokalen Werten und Jobvariablen deren GUID. Dies ist nicht nur die rohe Step-ID.
`inputs.value_path`	`String`	`Nicht angegeben`	Optionaler Pfad unterhalb einer Anbieterquelle, zum Beispiel zu einem typisierten Objektmitglied. Er ändert den Quellanbieter nicht; der ausgewählte Unterwert muss kompatibel sein.
`is_enabled`	`Boolean`	`true`	true führt den Step aus; false deaktiviert ihn. Blockmarker können in der UI nicht beliebig deaktiviert werden, weil ihre Struktur erhalten bleiben muss.
`settings`	`PointComparisonSettings`	`Nicht angegeben`	Direkte beziehungsweise ältere Step-Konfiguration. Für neue referenzbasierte Dateien inputs und localValues verwenden; die UI migriert gespeicherte Literalwerte in lokale Quellen.
`settings.expression_settings`	`ExpressionComparisonSettings`	`Nicht angegeben`	Einstellungen für den Punktvergleich mittels Achsenbedingungen und deren Verknüpfung.
`settings.expression_settings.combine_mode`	`ExpressionCombineMode`	`And` `["And", "Or"]`	Verknüpft Achsenbedingungen mit And (UND) oder Or (ODER). `And` Bedingungen mit logischem UND verknüpfen. `Or` Bedingungen mit logischem ODER verknüpfen.
`settings.expression_settings.expressions`	List`1	`Nicht angegeben`	Liste von Achsenbedingungen. Jede Bedingung beschreibt Achse, Operator und Vergleichsausdruck.
`settings.expression_settings.expressions.axis`	`String`	`Nicht angegeben`	Zu prüfende Koordinatenachse, etwa X oder Y. Die Bedingung bezieht sich auf diese Komponente des Punktes.
`settings.expression_settings.expressions.operator`	`PointAxisOperator`	`Nicht angegeben` `["LessThan", "LessThanOrEqual", "GreaterThan", "GreaterThanOrEqual", "Equal", "NotEqual"]`	Vergleichsoperator. Wahrheits-/Leerheitsprüfungen benötigen keinen zusätzlichen Vergleichstext; andere Operatoren verlangen kompatible Werte. `LessThan` Linker Wert muss kleiner sein als der rechte Vergleichswert. `LessThanOrEqual` Linker Wert muss kleiner oder gleich dem Vergleichswert sein. `GreaterThan` Linker Wert muss größer sein als der rechte Vergleichswert. `GreaterThanOrEqual` Linker Wert muss größer oder gleich dem Vergleichswert sein. `Equal` Prüft die Achsenbedingung auf Gleichheit. `NotEqual` Prüft die Achsenbedingung auf Ungleichheit.
`settings.expression_settings.expressions.value`	`Int32`	`Nicht angegeben`	Gespeicherter Literal- oder Vergleichswert. Sein JSON-Typ muss zum angegebenen value_kind und zur Kardinalität passen; Zahlen und Booleans nicht versehentlich als Text speichern.
`settings.match_requirement`	`PointMatchRequirement`	`All` `["All", "Any"]`	Legt fest, ob alle geprüften Punkte/Bedingungen oder wenigstens einer/eine die Prüfung bestehen müssen. `All` Alle betrachteten Bedingungen beziehungsweise Punkte müssen passen. `Any` Mindestens eine betrachtete Bedingung beziehungsweise ein Punkt muss passen.
`settings.mode`	`PointComparisonMode`	`Offset` `["Offset", "Expression"]`	Offset vergleicht Punkte mit einer Referenz und erlaubten X-/Y-Abweichungen. Expression wertet die konfigurierten Achsenbedingungen aus. Nur die Einstellungen des gewählten Modus sind aktiv. `Offset` Punkte anhand einer Referenzposition und erlaubter Versätze vergleichen. `Expression` Punkte anhand expliziter Achsenbedingungen vergleichen.
`settings.offset_settings`	`OffsetComparisonSettings`	`Nicht angegeben`	Einstellungen für den Punktvergleich mit Referenzpunkt und erlaubten Abweichungen.
`settings.offset_settings.offset_x`	`Int32`	`10`	Zusätzlicher horizontaler Versatz in Pixeln relativ zum ermittelten Punkt, Referenzpunkt oder Anzeigeursprung.
`settings.offset_settings.offset_y`	`Int32`	`10`	Zusätzlicher vertikaler Versatz in Pixeln relativ zum ermittelten Punkt, Referenzpunkt oder Anzeigeursprung.
`settings.offset_settings.reference_points_source`	`ResultBinding`	`Nicht angegeben`	Typisierte Punktquelle als Referenz für den Punktvergleich.
`settings.offset_settings.reference_points_source.items`	List`1	`Nicht angegeben`	Geordnete Unterbindungen einer Liste. Die Reihenfolge ist Teil der Eingabe; Elemente müssen das Listenelement-Schema erfüllen.
`settings.offset_settings.reference_points_source.property_id`	`String`	`Nicht angegeben`	Stabile Ergebnis-ID einer älteren Step-Referenz. Neue Dateien kodieren sie in source_id; nicht mit einem CLR-Propertynamen oder dem UI-Label verwechseln.
`settings.offset_settings.reference_points_source.property_path`	`String`	`Nicht angegeben`	Älterer Pfad zu einem Ergebnis-Unterwert. Bestehende Dateien bleiben lesbar; neue Referenzen verwenden stabile Ergebnis-IDs und gegebenenfalls value_path.
`settings.offset_settings.reference_points_source.source_step_id`	`String`	`Nicht angegeben`	Kompatibilitätsfeld älterer Referenzen. Neue Referenzen verwenden provider_id=step_result und die versionierte source_id.
`settings.offset_settings.reference_points_source.members`	Dictionary`2	`Nicht angegeben`	Benannte Unterbindungen eines strukturierten Werts. Jeder Schlüssel ist eine stabile Mitglied-ID des Feldschemas; Unterbindungen können Werte einer Basisquelle gezielt überschreiben.
`settings.offset_settings.reference_points_source.provider_id`	`String`	`Leerer Text`	Anbieter der Wertequelle: local_value, job_variable, step_result oder secret. Ein Quellwert benötigt zusätzlich source_id und muss zum Eingabetyp passen.
`settings.offset_settings.reference_points_source.schema_id`	`String`	`Nicht angegeben`	Versionierte Form eines zusammengesetzten Eingabewerts. Sie gehört zum Bindungsbaum, nicht als frei erfundener Schlüssel in die Variable. Übernimm die für dieses Feld exportierte Schema-ID.
`settings.offset_settings.reference_points_source.source_id`	`String`	`Leerer Text`	Anbieterbezogene Identität. Bei step_result: v1/<URI-kodierte-Step-ID>/<URI-kodierte-stabile-Ergebnis-ID>; bei lokalen Werten und Jobvariablen deren GUID. Dies ist nicht nur die rohe Step-ID.
`settings.offset_settings.reference_points_source.value_path`	`String`	`Nicht angegeben`	Optionaler Pfad unterhalb einer Anbieterquelle, zum Beispiel zu einem typisierten Objektmitglied. Er ändert den Quellanbieter nicht; der ausgewählte Unterwert muss kompatibel sein.
`settings.offset_settings.reference_source`	`PointEntrySource`	`Manual` `["Manual", "JobResult"]`	Manual verwendet die direkt angegebenen Referenzkoordinaten; JobResult verwendet reference_points_source. `Manual` Verwendet die manuell angegebenen Koordinaten. `JobResult` Verwendet einen kompatiblen Ergebniswert eines Job-Steps.
`settings.offset_settings.reference_x`	`Int32`	`0`	Horizontale Referenzkoordinate für den Offsetvergleich in Pixeln.
`settings.offset_settings.reference_y`	`Int32`	`0`	Vertikale Referenzkoordinate für den Offsetvergleich in Pixeln.
`settings.points`	List`1	`Nicht angegeben`	Füge die zu prüfenden Punkte hinzu. Wähle pro Eintrag eine manuelle X-/Y-Koordinate oder die kompatible Punktquelle eines vorherigen Steps. Die Auswahl bestimmt, welche Unterfelder erscheinen.
`settings.points.manual_x`	`Int32`	`Nicht angegeben`	Direkt eingetragene horizontale Punktkoordinate in Pixeln.
`settings.points.manual_y`	`Int32`	`Nicht angegeben`	Direkt eingetragene vertikale Punktkoordinate in Pixeln.
`settings.points.points_source`	`ResultBinding`	`Nicht angegeben`	Kompatible Punkt-/Erkennungsquelle. Der betreffende Eingabevertrag bestimmt, ob der erste oder alle Listeneinträge verarbeitet werden.
`settings.points.points_source.items`	List`1	`Nicht angegeben`	Geordnete Unterbindungen einer Liste. Die Reihenfolge ist Teil der Eingabe; Elemente müssen das Listenelement-Schema erfüllen.
`settings.points.points_source.property_id`	`String`	`Nicht angegeben`	Stabile Ergebnis-ID einer älteren Step-Referenz. Neue Dateien kodieren sie in source_id; nicht mit einem CLR-Propertynamen oder dem UI-Label verwechseln.
`settings.points.points_source.property_path`	`String`	`Nicht angegeben`	Älterer Pfad zu einem Ergebnis-Unterwert. Bestehende Dateien bleiben lesbar; neue Referenzen verwenden stabile Ergebnis-IDs und gegebenenfalls value_path.
`settings.points.points_source.source_step_id`	`String`	`Nicht angegeben`	Kompatibilitätsfeld älterer Referenzen. Neue Referenzen verwenden provider_id=step_result und die versionierte source_id.
`settings.points.points_source.members`	Dictionary`2	`Nicht angegeben`	Benannte Unterbindungen eines strukturierten Werts. Jeder Schlüssel ist eine stabile Mitglied-ID des Feldschemas; Unterbindungen können Werte einer Basisquelle gezielt überschreiben.
`settings.points.points_source.provider_id`	`String`	`Nicht angegeben`	Anbieter der Wertequelle: local_value, job_variable, step_result oder secret. Ein Quellwert benötigt zusätzlich source_id und muss zum Eingabetyp passen.
`settings.points.points_source.schema_id`	`String`	`Nicht angegeben`	Versionierte Form eines zusammengesetzten Eingabewerts. Sie gehört zum Bindungsbaum, nicht als frei erfundener Schlüssel in die Variable. Übernimm die für dieses Feld exportierte Schema-ID.
`settings.points.points_source.source_id`	`String`	`Nicht angegeben`	Anbieterbezogene Identität. Bei step_result: v1/<URI-kodierte-Step-ID>/<URI-kodierte-stabile-Ergebnis-ID>; bei lokalen Werten und Jobvariablen deren GUID. Dies ist nicht nur die rohe Step-ID.
`settings.points.points_source.value_path`	`String`	`Nicht angegeben`	Optionaler Pfad unterhalb einer Anbieterquelle, zum Beispiel zu einem typisierten Objektmitglied. Er ändert den Quellanbieter nicht; der ausgewählte Unterwert muss kompatibel sein.
`settings.points.source`	`PointEntrySource`	`Nicht angegeben` `["Manual", "JobResult"]`	Auswahl zwischen einem direkt angegebenen Wert und einem referenzierten Job-Ergebnis, soweit dieser Konfigurationstyp beide Varianten anbietet. `Manual` Verwendet die manuell angegebenen Koordinaten. `JobResult` Verwendet einen kompatiblen Ergebniswert eines Job-Steps.

Eingabeverträge

Eingabe	Fehlende Werte	Listen	Akzeptierte Typen / Quellen	Erklärung
`points`	`SkipStep`	`AllValues`	`[{"ValueKind": "Point", "Cardinalities": ["Single", "OptionalSingle", "Collection"]}]` `["job_variable", "step_result"]`	Punkt-/Erkennungsergebnis. Eine gültige, aber noch nicht verfügbare optionale Step-Quelle kann den Verbraucher mit NoInput überspringen; malformed Referenzen bleiben Fehler. Alle kompatiblen Listeneinträge werden verarbeitet. Akzeptierte Typen und Anbieter stehen in den Vertragsspalten; unbegrenzte Anbieterwahl bedeutet weiterhin Typprüfung.

Ergebnisvertrag

Ergebnis	Typ / Optionen	Anzahl	Erklärung
`matches`	`Boolean`	`Single`	Einzelne OCR-/Punktvergleichstreffer mit ihren Detailwerten. Der Ergebnis-Typ bestimmt die Elementstruktur. Einzelwert dieses Ergebnisses.
`match_count`	`Integer`	`Single`	Anzahl passender Prozesse oder Merkmalszuordnungen im konkreten Ergebnis; der Ergebnis-Typ bestimmt, was gezählt wird. Einzelwert dieses Ergebnisses.
`total_count`	`Integer`	`Single`	Gesamtzahl der im konkreten Abfrageergebnis gelieferten Einträge. Einzelwert dieses Ergebnisses.

Diese Referenz für Textdateien und Agenten: Markdown · JSON-Vertrag

JSON-Vorlage für Textdateien und Agenten

Strukturelle Defaultvorlage direkt vom App-Serializer. Leere Pflichtwerte und Ziele vor Verwendung ergänzen; diese Vorlage ist kein vollständig validierter Ablauf. Bei neuen Jobs den aktuellen inputs/localValues-Vertrag verwenden.

Dateiformate und Regeln · JSON herunterladen

{
  "type": "point_comparison",
  "settings": {
    "mode": "Offset",
    "match_requirement": "All",
    "points": [
      {
        "source": "Manual",
        "manual_x": 0,
        "manual_y": 0,
        "points_source": {
          "provider_id": "",
          "source_id": ""
        }
      }
    ],
    "offset_settings": {
      "reference_source": "Manual",
      "reference_x": 0,
      "reference_y": 0,
      "reference_points_source": {
        "provider_id": "",
        "source_id": ""
      },
      "offset_x": 10,
      "offset_y": 10
    },
    "expression_settings": {
      "expressions": [
        {
          "axis": "X",
          "operator": "LessThan",
          "value": 0
        }
      ],
      "combine_mode": "And"
    }
  },
  "id": "e82b1d75-e0de-5ff6-a44a-a5c26f839b7f",
  "inputs": {},
  "is_enabled": true
}