{ "appVersion": "1.6.1", "contract": { "id": "active_process", "name": "Prozessstatus prüfen", "description": "Prüft nur, ob eine passende Programminstanz läuft; ein sichtbares Fenster ist nicht erforderlich.", "category": "ProgrammeFenster", "uiFieldIds": [ "process_target" ], "fields": [ { "id": "process_target", "name": "Prozessreferenz", "descriptor": { "Id": "process_target", "LabelKey": "Ui.Step.Settings.ProcessSource", "ValueKind": "Object", "Required": true, "DefaultValue": null, "DescriptionKey": null, "EditorHint": "process-target-picker", "Constraints": null, "Width": "Full", "Advanced": false, "Order": 0, "VisibleWhen": null, "Options": null, "InputContractId": "process", "VisibleWhenAll": null, "VisualOverlayOptions": null, "DirectoryPickerOptions": null, "FilePickerOptions": null, "RoiPickerOptions": null, "YoloPickerOptions": null, "WindowsCapabilityPickerOptions": null, "ScreenPointPickerOptions": null, "AllowsDirectValue": null, "MonitorDeviceNameFieldId": null } } ], "schema": [ { "id": "id", "name": "id", "type": "String", "options": [], "defaultValue": null }, { "id": "inputs", "name": "inputs", "type": "Dictionary`2", "options": [], "defaultValue": null }, { "id": "inputs.items", "name": "items", "type": "List`1", "options": [], "defaultValue": null }, { "id": "inputs.property_id", "name": "property_id", "type": "String", "options": [], "defaultValue": null }, { "id": "inputs.property_path", "name": "property_path", "type": "String", "options": [], "defaultValue": null }, { "id": "inputs.source_step_id", "name": "source_step_id", "type": "String", "options": [], "defaultValue": null }, { "id": "inputs.members", "name": "members", "type": "Dictionary`2", "options": [], "defaultValue": null }, { "id": "inputs.provider_id", "name": "provider_id", "type": "String", "options": [], "defaultValue": null }, { "id": "inputs.schema_id", "name": "schema_id", "type": "String", "options": [], "defaultValue": null }, { "id": "inputs.source_id", "name": "source_id", "type": "String", "options": [], "defaultValue": null }, { "id": "inputs.value_path", "name": "value_path", "type": "String", "options": [], "defaultValue": null }, { "id": "is_enabled", "name": "is_enabled", "type": "Boolean", "options": [], "defaultValue": true }, { "id": "settings", "name": "settings", "type": "ActiveProcessSettings", "options": [], "defaultValue": null }, { "id": "settings.target", "name": "target", "type": "ProcessTargetSettings", "options": [], "defaultValue": null }, { "id": "settings.target.executable_path", "name": "executable_path", "type": "String", "options": [], "defaultValue": "" }, { "id": "settings.target.process_name", "name": "process_name", "type": "String", "options": [], "defaultValue": "" }, { "id": "settings.target.process_source", "name": "process_source", "type": "ResultBinding", "options": [], "defaultValue": null }, { "id": "settings.target.process_source.items", "name": "items", "type": "List`1", "options": [], "defaultValue": null }, { "id": "settings.target.process_source.property_id", "name": "property_id", "type": "String", "options": [], "defaultValue": null }, { "id": "settings.target.process_source.property_path", "name": "property_path", "type": "String", "options": [], "defaultValue": null }, { "id": "settings.target.process_source.source_step_id", "name": "source_step_id", "type": "String", "options": [], "defaultValue": null }, { "id": "settings.target.process_source.members", "name": "members", "type": "Dictionary`2", "options": [], "defaultValue": null }, { "id": "settings.target.process_source.provider_id", "name": "provider_id", "type": "String", "options": [], "defaultValue": "" }, { "id": "settings.target.process_source.schema_id", "name": "schema_id", "type": "String", "options": [], "defaultValue": null }, { "id": "settings.target.process_source.source_id", "name": "source_id", "type": "String", "options": [], "defaultValue": "" }, { "id": "settings.target.process_source.value_path", "name": "value_path", "type": "String", "options": [], "defaultValue": null }, { "id": "settings.target.window_title_contains", "name": "window_title_contains", "type": "String", "options": [], "defaultValue": "" } ], "inputs": [ { "Key": "process", "Required": false, "MissingValuePolicy": "SkipStep", "CollectionConsumption": "NotApplicable", "AcceptedShapes": [ { "ValueKind": "ProcessReference", "Cardinalities": [ "Single", "OptionalSingle" ] } ], "AllowedProviderIds": [ "job_variable", "step_result" ], "LegacyAllowedProviderIds": [], "AllowsDirectValue": false, "LegacyAcceptedShapes": [] } ], "result": { "TypeName": "ActiveProcessResult", "DisplayName": "ActiveProcessResult", "Properties": [ { "Name": "IsRunning", "DisplayName": "Is Running", "DataType": "Boolean", "Description": "Boolean", "IsNullable": false, "Example": null, "Cardinality": "Single", "EnumTypeName": null, "EnumValues": null, "Id": "is_running", "EnumDisplayNames": null, "StableId": "is_running" }, { "Name": "MatchCount", "DisplayName": "Match Count", "DataType": "Integer", "Description": "Integer", "IsNullable": false, "Example": null, "Cardinality": "Single", "EnumTypeName": null, "EnumValues": null, "Id": "match_count", "EnumDisplayNames": null, "StableId": "match_count" }, { "Name": "Process", "DisplayName": "Process", "DataType": "ProcessReference", "Description": "ProcessReference, kann leer sein", "IsNullable": true, "Example": null, "Cardinality": "OptionalSingle", "EnumTypeName": null, "EnumValues": null, "Id": "process", "EnumDisplayNames": null, "StableId": "process" }, { "Name": "Process.ProcessId", "DisplayName": "Process / Process Id", "DataType": "Integer", "Description": "Integer", "IsNullable": false, "Example": null, "Cardinality": "OptionalSingle", "EnumTypeName": null, "EnumValues": null, "Id": "process.process_id", "EnumDisplayNames": null, "StableId": "process.process_id" }, { "Name": "Process.StartTimeUtc", "DisplayName": "Process / Start Time Utc", "DataType": "DateTime", "Description": "DateTime", "IsNullable": false, "Example": null, "Cardinality": "OptionalSingle", "EnumTypeName": null, "EnumValues": null, "Id": "process.start_time_utc", "EnumDisplayNames": null, "StableId": "process.start_time_utc" }, { "Name": "Process.ProcessName", "DisplayName": "Process / Process Name", "DataType": "Text", "Description": "Text, kann leer sein", "IsNullable": true, "Example": null, "Cardinality": "OptionalSingle", "EnumTypeName": null, "EnumValues": null, "Id": "process.process_name", "EnumDisplayNames": null, "StableId": "process.process_name" }, { "Name": "Process.ExecutablePath", "DisplayName": "Process / Executable Path", "DataType": "Text", "Description": "Text, kann leer sein", "IsNullable": true, "Example": null, "Cardinality": "OptionalSingle", "EnumTypeName": null, "EnumValues": null, "Id": "process.executable_path", "EnumDisplayNames": null, "StableId": "process.executable_path" }, { "Name": "Process.WindowHandle", "DisplayName": "Process / Window Handle", "DataType": "Integer", "Description": "Integer", "IsNullable": false, "Example": null, "Cardinality": "OptionalSingle", "EnumTypeName": null, "EnumValues": null, "Id": "process.window_handle", "EnumDisplayNames": null, "StableId": "process.window_handle" } ], "PropertyTree": [ { "Segment": "IsRunning", "DisplayName": "Is Running", "Property": { "Name": "IsRunning", "DisplayName": "Is Running", "DataType": "Boolean", "Description": "Boolean", "IsNullable": false, "Example": null, "Cardinality": "Single", "EnumTypeName": null, "EnumValues": null, "Id": "is_running", "EnumDisplayNames": null, "StableId": "is_running" }, "Children": [] }, { "Segment": "MatchCount", "DisplayName": "Match Count", "Property": { "Name": "MatchCount", "DisplayName": "Match Count", "DataType": "Integer", "Description": "Integer", "IsNullable": false, "Example": null, "Cardinality": "Single", "EnumTypeName": null, "EnumValues": null, "Id": "match_count", "EnumDisplayNames": null, "StableId": "match_count" }, "Children": [] }, { "Segment": "Process", "DisplayName": "Process", "Property": { "Name": "Process", "DisplayName": "Process", "DataType": "ProcessReference", "Description": "ProcessReference, kann leer sein", "IsNullable": true, "Example": null, "Cardinality": "OptionalSingle", "EnumTypeName": null, "EnumValues": null, "Id": "process", "EnumDisplayNames": null, "StableId": "process" }, "Children": [ { "Segment": "ProcessId", "DisplayName": "Process Id", "Property": { "Name": "Process.ProcessId", "DisplayName": "Process / Process Id", "DataType": "Integer", "Description": "Integer", "IsNullable": false, "Example": null, "Cardinality": "OptionalSingle", "EnumTypeName": null, "EnumValues": null, "Id": "process.process_id", "EnumDisplayNames": null, "StableId": "process.process_id" }, "Children": [] }, { "Segment": "StartTimeUtc", "DisplayName": "Start Time Utc", "Property": { "Name": "Process.StartTimeUtc", "DisplayName": "Process / Start Time Utc", "DataType": "DateTime", "Description": "DateTime", "IsNullable": false, "Example": null, "Cardinality": "OptionalSingle", "EnumTypeName": null, "EnumValues": null, "Id": "process.start_time_utc", "EnumDisplayNames": null, "StableId": "process.start_time_utc" }, "Children": [] }, { "Segment": "ProcessName", "DisplayName": "Process Name", "Property": { "Name": "Process.ProcessName", "DisplayName": "Process / Process Name", "DataType": "Text", "Description": "Text, kann leer sein", "IsNullable": true, "Example": null, "Cardinality": "OptionalSingle", "EnumTypeName": null, "EnumValues": null, "Id": "process.process_name", "EnumDisplayNames": null, "StableId": "process.process_name" }, "Children": [] }, { "Segment": "ExecutablePath", "DisplayName": "Executable Path", "Property": { "Name": "Process.ExecutablePath", "DisplayName": "Process / Executable Path", "DataType": "Text", "Description": "Text, kann leer sein", "IsNullable": true, "Example": null, "Cardinality": "OptionalSingle", "EnumTypeName": null, "EnumValues": null, "Id": "process.executable_path", "EnumDisplayNames": null, "StableId": "process.executable_path" }, "Children": [] }, { "Segment": "WindowHandle", "DisplayName": "Window Handle", "Property": { "Name": "Process.WindowHandle", "DisplayName": "Process / Window Handle", "DataType": "Integer", "Description": "Integer", "IsNullable": false, "Example": null, "Cardinality": "OptionalSingle", "EnumTypeName": null, "EnumValues": null, "Id": "process.window_handle", "EnumDisplayNames": null, "StableId": "process.window_handle" }, "Children": [] } ] } ] } }, "explanations": { "purpose": "Wähle eine Prozessreferenz, um festzustellen, ob genau diese Instanz noch läuft. Anders als eine Fenstersuche benötigt diese Prüfung kein sichtbares Fenster. Kombiniere is_running mit einem Wenn-Step, bevor du einen Prozess erneut startest.", "example": "get_process sucht notepad; active_process liest dessen process und ein Wenn-Step prüft is_running.", "errors": "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.", "field.process_target": "Im Editor eine kompatible Prozessreferenz wählen. Suchkriterien einer älteren settings.target-Konfiguration sind kein Ersatz für eine beliebige Textquelle im typisierten Prozesseingang.", "schema.id": "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.", "schema.inputs": "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.", "schema.inputs.items": "Geordnete Unterbindungen einer Liste. Die Reihenfolge ist Teil der Eingabe; Elemente müssen das Listenelement-Schema erfüllen.", "schema.inputs.property_id": "Stabile Ergebnis-ID einer älteren Step-Referenz. Neue Dateien kodieren sie in source_id; nicht mit einem CLR-Propertynamen oder dem UI-Label verwechseln.", "schema.inputs.property_path": "Älterer Pfad zu einem Ergebnis-Unterwert. Bestehende Dateien bleiben lesbar; neue Referenzen verwenden stabile Ergebnis-IDs und gegebenenfalls value_path.", "schema.inputs.source_step_id": "Kompatibilitätsfeld älterer Referenzen. Neue Referenzen verwenden provider_id=step_result und die versionierte source_id.", "schema.inputs.members": "Benannte Unterbindungen eines strukturierten Werts. Jeder Schlüssel ist eine stabile Mitglied-ID des Feldschemas; Unterbindungen können Werte einer Basisquelle gezielt überschreiben.", "schema.inputs.provider_id": "Anbieter der Wertequelle: local_value, job_variable, step_result oder secret. Ein Quellwert benötigt zusätzlich source_id und muss zum Eingabetyp passen.", "schema.inputs.schema_id": "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.", "schema.inputs.source_id": "Anbieterbezogene Identität. Bei step_result: v1//; bei lokalen Werten und Jobvariablen deren GUID. Dies ist nicht nur die rohe Step-ID.", "schema.inputs.value_path": "Optionaler Pfad unterhalb einer Anbieterquelle, zum Beispiel zu einem typisierten Objektmitglied. Er ändert den Quellanbieter nicht; der ausgewählte Unterwert muss kompatibel sein.", "schema.is_enabled": "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.", "schema.settings": "Direkte beziehungsweise ältere Step-Konfiguration. Für neue referenzbasierte Dateien inputs und localValues verwenden; die UI migriert gespeicherte Literalwerte in lokale Quellen.", "schema.settings.target": "Prozess-Zielkonfiguration aus Name/Pfad/Titel oder einer konkreten Prozessreferenz. Die konkrete Referenz schützt vor Verwechslung gleichnamiger Instanzen.", "schema.settings.target.executable_path": "Pfad zur ausführbaren Datei. Beim Start muss er zu einem startbaren Programm führen; bei einer Suche grenzt er die Programminstanz ein.", "schema.settings.target.process_name": "Name des gesuchten Prozesses, zum Beispiel notepad. Ein Name kann mehrere Instanzen treffen; eine konkrete Prozessreferenz grenzt gezielt ein.", "schema.settings.target.process_source": "Referenz auf eine konkrete laufende Programminstanz, üblicherweise process aus get_process oder start_process.", "schema.settings.target.process_source.items": "Geordnete Unterbindungen einer Liste. Die Reihenfolge ist Teil der Eingabe; Elemente müssen das Listenelement-Schema erfüllen.", "schema.settings.target.process_source.property_id": "Stabile Ergebnis-ID einer älteren Step-Referenz. Neue Dateien kodieren sie in source_id; nicht mit einem CLR-Propertynamen oder dem UI-Label verwechseln.", "schema.settings.target.process_source.property_path": "Älterer Pfad zu einem Ergebnis-Unterwert. Bestehende Dateien bleiben lesbar; neue Referenzen verwenden stabile Ergebnis-IDs und gegebenenfalls value_path.", "schema.settings.target.process_source.source_step_id": "Kompatibilitätsfeld älterer Referenzen. Neue Referenzen verwenden provider_id=step_result und die versionierte source_id.", "schema.settings.target.process_source.members": "Benannte Unterbindungen eines strukturierten Werts. Jeder Schlüssel ist eine stabile Mitglied-ID des Feldschemas; Unterbindungen können Werte einer Basisquelle gezielt überschreiben.", "schema.settings.target.process_source.provider_id": "Anbieter der Wertequelle: local_value, job_variable, step_result oder secret. Ein Quellwert benötigt zusätzlich source_id und muss zum Eingabetyp passen.", "schema.settings.target.process_source.schema_id": "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.", "schema.settings.target.process_source.source_id": "Anbieterbezogene Identität. Bei step_result: v1//; bei lokalen Werten und Jobvariablen deren GUID. Dies ist nicht nur die rohe Step-ID.", "schema.settings.target.process_source.value_path": "Optionaler Pfad unterhalb einer Anbieterquelle, zum Beispiel zu einem typisierten Objektmitglied. Er ändert den Quellanbieter nicht; der ausgewählte Unterwert muss kompatibel sein.", "schema.settings.target.window_title_contains": "Optionaler Teil des Fenstertitels zum Eingrenzen mehrerer Fenster. Ein leerer Text setzt diesen Filter nicht.", "result.is_running": "Ob die geprüfte Prozessinstanz beziehungsweise die Prozessabfrage einen laufenden Prozess festgestellt hat. Einzelwert dieses Ergebnisses.", "result.match_count": "Anzahl passender Prozesse oder Merkmalszuordnungen im konkreten Ergebnis; der Ergebnis-Typ bestimmt, was gezählt wird. Einzelwert dieses Ergebnisses.", "result.process": "Konkrete 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.", "result.process.process_id": "Windows-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.", "result.process.start_time_utc": "UTC-Startzeit der Prozessinstanz zur Unterscheidung wiederverwendeter PIDs. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.", "result.process.process_name": "Vom System ermittelter Prozessname, nicht notwendigerweise der sichtbare Fenstertitel. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.", "result.process.executable_path": "Ermittelter Pfad des Programms. Bei fehlenden Rechten oder fehlender Information kann ein optionaler Wert leer sein. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.", "result.process.window_handle": "Native 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.", "input.process": "konkrete Prozessreferenz. Eine gültige, aber noch nicht verfügbare optionale Step-Quelle kann den Verbraucher mit NoInput überspringen; malformed Referenzen bleiben Fehler. Es wird kein beliebiges Listenelement ausgewählt. Akzeptierte Typen und Anbieter stehen in den Vertragsspalten; unbegrenzte Anbieterwahl bedeutet weiterhin Typprüfung." }, "template": { "type": "active_process", "settings": { "target": { "process_source": { "provider_id": "", "source_id": "" }, "process_name": "", "executable_path": "", "window_title_contains": "" } }, "id": "7d3962ef-45d1-44a8-69db-2fa973922fc6", "inputs": {}, "is_enabled": true }, "screenshots": [ { "id": "step-prozessstatus", "file": "step-prozessstatus.detail.png", "title": "Prozessstatus prüfen", "caption": "Die Prozessabfrage prüft notepad und liefert den Status für die anschließende Bedingung. Zusammengestellte Ausschnitte echter Einstellungsfelder mit Beispielwerten; die Nummer markiert Beschriftung und Eingabe gemeinsam.", "width": 464, "height": 202, "pages": [ "/doku/steps/active_process/" ], "markers": [ { "number": 1, "label": "Prozessreferenz", "bounds": [ 48, 10, 364, 172 ], "inputs": [ { "kind": "choice", "value": "notepad" }, { "kind": "choice", "value": "Editor" } ], "explanation": "Im Editor eine kompatible Prozessreferenz wählen. Suchkriterien einer älteren settings.target-Konfiguration sind kein Ersatz für eine beliebige Textquelle im typisierten Prozesseingang." } ] } ], "note": "Referenzdaten. Defaultvorlage vor Verwendung vervollständigen und fachlich validieren." }