Vorschau · Entwicklungsstand 1.6.1

USB-Geräte

Wofür ist das gedacht?

Zustandsabfrage: USB-Geräte. 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.

USB-Geräte verstehen

1
Filter
Optionaler Textfilter für die angebotene Geräteabfrage beziehungsweise Ereignisquelle. Seine konkrete Wirkung hängt vom Geräteprovider ab.

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

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
Filter	Optionaler Textfilter für die angebotene Geräteabfrage beziehungsweise Ereignisquelle. Seine konkrete Wirkung hängt vom Geräteprovider ab.	Beispieltext

Ergebniswerte verwenden

Ergebnis	Bedeutung
Exists	Ob der abgefragte Datei-/Ordnerpfad zum Beobachtungszeitpunkt existiert. Einzelwert dieses Ergebnisses.
Is Connected	Ob die Verbindung zum Zeitpunkt der Abfrage hergestellt war. Einzelwert dieses Ergebnisses.
Count	Anzahl der Elemente der referenzierten Sammlung, automatisch als zusätzlicher Ergebniswert verfügbar. Einzelwert dieses Ergebnisses.
Name	Lesbarer Name des abgefragten Geräts, Monitors, Laufwerks oder Objekts. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Device State	Vom Windows-Geräteprovider gemeldeter Gerätezustand. Einzelwert dieses Ergebnisses.
Items	Liste abgefragter Objekte, zum Beispiel Geräte, Monitore, Drucker oder Laufwerke. Mitglieder besitzen die in dieser Referenz aufgeführten Unterwerte. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
Items / Count	Anzahl der Elemente der referenzierten Sammlung, automatisch als zusätzlicher Ergebniswert verfügbar. Einzelwert dieses Ergebnisses.
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 device.usb 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: device.usb

Felder und Zusammenhänge auf einen Blick

1
Filterfilter_value · Text · Nicht angegeben
Optionaler Textfilter für die angebotene Geräteabfrage beziehungsweise Ereignisquelle
2
ExistsErgebnis: exists · Wert
Ob der abgefragte Datei-/Ordnerpfad zum Beobachtungszeitpunkt existiert
3
Is ConnectedErgebnis: is_connected · Wert
Ob die Verbindung zum Zeitpunkt der Abfrage hergestellt war
4
CountErgebnis: count · Wert
Anzahl der Elemente der referenzierten Sammlung, automatisch als zusätzlicher Ergebniswert verfügbar
5
NameErgebnis: name · Wert
Lesbarer Name des abgefragten Geräts, Monitors, Laufwerks oder Objekts
6
Device StateErgebnis: device_state · Wert
Vom Windows-Geräteprovider gemeldeter Gerätezustand
7
ItemsErgebnis: items · Wert
Liste abgefragter Objekte, zum Beispiel Geräte, Monitore, Drucker oder Laufwerke
8
Items / CountErgebnis: items.count · Wert
Anzahl der Elemente der referenzierten Sammlung, automatisch als zusätzlicher Ergebniswert verfügbar
9
StatusErgebnis: status · Wert
Vom zuständigen Windows-Dienst gemeldeter Zustand
10
Captured AtErgebnis: captured_at · Wert
Zeitpunkt der Windows-Abfrage beziehungsweise Erfassung im Ergebnis
11
Error CodeErgebnis: error_code · Wert
Maschinenlesbarer Fehlercode einer Windows-Operation; bei Erfolg entsprechend dem Vertrag leer beziehungsweise nicht gesetzt
12
Error MessageErgebnis: error_message · Wert
Lesbare Diagnose der Windows-Operation

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
Filter `filter_value`	`Text`	`Nicht angegeben`	Regeln siehe Erklärung	Optionaler Textfilter für die angebotene Geräteabfrage beziehungsweise Ereignisquelle. Seine konkrete Wirkung hängt vom Geräteprovider ab.

Ergebnisvertrag

Ergebnis	Typ / Optionen	Anzahl	Erklärung
`exists`	`Boolean`	`Single`	Ob der abgefragte Datei-/Ordnerpfad zum Beobachtungszeitpunkt existiert. Einzelwert dieses Ergebnisses.
`is_connected`	`Boolean`	`Single`	Ob die Verbindung zum Zeitpunkt der Abfrage hergestellt war. Einzelwert dieses Ergebnisses.
`count`	`Integer`	`Single`	Anzahl der Elemente der referenzierten Sammlung, automatisch als zusätzlicher Ergebniswert verfügbar. Einzelwert dieses Ergebnisses.
`name`	`Text`	`OptionalSingle`	Lesbarer Name des abgefragten Geräts, Monitors, Laufwerks oder Objekts. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`device_state`	`Enum` `["Unknown", "Connected", "Disconnected", "Disabled", "Error"]`	`Single`	Vom Windows-Geräteprovider gemeldeter Gerätezustand. Einzelwert dieses Ergebnisses. `Unknown` Die vorhandenen Daten erlauben keinen eindeutigeren Zustand. `Connected` Das Gerät beziehungsweise die Verbindung ist verbunden. `Disconnected` Verbindung getrennt beziehungsweise Sitzung nicht verbunden; Bedeutung ergibt sich aus dem jeweiligen Ergebnisfeld. `Disabled` Das Gerät ist deaktiviert. `Error` Fehlerbeobachtung; den tatsächlichen Laufabschluss zusätzlich über Outcome prüfen.
`items`	`Text`	`Collection`	Liste abgefragter Objekte, zum Beispiel Geräte, Monitore, Drucker oder Laufwerke. Mitglieder besitzen die in dieser Referenz aufgeführten Unterwerte. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
`items.count`	`Integer`	`Single`	Anzahl der Elemente der referenzierten Sammlung, automatisch als zusätzlicher Ergebniswert verfügbar. Einzelwert dieses Ergebnisses.
`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