Vorschau · Entwicklungsstand 1.6.1
Wenn

- 1Bedingungen
Geordnete Bedingungsliste des Wenn-Zweigs. Jede Bedingung benötigt eine passende Ergebnisquelle und den gewählten Operator.
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?
Beginne einen bedingten Block und wähle Ergebniswert, Operator und gegebenenfalls Vergleichswert. „Alle“ verknüpft Bedingungen mit UND, „Mindestens eine“ mit ODER. Bedingungen verwenden typisierte Werte; ein noch nicht ausgeführter oder inkompatibler Quell-Step darf nicht als vorhandenes Ergebnis angenommen werden.
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 |
|---|---|---|
| Bedingungen | Geordnete Bedingungsliste des Wenn-Zweigs. Jede Bedingung benötigt eine passende Ergebnisquelle und den gewählten Operator. | Rückgabewert der Antwort = yes |
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 |
|---|---|---|
| Bedingungen › Vergleich › Kind | Literal verwendet den direkt konfigurierten Vergleichswert; JobResult verwendet die zweite typisierte Ergebnisreferenz. Dieses Enum ist kein type/$type-Discriminator.
| Literal |
| Bedingungen › Vergleich › Wert | Gespeicherter Literal- oder Vergleichswert. Sein JSON-Typ muss zum angegebenen value_kind und zur Kardinalität passen; Zahlen und Booleans nicht versehentlich als Text speichern. | yes |
| Bedingungen › Vergleichswert | Direkt eingetragener Vergleichswert. Sein Typ muss zum linken Ergebnis und Operator passen. | yes |
| Bedingungen › Operator | Vergleichsoperator. Wahrheits-/Leerheitsprüfungen benötigen keinen zusätzlichen Vergleichstext; andere Operatoren verlangen kompatible Werte.
| IsTrue |
Beispiel
Der Beispieljob „Arbeitsunterlagen vorbereiten“ vergleicht selected_value mit „rechnung“ und führt nur den passenden Kopierzweig aus.
Vorbereitete Beispielabläufe ansehenFehler und Hinweise
Ungültige Ergebnisreferenzen, inkompatible Vergleichstypen und unvollständige Blockstruktur werden zurückgewiesen. Rohwerte und Secrets gehören nicht in Diagnosemeldungen; der Verlauf beschreibt Operator und Entscheidungsstatus.
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: if
- 1Bedingungenconditions · Object · {"match_mode": "All", "conditions": []}
Geordnete Bedingungsliste des Wenn-Zweigs
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 |
|---|---|---|---|---|
Bedingungenconditions | Object | {"match_mode": "All", "conditions": []} | Pflichtfeld | Geordnete Bedingungsliste des Wenn-Zweigs. Jede Bedingung benötigt eine passende Ergebnisquelle und den gewählten Operator. |
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 | IfConditionSettings | 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.conditions | List`1 | Nicht angegeben | Geordnete Bedingungsliste des Wenn-Zweigs. Jede Bedingung benötigt eine passende Ergebnisquelle und den gewählten Operator. |
settings.conditions.comparison | ComparisonOperand | Nicht angegeben | Rechte Seite des Vergleichs: Literal oder ein weiteres Job-Ergebnis, abhängig von kind. |
settings.conditions.comparison.items | List`1 | Nicht angegeben | Geordnete Unterbindungen einer Liste. Die Reihenfolge ist Teil der Eingabe; Elemente müssen das Listenelement-Schema erfüllen. |
settings.conditions.comparison.items.items | List`1 | Nicht angegeben | Geordnete Unterbindungen einer Liste. Die Reihenfolge ist Teil der Eingabe; Elemente müssen das Listenelement-Schema erfüllen. |
settings.conditions.comparison.items.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.conditions.comparison.items.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.conditions.comparison.items.source_step_id | String | Nicht angegeben | Kompatibilitätsfeld älterer Referenzen. Neue Referenzen verwenden provider_id=step_result und die versionierte source_id. |
settings.conditions.comparison.items.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.conditions.comparison.items.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.conditions.comparison.items.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.conditions.comparison.items.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.conditions.comparison.items.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.conditions.comparison.kind | ComparisonOperandKind | Nicht angegeben["Literal", "JobResult"] | Literal verwendet den direkt konfigurierten Vergleichswert; JobResult verwendet die zweite typisierte Ergebnisreferenz. Dieses Enum ist kein type/$type-Discriminator. |
settings.conditions.comparison.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.conditions.comparison.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.conditions.comparison.source_step_id | String | Nicht angegeben | Kompatibilitätsfeld älterer Referenzen. Neue Referenzen verwenden provider_id=step_result und die versionierte source_id. |
settings.conditions.comparison.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.conditions.comparison.members.items | List`1 | Nicht angegeben | Geordnete Unterbindungen einer Liste. Die Reihenfolge ist Teil der Eingabe; Elemente müssen das Listenelement-Schema erfüllen. |
settings.conditions.comparison.members.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.conditions.comparison.members.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.conditions.comparison.members.source_step_id | String | Nicht angegeben | Kompatibilitätsfeld älterer Referenzen. Neue Referenzen verwenden provider_id=step_result und die versionierte source_id. |
settings.conditions.comparison.members.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.conditions.comparison.members.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.conditions.comparison.members.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.conditions.comparison.members.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.conditions.comparison.members.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.conditions.comparison.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.conditions.comparison.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.conditions.comparison.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.conditions.comparison.value | String | Nicht angegeben | Gespeicherter Literal- oder Vergleichswert. Sein JSON-Typ muss zum angegebenen value_kind und zur Kardinalität passen; Zahlen und Booleans nicht versehentlich als Text speichern. |
settings.conditions.comparison.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.conditions.comparison_value | String | Nicht angegeben | Direkt eingetragener Vergleichswert. Sein Typ muss zum linken Ergebnis und Operator passen. |
settings.conditions.items | List`1 | Nicht angegeben | Geordnete Unterbindungen einer Liste. Die Reihenfolge ist Teil der Eingabe; Elemente müssen das Listenelement-Schema erfüllen. |
settings.conditions.items.items | List`1 | Nicht angegeben | Geordnete Unterbindungen einer Liste. Die Reihenfolge ist Teil der Eingabe; Elemente müssen das Listenelement-Schema erfüllen. |
settings.conditions.items.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.conditions.items.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.conditions.items.source_step_id | String | Nicht angegeben | Kompatibilitätsfeld älterer Referenzen. Neue Referenzen verwenden provider_id=step_result und die versionierte source_id. |
settings.conditions.items.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.conditions.items.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.conditions.items.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.conditions.items.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.conditions.items.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.conditions.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.conditions.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.conditions.source_step_id | String | Nicht angegeben | Kompatibilitätsfeld älterer Referenzen. Neue Referenzen verwenden provider_id=step_result und die versionierte source_id. |
settings.conditions.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.conditions.members.items | List`1 | Nicht angegeben | Geordnete Unterbindungen einer Liste. Die Reihenfolge ist Teil der Eingabe; Elemente müssen das Listenelement-Schema erfüllen. |
settings.conditions.members.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.conditions.members.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.conditions.members.source_step_id | String | Nicht angegeben | Kompatibilitätsfeld älterer Referenzen. Neue Referenzen verwenden provider_id=step_result und die versionierte source_id. |
settings.conditions.members.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.conditions.members.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.conditions.members.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.conditions.members.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.conditions.members.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.conditions.operator | ConditionOperator | Nicht angegeben["IsTrue", "IsFalse", "Equals", "NotEquals", "GreaterThan", "LessThan", "GreaterThanOrEqual", "LessThanOrEqual", "Contains", "StartsWith", "IsEmpty", "IsNotEmpty"] | Vergleichsoperator. Wahrheits-/Leerheitsprüfungen benötigen keinen zusätzlichen Vergleichstext; andere Operatoren verlangen kompatible Werte.
|
settings.conditions.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.conditions.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.conditions.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.conditions.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.match_mode | ConditionMatchMode | All["All", "Any"] | All verlangt alle Bedingungen; Any lässt eine passende Bedingung genügen. |
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": "if",
"settings": {
"match_mode": "All",
"conditions": []
},
"CanBeDisabled": false,
"id": "d63699e5-2497-796d-bcbd-666b1c4a79ab",
"inputs": {},
"is_enabled": true
}