Vorschau · Entwicklungsstand 1.6.1

Text auf Desktop anzeigen

**Ergebnis als Text verwenden**Die Desktop-Textausgabe übernimmt die Beschriftung der Benutzerauswahl als Ergebnisquelle. Zusammengestellte Ausschnitte echter Einstellungsfelder mit Beispielwerten; die Nummer markiert Beschriftung und Eingabe gemeinsam.

Wofür ist das gedacht?

Trage Text ein oder verbinde einen kompatiblen Wert. Wähle Monitor, Schrift, Farbe, Deckkraft und Anzeigedauer. Die Anzeige kann nach Zeitablauf oder beim Job-Ende entfernt werden. Verwende selected_label einer Benutzerauswahl für eine verständliche Rückmeldung.

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
Text	Text oder kompatibler Anzeige-Wert aus einer Quelle. Für Benutzerauswahlen eignet sich selected_label.	Benutzerauswahl → Antworttext
Monitor	Nullbasierter Zielmonitor der Desktop-Anzeige oder Benutzerauswahl. Prüfe ihn auf dem Zielrechner. Zulässiger Bereich: ab 0.	0
Schriftgröße (pt)	Schriftgröße der Textanzeige in Punkten. Prüfe Lesbarkeit auf dem tatsächlichen Monitor und dessen Skalierung. Im Bereich „Erweitert“ verfügbar. Zulässiger Bereich: ab 0.01.	24
Schriftfarbe	Hex-Farbwert der Textanzeige. Wähle einen ausreichenden Kontrast zum Hintergrund. Im Bereich „Erweitert“ verfügbar.	#2563EB
Deckkraft (%)	Deckkraft als Anteil von 0 bis 1, auch im referenzierten localValues-Wert. 1 bedeutet vollständig sichtbar, 0 unsichtbar. Der Editor zeigt Prozent an. Im Bereich „Erweitert“ verfügbar. Zulässiger Bereich: ab 0 % bis 100 %.	100 %
Anzeigedauer (ms)	Anzeigedauer in Millisekunden. Beachte die vom Editor angebotenen Grenzen und die zusätzliche Entfernung beim Job-Ende. Im Bereich „Erweitert“ verfügbar. Zulässiger Bereich: ab 0.	5000
Bei Job-Ende entfernen	Entfernt die durch diesen Job erzeugte Anzeige beim regulären Aufräumen. Im Bereich „Erweitert“ verfügbar.	Aus (Häkchen entfernt)
Versatz X (px)	Zusätzlicher horizontaler Versatz in Pixeln relativ zum ermittelten Punkt, Referenzpunkt oder Anzeigeursprung. Im Bereich „Erweitert“ verfügbar.	100
Versatz Y (px)	Zusätzlicher vertikaler Versatz in Pixeln relativ zum ermittelten Punkt, Referenzpunkt oder Anzeigeursprung. Im Bereich „Erweitert“ verfügbar.	100

Ergebniswerte verwenden

Ergebnis	Bedeutung

Beispiel

Die gewählte Antwort aus user_choice über selected_label zwei Sekunden auf Monitor 0 anzeigen.

Vorbereitete Beispielabläufe ansehen

Fehler 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: show_text

Felder und Zusammenhänge auf einen Blick

