Vorschau · Entwicklungsstand 1.6.1

Dynamischen Bildbereich erstellen

Dynamischen Bildbereich erstellenDetailansicht: Dynamischen Bildbereich erstellen. Markierte Beschriftungen zeigen die Einstellungen im Editor. Die Abbildung zeigt eine Beispielkonfiguration, keine ausgeführte Aktion. Zusammengestellte Ausschnitte echter Einstellungsfelder mit Beispielwerten; die Nummer markiert Beschriftung und Eingabe gemeinsam.
Detailansicht: Dynamischen Bildbereich erstellen. Markierte Beschriftungen zeigen die Einstellungen im Editor. Die Abbildung zeigt eine Beispielkonfiguration, keine ausgeführte Aktion. Zusammengestellte Ausschnitte echter Einstellungsfelder mit Beispielwerten; die Nummer markiert Beschriftung und Eingabe gemeinsam.
  1. 1
    Erkennungsergebnis

    Erkennung mit einem kompatiblen Rechteck als Quelle des dynamischen Suchbereichs.

  2. 2
    Rand (px)

    Ganzzahliger zusätzlicher Rand des dynamischen Suchbereichs in Pixeln; im Editor kann ein direkter Wert gewählt werden.

  3. 3
    Mindestkonfidenz (%)

    Mindestkonfidenz für die Übernahme eines Treffers in ROI/Vorhersage. Erkennungsergebnisse verwenden 0 bis 1; der Editor kann denselben Wert als Prozent darstellen.

  4. 4
    Durchläufe bis zur Vollbildsuche (0 = nie)

    Anzahl Durchläufe bis zur erneuten Vollsuche. 0 deaktiviert die regelmäßige Vollsuche.

  5. 5
    Fehlversuche 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.

EinstellungBedeutung und BedienungBeispielwert
ErkennungsergebnisErkennung 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

ErgebnisBedeutung
Roi UpdatedOb der dynamische Suchbereich in diesem Step neu aus einem verwertbaren Treffer aktualisiert wurde. Einzelwert dieses Ergebnisses.
Roi ResetOb der Suchbereich wegen der Rücksetzregel auf den Ausgangsbereich zurückgesetzt wurde. Einzelwert dieses Ergebnisses.
Global BoundsSuchrechteck in globalen Desktopkoordinaten. Für bildlokale Verbraucher muss dessen Quelle/Versatz berücksichtigt werden. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Global Bounds / XHorizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Global Bounds / YVertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Global Bounds / WidthBreite des Ergebnisrechtecks in Pixeln. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Global Bounds / HeightHöhe des Ergebnisrechtecks in Pixeln. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Global Bounds / LeftLinke Rechteckkante in Pixeln. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Global Bounds / TopObere Rechteckkante in Pixeln. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Global Bounds / RightRechte Rechteckkante in Pixeln, aus Ursprung und Breite abgeleitet. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Global Bounds / BottomUntere Rechteckkante in Pixeln, aus Ursprung und Höhe abgeleitet. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Global Bounds / Is EmptyOb die Zwischenablage im abgefragten Kontext leer ist. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Global Bounds / LocationPixelposition/-bereich eines erkannten Wortes oder Trefferobjekts; verwende den im Ergebnis ausgewiesenen Koordinatenraum. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Global Bounds / Location / XHorizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Global Bounds / Location / YVertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Global Bounds / CenterMittelpunkt einer einzelnen Erkennung in Pixeln. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Global Bounds / Center / XHorizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Global Bounds / Center / YVertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Consecutive MissesAnzahl aufeinanderfolgender nicht verwertbarer Treffer seit der letzten gültigen Aktualisierung. Einzelwert dieses Ergebnisses.
Full Search IntervalKonfigurierter 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 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: dynamic_roi

