Vorschau · Entwicklungsstand 1.6.1

Benutzerauswahl abfragen

**Benutzerauswahl**Eine Rückfrage mit zwei beschrifteten Optionen und getrennten Rückgabewerten. Zusammengestellte Ausschnitte echter Einstellungsfelder mit Beispielwerten; die Nummer markiert Beschriftung und Eingabe gemeinsam.

Wofür ist das gedacht?

Lege zwei bis achtzehn Antworten an und frage den Benutzer während des Jobs nach einer Auswahl. Jede Antwort hat eine stabile ID, ein sichtbares Label und einen weitergegebenen Textwert. Die Ergebnisse selected_option_id, selected_label und selected_value erfüllen unterschiedliche Zwecke; ein Abbruch wird separat als was_cancelled gemeldet.

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
Überschrift (optional)	Sichtbare Überschrift der Auswahl beziehungsweise Gruppentitel. Sie ist keine technische Identität.	Hinweis
Titel (optional)	Fragetext der Benutzerauswahl. Formuliere ihn so, dass die angebotenen Antworten eine eindeutige Entscheidung ermöglichen.	Dateien sichern?
Beschreibung (optional)	Zusätzliche Beschreibung für Menschen; sie ist kein auszuführender Befehl.	Wähle den nächsten Arbeitsschritt.
Monitor	Nullbasierter Zielmonitor der Desktop-Anzeige oder Benutzerauswahl. Prüfe ihn auf dem Zielrechner. Zulässiger Bereich: ab 0.	0
Antwortmöglichkeiten (2 bis 18, verpflichtend)	Lege zwei bis achtzehn Antworten an. Jede Antwort benötigt einen sichtbaren Antworttext. Ein optionaler Rückgabewert ermöglicht stabile Bedingungen; bleibt er leer, wird der Antworttext zurückgegeben. Die interne ID bleibt beim Umbenennen oder Umordnen erhalten.	Ja, sichern → yes / Nein → no

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
Antwortmöglichkeiten › Antwort-ID	Eindeutige, stabile ID dieser Antwort innerhalb der Antwortliste. Über diese ID können nachfolgende Steps die gewählte Option erkennen. Beim Umbenennen der Beschriftung die ID beibehalten.	Beispieltext
Antwortmöglichkeiten › Beschriftung	Für Menschen sichtbarer Antworttext. Verwende value für stabile fachliche Vergleiche, wenn das Label später umformuliert werden soll.	Ja, sichern
Antwortmöglichkeiten › Wert	Optionaler Textwert, der bei Auswahl dieser Antwort weitergereicht wird, zum Beispiel „yes“. Leer verwendet den Antworttext. Mit einem stabilen Rückgabewert funktionieren Bedingungen auch nach einer Änderung der sichtbaren Beschriftung.	yes

Ergebniswerte verwenden

Antwort-IDs hängen von deiner Benutzerauswahl ab. Die hier aufgeführten Options-IDs sind Beispiele.

Ergebnis	Bedeutung
Selected Option Id	Stabile ID der gewählten Antwort; sie ist vom sichtbaren Label und vom fachlichen Textwert getrennt. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Selected Label	Sichtbarer Text der gewählten Antwort, geeignet für eine verständliche Rückmeldung. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Selected Value	Weitergereichter fachlicher Textwert der Antwort, geeignet für nachfolgende Vergleiche. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Selected Index	Index der gewählten Antwort, nullbasiert. Vor Verwendung was_cancelled prüfen. Einzelwert dieses Ergebnisses.
Was Cancelled	Ob der Benutzer das Auswahlfenster ohne Antwort abgebrochen hat. Dies allein bedeutet nicht, dass der komplette Job gestoppt wurde. Einzelwert dieses Ergebnisses.

Beispiel

Zwei Antworten: ID rechnung, Label Rechnungen, Wert rechnung sowie ID notiz, Label Notizen, Wert notiz. Der Wenn-Step verwendet selected_value.

Vorbereitete Beispielabläufe ansehen

Fehler und Hinweise

Abbrechen der Auswahl ist von Stoppen des ganzen Jobs zu unterscheiden. Prüfe was_cancelled, bevor du selected_value verwendest. Ungültige, doppelte oder zu wenige/zu viele Antworten werden bei der Konfiguration zurückgewiesen.

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

Felder und Zusammenhänge auf einen Blick

