Vorschau · Entwicklungsstand 1.6.1

Datei oder Ordner bearbeiten

**Dateien kopieren**Kopieraktion mit Quell- und Zielpfad und automatischem Anlegen fehlender übergeordneter Ordner. Weitere Optionen stehen unter Erweitert. Zusammengestellte Ausschnitte echter Einstellungsfelder mit Beispielwerten; die Nummer markiert Beschriftung und Eingabe gemeinsam.

**Datei umbenennen**Vollständige Feld-Ausschnitte der echten Oberfläche mit Beispielwerten zur Aktion Umbenennen. Die Nummer markiert Beschriftung und Eingabe gemeinsam; keine Dateiaktion wird ausgeführt.

**Dateien mit Muster auswählen**Vollständige Feld-Ausschnitte der echten Oberfläche mit Beispielwerten zur Aktion Löschen. Die Nummer markiert Beschriftung und Eingabe gemeinsam; keine Dateiaktion wird ausgeführt.

Wofür ist das gedacht?

Wähle Kopieren, Verschieben, Umbenennen oder Löschen. Trage Quelle und die für diese Aktion benötigten Zielwerte ein. Nach dem Lauf zeigen affected_count und affected_paths, welche Einträge betroffen waren. Kopieren kann vorhandene Zieldateien ersetzen; teste den Ablauf zunächst mit den bereitgestellten Beispieldateien.

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
Aktion	Dateiaktion Copy, Move, Rename oder Delete. Quelle und benötigte Zusatzfelder ändern sich mit der Aktion. Kopieren Kopiert die Quelle zum Ziel; die Quelle bleibt erhalten. Verschieben Verschiebt die Quelle zum Ziel; bei Erfolg liegt sie dort statt am ursprünglichen Ort. Umbenennen Benennt den Quelleintrag mit new_name um. Löschen Entfernt passende Quelleinträge; zuerst mit entbehrlichen Testdaten prüfen.	Kopieren
Quelle	Datei- oder Ordnerpfad, auf den die Dateiaktion angewendet wird. Der Pfad ist auf dem Zielrechner zu prüfen, nicht nur auf dem Rechner eines Agenten.	C:\Beispiele\Eingang
Ziel	Ziel der Kopier- oder Verschiebeaktion. Bei anderen Aktionen nicht als Ersatz für new_name verwenden. Sichtbar bei: Aktion = Kopieren / Verschieben.	C:\Beispiele\Archiv
Neuer Name	Neuer Dateiname für Rename. Hier wird ein Name angegeben; die Quelle bestimmt den umzubenennenden Eintrag. Sichtbar bei: Aktion = Umbenennen.	Archiv.txt
Optionaler Filter	Nur bei Aktion „Löschen“ sichtbar: Dateimuster wie *.txt für passende Dateien innerhalb eines Ordners. Mehrere Muster mit Semikolon trennen; keine Ordnertrennzeichen eintragen. Leer beschränkt die Auswahl nicht durch ein Muster. Sichtbar bei: Aktion = Löschen.	*.txt
Fehlende übergeordnete Ordner automatisch erstellen	Legt fehlende übergeordnete Zielordner bei den unterstützten Kopier-/Verschiebeaktionen an. Dies gewährt keine zusätzlichen Zugriffsrechte. Sichtbar bei: Aktion = Kopieren / Verschieben.	An (Häkchen gesetzt)
Bei gesperrten Dateien wiederholen	Wiederholt eine wegen Dateisperre fehlgeschlagene Dateiaktion nach konfigurierter Wartezeit. Andere Konfigurationsfehler werden dadurch nicht behoben. Im Bereich „Erweitert“ verfügbar.	An (Häkchen gesetzt)
Anzahl der Wiederholungen	Anzahl zusätzlicher Wiederholungsversuche nach einer Dateisperre; 0 deaktiviert zusätzliche Versuche. Im Bereich „Erweitert“ verfügbar. Sichtbar bei: Bei gesperrten Dateien wiederholen = An. Zulässiger Bereich: ab 0.	3
Wartezeit zwischen Versuchen (ms)	Pause zwischen Wiederholungsversuchen in Millisekunden. Ein höherer Wert gibt dem anderen Programm mehr Zeit zur Freigabe. Im Bereich „Erweitert“ verfügbar. Sichtbar bei: Bei gesperrten Dateien wiederholen = An. Zulässiger Bereich: ab 0.	100

