Vorschau · Entwicklungsstand 1.6.1

Fenster anzeigen oder minimieren

Wofür ist das gedacht?

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.

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.

Einstellung	Bedeutung und Bedienung	Beispielwert
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.	Programm starten → Prozess
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. Im Bereich „Erweitert“ verfügbar. In den Vordergrund Versucht das passende Fenster in den Vordergrund zu bringen. Minimieren Minimiert das passende Fenster.	In den Vordergrund
Fenstermodus	Fensterdarstellung: Voreinstellung des Programms, Normal oder Maximiert, soweit der jeweilige Step diese Option unterstützt. Im Bereich „Erweitert“ verfügbar. Sichtbar bei: Aktion = In den Vordergrund. Normal Verwendet ein normales, nicht maximiertes Fenster. Maximiert Maximiert das Fenster, soweit es dies unterstützt.	Normal

Einstellung

Bedeutung und Bedienung

Beispielwert

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.

Programm starten → Prozess

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.

Im Bereich „Erweitert“ verfügbar.

In den Vordergrund: Versucht das passende Fenster in den Vordergrund zu bringen.
Minimieren: Minimiert das passende Fenster.

In den Vordergrund

Fenstermodus

Fensterdarstellung: Voreinstellung des Programms, Normal oder Maximiert, soweit der jeweilige Step diese Option unterstützt.

Im Bereich „Erweitert“ verfügbar.

Sichtbar bei: Aktion = In den Vordergrund.

Normal: Verwendet ein normales, nicht maximiertes Fenster.
Maximiert: Maximiert das Fenster, soweit es dies unterstützt.

Normal

Eingaben innerhalb zusammengesetzter Einstellungen

Diese Felder erscheinen innerhalb der jeweiligen Einstellung und je nach gewählter Aktion oder Quelle. Bei einer Ergebnisquelle wählst du den passenden vorherigen Step statt eines direkten Werts.

Einstellung / Unterfeld	Bedeutung und Bedienung	Beispielwert
Prozessreferenz › Programmpfad	Pfad zur ausführbaren Datei. Beim Start muss er zu einem startbaren Programm führen; bei einer Suche grenzt er die Programminstanz ein.	C:\Windows\System32\notepad.exe
Prozessreferenz › Prozessname	Name des gesuchten Prozesses, zum Beispiel notepad. Ein Name kann mehrere Instanzen treffen; eine konkrete Prozessreferenz grenzt gezielt ein.	notepad
Prozessreferenz › Fenstertitel enthält	Optionaler Teil des Fenstertitels zum Eingrenzen mehrerer Fenster. Ein leerer Text setzt diesen Filter nicht.	Editor

Ergebniswerte verwenden

Ergebnis	Bedeutung
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.
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.
Process / Start Time Utc	UTC-Startzeit der Prozessinstanz zur Unterscheidung wiederverwendeter PIDs. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Process / Process Name	Vom System ermittelter Prozessname, nicht notwendigerweise der sichtbare Fenstertitel. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
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.
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.

Beispiel

Editorinstanz suchen → BringToFront und Normal auswählen → Makro „Notiz eingeben“ ausführen.

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: focus_process

Felder und Zusammenhänge auf einen Blick

1
Prozessreferenzprocess_target · Object · Nicht angegeben
Im Editor eine kompatible Prozessreferenz wählen
2
Aktionaction · Enum · BringToFront, Minimize
Gewünschte Aktion
3
Fenstermoduswindow_mode · Enum · Normal, Maximized
Fensterdarstellung: Voreinstellung des Programms, Normal oder Maximiert, soweit der jeweilige Step diese Option unterstützt.
4
ProcessErgebnis: process · Wert
Konkrete Prozessreferenz mit Identität und optionalen Programmdaten
5
Process / Process IdErgebnis: process.process_id · Wert
Windows-Prozess-ID
6
Process / Start Time UtcErgebnis: process.start_time_utc · Wert
UTC-Startzeit der Prozessinstanz zur Unterscheidung wiederverwendeter PIDs
7
Process / Process NameErgebnis: process.process_name · Wert
Vom System ermittelter Prozessname, nicht notwendigerweise der sichtbare Fenstertitel
8
Process / Executable PathErgebnis: process.executable_path · Wert
Ermittelter Pfad des Programms
9
Process / Window HandleErgebnis: process.window_handle · Wert
Native Fensterkennung der Programminstanz

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

