Vorschau · Entwicklungsstand 1.6.1

Zwischenablageninhalt

Wofür ist das gedacht?

Zustandsabfrage: Zwischenablageninhalt. Liest den aktuellen vom System angebotenen Zustand und stellt die hier aufgeführten typisierten Werte bereit. Wähle die Funktion im Windows-Auswahldialog; die verfügbaren Parameter stehen unten. Der Katalog verlangt keine erhöhte Ausführung; einzelne Systemzugriffe können dennoch Rechte voraussetzen.

Zwischenablageninhalt verstehen

1
Zweck
Zustandsabfrage: Zwischenablageninhalt. Liest den aktuellen vom System angebotenen Zustand und stellt die hier aufgeführten typisierten Werte bereit. Wähle die Funktion im Windows-Auswahldialog; die verfügbaren Parameter stehen unten. Der Katalog verlangt keine erhöhte Ausführung; einzelne Systemzugriffe können dennoch Rechte voraussetzen.
2
Beispiel
Wähle clipboard.content im Step „Windows-Zustand abfragen“ und verbinde einen unten beschriebenen Ergebniswert mit einer Bedingung.
3
Hinweise
Verfügbarkeit und Ereignisevidenz hängen von Windows-Version, installiertem Gerät/Dienst und Rechten ab. Die Abfrage ist ein zeitlicher Snapshot. Nur die im Katalog gesetzten Unterstützungsmerkmale verwenden: eine reine Änderungsfunktion liefert keinen eigenen Abfragevertrag, eine reine Abfrage ist kein Ereignistrigger. Bei Windows-Einstellungen den Erfolg und Fehlercode im Step-Ergebnis prüfen.

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

Ergebniswerte verwenden

Ergebnis	Bedeutung
Exists	Ob der abgefragte Datei-/Ordnerpfad zum Beobachtungszeitpunkt existiert. Einzelwert dieses Ergebnisses.
Name	Lesbarer Name des abgefragten Geräts, Monitors, Laufwerks oder Objekts. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Text	Erkannter oder abgefragter Text. Er kann leer sein; Datentyp und Leerheitsprüfung vor einem nachfolgenden Vergleich beachten. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Status	Vom zuständigen Windows-Dienst gemeldeter Zustand. Nicht durch frei erfundene Statusnamen ersetzen. Einzelwert dieses Ergebnisses.
Captured At	Zeitpunkt der Windows-Abfrage beziehungsweise Erfassung im Ergebnis. Er zeigt den Beobachtungsstand, nicht einen garantierten späteren Systemzustand. Einzelwert dieses Ergebnisses.
Error Code	Maschinenlesbarer Fehlercode einer Windows-Operation; bei Erfolg entsprechend dem Vertrag leer beziehungsweise nicht gesetzt. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Error Message	Lesbare Diagnose der Windows-Operation. Für Entscheidungen vorzugsweise Status und stabilen Code verwenden. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.

Beispiel

Wähle clipboard.content im Step „Windows-Zustand abfragen“ und verbinde einen unten beschriebenen Ergebniswert mit einer Bedingung.

Vorbereitete Beispielabläufe ansehen

Fehler und Hinweise

Verfügbarkeit und Ereignisevidenz hängen von Windows-Version, installiertem Gerät/Dienst und Rechten ab. Die Abfrage ist ein zeitlicher Snapshot. Nur die im Katalog gesetzten Unterstützungsmerkmale verwenden: eine reine Änderungsfunktion liefert keinen eigenen Abfragevertrag, eine reine Abfrage ist kein Ereignistrigger. Bei Windows-Einstellungen den Erfolg und Fehlercode im Step-Ergebnis prüfen.

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: clipboard.content

Felder und Zusammenhänge auf einen Blick

1
ExistsErgebnis: exists · Wert
Ob der abgefragte Datei-/Ordnerpfad zum Beobachtungszeitpunkt existiert
2
NameErgebnis: name · Wert
Lesbarer Name des abgefragten Geräts, Monitors, Laufwerks oder Objekts
3
TextErgebnis: text · Wert
Erkannter oder abgefragter Text
4
StatusErgebnis: status · Wert
Vom zuständigen Windows-Dienst gemeldeter Zustand
5
Captured AtErgebnis: captured_at · Wert
Zeitpunkt der Windows-Abfrage beziehungsweise Erfassung im Ergebnis
6
Error CodeErgebnis: error_code · Wert
Maschinenlesbarer Fehlercode einer Windows-Operation; bei Erfolg entsprechend dem Vertrag leer beziehungsweise nicht gesetzt
7
Error MessageErgebnis: error_message · Wert
Lesbare Diagnose der Windows-Operation

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

Ergebnisvertrag

Ergebnis	Typ / Optionen	Anzahl	Erklärung
`exists`	`Boolean`	`Single`	Ob der abgefragte Datei-/Ordnerpfad zum Beobachtungszeitpunkt existiert. Einzelwert dieses Ergebnisses.
`name`	`Text`	`OptionalSingle`	Lesbarer Name des abgefragten Geräts, Monitors, Laufwerks oder Objekts. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`text`	`Text`	`OptionalSingle`	Erkannter oder abgefragter Text. Er kann leer sein; Datentyp und Leerheitsprüfung vor einem nachfolgenden Vergleich beachten. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`status`	`Enum` `["Success", "Unsupported", "AccessDenied", "Timeout", "Failed"]`	`Single`	Vom zuständigen Windows-Dienst gemeldeter Zustand. Nicht durch frei erfundene Statusnamen ersetzen. Einzelwert dieses Ergebnisses. `Success` Windows-Aufruf erfolgreich. Erst anschließend den fachlichen Ergebniswert auswerten. `Unsupported` Funktion auf diesem Zielsystem nicht unterstützt. `AccessDenied` Windows verweigert den Zugriff; kein negativer fachlicher Zustand, sondern fehlende Berechtigung. `Timeout` Windows-Aufruf überschritt seine Zeitgrenze; daraus keinen Systemzustand ableiten. `Failed` Lauf wegen Fehler fehlgeschlagen.
`captured_at`	`DateTime`	`Single`	Zeitpunkt der Windows-Abfrage beziehungsweise Erfassung im Ergebnis. Er zeigt den Beobachtungsstand, nicht einen garantierten späteren Systemzustand. Einzelwert dieses Ergebnisses.
`error_code`	`Text`	`OptionalSingle`	Maschinenlesbarer Fehlercode einer Windows-Operation; bei Erfolg entsprechend dem Vertrag leer beziehungsweise nicht gesetzt. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`error_message`	`Text`	`OptionalSingle`	Lesbare Diagnose der Windows-Operation. Für Entscheidungen vorzugsweise Status und stabilen Code verwenden. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.

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