Vorschau · Entwicklungsstand 1.6.1
Dynamischen Bildbereich erstellen

- 1Erkennungsergebnis
Erkennung mit einem kompatiblen Rechteck als Quelle des dynamischen Suchbereichs.
- 2Rand (px)
Ganzzahliger zusätzlicher Rand des dynamischen Suchbereichs in Pixeln; im Editor kann ein direkter Wert gewählt werden.
- 3Mindestkonfidenz (%)
Mindestkonfidenz für die Übernahme eines Treffers in ROI/Vorhersage. Erkennungsergebnisse verwenden 0 bis 1; der Editor kann denselben Wert als Prozent darstellen.
- 4Durchläufe bis zur Vollbildsuche (0 = nie)
Anzahl Durchläufe bis zur erneuten Vollsuche. 0 deaktiviert die regelmäßige Vollsuche.
- 5Fehlversuche bis zum Zurücksetzen (0 = nie)
Anzahl aufeinanderfolgender Fehlversuche bis zum Rücksetzen auf den Ausgangssuchbereich. 0 deaktiviert dieses automatische Rücksetzen.
Editor-Ausschnitt mit Markierungen · Lightmode · Beispieldaten · Bild anklicken zum Vergrößern. Die Ansichten erklären die Bedienung; noch nicht gewählte Quellen, Geräte oder Modelle müssen für einen ausführbaren Job ergänzt werden.
Wofür ist das gedacht?
Leite aus einem Erkennungstreffer den nächsten Suchbereich ab. Rand, Mindestkonfidenz, regelmäßige Vollsuche und Rücksetzen nach Fehlversuchen steuern, wie lange die Suche auf dem Ziel bleibt. Verbinde diesen Step mit dem dynamischen ROI-Eingang der Erkennung; im ersten Durchlauf dient deren ursprünglicher Bereich als Ausgangspunkt.
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 |
|---|---|---|
| Erkennungsergebnis | Erkennung mit einem kompatiblen Rechteck als Quelle des dynamischen Suchbereichs. | Farberkennung → Begrenzungsrahmen |
| Rand (px) | Ganzzahliger zusätzlicher Rand des dynamischen Suchbereichs in Pixeln; im Editor kann ein direkter Wert gewählt werden. | 20 px |
| Mindestkonfidenz (%) | Mindestkonfidenz für die Übernahme eines Treffers in ROI/Vorhersage. Erkennungsergebnisse verwenden 0 bis 1; der Editor kann denselben Wert als Prozent darstellen. Im Bereich „Erweitert“ verfügbar. Zulässiger Bereich: ab 0 % bis 100 %. | 0 % |
| Durchläufe bis zur Vollbildsuche (0 = nie) | Anzahl Durchläufe bis zur erneuten Vollsuche. 0 deaktiviert die regelmäßige Vollsuche. Im Bereich „Erweitert“ verfügbar. Zulässiger Bereich: ab 0. | 10 |
| Fehlversuche bis zum Zurücksetzen (0 = nie) | Anzahl aufeinanderfolgender Fehlversuche bis zum Rücksetzen auf den Ausgangssuchbereich. 0 deaktiviert dieses automatische Rücksetzen. Im Bereich „Erweitert“ verfügbar. Zulässiger Bereich: ab 0. | 3 |
Ergebniswerte verwenden
| Ergebnis | Bedeutung |
|---|---|
| Roi Updated | Ob der dynamische Suchbereich in diesem Step neu aus einem verwertbaren Treffer aktualisiert wurde. Einzelwert dieses Ergebnisses. |
| Roi Reset | Ob der Suchbereich wegen der Rücksetzregel auf den Ausgangsbereich zurückgesetzt wurde. Einzelwert dieses Ergebnisses. |
| Global Bounds | Suchrechteck in globalen Desktopkoordinaten. Für bildlokale Verbraucher muss dessen Quelle/Versatz berücksichtigt werden. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden. |
| Global Bounds / X | Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden. |
| Global Bounds / Y | Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden. |
| Global Bounds / Width | Breite des Ergebnisrechtecks in Pixeln. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden. |
| Global Bounds / Height | Höhe des Ergebnisrechtecks in Pixeln. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden. |
| Global Bounds / Left | Linke Rechteckkante in Pixeln. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden. |
| Global Bounds / Top | Obere Rechteckkante in Pixeln. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden. |
| Global Bounds / Right | Rechte Rechteckkante in Pixeln, aus Ursprung und Breite abgeleitet. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden. |
| Global Bounds / Bottom | Untere Rechteckkante in Pixeln, aus Ursprung und Höhe abgeleitet. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden. |
| Global Bounds / Is Empty | Ob die Zwischenablage im abgefragten Kontext leer ist. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden. |
| Global Bounds / Location | Pixelposition/-bereich eines erkannten Wortes oder Trefferobjekts; verwende den im Ergebnis ausgewiesenen Koordinatenraum. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden. |
| Global Bounds / Location / X | Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden. |
| Global Bounds / Location / Y | Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden. |
| Global Bounds / Center | Mittelpunkt einer einzelnen Erkennung in Pixeln. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden. |
| Global Bounds / Center / X | Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden. |
| Global Bounds / Center / Y | Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden. |
| Consecutive Misses | Anzahl aufeinanderfolgender nicht verwertbarer Treffer seit der letzten gültigen Aktualisierung. Einzelwert dieses Ergebnisses. |
| Full Search Interval | Konfigurierter Abstand regelmäßiger Vollsuchen in Durchläufen; 0 bedeutet keine regelmäßige Vollsuche. Einzelwert dieses Ergebnisses. |
Beispiel
Erkennung → dynamischer ROI mit Rand 20 → denselben ROI im nächsten Erkennungsdurchlauf verwenden; regelmäßig eine Vollsuche einplanen.
Vorbereitete Beispielabläufe ansehenFehler 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: dynamic_roi
- 1Erkennungsergebnisbounds_source · ResultBinding · Nicht angegeben
Erkennung mit einem kompatiblen Rechteck als Quelle des dynamischen Suchbereichs.
- 2Rand (px)padding_source · ResultBinding · 0
Ganzzahliger zusätzlicher Rand des dynamischen Suchbereichs in Pixeln; im Editor kann ein direkter Wert gewählt werden.
- 3Mindestkonfidenz (%)minimum_confidence · Number · 0
Mindestkonfidenz für die Übernahme eines Treffers in ROI/Vorhersage
- 4Durchläufe bis zur Vollbildsuche (0 = nie)full_search_interval · Integer · 10
Anzahl Durchläufe bis zur erneuten Vollsuche
- 5Fehlversuche bis zum Zurücksetzen (0 = nie)reset_after_misses · Integer · 3
Anzahl aufeinanderfolgender Fehlversuche bis zum Rücksetzen auf den Ausgangssuchbereich
- 6Roi UpdatedErgebnis: roi_updated · Wert
Ob der dynamische Suchbereich in diesem Step neu aus einem verwertbaren Treffer aktualisiert wurde
- 7Roi ResetErgebnis: roi_reset · Wert
Ob der Suchbereich wegen der Rücksetzregel auf den Ausgangsbereich zurückgesetzt wurde
- 8Global BoundsErgebnis: global_bounds · Wert
Suchrechteck in globalen Desktopkoordinaten
- 9Global Bounds / XErgebnis: global_bounds.x · Wert
Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten
- 10Global Bounds / YErgebnis: global_bounds.y · Wert
Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen
- 11Global Bounds / WidthErgebnis: global_bounds.width · Wert
Breite des Ergebnisrechtecks in Pixeln
- 12Global Bounds / HeightErgebnis: global_bounds.height · Wert
Höhe des Ergebnisrechtecks in Pixeln
- 13Global Bounds / LeftErgebnis: global_bounds.left · Wert
Linke Rechteckkante in Pixeln
- 14Global Bounds / TopErgebnis: global_bounds.top · Wert
Obere Rechteckkante in Pixeln
- 15Global Bounds / RightErgebnis: global_bounds.right · Wert
Rechte Rechteckkante in Pixeln, aus Ursprung und Breite abgeleitet
- 16Global Bounds / BottomErgebnis: global_bounds.bottom · Wert
Untere Rechteckkante in Pixeln, aus Ursprung und Höhe abgeleitet
- 17Global Bounds / Is EmptyErgebnis: global_bounds.is_empty · Wert
Ob die Zwischenablage im abgefragten Kontext leer ist
- 18Global Bounds / LocationErgebnis: global_bounds.location · Wert
Pixelposition/-bereich eines erkannten Wortes oder Trefferobjekts; verwende den im Ergebnis ausgewiesenen Koordinatenraum
- 19Global Bounds / Location / XErgebnis: global_bounds.location.x · Wert
Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten
- 20Global Bounds / Location / YErgebnis: global_bounds.location.y · Wert
Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen
- 21Global Bounds / CenterErgebnis: global_bounds.center · Wert
Mittelpunkt einer einzelnen Erkennung in Pixeln
- 22Global Bounds / Center / XErgebnis: global_bounds.center.x · Wert
Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten
- 23Global Bounds / Center / YErgebnis: global_bounds.center.y · Wert
Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen
- 24Consecutive MissesErgebnis: consecutive_misses · Wert
Anzahl aufeinanderfolgender nicht verwertbarer Treffer seit der letzten gültigen Aktualisierung
- 25Full Search IntervalErgebnis: full_search_interval · Wert
Konfigurierter Abstand regelmäßiger Vollsuchen in Durchläufen; 0 bedeutet keine regelmäßige Vollsuche
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 |
|---|---|---|---|---|
Erkennungsergebnisbounds_source | ResultBinding | Nicht angegeben | Pflichtfeld | Erkennung mit einem kompatiblen Rechteck als Quelle des dynamischen Suchbereichs. |
Rand (px)padding_source | ResultBinding | 0 | Pflichtfeld | Ganzzahliger zusätzlicher Rand des dynamischen Suchbereichs in Pixeln; im Editor kann ein direkter Wert gewählt werden. |
Mindestkonfidenz (%)minimum_confidence | Number | 0 | Regeln siehe Erklärung Grenzen: {"Minimum": 0, "Maximum": 1} | Mindestkonfidenz für die Übernahme eines Treffers in ROI/Vorhersage. Erkennungsergebnisse verwenden 0 bis 1; der Editor kann denselben Wert als Prozent darstellen. |
Durchläufe bis zur Vollbildsuche (0 = nie)full_search_interval | Integer | 10 | Regeln siehe Erklärung Grenzen: {"Minimum": 0} | Anzahl Durchläufe bis zur erneuten Vollsuche. 0 deaktiviert die regelmäßige Vollsuche. |
Fehlversuche bis zum Zurücksetzen (0 = nie)reset_after_misses | Integer | 3 | Regeln siehe Erklärung Grenzen: {"Minimum": 0} | Anzahl aufeinanderfolgender Fehlversuche bis zum Rücksetzen auf den Ausgangssuchbereich. 0 deaktiviert dieses automatische Rücksetzen. |
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 | DynamicRoiSettings | 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.bounds_source | ResultBinding | Nicht angegeben | Erkennung mit einem kompatiblen Rechteck als Quelle des dynamischen Suchbereichs. |
settings.bounds_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.bounds_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.bounds_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.bounds_source.source_step_id | String | Nicht angegeben | Kompatibilitätsfeld älterer Referenzen. Neue Referenzen verwenden provider_id=step_result und die versionierte source_id. |
settings.bounds_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.bounds_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.bounds_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.bounds_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.bounds_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.full_search_interval | Int32 | 10 | Anzahl Durchläufe bis zur erneuten Vollsuche. 0 deaktiviert die regelmäßige Vollsuche. |
settings.minimum_confidence | Double | 0 | Mindestkonfidenz für die Übernahme eines Treffers in ROI/Vorhersage. Erkennungsergebnisse verwenden 0 bis 1; der Editor kann denselben Wert als Prozent darstellen. |
settings.padding | Int32 | -1 | Rand um das erkannte Rechteck in Pixeln; er erweitert den nächsten Suchbereich. |
settings.padding_source | ResultBinding | Nicht angegeben | Ganzzahliger zusätzlicher Rand des dynamischen Suchbereichs in Pixeln; im Editor kann ein direkter Wert gewählt werden. |
settings.padding_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.padding_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.padding_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.padding_source.source_step_id | String | Nicht angegeben | Kompatibilitätsfeld älterer Referenzen. Neue Referenzen verwenden provider_id=step_result und die versionierte source_id. |
settings.padding_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.padding_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.padding_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.padding_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.padding_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.reset_after_misses | Int32 | 3 | Anzahl aufeinanderfolgender Fehlversuche bis zum Rücksetzen auf den Ausgangssuchbereich. 0 deaktiviert dieses automatische Rücksetzen. |
Eingabeverträge
| Eingabe | Fehlende Werte | Listen | Akzeptierte Typen / Quellen | Erklärung |
|---|---|---|---|---|
bounds | FailStep | FirstValue | [{"ValueKind": "Rectangle", "Cardinalities": ["Single", "OptionalSingle", "Collection"]}]["step_result"] | Rechteck eines Erkennungsergebnisses. Fehlende erforderliche Werte führen zum Fehler. Bei kompatiblen Listen wird der erste Wert verwendet. Akzeptierte Typen und Anbieter stehen in den Vertragsspalten; unbegrenzte Anbieterwahl bedeutet weiterhin Typprüfung. |
padding | FailStep | FirstValue | [{"ValueKind": "Integer", "Cardinalities": ["Single", "OptionalSingle"]}]["job_variable", "step_result"] | ganzzahliger ROI-Rand. Fehlende erforderliche Werte führen zum Fehler. Bei kompatiblen Listen wird der erste Wert verwendet. Akzeptierte Typen und Anbieter stehen in den Vertragsspalten; unbegrenzte Anbieterwahl bedeutet weiterhin Typprüfung. |
Ergebnisvertrag
| Ergebnis | Typ / Optionen | Anzahl | Erklärung |
|---|---|---|---|
roi_updated | Boolean | Single | Ob der dynamische Suchbereich in diesem Step neu aus einem verwertbaren Treffer aktualisiert wurde. Einzelwert dieses Ergebnisses. |
roi_reset | Boolean | Single | Ob der Suchbereich wegen der Rücksetzregel auf den Ausgangsbereich zurückgesetzt wurde. Einzelwert dieses Ergebnisses. |
global_bounds | Rectangle | OptionalSingle | Suchrechteck in globalen Desktopkoordinaten. Für bildlokale Verbraucher muss dessen Quelle/Versatz berücksichtigt werden. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden. |
global_bounds.x | Integer | OptionalSingle | Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden. |
global_bounds.y | Integer | OptionalSingle | Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden. |
global_bounds.width | Integer | OptionalSingle | Breite des Ergebnisrechtecks in Pixeln. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden. |
global_bounds.height | Integer | OptionalSingle | Höhe des Ergebnisrechtecks in Pixeln. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden. |
global_bounds.left | Integer | OptionalSingle | Linke Rechteckkante in Pixeln. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden. |
global_bounds.top | Integer | OptionalSingle | Obere Rechteckkante in Pixeln. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden. |
global_bounds.right | Integer | OptionalSingle | Rechte Rechteckkante in Pixeln, aus Ursprung und Breite abgeleitet. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden. |
global_bounds.bottom | Integer | OptionalSingle | Untere Rechteckkante in Pixeln, aus Ursprung und Höhe abgeleitet. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden. |
global_bounds.is_empty | Boolean | OptionalSingle | Ob die Zwischenablage im abgefragten Kontext leer ist. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden. |
global_bounds.location | Point | OptionalSingle | Pixelposition/-bereich eines erkannten Wortes oder Trefferobjekts; verwende den im Ergebnis ausgewiesenen Koordinatenraum. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden. |
global_bounds.location.x | Integer | OptionalSingle | Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden. |
global_bounds.location.y | Integer | OptionalSingle | Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden. |
global_bounds.center | Point | OptionalSingle | Mittelpunkt einer einzelnen Erkennung in Pixeln. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden. |
global_bounds.center.x | Integer | OptionalSingle | Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden. |
global_bounds.center.y | Integer | OptionalSingle | Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden. |
consecutive_misses | Integer | Single | Anzahl aufeinanderfolgender nicht verwertbarer Treffer seit der letzten gültigen Aktualisierung. Einzelwert dieses Ergebnisses. |
full_search_interval | Integer | Single | Konfigurierter Abstand regelmäßiger Vollsuchen in Durchläufen; 0 bedeutet keine regelmäßige Vollsuche. 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": "dynamic_roi",
"settings": {
"bounds_source": {
"provider_id": "",
"source_id": ""
},
"padding": -1,
"padding_source": {
"provider_id": "",
"source_id": ""
},
"minimum_confidence": 0,
"full_search_interval": 10,
"reset_after_misses": 3
},
"id": "5daa1a25-95e8-a1e7-7645-817670fbad9a",
"inputs": {},
"is_enabled": true
}