Feldtypen, Standards und Regeln

Wert	Typ	Standard laut Vertrag	Optionen und Regeln	Erklärung
Prozessreferenz `process_target`	`Object`	`Nicht angegeben`	Pflichtfeld	Im Editor eine kompatible Prozessreferenz wählen. Suchkriterien einer älteren settings.target-Konfiguration sind kein Ersatz für eine beliebige Textquelle im typisierten Prozesseingang.
Aktion `action`	`Enum`	`BringToFront`	Pflichtfeld `["BringToFront", "Minimize"]`	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. `BringToFront` Versucht das passende Fenster in den Vordergrund zu bringen. `Minimize` Minimiert das passende Fenster.
Fenstermodus `window_mode`	`Enum`	`Normal`	Pflichtfeld `["Normal", "Maximized"]` Sichtbar wenn: `{"FieldId": "action", "EqualsValue": "BringToFront", "AnyOfValues": null}`	Fensterdarstellung: Voreinstellung des Programms, Normal oder Maximiert, soweit der jeweilige Step diese Option unterstützt. `Normal` Verwendet ein normales, nicht maximiertes Fenster. `Maximized` Maximiert das Fenster, soweit es dies unterstützt.

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.

Feld	Modelltyp	Modell-Standard / Optionen	Erklärung
`id`	`String`	`Nicht angegeben`	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.
`inputs`	Dictionary`2	`Nicht angegeben`	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.
`inputs.items`	List`1	`Nicht angegeben`	Geordnete Unterbindungen einer Liste. Die Reihenfolge ist Teil der Eingabe; Elemente müssen das Listenelement-Schema erfüllen.
`inputs.property_id`	`String`	`Nicht angegeben`	Stabile 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_path`	`String`	`Nicht angegeben`	Älterer Pfad zu einem Ergebnis-Unterwert. Bestehende Dateien bleiben lesbar; neue Referenzen verwenden stabile Ergebnis-IDs und gegebenenfalls value_path.
`inputs.source_step_id`	`String`	`Nicht angegeben`	Kompatibilitätsfeld älterer Referenzen. Neue Referenzen verwenden provider_id=step_result und die versionierte source_id.
`inputs.members`	Dictionary`2	`Nicht angegeben`	Benannte Unterbindungen eines strukturierten Werts. Jeder Schlüssel ist eine stabile Mitglied-ID des Feldschemas; Unterbindungen können Werte einer Basisquelle gezielt überschreiben.
`inputs.provider_id`	`String`	`Nicht angegeben`	Anbieter 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_id`	`String`	`Nicht angegeben`	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.
`inputs.source_id`	`String`	`Nicht angegeben`	Anbieterbezogene 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_path`	`String`	`Nicht angegeben`	Optionaler Pfad unterhalb einer Anbieterquelle, zum Beispiel zu einem typisierten Objektmitglied. Er ändert den Quellanbieter nicht; der ausgewählte Unterwert muss kompatibel sein.
`is_enabled`	`Boolean`	`true`	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.
`settings`	`FocusProcessSettings`	`Nicht angegeben`	Direkte beziehungsweise ältere Step-Konfiguration. Für neue referenzbasierte Dateien inputs und localValues verwenden; die UI migriert gespeicherte Literalwerte in lokale Quellen.
`settings.action`	`FocusProcessAction`	`BringToFront` `["BringToFront", "Minimize"]`	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. `BringToFront` Versucht das passende Fenster in den Vordergrund zu bringen. `Minimize` Minimiert das passende Fenster.
`settings.target`	`ProcessTargetSettings`	`Nicht angegeben`	Prozess-Zielkonfiguration aus Name/Pfad/Titel oder einer konkreten Prozessreferenz. Die konkrete Referenz schützt vor Verwechslung gleichnamiger Instanzen.
`settings.target.executable_path`	`String`	`Leerer Text`	Pfad zur ausführbaren Datei. Beim Start muss er zu einem startbaren Programm führen; bei einer Suche grenzt er die Programminstanz ein.
`settings.target.process_name`	`String`	`Leerer Text`	Name des gesuchten Prozesses, zum Beispiel notepad. Ein Name kann mehrere Instanzen treffen; eine konkrete Prozessreferenz grenzt gezielt ein.
`settings.target.process_source`	`ResultBinding`	`Nicht angegeben`	Referenz auf eine konkrete laufende Programminstanz, üblicherweise process aus get_process oder start_process.
`settings.target.process_source.items`	List`1	`Nicht angegeben`	Geordnete Unterbindungen einer Liste. Die Reihenfolge ist Teil der Eingabe; Elemente müssen das Listenelement-Schema erfüllen.
`settings.target.process_source.property_id`	`String`	`Nicht angegeben`	Stabile Ergebnis-ID einer älteren Step-Referenz. Neue Dateien kodieren sie in source_id; nicht mit einem CLR-Propertynamen oder dem UI-Label verwechseln.
`settings.target.process_source.property_path`	`String`	`Nicht angegeben`	Älterer Pfad zu einem Ergebnis-Unterwert. Bestehende Dateien bleiben lesbar; neue Referenzen verwenden stabile Ergebnis-IDs und gegebenenfalls value_path.
`settings.target.process_source.source_step_id`	`String`	`Nicht angegeben`	Kompatibilitätsfeld älterer Referenzen. Neue Referenzen verwenden provider_id=step_result und die versionierte source_id.
`settings.target.process_source.members`	Dictionary`2	`Nicht angegeben`	Benannte Unterbindungen eines strukturierten Werts. Jeder Schlüssel ist eine stabile Mitglied-ID des Feldschemas; Unterbindungen können Werte einer Basisquelle gezielt überschreiben.
`settings.target.process_source.provider_id`	`String`	`Leerer Text`	Anbieter der Wertequelle: local_value, job_variable, step_result oder secret. Ein Quellwert benötigt zusätzlich source_id und muss zum Eingabetyp passen.
`settings.target.process_source.schema_id`	`String`	`Nicht angegeben`	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.
`settings.target.process_source.source_id`	`String`	`Leerer Text`	Anbieterbezogene 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.target.process_source.value_path`	`String`	`Nicht angegeben`	Optionaler Pfad unterhalb einer Anbieterquelle, zum Beispiel zu einem typisierten Objektmitglied. Er ändert den Quellanbieter nicht; der ausgewählte Unterwert muss kompatibel sein.
`settings.target.window_title_contains`	`String`	`Leerer Text`	Optionaler Teil des Fenstertitels zum Eingrenzen mehrerer Fenster. Ein leerer Text setzt diesen Filter nicht.
`settings.window_mode`	`FocusProcessWindowMode`	`Normal` `["Normal", "Maximized", "Fullscreen"]`	Fensterdarstellung: Voreinstellung des Programms, Normal oder Maximiert, soweit der jeweilige Step diese Option unterstützt. `Normal` Verwendet ein normales, nicht maximiertes Fenster. `Maximized` Maximiert das Fenster, soweit es dies unterstützt. `Fullscreen` Fenster im unterstützten Vollbildmodus anzeigen.

Eingabeverträge

Eingabe	Fehlende Werte	Listen	Akzeptierte Typen / Quellen	Erklärung
`process`	`SkipStep`	`NotApplicable`	`[{"ValueKind": "ProcessReference", "Cardinalities": ["Single", "OptionalSingle"]}]` `["job_variable", "step_result"]`	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.

Ergebnisvertrag

Ergebnis	Typ / Optionen	Anzahl	Erklärung
`process`	`ProcessReference`	`OptionalSingle`	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.
`process.process_id`	`Integer`	`OptionalSingle`	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.
`process.start_time_utc`	`DateTime`	`OptionalSingle`	UTC-Startzeit der Prozessinstanz zur Unterscheidung wiederverwendeter PIDs. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`process.process_name`	`Text`	`OptionalSingle`	Vom System ermittelter Prozessname, nicht notwendigerweise der sichtbare Fenstertitel. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`process.executable_path`	`Text`	`OptionalSingle`	Ermittelter 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_handle`	`Integer`	`OptionalSingle`	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.

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": "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
}