Vorschau · Entwicklungsstand 1.6.1
DynamicRoiResult
Wofür ist das gedacht?
Typisierter Ergebnisvertrag DynamicRoiResult. Wird von Dynamischen Bildbereich erstellen geliefert. Die stabilen Ergebnis-IDs unten sind unabhängig von CLR-Namen und UI-Übersetzungen. Wähle im Ergebnis-Auswahldialog eine kompatible Eigenschaft statt das ganze Objekt ungeprüft als Text zu verwenden.
- 1Zweck
Typisierter Ergebnisvertrag DynamicRoiResult. Wird von Dynamischen Bildbereich erstellen geliefert. Die stabilen Ergebnis-IDs unten sind unabhängig von CLR-Namen und UI-Übersetzungen. Wähle im Ergebnis-Auswahldialog eine kompatible Eigenschaft statt das ganze Objekt ungeprüft als Text zu verwenden.
- 2Beispiel
Eine Ergebnisreferenz verwendet provider_id=step_result und source_id=v1/<kodierte-Step-ID>/<kodierte-Ergebnis-ID>. Die Anleitung „Werte verbinden“ zeigt eine vollständige Verbindung. Prüfe Typ und Kardinalität vor der Verwendung in einer Bedingung oder Folgeaktion.
- 3Hinweise
Ein konfigurierte Quelle hat noch nicht zwingend einen Wert geliefert. Prüfe den fachlichen Erfolgswert, fehlende optionale Eigenschaften und den Ausführungszustand des Produzenten. Nur DynamicRoi besitzt die dokumentierte Ausnahme für späteres Feedback; andere Verbraucher dürfen keine beliebigen Vorwärtsreferenzen verwenden.
Orientierung für die Bedienung. Technische Verträge stehen im Entwicklerbereich am Seitenende.
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
Eine Ergebnisreferenz verwendet provider_id=step_result und source_id=v1/<kodierte-Step-ID>/<kodierte-Ergebnis-ID>. Die Anleitung „Werte verbinden“ zeigt eine vollständige Verbindung. Prüfe Typ und Kardinalität vor der Verwendung in einer Bedingung oder Folgeaktion.
Vorbereitete Beispielabläufe ansehenFehler und Hinweise
Ein konfigurierte Quelle hat noch nicht zwingend einen Wert geliefert. Prüfe den fachlichen Erfolgswert, fehlende optionale Eigenschaften und den Ausführungszustand des Produzenten. Nur DynamicRoi besitzt die dokumentierte Ausnahme für späteres Feedback; andere Verbraucher dürfen keine beliebigen Vorwärtsreferenzen verwenden.
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: DynamicRoiResult
- 1Roi UpdatedErgebnis: roi_updated · Wert
Ob der dynamische Suchbereich in diesem Step neu aus einem verwertbaren Treffer aktualisiert wurde
- 2Roi ResetErgebnis: roi_reset · Wert
Ob der Suchbereich wegen der Rücksetzregel auf den Ausgangsbereich zurückgesetzt wurde
- 3Global BoundsErgebnis: global_bounds · Wert
Suchrechteck in globalen Desktopkoordinaten
- 4Global Bounds / XErgebnis: global_bounds.x · Wert
Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten
- 5Global Bounds / YErgebnis: global_bounds.y · Wert
Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen
- 6Global Bounds / WidthErgebnis: global_bounds.width · Wert
Breite des Ergebnisrechtecks in Pixeln
- 7Global Bounds / HeightErgebnis: global_bounds.height · Wert
Höhe des Ergebnisrechtecks in Pixeln
- 8Global Bounds / LeftErgebnis: global_bounds.left · Wert
Linke Rechteckkante in Pixeln
- 9Global Bounds / TopErgebnis: global_bounds.top · Wert
Obere Rechteckkante in Pixeln
- 10Global Bounds / RightErgebnis: global_bounds.right · Wert
Rechte Rechteckkante in Pixeln, aus Ursprung und Breite abgeleitet
- 11Global Bounds / BottomErgebnis: global_bounds.bottom · Wert
Untere Rechteckkante in Pixeln, aus Ursprung und Höhe abgeleitet
- 12Global Bounds / Is EmptyErgebnis: global_bounds.is_empty · Wert
Ob die Zwischenablage im abgefragten Kontext leer ist
- 13Global Bounds / LocationErgebnis: global_bounds.location · Wert
Pixelposition/-bereich eines erkannten Wortes oder Trefferobjekts; verwende den im Ergebnis ausgewiesenen Koordinatenraum
- 14Global Bounds / Location / XErgebnis: global_bounds.location.x · Wert
Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten
- 15Global Bounds / Location / YErgebnis: global_bounds.location.y · Wert
Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen
- 16Global Bounds / CenterErgebnis: global_bounds.center · Wert
Mittelpunkt einer einzelnen Erkennung in Pixeln
- 17Global Bounds / Center / XErgebnis: global_bounds.center.x · Wert
Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten
- 18Global Bounds / Center / YErgebnis: global_bounds.center.y · Wert
Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen
- 19Consecutive MissesErgebnis: consecutive_misses · Wert
Anzahl aufeinanderfolgender nicht verwertbarer Treffer seit der letzten gültigen Aktualisierung
- 20Full 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.
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