Vorschau · Entwicklungsstand 1.6.1

SystemLifecycleQueryResult

Wofür ist das gedacht?

Typisierter Ergebnisvertrag SystemLifecycleQueryResult. Wird von der zugehörigen Windows-Abfrage geliefert. Die stabilen Ergebnis-IDs unten sind unabhängig von CLR-Namen und UI-Übersetzungen. Wähle im Ergebnis-Auswahldialog eine kompatible Eigenschaft statt das ganze Objekt ungeprüft als Text zu verwenden.

SystemLifecycleQueryResult verstehen
  1. 1
    Zweck

    Typisierter Ergebnisvertrag SystemLifecycleQueryResult. Wird von der zugehörigen Windows-Abfrage geliefert. Die stabilen Ergebnis-IDs unten sind unabhängig von CLR-Namen und UI-Übersetzungen. Wähle im Ergebnis-Auswahldialog eine kompatible Eigenschaft statt das ganze Objekt ungeprüft als Text zu verwenden.

  2. 2
    Beispiel

    Eine Ergebnisreferenz verwendet provider_id=step_result und source_id=v1/<kodierte-Step-ID>/<kodierte-Ergebnis-ID>. Die Anleitung „Werte verbinden“ zeigt eine vollständige Verbindung. Prüfe Typ und Kardinalität vor der Verwendung in einer Bedingung oder Folgeaktion.

  3. 3
    Hinweise

    Ein konfigurierte Quelle hat noch nicht zwingend einen Wert geliefert. Prüfe den fachlichen Erfolgswert, fehlende optionale Eigenschaften und den Ausführungszustand des Produzenten. Nur DynamicRoi besitzt die dokumentierte Ausnahme für späteres Feedback; andere Verbraucher dürfen keine beliebigen Vorwärtsreferenzen verwenden.

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

Ergebniswerte verwenden

ErgebnisBedeutung
Uptime MillisecondsDer von dieser Windows-Abfrage gelieferte fachliche Wert; die Typ- und Kardinalitätsspalten beschreiben seine Darstellung. Einzelwert dieses Ergebnisses.
Uptime SecondsAktueller Akkuladestand als Prozentwert, soweit vom System verfügbar. Einzelwert dieses Ergebnisses.
Operating System VersionErkannter oder abgefragter Text. Er kann leer sein; Datentyp und Leerheitsprüfung vor einem nachfolgenden Vergleich beachten. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
StatusVom zuständigen Windows-Dienst gemeldeter Zustand. Nicht durch frei erfundene Statusnamen ersetzen. Einzelwert dieses Ergebnisses.
Captured AtZeitpunkt der Windows-Abfrage beziehungsweise Erfassung im Ergebnis. Er zeigt den Beobachtungsstand, nicht einen garantierten späteren Systemzustand. Einzelwert dieses Ergebnisses.
Error CodeMaschinenlesbarer Fehlercode einer Windows-Operation; bei Erfolg entsprechend dem Vertrag leer beziehungsweise nicht gesetzt. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Error MessageLesbare Diagnose der Windows-Operation. Für Entscheidungen vorzugsweise Status und stabilen Code verwenden. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.

Beispiel

Eine Ergebnisreferenz verwendet provider_id=step_result und source_id=v1/<kodierte-Step-ID>/<kodierte-Ergebnis-ID>. Die Anleitung „Werte verbinden“ zeigt eine vollständige Verbindung. Prüfe Typ und Kardinalität vor der Verwendung in einer Bedingung oder Folgeaktion.

Vorbereitete Beispielabläufe ansehen

Fehler und Hinweise

Ein konfigurierte Quelle hat noch nicht zwingend einen Wert geliefert. Prüfe den fachlichen Erfolgswert, fehlende optionale Eigenschaften und den Ausführungszustand des Produzenten. Nur DynamicRoi besitzt die dokumentierte Ausnahme für späteres Feedback; andere Verbraucher dürfen keine beliebigen Vorwärtsreferenzen verwenden.

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

Felder und Zusammenhänge auf einen Blick
  1. 1
    Uptime MillisecondsErgebnis: value · Wert

    Der von dieser Windows-Abfrage gelieferte fachliche Wert; die Typ- und Kardinalitätsspalten beschreiben seine Darstellung

  2. 2
    Uptime SecondsErgebnis: percentage · Wert

    Aktueller Akkuladestand als Prozentwert, soweit vom System verfügbar

  3. 3
    Operating System VersionErgebnis: text · Wert

    Erkannter oder abgefragter Text

  4. 4
    StatusErgebnis: status · Wert

    Vom zuständigen Windows-Dienst gemeldeter Zustand

  5. 5
    Captured AtErgebnis: captured_at · Wert

    Zeitpunkt der Windows-Abfrage beziehungsweise Erfassung im Ergebnis

  6. 6
    Error CodeErgebnis: error_code · Wert

    Maschinenlesbarer Fehlercode einer Windows-Operation; bei Erfolg entsprechend dem Vertrag leer beziehungsweise nicht gesetzt

  7. 7
    Error MessageErgebnis: error_message · Wert

    Lesbare Diagnose der Windows-Operation

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

Ergebnisvertrag

ErgebnisTyp / OptionenAnzahlErklärung
valueIntegerSingleDer von dieser Windows-Abfrage gelieferte fachliche Wert; die Typ- und Kardinalitätsspalten beschreiben seine Darstellung. Einzelwert dieses Ergebnisses.
percentageNumberSingleAktueller Akkuladestand als Prozentwert, soweit vom System verfügbar. Einzelwert dieses Ergebnisses.
textTextOptionalSingleErkannter oder abgefragter Text. Er kann leer sein; Datentyp und Leerheitsprüfung vor einem nachfolgenden Vergleich beachten. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
statusEnum
["Success", "Unsupported", "AccessDenied", "Timeout", "Failed"]
SingleVom 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_atDateTimeSingleZeitpunkt der Windows-Abfrage beziehungsweise Erfassung im Ergebnis. Er zeigt den Beobachtungsstand, nicht einen garantierten späteren Systemzustand. Einzelwert dieses Ergebnisses.
error_codeTextOptionalSingleMaschinenlesbarer Fehlercode einer Windows-Operation; bei Erfolg entsprechend dem Vertrag leer beziehungsweise nicht gesetzt. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
error_messageTextOptionalSingleLesbare 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