Felder und Zusammenhänge auf einen Blick
  1. 1
    Erkennungsergebnisbounds_source · ResultBinding · Nicht angegeben

    Erkennung mit einem kompatiblen Rechteck als Quelle des dynamischen Suchbereichs.

  2. 2
    Rand (px)padding_source · ResultBinding · 0

    Ganzzahliger zusätzlicher Rand des dynamischen Suchbereichs in Pixeln; im Editor kann ein direkter Wert gewählt werden.

  3. 3
    Mindestkonfidenz (%)minimum_confidence · Number · 0

    Mindestkonfidenz für die Übernahme eines Treffers in ROI/Vorhersage

  4. 4
    Durchläufe bis zur Vollbildsuche (0 = nie)full_search_interval · Integer · 10

    Anzahl Durchläufe bis zur erneuten Vollsuche

  5. 5
    Fehlversuche bis zum Zurücksetzen (0 = nie)reset_after_misses · Integer · 3

    Anzahl aufeinanderfolgender Fehlversuche bis zum Rücksetzen auf den Ausgangssuchbereich

  6. 6
    Roi UpdatedErgebnis: roi_updated · Wert

    Ob der dynamische Suchbereich in diesem Step neu aus einem verwertbaren Treffer aktualisiert wurde

  7. 7
    Roi ResetErgebnis: roi_reset · Wert

    Ob der Suchbereich wegen der Rücksetzregel auf den Ausgangsbereich zurückgesetzt wurde

  8. 8
    Global BoundsErgebnis: global_bounds · Wert

    Suchrechteck in globalen Desktopkoordinaten

  9. 9
    Global Bounds / XErgebnis: global_bounds.x · Wert

    Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten

  10. 10
    Global Bounds / YErgebnis: global_bounds.y · Wert

    Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen

  11. 11
    Global Bounds / WidthErgebnis: global_bounds.width · Wert

    Breite des Ergebnisrechtecks in Pixeln

  12. 12
    Global Bounds / HeightErgebnis: global_bounds.height · Wert

    Höhe des Ergebnisrechtecks in Pixeln

  13. 13
    Global Bounds / LeftErgebnis: global_bounds.left · Wert

    Linke Rechteckkante in Pixeln

  14. 14
    Global Bounds / TopErgebnis: global_bounds.top · Wert

    Obere Rechteckkante in Pixeln

  15. 15
    Global Bounds / RightErgebnis: global_bounds.right · Wert

    Rechte Rechteckkante in Pixeln, aus Ursprung und Breite abgeleitet

  16. 16
    Global Bounds / BottomErgebnis: global_bounds.bottom · Wert

    Untere Rechteckkante in Pixeln, aus Ursprung und Höhe abgeleitet

  17. 17
    Global Bounds / Is EmptyErgebnis: global_bounds.is_empty · Wert

    Ob die Zwischenablage im abgefragten Kontext leer ist

  18. 18
    Global Bounds / LocationErgebnis: global_bounds.location · Wert

    Pixelposition/-bereich eines erkannten Wortes oder Trefferobjekts; verwende den im Ergebnis ausgewiesenen Koordinatenraum

  19. 19
    Global Bounds / Location / XErgebnis: global_bounds.location.x · Wert

    Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten

  20. 20
    Global Bounds / Location / YErgebnis: global_bounds.location.y · Wert

    Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen

  21. 21
    Global Bounds / CenterErgebnis: global_bounds.center · Wert

    Mittelpunkt einer einzelnen Erkennung in Pixeln

  22. 22
    Global Bounds / Center / XErgebnis: global_bounds.center.x · Wert

    Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten

  23. 23
    Global Bounds / Center / YErgebnis: global_bounds.center.y · Wert

    Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen

  24. 24
    Consecutive MissesErgebnis: consecutive_misses · Wert

    Anzahl aufeinanderfolgender nicht verwertbarer Treffer seit der letzten gültigen Aktualisierung

  25. 25
    Full 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

WertTypStandard laut VertragOptionen und RegelnErklärung
Erkennungsergebnis
bounds_source
ResultBindingNicht angegebenPflichtfeld
Erkennung mit einem kompatiblen Rechteck als Quelle des dynamischen Suchbereichs.
Rand (px)
padding_source
ResultBinding0Pflichtfeld
Ganzzahliger zusätzlicher Rand des dynamischen Suchbereichs in Pixeln; im Editor kann ein direkter Wert gewählt werden.
Mindestkonfidenz (%)
minimum_confidence
Number0Regeln 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
Integer10Regeln 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
Integer3Regeln 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.

