## Steps: Fenster anzeigen oder minimieren ID: focus_process Website: /doku/steps/focus_process/ Abbildung: [Detailansicht: Fenster anzeigen oder minimieren. 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.](/ref-step-focus-process.detail.png) 1. Prozessreferenz: Im Editor eine kompatible Prozessreferenz wählen. Suchkriterien einer älteren settings.target-Konfiguration sind kein Ersatz für eine beliebige Textquelle im typisierten Prozesseingang. 2. Aktion: Gewünschte Aktion. Die zulässigen Optionen hängen vom Step ab; wähle die Option in der folgenden Liste und ergänze nur ihre aktiven Felder. 3. Fenstermodus: Fensterdarstellung: Voreinstellung des Programms, Normal oder Maximiert, soweit der jeweilige Step diese Option unterstützt. ### 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. ### example Editorinstanz suchen → BringToFront und Normal auswählen → Makro „Notiz eingeben“ ausführen. ### field.action Gewünschte Aktion. Die zulässigen Optionen hängen vom Step ab; wähle die Option in der folgenden Liste und ergänze nur ihre aktiven Felder. ### field.action.option.BringToFront Versucht das passende Fenster in den Vordergrund zu bringen. ### field.action.option.Minimize Minimiert das passende Fenster. ### 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. ### field.window_mode Fensterdarstellung: Voreinstellung des Programms, Normal oder Maximiert, soweit der jeweilige Step diese Option unterstützt. ### field.window_mode.option.Maximized Maximiert das Fenster, soweit es dies unterstützt. ### field.window_mode.option.Normal Verwendet ein normales, nicht maximiertes Fenster. ### 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. ### purpose Wähle eine konkrete Prozessreferenz und bringe ein passendes Fenster nach vorn oder minimiere es. Der Titelteil hilft bei mehreren Fenstern; beim Anzeigen kannst du Normal oder Maximiert wählen. Windows kann den Vordergrundwechsel beschränken, etwa bei anderen Berechtigungsstufen. ### 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.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.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.process_name Vom System ermittelter Prozessname, nicht notwendigerweise der sichtbare Fenstertitel. 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.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. ### 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.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.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.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.source_step_id Kompatibilitätsfeld älterer Referenzen. Neue Referenzen verwenden provider_id=step_result und die versionierte source_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.action Gewünschte Aktion. Die zulässigen Optionen hängen vom Step ab; wähle die Option in der folgenden Liste und ergänze nur ihre aktiven Felder. ### schema.settings.action.option.BringToFront Versucht das passende Fenster in den Vordergrund zu bringen. ### schema.settings.action.option.Minimize Minimiert das passende Fenster. ### 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.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.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.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.source_step_id Kompatibilitätsfeld älterer Referenzen. Neue Referenzen verwenden provider_id=step_result und die versionierte source_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. ### schema.settings.window_mode Fensterdarstellung: Voreinstellung des Programms, Normal oder Maximiert, soweit der jeweilige Step diese Option unterstützt. ### schema.settings.window_mode.option.Fullscreen Fenster im unterstützten Vollbildmodus anzeigen. ### schema.settings.window_mode.option.Maximized Maximiert das Fenster, soweit es dies unterstützt. ### schema.settings.window_mode.option.Normal Verwendet ein normales, nicht maximiertes Fenster. ### Vertrag (Metadaten; keine Konfigurationsdatei) ```json { "id": "focus_process", "name": "Fenster anzeigen oder minimieren", "description": "Bringt ein Prozessfenster in den Vordergrund oder minimiert es. Optional kann nach einem Fenstertitel gefiltert werden.", "category": "ProgrammeFenster", "uiFieldIds": [ "process_target", "action", "window_mode" ], "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 } }, { "id": "action", "name": "Aktion", "descriptor": { "Id": "action", "LabelKey": "Ui.Step.Settings.Action", "ValueKind": "Enum", "Required": true, "DefaultValue": "BringToFront", "DescriptionKey": null, "EditorHint": null, "Constraints": { "Minimum": null, "Maximum": null, "MinimumLength": null, "MaximumLength": null, "AllowedValues": [ "BringToFront", "Minimize" ] }, "Width": "Full", "Advanced": true, "Order": 2, "VisibleWhen": null, "Options": [ { "Value": "BringToFront", "LabelKey": "Enum.FocusProcessAction.BringToFront", "DisplayName": null }, { "Value": "Minimize", "LabelKey": "Enum.FocusProcessAction.Minimize", "DisplayName": null } ], "InputContractId": null, "VisibleWhenAll": null, "VisualOverlayOptions": null, "DirectoryPickerOptions": null, "FilePickerOptions": null, "RoiPickerOptions": null, "YoloPickerOptions": null, "WindowsCapabilityPickerOptions": null, "ScreenPointPickerOptions": null, "AllowsDirectValue": null, "MonitorDeviceNameFieldId": null } }, { "id": "window_mode", "name": "Fenstermodus", "descriptor": { "Id": "window_mode", "LabelKey": "Ui.Step.Settings.WindowMode", "ValueKind": "Enum", "Required": true, "DefaultValue": "Normal", "DescriptionKey": null, "EditorHint": null, "Constraints": { "Minimum": null, "Maximum": null, "MinimumLength": null, "MaximumLength": null, "AllowedValues": [ "Normal", "Maximized" ] }, "Width": "Full", "Advanced": true, "Order": 3, "VisibleWhen": { "FieldId": "action", "EqualsValue": "BringToFront", "AnyOfValues": null }, "Options": [ { "Value": "Normal", "LabelKey": "Enum.FocusProcessWindowMode.Normal", "DisplayName": null }, { "Value": "Maximized", "LabelKey": "Enum.FocusProcessWindowMode.Maximized", "DisplayName": null } ], "InputContractId": null, "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": "FocusProcessSettings", "options": [], "defaultValue": null }, { "id": "settings.action", "name": "action", "type": "FocusProcessAction", "options": [ "BringToFront", "Minimize" ], "defaultValue": "BringToFront" }, { "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": "" }, { "id": "settings.window_mode", "name": "window_mode", "type": "FocusProcessWindowMode", "options": [ "Normal", "Maximized", "Fullscreen" ], "defaultValue": "Normal" } ], "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": "FocusProcessResult", "DisplayName": "FocusProcessResult", "Properties": [ { "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": "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": [] } ] } ] } } ``` ### Strukturelle Serializer-Vorlage ```json { "type": "focus_process", "settings": { "target": { "process_source": { "provider_id": "", "source_id": "" }, "process_name": "", "executable_path": "", "window_title_contains": "" }, "action": "BringToFront", "window_mode": "Normal" }, "id": "57d5804e-5282-502f-0454-33619a4efedb", "inputs": {}, "is_enabled": true } ```