1
Überschrift (optional)title · Text · Leerer Text
Sichtbare Überschrift der Auswahl beziehungsweise Gruppentitel
2
Titel (optional)question · MultilineText · Leerer Text
Fragetext der Benutzerauswahl
3
Beschreibung (optional)description · MultilineText · Leerer Text
Zusätzliche Beschreibung für Menschen; sie ist kein auszuführender Befehl.
4
Monitordesktop_index · Integer · 0
Nullbasierter Zielmonitor der Desktop-Anzeige oder Benutzerauswahl
5
Antwortmöglichkeiten (2 bis 18, verpflichtend)options · Collection · Nicht angegeben
Lege zwei bis achtzehn Antworten an
6
Selected Option IdErgebnis: selected_option_id · Wert
Stabile ID der gewählten Antwort; sie ist vom sichtbaren Label und vom fachlichen Textwert getrennt
7
Selected LabelErgebnis: selected_label · Wert
Sichtbarer Text der gewählten Antwort, geeignet für eine verständliche Rückmeldung
8
Selected ValueErgebnis: selected_value · Wert
Weitergereichter fachlicher Textwert der Antwort, geeignet für nachfolgende Vergleiche
9
Selected IndexErgebnis: selected_index · Wert
Index der gewählten Antwort, nullbasiert
10
Was CancelledErgebnis: was_cancelled · Wert
Ob der Benutzer das Auswahlfenster ohne Antwort abgebrochen hat

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
Überschrift (optional) `title`	`Text`	`Leerer Text`	Regeln siehe Erklärung	Sichtbare Überschrift der Auswahl beziehungsweise Gruppentitel. Sie ist keine technische Identität.
Titel (optional) `question`	`MultilineText`	`Leerer Text`	Regeln siehe Erklärung	Fragetext der Benutzerauswahl. Formuliere ihn so, dass die angebotenen Antworten eine eindeutige Entscheidung ermöglichen.
Beschreibung (optional) `description`	`MultilineText`	`Leerer Text`	Regeln siehe Erklärung	Zusätzliche Beschreibung für Menschen; sie ist kein auszuführender Befehl.
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.
Antwortmöglichkeiten (2 bis 18, verpflichtend) `options`	`Collection`	`Nicht angegeben`	Pflichtfeld Grenzen: `{"MinimumLength": 2, "MaximumLength": 18}`	Lege zwei bis achtzehn Antworten an. Jede Antwort benötigt einen sichtbaren Antworttext. Ein optionaler Rückgabewert ermöglicht stabile Bedingungen; bleibt er leer, wird der Antworttext zurückgegeben. Die interne ID bleibt beim Umbenennen oder Umordnen erhalten.

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`	`UserChoiceSettings`	`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.description`	`String`	`Leerer Text`	Zusätzliche Beschreibung für Menschen; sie ist kein auszuführender Befehl.
`settings.desktopIndex`	`Int32`	`0`	Nullbasierter Monitorindex dieser Konfiguration; die Monitorreihenfolge ist rechnerabhängig.
`settings.options`	List`1	`Nicht angegeben`	Antwortliste mit zwei bis achtzehn Einträgen. Jeder Eintrag benötigt stabile ID, sichtbares Label und einen weitergereichten Textwert.
`settings.options.id`	`String`	`Nicht angegeben`	Eindeutige, stabile ID dieser Antwort innerhalb der Antwortliste. Über diese ID können nachfolgende Steps die gewählte Option erkennen. Beim Umbenennen der Beschriftung die ID beibehalten.
`settings.options.label`	`String`	`Nicht angegeben`	Für Menschen sichtbarer Antworttext. Verwende value für stabile fachliche Vergleiche, wenn das Label später umformuliert werden soll.
`settings.options.value`	`String`	`Nicht angegeben`	Optionaler Textwert, der bei Auswahl dieser Antwort weitergereicht wird, zum Beispiel „yes“. Leer verwendet den Antworttext. Mit einem stabilen Rückgabewert funktionieren Bedingungen auch nach einer Änderung der sichtbaren Beschriftung.
`settings.question`	`String`	`Leerer Text`	Fragetext der Benutzerauswahl. Formuliere ihn so, dass die angebotenen Antworten eine eindeutige Entscheidung ermöglichen.
`settings.title`	`String`	`Leerer Text`	Sichtbare Überschrift der Auswahl beziehungsweise Gruppentitel. Sie ist keine technische Identität.

Ergebnisvertrag

Antwort-IDs hängen von deiner Benutzerauswahl ab. Die hier aufgeführten Options-IDs sind Beispiele.

Ergebnis	Typ / Optionen	Anzahl	Erklärung
`selected_option_id`	`Enum` `["example-option-0", "example-option-1"]`	`OptionalSingle`	Stabile ID der gewählten Antwort; sie ist vom sichtbaren Label und vom fachlichen Textwert getrennt. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden. `example-option-0` Beispielhafte Antwort-ID einer Benutzerauswahl; bei eigener Antwortliste entstehen deren eigene stabile IDs. Der zugehörige Wert beschreibt nur diese Option. `example-option-1` Beispielhafte Antwort-ID einer Benutzerauswahl; bei eigener Antwortliste entstehen deren eigene stabile IDs. Der zugehörige Wert beschreibt nur diese Option.
`selected_label`	`Text`	`OptionalSingle`	Sichtbarer Text der gewählten Antwort, geeignet für eine verständliche Rückmeldung. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`selected_value`	`Text`	`OptionalSingle`	Weitergereichter fachlicher Textwert der Antwort, geeignet für nachfolgende Vergleiche. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`selected_index`	`Integer`	`Single`	Index der gewählten Antwort, nullbasiert. Vor Verwendung was_cancelled prüfen. Einzelwert dieses Ergebnisses.
`was_cancelled`	`Boolean`	`Single`	Ob der Benutzer das Auswahlfenster ohne Antwort abgebrochen hat. Dies allein bedeutet nicht, dass der komplette Job gestoppt wurde. 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": "user_choice",
  "settings": {
    "title": "",
    "question": "",
    "description": "",
    "desktopIndex": 0,
    "options": [
      {
        "id": "c4de30c6-f016-2700-00a7-c656a7abcf11",
        "label": "",
        "value": ""
      },
      {
        "id": "5c562fe4-9360-401a-e540-39a24df5f2aa",
        "label": "",
        "value": ""
      }
    ]
  },
  "id": "50a7ffc1-3f4c-06a1-4d31-b5461fe898cb",
  "inputs": {},
  "is_enabled": true
}