FeldModelltypModell-Standard / OptionenErklärung
idStringNicht angegebenStabile 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.
inputsDictionary`2Nicht angegebenZuordnung 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.itemsList`1Nicht angegebenGeordnete Unterbindungen einer Liste. Die Reihenfolge ist Teil der Eingabe; Elemente müssen das Listenelement-Schema erfüllen.
inputs.property_idStringNicht angegebenStabile 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_pathStringNicht angegebenÄlterer Pfad zu einem Ergebnis-Unterwert. Bestehende Dateien bleiben lesbar; neue Referenzen verwenden stabile Ergebnis-IDs und gegebenenfalls value_path.
inputs.source_step_idStringNicht angegebenKompatibilitätsfeld älterer Referenzen. Neue Referenzen verwenden provider_id=step_result und die versionierte source_id.
inputs.membersDictionary`2Nicht angegebenBenannte Unterbindungen eines strukturierten Werts. Jeder Schlüssel ist eine stabile Mitglied-ID des Feldschemas; Unterbindungen können Werte einer Basisquelle gezielt überschreiben.
inputs.provider_idStringNicht angegebenAnbieter 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_idStringNicht angegebenVersionierte 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_idStringNicht angegebenAnbieterbezogene 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_pathStringNicht angegebenOptionaler Pfad unterhalb einer Anbieterquelle, zum Beispiel zu einem typisierten Objektmitglied. Er ändert den Quellanbieter nicht; der ausgewählte Unterwert muss kompatibel sein.
is_enabledBooleantruetrue führt den Step aus; false deaktiviert ihn. Blockmarker können in der UI nicht beliebig deaktiviert werden, weil ihre Struktur erhalten bleiben muss.
settingsDynamicRoiSettingsNicht angegebenDirekte beziehungsweise ältere Step-Konfiguration. Für neue referenzbasierte Dateien inputs und localValues verwenden; die UI migriert gespeicherte Literalwerte in lokale Quellen.
settings.bounds_sourceResultBindingNicht angegebenErkennung mit einem kompatiblen Rechteck als Quelle des dynamischen Suchbereichs.
settings.bounds_source.itemsList`1Nicht angegebenGeordnete Unterbindungen einer Liste. Die Reihenfolge ist Teil der Eingabe; Elemente müssen das Listenelement-Schema erfüllen.
settings.bounds_source.property_idStringNicht angegebenStabile 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_pathStringNicht 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_idStringNicht angegebenKompatibilitätsfeld älterer Referenzen. Neue Referenzen verwenden provider_id=step_result und die versionierte source_id.
settings.bounds_source.membersDictionary`2Nicht angegebenBenannte 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_idStringLeerer TextAnbieter 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_idStringNicht angegebenVersionierte 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_idStringLeerer TextAnbieterbezogene 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_pathStringNicht angegebenOptionaler 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_intervalInt3210Anzahl Durchläufe bis zur erneuten Vollsuche. 0 deaktiviert die regelmäßige Vollsuche.
settings.minimum_confidenceDouble0Mindestkonfidenz für die Übernahme eines Treffers in ROI/Vorhersage. Erkennungsergebnisse verwenden 0 bis 1; der Editor kann denselben Wert als Prozent darstellen.
settings.paddingInt32-1Rand um das erkannte Rechteck in Pixeln; er erweitert den nächsten Suchbereich.
settings.padding_sourceResultBindingNicht angegebenGanzzahliger zusätzlicher Rand des dynamischen Suchbereichs in Pixeln; im Editor kann ein direkter Wert gewählt werden.
settings.padding_source.itemsList`1Nicht angegebenGeordnete Unterbindungen einer Liste. Die Reihenfolge ist Teil der Eingabe; Elemente müssen das Listenelement-Schema erfüllen.
settings.padding_source.property_idStringNicht angegebenStabile 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_pathStringNicht 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_idStringNicht angegebenKompatibilitätsfeld älterer Referenzen. Neue Referenzen verwenden provider_id=step_result und die versionierte source_id.
settings.padding_source.membersDictionary`2Nicht angegebenBenannte 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_idStringLeerer TextAnbieter 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_idStringNicht angegebenVersionierte 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_idStringLeerer TextAnbieterbezogene 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_pathStringNicht angegebenOptionaler 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_missesInt323Anzahl aufeinanderfolgender Fehlversuche bis zum Rücksetzen auf den Ausgangssuchbereich. 0 deaktiviert dieses automatische Rücksetzen.

Eingabeverträge

EingabeFehlende WerteListenAkzeptierte Typen / QuellenErklärung
boundsFailStepFirstValue[{"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.
paddingFailStepFirstValue[{"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

ErgebnisTyp / OptionenAnzahlErklärung
roi_updatedBooleanSingleOb der dynamische Suchbereich in diesem Step neu aus einem verwertbaren Treffer aktualisiert wurde. Einzelwert dieses Ergebnisses.
roi_resetBooleanSingleOb der Suchbereich wegen der Rücksetzregel auf den Ausgangsbereich zurückgesetzt wurde. Einzelwert dieses Ergebnisses.
global_boundsRectangleOptionalSingleSuchrechteck in globalen Desktopkoordinaten. Für bildlokale Verbraucher muss dessen Quelle/Versatz berücksichtigt werden. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
global_bounds.xIntegerOptionalSingleHorizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
global_bounds.yIntegerOptionalSingleVertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
global_bounds.widthIntegerOptionalSingleBreite des Ergebnisrechtecks in Pixeln. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
global_bounds.heightIntegerOptionalSingleHöhe des Ergebnisrechtecks in Pixeln. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
global_bounds.leftIntegerOptionalSingleLinke Rechteckkante in Pixeln. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
global_bounds.topIntegerOptionalSingleObere Rechteckkante in Pixeln. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
global_bounds.rightIntegerOptionalSingleRechte Rechteckkante in Pixeln, aus Ursprung und Breite abgeleitet. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
global_bounds.bottomIntegerOptionalSingleUntere Rechteckkante in Pixeln, aus Ursprung und Höhe abgeleitet. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
global_bounds.is_emptyBooleanOptionalSingleOb die Zwischenablage im abgefragten Kontext leer ist. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
global_bounds.locationPointOptionalSinglePixelposition/-bereich eines erkannten Wortes oder Trefferobjekts; verwende den im Ergebnis ausgewiesenen Koordinatenraum. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
global_bounds.location.xIntegerOptionalSingleHorizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
global_bounds.location.yIntegerOptionalSingleVertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
global_bounds.centerPointOptionalSingleMittelpunkt einer einzelnen Erkennung in Pixeln. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
global_bounds.center.xIntegerOptionalSingleHorizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
global_bounds.center.yIntegerOptionalSingleVertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
consecutive_missesIntegerSingleAnzahl aufeinanderfolgender nicht verwertbarer Treffer seit der letzten gültigen Aktualisierung. Einzelwert dieses Ergebnisses.
full_search_intervalIntegerSingleKonfigurierter 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
}