Ergebniswerte verwenden

Ergebnis	Bedeutung
Operation	Tatsächlich angeforderte Dateiaktion. Zusammen mit den Zählern und Pfaden lesen, um deren Auswirkungen zu verstehen. Einzelwert dieses Ergebnisses.
Source Path	Verwendeter Quellpfad der Dateiaktion. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Target Path	Verwendeter Zielpfad der Dateiaktion, soweit die gewählte Aktion ein Ziel besitzt. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Item Type	Ob Datei, Ordner oder mehrere Einträge von der Dateiaktion betroffen waren. Einzelwert dieses Ergebnisses.
Affected Count	Gesamtzahl betroffener Einträge der Dateiaktion. Einzelwert dieses Ergebnisses.
Affected File Count	Anzahl betroffener Dateien, getrennt von Ordnern. Einzelwert dieses Ergebnisses.
Affected Directory Count	Anzahl betroffener Ordner, getrennt von Dateien. Einzelwert dieses Ergebnisses.
Affected Bytes	Umfang der betroffenen Dateidaten in Bytes. Einzelwert dieses Ergebnisses.
Affected Paths	Liste 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 / Count	Anzahl der Elemente der referenzierten Sammlung, automatisch als zusätzlicher Ergebniswert verfügbar. Einzelwert dieses Ergebnisses.
Completed At Utc	UTC-Abschlusszeitpunkt der Aktion. Einzelwert dieses Ergebnisses.

Beispiel

Der Beispielablauf „Arbeitsunterlagen vorbereiten“ kopiert je nach Auswahl Rechnungen oder Notizen in getrennte Arbeitsordner.

Vorbereitete Beispielabläufe ansehen

Fehler und Hinweise

Prüfe bei Fehlern Quellpfad, Aktion, Ziel, Zugriffsrechte und Dateisperren. Wiederholungen gelten für konfigurierte gesperrte Dateiaktionen; sie machen eine falsche Quelle nicht gültig. Ein teilweise bearbeiteter Ordner wird bei einem späteren Fehler nicht automatisch zurückgerollt.

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

Felder und Zusammenhänge auf einen Blick

