Vorschau · Entwicklungsstand 1.6.1

GetProcessResult

Wofür ist das gedacht?

Typisierter Ergebnisvertrag GetProcessResult. Wird von Laufenden Prozess suchen 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.

GetProcessResult verstehen
  1. 1
    Zweck

    Typisierter Ergebnisvertrag GetProcessResult. Wird von Laufenden Prozess suchen 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.

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

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

Orientierung für die Bedienung. Technische Verträge stehen im Entwicklerbereich am Seitenende.

Ergebniswerte verwenden

ErgebnisBedeutung
FoundOb die Erkennung/Suche in diesem Lauf einen passenden Treffer geliefert hat. false ist ein fachliches Ergebnis und nicht automatisch ein Step-Fehler. Einzelwert dieses Ergebnisses.
ProcessKonkrete Prozessreferenz mit Identität und optionalen Programmdaten. Bei keinem Treffer kann sie fehlen; nicht nur process_name als Instanzidentität verwenden. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Process / Process IdWindows-Prozess-ID. PIDs können später wiederverwendet werden; die Prozessreferenz ergänzt daher gegebenenfalls Startzeit und weitere Merkmale. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Process / Start Time UtcUTC-Startzeit der Prozessinstanz zur Unterscheidung wiederverwendeter PIDs. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Process / Process NameVom System ermittelter Prozessname, nicht notwendigerweise der sichtbare Fenstertitel. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Process / Executable PathErmittelter Pfad des Programms. Bei fehlenden Rechten oder fehlender Information kann ein optionaler Wert leer sein. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Process / Window HandleNative Fensterkennung der Programminstanz. Sie gilt im laufenden System und ist kein stabiler Dateipfad oder dauerhafter Job-Bezeichner. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.

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 ansehen

Fehler 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: GetProcessResult

Felder und Zusammenhänge auf einen Blick
  1. 1
    FoundErgebnis: found · Wert

    Ob die Erkennung/Suche in diesem Lauf einen passenden Treffer geliefert hat

  2. 2
    ProcessErgebnis: process · Wert

    Konkrete Prozessreferenz mit Identität und optionalen Programmdaten

  3. 3
    Process / Process IdErgebnis: process.process_id · Wert

    Windows-Prozess-ID

  4. 4
    Process / Start Time UtcErgebnis: process.start_time_utc · Wert

    UTC-Startzeit der Prozessinstanz zur Unterscheidung wiederverwendeter PIDs

  5. 5
    Process / Process NameErgebnis: process.process_name · Wert

    Vom System ermittelter Prozessname, nicht notwendigerweise der sichtbare Fenstertitel

  6. 6
    Process / Executable PathErgebnis: process.executable_path · Wert

    Ermittelter Pfad des Programms

  7. 7
    Process / Window HandleErgebnis: process.window_handle · Wert

    Native Fensterkennung der Programminstanz

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

Ergebnisvertrag

ErgebnisTyp / OptionenAnzahlErklärung
foundBooleanSingleOb die Erkennung/Suche in diesem Lauf einen passenden Treffer geliefert hat. false ist ein fachliches Ergebnis und nicht automatisch ein Step-Fehler. Einzelwert dieses Ergebnisses.
processProcessReferenceOptionalSingleKonkrete Prozessreferenz mit Identität und optionalen Programmdaten. Bei keinem Treffer kann sie fehlen; nicht nur process_name als Instanzidentität verwenden. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
process.process_idIntegerOptionalSingleWindows-Prozess-ID. PIDs können später wiederverwendet werden; die Prozessreferenz ergänzt daher gegebenenfalls Startzeit und weitere Merkmale. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
process.start_time_utcDateTimeOptionalSingleUTC-Startzeit der Prozessinstanz zur Unterscheidung wiederverwendeter PIDs. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
process.process_nameTextOptionalSingleVom System ermittelter Prozessname, nicht notwendigerweise der sichtbare Fenstertitel. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
process.executable_pathTextOptionalSingleErmittelter Pfad des Programms. Bei fehlenden Rechten oder fehlender Information kann ein optionaler Wert leer sein. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
process.window_handleIntegerOptionalSingleNative Fensterkennung der Programminstanz. Sie gilt im laufenden System und ist kein stabiler Dateipfad oder dauerhafter Job-Bezeichner. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.

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