Vorschau · Entwicklungsstand 1.6.1
Bild speichern
- 1Bildquelle
Bildobjekt eines Aufnahme-Steps. Ein Dateipfad als Text ist nicht automatisch eine kompatible Bildquelle.
- 2Speicherpfad
Ordner für die Bild-/Videoausgabe. Er muss auf dem Zielrechner erreichbar und beschreibbar sein.
- 3Dateiname
Dateiname der Bild-/Videoausgabe. Wähle ein zur Ausgabe passendes Format und prüfe vorhandene Dateien am Ziel.
- 4Einblendungen
Zusammengesetzte Darstellungseinstellungen für Erkennungen und Text. Die zugrunde liegenden Ergebnisse müssen vorher erzeugt worden sein.
Editor-Ausschnitt mit Markierungen · Lightmode · Beispieldaten · Bild anklicken zum Vergrößern. Die Ansichten erklären die Bedienung; noch nicht gewählte Quellen, Geräte oder Modelle müssen für einen ausführbaren Job ergänzt werden.
Wofür ist das gedacht?
Wähle ein Bild, Ausgabeordner und Dateiname. Optional zeichnest du Einblendungen in die gespeicherte Kopie. file_path und saved_at_utc beschreiben die Ausgabe; die Bildquelle selbst bleibt eine Laufzeitressource und wird nicht als Bitmap in die Jobdatei geschrieben.
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 |
|---|---|---|
| Bildquelle | Bildobjekt eines Aufnahme-Steps. Ein Dateipfad als Text ist nicht automatisch eine kompatible Bildquelle. | Bildaufnahme → Bild |
| Speicherpfad | Ordner für die Bild-/Videoausgabe. Er muss auf dem Zielrechner erreichbar und beschreibbar sein. | C:\Beispiele\Ausgabe |
| Dateiname | Dateiname der Bild-/Videoausgabe. Wähle ein zur Ausgabe passendes Format und prüfe vorhandene Dateien am Ziel. | image.png |
| Einblendungen | Zusammengesetzte Darstellungseinstellungen für Erkennungen und Text. Die zugrunde liegenden Ergebnisse müssen vorher erzeugt worden sein. Im Bereich „Erweitert“ verfügbar. | Farberkennung → Alle Erkennungen; Text bei X = 100, Y = 80 |
Eingaben innerhalb zusammengesetzter Einstellungen
Diese Felder erscheinen innerhalb der jeweiligen Einstellung und je nach gewählter Aktion oder Quelle. Bei einer Ergebnisquelle wählst du den passenden vorherigen Step statt eines direkten Werts.
| Einstellung / Unterfeld | Bedeutung und Bedienung | Beispielwert |
|---|---|---|
| Einblendung › Textergebnis › Bei Job-Ende entfernen | Entfernt die durch diesen Job erzeugte Anzeige beim regulären Aufräumen. | Aus (Häkchen entfernt) |
| Einblendung › Textergebnis › Monitor | Nullbasierter Zielmonitor der Desktop-Anzeige oder Benutzerauswahl. Prüfe ihn auf dem Zielrechner. | 100 |
| Einblendung › Textergebnis › Dauer (ms) | Anzeigedauer in Millisekunden. Beachte die vom Editor angebotenen Grenzen und die zusätzliche Entfernung beim Job-Ende. | 100 |
| Einblendung › Textergebnis › Schriftfarbe | Hex-Farbwert der Textanzeige. Wähle einen ausreichenden Kontrast zum Hintergrund. | #2563EB |
| Einblendung › Textergebnis › Versatz X (px) | Zusätzlicher horizontaler Versatz in Pixeln relativ zum ermittelten Punkt, Referenzpunkt oder Anzeigeursprung. | 100 |
| Einblendung › Textergebnis › Versatz Y (px) | Zusätzlicher vertikaler Versatz in Pixeln relativ zum ermittelten Punkt, Referenzpunkt oder Anzeigeursprung. | 100 |
Ergebniswerte verwenden
| Ergebnis | Bedeutung |
|---|---|
| File Path | Pfad der erzeugten Bild-/Videodatei auf dem ausführenden Rechner. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden. |
| File Name | Name der erzeugten Datei ohne zwingend den ganzen Verzeichnispfad. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden. |
| Format | Ausgabeformat der Bild-/Videodatei. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden. |
| Width | Breite des Ergebnisrechtecks in Pixeln. Einzelwert dieses Ergebnisses. |
| Height | Höhe des Ergebnisrechtecks in Pixeln. Einzelwert dieses Ergebnisses. |
| File Size Bytes | Größe der gespeicherten Datei in Bytes. Einzelwert dieses Ergebnisses. |
| Saved At Utc | UTC-Zeitpunkt der Speicherung/Finalisierung. Einzelwert dieses Ergebnisses. |
Beispiel
Eine Bildschirmaufnahme als PNG in C:\DesktopAutomation-Beispiele\Ausgabe speichern; den zurückgegebenen file_path für eine Folgeaktion verwenden.
Vorbereitete Beispielabläufe ansehenFehler und Hinweise
Prüfe die in dieser Referenz beschriebenen aktiven Pflichtfelder, kompatible Wertequellen und die Voraussetzungen auf dem Zielrechner. Ungültige Quellen oder Typen sind Fehler; eine gültige, aber nicht verfügbare optionale Quelle kann gemäß Eingabevertrag zum Überspringen führen. Ein Fehler beendet die Start-/Hauptphase; die vorgesehene Endphase wird zum Aufräumen behandelt. Der Verlauf zeigt den tatsächlich belegten Status.
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: save_image
- 1Bildquelleimage_source · ResultBinding · Nicht angegeben
Bildobjekt eines Aufnahme-Steps
- 2Speicherpfadsave_path · DirectoryPath · Leerer Text
Ordner für die Bild-/Videoausgabe
- 3Dateinamefile_name · Text · image.png
Dateiname der Bild-/Videoausgabe
- 4Einblendungenoverlay · Object · {"detection_results": [], "text_results": []}
Zusammengesetzte Darstellungseinstellungen für Erkennungen und Text
- 5File PathErgebnis: file_path · Wert
Pfad der erzeugten Bild-/Videodatei auf dem ausführenden Rechner
- 6File NameErgebnis: file_name · Wert
Name der erzeugten Datei ohne zwingend den ganzen Verzeichnispfad
- 7FormatErgebnis: format · Wert
Ausgabeformat der Bild-/Videodatei
- 8WidthErgebnis: width · Wert
Breite des Ergebnisrechtecks in Pixeln
- 9HeightErgebnis: height · Wert
Höhe des Ergebnisrechtecks in Pixeln
- 10File Size BytesErgebnis: file_size_bytes · Wert
Größe der gespeicherten Datei in Bytes
- 11Saved At UtcErgebnis: saved_at_utc · Wert
UTC-Zeitpunkt der Speicherung/Finalisierung
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 |
|---|---|---|---|---|
Bildquelleimage_source | ResultBinding | Nicht angegeben | Pflichtfeld | Bildobjekt eines Aufnahme-Steps. Ein Dateipfad als Text ist nicht automatisch eine kompatible Bildquelle. |
Speicherpfadsave_path | DirectoryPath | Leerer Text | Pflichtfeld | Ordner für die Bild-/Videoausgabe. Er muss auf dem Zielrechner erreichbar und beschreibbar sein. |
Dateinamefile_name | Text | image.png | Pflichtfeld | Dateiname der Bild-/Videoausgabe. Wähle ein zur Ausgabe passendes Format und prüfe vorhandene Dateien am Ziel. |
Einblendungenoverlay | Object | {"detection_results": [], "text_results": []} | Regeln siehe Erklärung | Zusammengesetzte Darstellungseinstellungen für Erkennungen und Text. Die zugrunde liegenden Ergebnisse müssen vorher erzeugt worden sein. |
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 | SaveImageSettings | 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.file_name | String | image.png | Dateiname der Bild-/Videoausgabe. Wähle ein zur Ausgabe passendes Format und prüfe vorhandene Dateien am Ziel. |
settings.image_source | ResultBinding | Nicht angegeben | Bildobjekt eines Aufnahme-Steps. Ein Dateipfad als Text ist nicht automatisch eine kompatible Bildquelle. |
settings.image_source.items | List`1 | Nicht angegeben | Geordnete Unterbindungen einer Liste. Die Reihenfolge ist Teil der Eingabe; Elemente müssen das Listenelement-Schema erfüllen. |
settings.image_source.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.image_source.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.image_source.source_step_id | String | Nicht angegeben | Kompatibilitätsfeld älterer Referenzen. Neue Referenzen verwenden provider_id=step_result und die versionierte source_id. |
settings.image_source.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.image_source.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.image_source.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.image_source.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.image_source.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.overlay | VisualOverlaySettings | Nicht angegeben | Zusammengesetzte Darstellungseinstellungen für Erkennungen und Text. Die zugrunde liegenden Ergebnisse müssen vorher erzeugt worden sein. |
settings.overlay.detection_results | List`1 | Nicht angegeben | Liste referenzierter Erkennungsergebnisse für die Einblendung. |
settings.overlay.detection_results.items | List`1 | Nicht angegeben | Geordnete Unterbindungen einer Liste. Die Reihenfolge ist Teil der Eingabe; Elemente müssen das Listenelement-Schema erfüllen. |
settings.overlay.detection_results.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.overlay.detection_results.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.overlay.detection_results.source_step_id | String | Nicht angegeben | Kompatibilitätsfeld älterer Referenzen. Neue Referenzen verwenden provider_id=step_result und die versionierte source_id. |
settings.overlay.detection_results.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.overlay.detection_results.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. |
settings.overlay.detection_results.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.overlay.detection_results.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. |
settings.overlay.detection_results.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.overlay.text_results | List`1 | Nicht angegeben | Liste referenzierter Text-/Anzeige-Werte für die Einblendung. |
settings.overlay.text_results.clear_on_job_end | Boolean | Nicht angegeben | Entfernt die durch diesen Job erzeugte Anzeige beim regulären Aufräumen. |
settings.overlay.text_results.desktop_index | Int32 | Nicht angegeben | Nullbasierter Zielmonitor der Desktop-Anzeige oder Benutzerauswahl. Prüfe ihn auf dem Zielrechner. |
settings.overlay.text_results.duration_ms | Int32 | Nicht angegeben | Anzeigedauer in Millisekunden. Beachte die vom Editor angebotenen Grenzen und die zusätzliche Entfernung beim Job-Ende. |
settings.overlay.text_results.font_color | String | Nicht angegeben | Hex-Farbwert der Textanzeige. Wähle einen ausreichenden Kontrast zum Hintergrund. |
settings.overlay.text_results.font_size | Single | Nicht angegeben | Schriftgröße der Textanzeige in Punkten. Prüfe Lesbarkeit auf dem tatsächlichen Monitor und dessen Skalierung. |
settings.overlay.text_results.id | Guid | 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. |
settings.overlay.text_results.offset_x | Int32 | Nicht angegeben | Zusätzlicher horizontaler Versatz in Pixeln relativ zum ermittelten Punkt, Referenzpunkt oder Anzeigeursprung. |
settings.overlay.text_results.offset_y | Int32 | Nicht angegeben | Zusätzlicher vertikaler Versatz in Pixeln relativ zum ermittelten Punkt, Referenzpunkt oder Anzeigeursprung. |
settings.overlay.text_results.opacity | Single | Nicht angegeben | Deckkraft als Anteil von 0 bis 1, auch im referenzierten localValues-Wert. 1 bedeutet vollständig sichtbar, 0 unsichtbar. Der Editor zeigt Prozent an. |
settings.overlay.text_results.result | ResultBinding | Nicht angegeben | Typisierte Ergebnisreferenz für den betreffenden Wert; Quelle und Ergebnis-ID auswählen und die Ausführungsreihenfolge beachten. |
settings.overlay.text_results.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.overlay.text_results.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.overlay.text_results.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.overlay.text_results.result.source_step_id | String | Nicht angegeben | Kompatibilitätsfeld älterer Referenzen. Neue Referenzen verwenden provider_id=step_result und die versionierte source_id. |
settings.overlay.text_results.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.overlay.text_results.result.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. |
settings.overlay.text_results.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.overlay.text_results.result.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. |
settings.overlay.text_results.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.save_path | String | Leerer Text | Ordner für die Bild-/Videoausgabe. Er muss auf dem Zielrechner erreichbar und beschreibbar sein. |
Eingabeverträge
| Eingabe | Fehlende Werte | Listen | Akzeptierte Typen / Quellen | Erklärung |
|---|---|---|---|---|
image | FailStep | NotApplicable | [{"ValueKind": "Image", "Cardinalities": ["Single", "OptionalSingle"]}]["step_result"] | Bildobjekt einer Aufnahme. Fehlende erforderliche Werte führen zum Fehler. Es wird kein beliebiges Listenelement ausgewählt. Akzeptierte Typen und Anbieter stehen in den Vertragsspalten; unbegrenzte Anbieterwahl bedeutet weiterhin Typprüfung. |
detections | SkipStep | AllValues | [{"ValueKind": "Detection", "Cardinalities": ["Collection"]}, {"ValueKind": "Rectangle", "Cardinalities": ["Single", "OptionalSingle", "Collection"]}, {"ValueKind": "Point", "Cardinalities": ["Single", "OptionalSingle", "Collection"]}]["job_variable", "step_result"] | Einblendungsquellen mit Geometrie. Eine gültige, aber noch nicht verfügbare optionale Step-Quelle kann den Verbraucher mit NoInput überspringen; malformed Referenzen bleiben Fehler. Alle kompatiblen Listeneinträge werden verarbeitet. Akzeptierte Typen und Anbieter stehen in den Vertragsspalten; unbegrenzte Anbieterwahl bedeutet weiterhin Typprüfung. |
text | SkipStep | AllValues | [{"ValueKind": "Text", "Cardinalities": ["Single", "OptionalSingle"]}, {"ValueKind": "Boolean", "Cardinalities": ["Single", "OptionalSingle"]}, {"ValueKind": "Integer", "Cardinalities": ["Single", "OptionalSingle"]}, {"ValueKind": "Number", "Cardinalities": ["Single", "OptionalSingle"]}, {"ValueKind": "DateTime", "Cardinalities": ["Single", "OptionalSingle"]}, {"ValueKind": "Color", "Cardinalities": ["Single", "OptionalSingle"]}, {"ValueKind": "FilePath", "Cardinalities": ["Single", "OptionalSingle"]}, {"ValueKind": "Enum", "Cardinalities": ["Single", "OptionalSingle"]}, {"ValueKind": "Point", "Cardinalities": ["Single", "OptionalSingle", "Collection"]}, {"ValueKind": "Rectangle", "Cardinalities": ["Single", "OptionalSingle", "Collection"]}, {"ValueKind": "Detection", "Cardinalities": ["Single", "OptionalSingle", "Collection"]}, {"ValueKind": "ProcessReference", "Cardinalities": ["Single", "OptionalSingle", "Collection"]}]["job_variable", "step_result"] | Text beziehungsweise darstellbarer Wert. Eine gültige, aber noch nicht verfügbare optionale Step-Quelle kann den Verbraucher mit NoInput überspringen; malformed Referenzen bleiben Fehler. Alle kompatiblen Listeneinträge werden verarbeitet. Akzeptierte Typen und Anbieter stehen in den Vertragsspalten; unbegrenzte Anbieterwahl bedeutet weiterhin Typprüfung. |
Ergebnisvertrag
| Ergebnis | Typ / Optionen | Anzahl | Erklärung |
|---|---|---|---|
file_path | Text | OptionalSingle | Pfad der erzeugten Bild-/Videodatei auf dem ausführenden Rechner. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden. |
file_name | Text | OptionalSingle | Name der erzeugten Datei ohne zwingend den ganzen Verzeichnispfad. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden. |
format | Text | OptionalSingle | Ausgabeformat der Bild-/Videodatei. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden. |
width | Integer | Single | Breite des Ergebnisrechtecks in Pixeln. Einzelwert dieses Ergebnisses. |
height | Integer | Single | Höhe des Ergebnisrechtecks in Pixeln. Einzelwert dieses Ergebnisses. |
file_size_bytes | Integer | Single | Größe der gespeicherten Datei in Bytes. Einzelwert dieses Ergebnisses. |
saved_at_utc | DateTime | Single | UTC-Zeitpunkt der Speicherung/Finalisierung. 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": "save_image",
"settings": {
"save_path": "",
"file_name": "image.png",
"image_source": {
"provider_id": "",
"source_id": ""
},
"overlay": {
"detection_results": [],
"text_results": []
}
},
"id": "469a3886-c8fa-1eba-0a8f-bbed4435a3cc",
"inputs": {},
"is_enabled": true
}