1
Aktionoperation · Enum · Copy, Move, Rename, Delete
Dateiaktion Copy, Move, Rename oder Delete
2
Quellesource_path · DirectoryPath · Nicht angegeben
Datei- oder Ordnerpfad, auf den die Dateiaktion angewendet wird
3
Zieltarget_path · DirectoryPath · Nicht angegeben
Ziel der Kopier- oder Verschiebeaktion
4
Neuer Namenew_name · Text · Nicht angegeben
Neuer Dateiname für Rename
5
Optionaler Filterfilter · Text · Nicht angegeben
Nur bei Aktion „Löschen“ sichtbar: Dateimuster wie *.txt für passende Dateien innerhalb eines Ordners
6
Fehlende übergeordnete Ordner automatisch erstellencreate_parent_directories · Boolean · true
Legt fehlende übergeordnete Zielordner bei den unterstützten Kopier-/Verschiebeaktionen an
7
Bei gesperrten Dateien wiederholenretry_locked_files · Boolean · true
Wiederholt eine wegen Dateisperre fehlgeschlagene Dateiaktion nach konfigurierter Wartezeit
8
Anzahl der Wiederholungenretry_count · Integer · 3
Anzahl zusätzlicher Wiederholungsversuche nach einer Dateisperre; 0 deaktiviert zusätzliche Versuche.
9
Wartezeit zwischen Versuchen (ms)retry_delay_ms · Duration · 100
Pause zwischen Wiederholungsversuchen in Millisekunden
10
OperationErgebnis: operation · Wert
Tatsächlich angeforderte Dateiaktion
11
Source PathErgebnis: source_path · Wert
Verwendeter Quellpfad der Dateiaktion
12
Target PathErgebnis: target_path · Wert
Verwendeter Zielpfad der Dateiaktion, soweit die gewählte Aktion ein Ziel besitzt
13
Item TypeErgebnis: item_type · Wert
Ob Datei, Ordner oder mehrere Einträge von der Dateiaktion betroffen waren
14
Affected CountErgebnis: affected_count · Wert
Gesamtzahl betroffener Einträge der Dateiaktion
15
Affected File CountErgebnis: affected_file_count · Wert
Anzahl betroffener Dateien, getrennt von Ordnern
16
Affected Directory CountErgebnis: affected_directory_count · Wert
Anzahl betroffener Ordner, getrennt von Dateien
17
Affected BytesErgebnis: affected_bytes · Wert
Umfang der betroffenen Dateidaten in Bytes
18
Affected PathsErgebnis: affected_paths · Wert
Liste der von der Dateiaktion betroffenen Pfade
19
Affected Paths / CountErgebnis: affected_paths.count · Wert
Anzahl der Elemente der referenzierten Sammlung, automatisch als zusätzlicher Ergebniswert verfügbar
20
Completed At UtcErgebnis: completed_at_utc · Wert
UTC-Abschlusszeitpunkt der Aktion

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
Aktion `operation`	`Enum`	`Copy`	Pflichtfeld `["Copy", "Move", "Rename", "Delete"]`	Dateiaktion Copy, Move, Rename oder Delete. Quelle und benötigte Zusatzfelder ändern sich mit der Aktion. `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.
Quelle `source_path`	`DirectoryPath`	`Nicht angegeben`	Pflichtfeld	Datei- oder Ordnerpfad, auf den die Dateiaktion angewendet wird. Der Pfad ist auf dem Zielrechner zu prüfen, nicht nur auf dem Rechner eines Agenten.
Ziel `target_path`	`DirectoryPath`	`Nicht angegeben`	Pflichtfeld Sichtbar wenn: `{"FieldId": "operation", "EqualsValue": null, "AnyOfValues": ["Copy", "Move"]}`	Ziel der Kopier- oder Verschiebeaktion. Bei anderen Aktionen nicht als Ersatz für new_name verwenden.
Neuer Name `new_name`	`Text`	`Nicht angegeben`	Regeln siehe Erklärung Sichtbar wenn: `{"FieldId": "operation", "EqualsValue": "Rename", "AnyOfValues": null}`	Neuer Dateiname für Rename. Hier wird ein Name angegeben; die Quelle bestimmt den umzubenennenden Eintrag.
Optionaler Filter `filter`	`Text`	`Nicht angegeben`	Regeln siehe Erklärung Sichtbar wenn: `{"FieldId": "operation", "EqualsValue": "Delete", "AnyOfValues": null}`	Nur bei Aktion „Löschen“ sichtbar: Dateimuster wie *.txt für passende Dateien innerhalb eines Ordners. Mehrere Muster mit Semikolon trennen; keine Ordnertrennzeichen eintragen. Leer beschränkt die Auswahl nicht durch ein Muster.
Fehlende übergeordnete Ordner automatisch erstellen `create_parent_directories`	`Boolean`	`true`	Regeln siehe Erklärung Sichtbar wenn: `{"FieldId": "operation", "EqualsValue": null, "AnyOfValues": ["Copy", "Move"]}`	Legt fehlende übergeordnete Zielordner bei den unterstützten Kopier-/Verschiebeaktionen an. Dies gewährt keine zusätzlichen Zugriffsrechte.
Bei gesperrten Dateien wiederholen `retry_locked_files`	`Boolean`	`true`	Regeln siehe Erklärung	Wiederholt eine wegen Dateisperre fehlgeschlagene Dateiaktion nach konfigurierter Wartezeit. Andere Konfigurationsfehler werden dadurch nicht behoben.
Anzahl der Wiederholungen `retry_count`	`Integer`	`3`	Regeln siehe Erklärung Grenzen: `{"Minimum": 0}` Sichtbar wenn: `{"FieldId": "retry_locked_files", "EqualsValue": true, "AnyOfValues": null}`	Anzahl zusätzlicher Wiederholungsversuche nach einer Dateisperre; 0 deaktiviert zusätzliche Versuche.
Wartezeit zwischen Versuchen (ms) `retry_delay_ms`	`Duration`	`100`	Regeln siehe Erklärung Grenzen: `{"Minimum": 0}` Sichtbar wenn: `{"FieldId": "retry_locked_files", "EqualsValue": true, "AnyOfValues": null}`	Pause zwischen Wiederholungsversuchen in Millisekunden. Ein höherer Wert gibt dem anderen Programm mehr Zeit zur Freigabe.

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`	`FileSystemOperationSettings`	`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.create_parent_directories`	`Boolean`	`true`	Legt fehlende übergeordnete Zielordner bei den unterstützten Kopier-/Verschiebeaktionen an. Dies gewährt keine zusätzlichen Zugriffsrechte.
`settings.filter`	`String`	`Leerer Text`	Nur bei Aktion „Löschen“ sichtbar: Dateimuster wie *.txt für passende Dateien innerhalb eines Ordners. Mehrere Muster mit Semikolon trennen; keine Ordnertrennzeichen eintragen. Leer beschränkt die Auswahl nicht durch ein Muster.
`settings.new_name`	`String`	`Leerer Text`	Neuer Dateiname für Rename. Hier wird ein Name angegeben; die Quelle bestimmt den umzubenennenden Eintrag.
`settings.operation`	`FileSystemOperation`	`Copy` `["Copy", "Move", "Rename", "Delete"]`	Dateiaktion Copy, Move, Rename oder Delete. Quelle und benötigte Zusatzfelder ändern sich mit der Aktion. `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.
`settings.retry_count`	`Int32`	`3`	Anzahl zusätzlicher Wiederholungsversuche nach einer Dateisperre; 0 deaktiviert zusätzliche Versuche.
`settings.retry_delay_ms`	`Int32`	`100`	Pause zwischen Wiederholungsversuchen in Millisekunden. Ein höherer Wert gibt dem anderen Programm mehr Zeit zur Freigabe.
`settings.retry_locked_files`	`Boolean`	`true`	Wiederholt eine wegen Dateisperre fehlgeschlagene Dateiaktion nach konfigurierter Wartezeit. Andere Konfigurationsfehler werden dadurch nicht behoben.
`settings.source_mode`	`FileSystemPathSource`	`ExplicitPath` `["ExplicitPath", "TaskResult"]`	Bei älterer Pfadkonfiguration: ExplicitPath liest source_path, TaskResult liest source_result. `ExplicitPath` Verwendet den direkt angegebenen Pfad. `TaskResult` Verwendet den verbundenen Step-Ergebniswert statt des direkten Literals.
`settings.source_path`	`String`	`Leerer Text`	Datei- oder Ordnerpfad, auf den die Dateiaktion angewendet wird. Der Pfad ist auf dem Zielrechner zu prüfen, nicht nur auf dem Rechner eines Agenten.
`settings.source_result`	`ResultBinding`	`Nicht angegeben`	Typisierte Referenz, deren Text/Dateipfad als Quelle der Dateiaktion verwendet wird.
`settings.source_result.items`	List`1	`Nicht angegeben`	Geordnete Unterbindungen einer Liste. Die Reihenfolge ist Teil der Eingabe; Elemente müssen das Listenelement-Schema erfüllen.
`settings.source_result.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.source_result.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.source_result.source_step_id`	`String`	`Nicht angegeben`	Kompatibilitätsfeld älterer Referenzen. Neue Referenzen verwenden provider_id=step_result und die versionierte source_id.
`settings.source_result.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.source_result.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.source_result.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.source_result.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.source_result.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_mode`	`FileSystemPathSource`	`ExplicitPath` `["ExplicitPath", "TaskResult"]`	Bei älterer Pfadkonfiguration: ExplicitPath liest target_path, TaskResult liest target_result. `ExplicitPath` Verwendet den direkt angegebenen Pfad. `TaskResult` Verwendet den verbundenen Step-Ergebniswert statt des direkten Literals.
`settings.target_path`	`String`	`Leerer Text`	Ziel der Kopier- oder Verschiebeaktion. Bei anderen Aktionen nicht als Ersatz für new_name verwenden.
`settings.target_result`	`ResultBinding`	`Nicht angegeben`	Typisierte Referenz, deren Text/Dateipfad als Ziel der Dateiaktion verwendet wird.
`settings.target_result.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_result.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_result.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_result.source_step_id`	`String`	`Nicht angegeben`	Kompatibilitätsfeld älterer Referenzen. Neue Referenzen verwenden provider_id=step_result und die versionierte source_id.
`settings.target_result.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_result.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_result.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_result.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_result.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.

Eingabeverträge

Eingabe	Fehlende Werte	Listen	Akzeptierte Typen / Quellen	Erklärung
`source`	`SkipStep`	`NotApplicable`	`[{"ValueKind": "Text", "Cardinalities": ["Single", "OptionalSingle"]}, {"ValueKind": "FilePath", "Cardinalities": ["Single", "OptionalSingle"]}]` `["step_result"]`	Quell-Dateipfad. 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.
`target`	`SkipStep`	`NotApplicable`	`[{"ValueKind": "Text", "Cardinalities": ["Single", "OptionalSingle"]}, {"ValueKind": "FilePath", "Cardinalities": ["Single", "OptionalSingle"]}]` `["step_result"]`	Ziel-Dateipfad. 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
`operation`	`Enum` `["Copy", "Move", "Rename", "Delete"]`	`Single`	Tatsä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_path`	`Text`	`OptionalSingle`	Verwendeter Quellpfad der Dateiaktion. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`target_path`	`Text`	`OptionalSingle`	Verwendeter Zielpfad der Dateiaktion, soweit die gewählte Aktion ein Ziel besitzt. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`item_type`	`Enum` `["File", "Directory", "Multiple"]`	`Single`	Ob 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_count`	`Integer`	`Single`	Gesamtzahl betroffener Einträge der Dateiaktion. Einzelwert dieses Ergebnisses.
`affected_file_count`	`Integer`	`Single`	Anzahl betroffener Dateien, getrennt von Ordnern. Einzelwert dieses Ergebnisses.
`affected_directory_count`	`Integer`	`Single`	Anzahl betroffener Ordner, getrennt von Dateien. Einzelwert dieses Ergebnisses.
`affected_bytes`	`Integer`	`Single`	Umfang der betroffenen Dateidaten in Bytes. Einzelwert dieses Ergebnisses.
`affected_paths`	`Text`	`Collection`	Liste 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.count`	`Integer`	`Single`	Anzahl der Elemente der referenzierten Sammlung, automatisch als zusätzlicher Ergebniswert verfügbar. Einzelwert dieses Ergebnisses.
`completed_at_utc`	`DateTime`	`Single`	UTC-Abschlusszeitpunkt der Aktion. Einzelwert dieses Ergebnisses.

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": "file_system_operation",
  "settings": {
    "operation": "Copy",
    "source_mode": "ExplicitPath",
    "source_path": "",
    "source_result": {
      "provider_id": "",
      "source_id": ""
    },
    "target_mode": "ExplicitPath",
    "target_path": "",
    "target_result": {
      "provider_id": "",
      "source_id": ""
    },
    "new_name": "",
    "filter": "",
    "create_parent_directories": true,
    "retry_locked_files": true,
    "retry_count": 3,
    "retry_delay_ms": 100
  },
  "id": "fd4d948b-8366-d9ec-c236-0eb9d97b2607",
  "inputs": {},
  "is_enabled": true
}