1
Texttext_result · ResultBinding · Leerer Text
Text oder kompatibler Anzeige-Wert aus einer Quelle
2
Monitordesktop_index · Integer · 0
Nullbasierter Zielmonitor der Desktop-Anzeige oder Benutzerauswahl
3
Schriftgröße (pt)font_size · Number · 24
Schriftgröße der Textanzeige in Punkten
4
Schriftfarbefont_color · Color · #FFFFFF
Hex-Farbwert der Textanzeige
5
Deckkraft (%)opacity · Number · 1
Deckkraft als Anteil von 0 bis 1, auch im referenzierten localValues-Wert
6
Anzeigedauer (ms)duration_ms · Duration · 5000
Anzeigedauer in Millisekunden
7
Bei Job-Ende entfernenclear_on_job_end · Boolean · false
Entfernt die durch diesen Job erzeugte Anzeige beim regulären Aufräumen.
8
Versatz X (px)offset_x · Integer · 100
Zusätzlicher horizontaler Versatz in Pixeln relativ zum ermittelten Punkt, Referenzpunkt oder Anzeigeursprung.
9
Versatz Y (px)offset_y · Integer · 100
Zusätzlicher vertikaler Versatz in Pixeln relativ zum ermittelten Punkt, Referenzpunkt oder Anzeigeursprung.

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
Text `text_result`	`ResultBinding`	`Leerer Text`	Pflichtfeld	Text oder kompatibler Anzeige-Wert aus einer Quelle. Für Benutzerauswahlen eignet sich selected_label.
Monitor `desktop_index`	`Integer`	`0`	Regeln siehe Erklärung Grenzen: `{"Minimum": 0}`	Nullbasierter Zielmonitor der Desktop-Anzeige oder Benutzerauswahl. Prüfe ihn auf dem Zielrechner.
Schriftgröße (pt) `font_size`	`Number`	`24`	Regeln siehe Erklärung Grenzen: `{"Minimum": 0.01}`	Schriftgröße der Textanzeige in Punkten. Prüfe Lesbarkeit auf dem tatsächlichen Monitor und dessen Skalierung.
Schriftfarbe `font_color`	`Color`	`#FFFFFF`	Regeln siehe Erklärung	Hex-Farbwert der Textanzeige. Wähle einen ausreichenden Kontrast zum Hintergrund.
Deckkraft (%) `opacity`	`Number`	`1`	Regeln siehe Erklärung Grenzen: `{"Minimum": 0, "Maximum": 1}`	Deckkraft als Anteil von 0 bis 1, auch im referenzierten localValues-Wert. 1 bedeutet vollständig sichtbar, 0 unsichtbar. Der Editor zeigt Prozent an.
Anzeigedauer (ms) `duration_ms`	`Duration`	`5000`	Regeln siehe Erklärung Grenzen: `{"Minimum": 0}`	Anzeigedauer in Millisekunden. Beachte die vom Editor angebotenen Grenzen und die zusätzliche Entfernung beim Job-Ende.
Bei Job-Ende entfernen `clear_on_job_end`	`Boolean`	`false`	Regeln siehe Erklärung	Entfernt die durch diesen Job erzeugte Anzeige beim regulären Aufräumen.
Versatz X (px) `offset_x`	`Integer`	`100`	Regeln siehe Erklärung	Zusätzlicher horizontaler Versatz in Pixeln relativ zum ermittelten Punkt, Referenzpunkt oder Anzeigeursprung.
Versatz Y (px) `offset_y`	`Integer`	`100`	Regeln siehe Erklärung	Zusätzlicher vertikaler Versatz in Pixeln relativ zum ermittelten Punkt, Referenzpunkt oder Anzeigeursprung.

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`	`ShowTextSettings`	`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.clear_on_job_end`	`Boolean`	`false`	Entfernt die durch diesen Job erzeugte Anzeige beim regulären Aufräumen.
`settings.desktop_index`	`Int32`	`0`	Nullbasierter Zielmonitor der Desktop-Anzeige oder Benutzerauswahl. Prüfe ihn auf dem Zielrechner.
`settings.duration_ms`	`Int32`	`5000`	Anzeigedauer in Millisekunden. Beachte die vom Editor angebotenen Grenzen und die zusätzliche Entfernung beim Job-Ende.
`settings.font_color`	`String`	`#FFFFFF`	Hex-Farbwert der Textanzeige. Wähle einen ausreichenden Kontrast zum Hintergrund.
`settings.font_size`	`Single`	`24`	Schriftgröße der Textanzeige in Punkten. Prüfe Lesbarkeit auf dem tatsächlichen Monitor und dessen Skalierung.
`settings.offset_x`	`Int32`	`100`	Zusätzlicher horizontaler Versatz in Pixeln relativ zum ermittelten Punkt, Referenzpunkt oder Anzeigeursprung.
`settings.offset_y`	`Int32`	`100`	Zusätzlicher vertikaler Versatz in Pixeln relativ zum ermittelten Punkt, Referenzpunkt oder Anzeigeursprung.
`settings.opacity`	`Single`	`1`	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.text`	`String`	`Leerer Text`	Direkt angezeigter beziehungsweise eingegebener Text. Ein Makro schreibt ihn in das aktive Fenster; die Desktop-Anzeige stellt ihn nur dar.
`settings.text_result`	`ResultBinding`	`Nicht angegeben`	Text oder kompatibler Anzeige-Wert aus einer Quelle. Für Benutzerauswahlen eignet sich selected_label.
`settings.text_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.text_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.text_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.text_result.source_step_id`	`String`	`Nicht angegeben`	Kompatibilitätsfeld älterer Referenzen. Neue Referenzen verwenden provider_id=step_result und die versionierte source_id.
`settings.text_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.text_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.text_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.text_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.text_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.text_source`	`ShowTextSource`	`TaskResult` `["ExplicitText", "TaskResult"]`	ExplicitText verwendet den direkten Text, TaskResult den verbundenen Ergebniswert in der älteren settings-Konfiguration. `ExplicitText` Verwendet den direkt eingegebenen Text. `TaskResult` Verwendet den verbundenen Step-Ergebniswert statt des direkten Literals.

Eingabeverträge

Eingabe	Fehlende Werte	Listen	Akzeptierte Typen / Quellen	Erklärung
`text`	`FailStep`	`FirstValue`	[{"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. Fehlende erforderliche Werte führen zum Fehler. Bei kompatiblen Listen wird der erste Wert verwendet. Akzeptierte Typen und Anbieter stehen in den Vertragsspalten; unbegrenzte Anbieterwahl bedeutet weiterhin Typprüfung.

Ergebnisvertrag

Ergebnis	Typ / Optionen	Anzahl	Erklärung

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": "show_text",
  "settings": {
    "text_source": "TaskResult",
    "text": "",
    "text_result": {
      "provider_id": "",
      "source_id": ""
    },
    "font_size": 24,
    "font_color": "#FFFFFF",
    "opacity": 1,
    "desktop_index": 0,
    "offset_x": 100,
    "offset_y": 100,
    "duration_ms": 5000,
    "clear_on_job_end": false
  },
  "id": "53488c77-d339-7ac1-2fc2-7774b8ec431e",
  "inputs": {},
  "is_enabled": true
}