Vorschau · Entwicklungsstand 1.6.1

FileSystemOperationResult

Wofür ist das gedacht?

Typisierter Ergebnisvertrag FileSystemOperationResult. Wird von Datei oder Ordner bearbeiten 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.

FileSystemOperationResult verstehen
  1. 1
    Zweck

    Typisierter Ergebnisvertrag FileSystemOperationResult. Wird von Datei oder Ordner bearbeiten 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
OperationTatsächlich angeforderte Dateiaktion. Zusammen mit den Zählern und Pfaden lesen, um deren Auswirkungen zu verstehen. Einzelwert dieses Ergebnisses.
Source PathVerwendeter Quellpfad der Dateiaktion. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Target PathVerwendeter Zielpfad der Dateiaktion, soweit die gewählte Aktion ein Ziel besitzt. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Item TypeOb Datei, Ordner oder mehrere Einträge von der Dateiaktion betroffen waren. Einzelwert dieses Ergebnisses.
Affected CountGesamtzahl betroffener Einträge der Dateiaktion. Einzelwert dieses Ergebnisses.
Affected File CountAnzahl betroffener Dateien, getrennt von Ordnern. Einzelwert dieses Ergebnisses.
Affected Directory CountAnzahl betroffener Ordner, getrennt von Dateien. Einzelwert dieses Ergebnisses.
Affected BytesUmfang der betroffenen Dateidaten in Bytes. Einzelwert dieses Ergebnisses.
Affected PathsListe der von der Dateiaktion betroffenen Pfade. Ein erfolgreicher Zähler ist nicht automatisch ein Backup-Versionsnachweis. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
Affected Paths / CountAnzahl der Elemente der referenzierten Sammlung, automatisch als zusätzlicher Ergebniswert verfügbar. Einzelwert dieses Ergebnisses.
Completed At UtcUTC-Abschlusszeitpunkt der Aktion. Einzelwert dieses Ergebnisses.

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

Felder und Zusammenhänge auf einen Blick
  1. 1
    OperationErgebnis: operation · Wert

    Tatsächlich angeforderte Dateiaktion

  2. 2
    Source PathErgebnis: source_path · Wert

    Verwendeter Quellpfad der Dateiaktion

  3. 3
    Target PathErgebnis: target_path · Wert

    Verwendeter Zielpfad der Dateiaktion, soweit die gewählte Aktion ein Ziel besitzt

  4. 4
    Item TypeErgebnis: item_type · Wert

    Ob Datei, Ordner oder mehrere Einträge von der Dateiaktion betroffen waren

  5. 5
    Affected CountErgebnis: affected_count · Wert

    Gesamtzahl betroffener Einträge der Dateiaktion

  6. 6
    Affected File CountErgebnis: affected_file_count · Wert

    Anzahl betroffener Dateien, getrennt von Ordnern

  7. 7
    Affected Directory CountErgebnis: affected_directory_count · Wert

    Anzahl betroffener Ordner, getrennt von Dateien

  8. 8
    Affected BytesErgebnis: affected_bytes · Wert

    Umfang der betroffenen Dateidaten in Bytes

  9. 9
    Affected PathsErgebnis: affected_paths · Wert

    Liste der von der Dateiaktion betroffenen Pfade

  10. 10
    Affected Paths / CountErgebnis: affected_paths.count · Wert

    Anzahl der Elemente der referenzierten Sammlung, automatisch als zusätzlicher Ergebniswert verfügbar

  11. 11
    Completed At UtcErgebnis: completed_at_utc · Wert

    UTC-Abschlusszeitpunkt der Aktion

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

Ergebnisvertrag

ErgebnisTyp / OptionenAnzahlErklärung
operationEnum
["Copy", "Move", "Rename", "Delete"]		SingleTatsächlich angeforderte Dateiaktion. Zusammen mit den Zählern und Pfaden lesen, um deren Auswirkungen zu verstehen. Einzelwert dieses Ergebnisses.
Copy
Kopiert die Quelle zum Ziel; die Quelle bleibt erhalten.
Move
Verschiebt die Quelle zum Ziel; bei Erfolg liegt sie dort statt am ursprünglichen Ort.
Rename
Benennt den Quelleintrag mit new_name um.
Delete
Entfernt passende Quelleinträge; zuerst mit entbehrlichen Testdaten prüfen.
source_pathTextOptionalSingleVerwendeter Quellpfad der Dateiaktion. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
target_pathTextOptionalSingleVerwendeter Zielpfad der Dateiaktion, soweit die gewählte Aktion ein Ziel besitzt. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
item_typeEnum
["File", "Directory", "Multiple"]		SingleOb Datei, Ordner oder mehrere Einträge von der Dateiaktion betroffen waren. Einzelwert dieses Ergebnisses.
File
Betroffener Eintrag ist eine Datei.
Directory
Betroffener Eintrag ist ein Ordner.
Multiple
Mehrere Einträge wurden bearbeitet.
affected_countIntegerSingleGesamtzahl betroffener Einträge der Dateiaktion. Einzelwert dieses Ergebnisses.
affected_file_countIntegerSingleAnzahl betroffener Dateien, getrennt von Ordnern. Einzelwert dieses Ergebnisses.
affected_directory_countIntegerSingleAnzahl betroffener Ordner, getrennt von Dateien. Einzelwert dieses Ergebnisses.
affected_bytesIntegerSingleUmfang der betroffenen Dateidaten in Bytes. Einzelwert dieses Ergebnisses.
affected_pathsTextCollectionListe der von der Dateiaktion betroffenen Pfade. Ein erfolgreicher Zähler ist nicht automatisch ein Backup-Versionsnachweis. Geordnete Liste; ein Verbraucher entscheidet gemäß seinem Eingabevertrag über erstes Element oder alle Elemente.
affected_paths.countIntegerSingleAnzahl der Elemente der referenzierten Sammlung, automatisch als zusätzlicher Ergebniswert verfügbar. Einzelwert dieses Ergebnisses.
completed_at_utcDateTimeSingleUTC-Abschlusszeitpunkt der Aktion. Einzelwert dieses Ergebnisses.

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