3.6 Operatoren
3.6 Operatoren
Der operator eines Knotens bestimmt, wie die Ergebnisse ALLER seiner direkten Kinder aggregiert
werden.
| Operator | Beschreibung | Details |
|---|---|---|
AND / NOT_AND | Konjunktion und negierte Konjunktion | 3.6.1 |
OR / NOT_OR | Disjunktion und negierte Disjunktion | 3.6.2 |
XOR / NOT_XOR | Disjunktion und negierte Disjunktion mit Short-Circuit | 3.6.3 |
DELEGATED | Verknüpfung durch eine im Knoten hinterlegte Capability | 3.6.4 |
undefined | Noch nicht definiert (Draft-Status) | 3.6.5 |
Auswertungsmodus
Eine Rulemap wird in einem von zwei Modi ausgewertet:
optimized: Short-Circuit-Regeln abhängig vom Operator anwendencomplete: jeden Child-Node ohne Short-Circuit auswerten
Leaf-Nodes
Ein Leaf-Node hat nichts zu verknüpfen. Außerhalb eines Entwurfs DARF er KEINEN operator
haben; in einem Entwurf (metadata.status: "draft") DARF er jeden der Operatoren haben,
einschließlich DELEGATED und undefined, und ein Evaluator ignoriert ihn (Regel NODE-07NODE-07 Ein Parser MUSS die optionalen Knotenfelder aus 3.5.3 akzeptieren, ob vorhanden oder nicht, außer operator an einem Leaf-Node: Ein Leaf-Node DARF KEINEN operator haben, außer metadata.status ist draft; in einem Entwurf MUSS ein Parser jeden der acht Operatoren aus 3.6 an einem Leaf-Node akzeptieren.). Das
Ergebnis eines Leaf-Nodes wird durch seine Capabilities bestimmt (siehe Kapitel
4).
3.6.1 AND und NOT_AND
Im Modus optimized MUSS der Evaluator die Ergebnisse der Child-Nodes nacheinander prüfen.
- Liefert ein Child-Node
false, MUSS sofortfalsegeliefert werden. Nicht geprüfte Child-Nodes MÜSSEN im RUML-Result aufignoredgesetzt werden. - Liefert ein Child-Node
undefined, MUSS sofortundefinedgeliefert werden. Nicht geprüfte Child-Nodes MÜSSEN im RUML-Result aufignoredgesetzt werden. - Liefern alle Child-Nodes
true, MUSStruegeliefert werden.
Im Modus complete MUSS der Evaluator alle Ergebnisse der Kinder gemeinsam in folgender
Reihenfolge prüfen:
- Hat ein Kind
falseergeben, MUSSfalsegeliefert werden - Hat ein Kind
undefinedergeben, MUSSundefinedgeliefert werden - Haben alle Child-Nodes
trueergeben, MUSStruegeliefert werden
NOT_AND MUSS dieselbe Logik anwenden, aber true liefern, wo AND false liefern würde,
und umgekehrt.
3.6.2 OR und NOT_OR
In den Modi optimized und complete MUSS der Evaluator alle Ergebnisse der Kinder gemeinsam
in folgender Reihenfolge prüfen:
- Hat ein Kind
trueergeben, MUSStruegeliefert werden. - Hat ein Kind
undefinedergeben, MUSSundefinedgeliefert werden. - Haben alle Child-Nodes
falseergeben, MUSSfalsegeliefert werden.
NOT_OR MUSS dieselbe Logik anwenden, aber true liefern, wo OR false liefern würde,
und umgekehrt.
3.6.3 XOR und NOT_XOR
XOR bezeichnet nicht das logische Exklusiv-Oder (bei dem zwei true-Eingaben false ergeben),
sondern das juristische XOR: Die Child-Nodes sind bewusst so konstruiert, dass nur einer true
sein kann. Der Evaluator verhält sich wie eine Disjunktion (OR) mit vorzeitigem Abbruch beim
ersten true.
Im Modus optimized MUSS der Evaluator die Ergebnisse der Child-Nodes nacheinander prüfen.
- Liefert ein Child-Node
true, MUSS soforttruegeliefert werden. Nicht geprüfte Child-Nodes MÜSSEN im RUML-Result aufignoredgesetzt werden. - Liefert ein Child-Node
undefined, MUSS sofortundefinedgeliefert werden. Nicht geprüfte Child-Nodes MÜSSEN im RUML-Result aufignoredgesetzt werden. - Liefern alle Child-Nodes
false, MUSSfalsegeliefert werden.
Im Modus complete MUSS der Evaluator alle Ergebnisse der Kinder gemeinsam in folgender
Reihenfolge prüfen:
- Hat ein Kind
trueergeben, MUSStruegeliefert werden. - Hat ein Kind
undefinedergeben, MUSSundefinedgeliefert werden. - Haben alle Child-Nodes
falseergeben, MUSSfalsegeliefert werden.
NOT_XOR MUSS dieselbe Logik anwenden, aber true liefern, wo XOR false liefern würde,
und umgekehrt.
3.6.4 Der Operator DELEGATED
Der Operator DELEGATED berechnet das Ergebnis aus den Ergebnissen der Child-Nodes mithilfe einer
Capability.
Er kann für Verknüpfungen verwendet werden, die die logischen Operatoren nicht ausdrücken können, insbesondere Schwellenwertregeln („mindestens drei der folgenden Merkmale”), Toleranzregeln („höchstens eine Voraussetzung darf fehlen”), Mehrheits- und Quorumsregeln sowie Regeln, die ein einzelnes Kind negieren statt des ganzen Knotens.
Bindung an einen Kombinierer
Die Regel selbst wird von einem Kombinierer getragen — einer Capability am Knoten, die dessen
Status aus den Ergebnissen seiner Kinder bestimmt. Der offizielle Kombinierer ist ruml:expression
(siehe Kapitel 4.14); ein nicht-offizieller kann
ebenfalls verwendet werden (siehe Eigene Kombinierer weiter unten).
Ein Parent-Node führt einen Kombinierer genau dann, wenn sein Operator DELEGATED ist:
- Außerhalb eines Entwurfs MUSS ein Knoten mit
operator: "DELEGATED"ein nicht-leereschildren-Array besitzen; ein Knoten mitoperator: "DELEGATED"undchildrenMUSS genau einen Capability-Eintrag führen, dessen Capability die Rollecombinerhat (RegelOP-02) (Regel OP-02OP-02 Außerhalb eines Entwurfs MUSS ein Knoten mitoperator: "DELEGATED"childrenhaben. Ein Knoten mitoperator: "DELEGATED"undchildrenMUSS genau einen Eintrag einer Capability mit der Rollecombinerhaben; bei einerruml:draft/- oder Reverse-Domain-Capability gilt die auf Root-Level deklarierte Rolle. In einem Entwurf MUSS ein Parser diesen Operator an einem Leaf-Node ohne Kombinierer akzeptieren (NODE-07).). In einem Entwurf DARF ein Leaf-Nodeoperator: "DELEGATED"ohne Kombinierer haben; der Operator wird wie jeder Operator an einem Leaf-Node ignoriert (Regel NODE-07NODE-07 Ein Parser MUSS die optionalen Knotenfelder aus 3.5.3 akzeptieren, ob vorhanden oder nicht, außeroperatoran einem Leaf-Node: Ein Leaf-Node DARF KEINENoperatorhaben, außermetadata.statusistdraft; in einem Entwurf MUSS ein Parser jeden der acht Operatoren aus 3.6 an einem Leaf-Node akzeptieren.). - Ein Knoten mit einem Kombinierer-Eintrag MUSS
operator: "DELEGATED"verwenden (RegelCAP-08) (Regel CAP-08CAP-08 Ein Eintrag einer Capability mit der RollecombinerDARF NICHT an einem Knoten vorkommen, dessenoperatornichtDELEGATEDist.). Ein Kombinierer steht daher nie an einem Leaf-Node und nie an einem Knoten mit logischem Operator.
Keine der beiden Hälften ist für sich gültig. Ein Werkzeug, das den Kombinierer nicht kennt, kann einen solchen Knoten daher nicht für einen logischen halten: Der Operator ist ihm unbekannt und die Datei wird abgelehnt.
Ausnahme von der Leaf-Beschränkung
Ein Kombinierer trägt die Rolle combiner, nicht decision, und ist die einzige Art von
Capability, die einen Knoten mit Kindern entscheidet. Die Beschränkung in
Kapitel 4.1 — Decision-Capabilities nur auf Leaf-Knoten — gilt
ruml:query und ruml:ai-query, die einen Knoten anstelle seiner Kinder entscheiden. Ein
Kombinierer entscheidet einen Knoten aus seinen Kindern und setzt sie deshalb voraus.
Der Kombinierer-Vertrag
Der Operator delegiert die Verknüpfungsregel, nicht die Zusicherungen, die eine Rulemap prüfbar machen. Jeder Kombinierer, offiziell oder nicht, MUSS:
true,falseoder kein Ergebnis liefern — niemals eine Zahl, eine Zeichenkette oder eine Struktur. Jedes andere Ergebnis MUSS den Statusundefinedergeben.- In seinem Payload auf Node-Level eine lesbare
descriptionführen, die die Regel in Prosa benennt. Der OperatorDELEGATEDsagt nicht, was der Knoten tut; ohne diese Angabe ist die Rulemap nicht prüfbar, ohne Code zu lesen (RegelOP-04) (Regel OP-04OP-04 Die Node-Level-Payload eines Kombinierers MUSS eine nicht-leeredescriptionin Prosa haben.). - Ohne Auswertung
undefinedergeben, sobald ein Kindundefinedist; JSONata ist zweiwertig und würde ein solches Kind sonst als nicht erfüllt zählen, sodass eine Schwellenwertregel bestimmt aussähe, obwohl sie es nicht ist. - Alle Kinder verbrauchen: Der Operator DARF NICHT short-circuiten (Regel
OP-03) (Regel OP-03OP-03 Ein Evaluator DARF einen Knoten mitoperator: "DELEGATED"NICHT short-circuiten; er wertet jedes Kind aus, bevor der Kombinierer läuft.).
Ein Kombinierer SOLLTE deterministisch und aus denselben Eingaben reproduzierbar sein. Er
DARF nicht-deterministische Eingaben verwenden, etwa eine Zufallszahl oder die aktuelle Zeit
(Regel OP-05OP-05 Ein Parser MUSS einen Kombinierer akzeptieren, der nicht-deterministische Eingaben verwendet, einschließlich einer ruml:expression, die $random, $now, $millis oder $eval aufruft.); dann SOLLTE er die gezogenen Werte im Knotenergebnis festhalten.
Ein Kombinierer SOLLTE im Knotenergebnis festhalten, was er gesehen hat — mindestens die verbrauchten Kind-Status, alle gelesenen DataPoint-Werte und den berechneten Wert —, damit die Entscheidung allein aus der RUML-Result-Datei nachvollzogen werden kann.
Die Rolle einer Capability sagt, wo sie stehen darf; dieser Vertrag sagt, was sie leisten muss, um dort zu stehen. Zusammen sind sie, was einen Kombinierer ausmacht; RUML definiert keinen eigenen Capability-Typ.
Eigene Kombinierer
Jede Capability mit der Rolle combiner DARF als Kombinierer auftreten, auch eine fremde nach
der Reverse-Domain-Konvention (siehe Kapitel 4.4)
(Regel OP-06OP-06 Ein Parser MUSS jede auf Root-Level mit der Rolle combiner deklarierte Capability, auch eine Reverse-Domain-Capability, als Kombinierer eines DELEGATED-Knotens akzeptieren.):
"capabilities": [ { "id": "com.example/expression", "required": true, "role": "combiner" }]Ob eine eigene Capability ein Kombinierer ist, legen Parser und Evaluator fest, die sie
implementieren. Ihr Eintrag auf Root-Level MUSS die Rolle combiner deklarieren (Regeln
CAP-03, OP-02); ein Parser, der die Capability implementiert, gleicht die deklarierte Rolle mit
seiner Implementierung ab (Regel CAP-04) (Regel CAP-03CAP-03 Der Root-Eintrag einer ruml:draft/- oder Reverse-Domain-Capability MUSS role deklarieren., Regel OP-02OP-02 Außerhalb eines Entwurfs MUSS ein Knoten mit operator: "DELEGATED" children haben. Ein Knoten mit operator: "DELEGATED" und children MUSS genau einen Eintrag einer Capability mit der Rolle combiner haben; bei einer ruml:draft/- oder Reverse-Domain-Capability gilt die auf Root-Level deklarierte Rolle. In einem Entwurf MUSS ein Parser diesen Operator an einem Leaf-Node ohne Kombinierer akzeptieren (NODE-07)., Regel CAP-04CAP-04 Ein Parser, der eine ruml:draft/- oder Reverse-Domain-Capability implementiert, MUSS die Datei ablehnen, wenn die deklarierte role von der Rolle abweicht, die er implementiert.). Zu den
Rollen und zum Unterschied zwischen combiner und decision siehe
Kapitel 4.1.
required: true ist das, was Regel CAP-01 dazu bringt, die Datei in einem Werkzeug abzulehnen,
das den Kombinierer nicht implementiert, statt einen Knoten mit einem Operator ohne dahinterliegende
Regel zu hinterlassen.
Ein eigener Kombinierer macht die Rulemap nicht portabel
Eine unbekannte Decision-Capability an einem Blatt lässt ein Blatt undefined, während die übrige
Rulemap weiter ausgewertet wird. Ein unbekannter Kombinierer, der wie vorgeschrieben
required: true deklariert ist, führt zur Ablehnung des gesamten Dokuments. Eine Rulemap mit einem
nicht-ruml:-Kombinierer ist daher nur von Werkzeugen lesbar, die ihn implementieren. Die Menge der
offiziellen Kombinierer wächst durch Revision dieser Spezifikation; ein proprietärer Kombinierer ist
ein bewusster Tausch von Portabilität gegen Ausdrucksstärke.
Was der Ausdruck sieht
Der Ausdruck wird gegen dasselbe Eingabedokument ausgewertet wie ein Ausdruck von ruml:query;
DataPoints werden also über ihre ID angesprochen (dp_alter). Zusätzlich sind die Ergebnisse der
direkten Kinder des Knotens an die Variable $children gebunden:
| Feld | Typ | Beschreibung |
|---|---|---|
lexId | String | Die lexId des Kindes |
label | String | Das Label des Kindes |
status | String | Der Status des Kindes: "true" oder "false" — ist ein Kind undefined, läuft der Ausdruck nicht |
Das Array folgt der Reihenfolge von children. Sichtbar sind ausschließlich direkte Kinder; ein
tiefer liegendes Ergebnis wird erreicht, indem der dazwischenliegende Knoten seinerseits seine
Kinder verknüpft.
Auswertungsregeln
- Der Operator DARF NICHT short-circuiten. Alle Kinder MÜSSEN vor der Auswertung des
Ausdrucks ausgewertet werden, und ein Knoten mit
operator: "DELEGATED"DARF NICHT dazu führen, dass ein Kind den Statusignoredmitreason.type: "shortCircuit"erhält (Regel OP-03OP-03 Ein Evaluator DARF einen Knoten mitoperator: "DELEGATED"NICHT short-circuiten; er wertet jedes Kind aus, bevor der Kombinierer läuft.). Eine Zählung über nur teilweise ausgewertete Kinder wäre nicht bloß unvollständig, sondern falsch. - Der Ausdruck MUSS zu einem Boolean auswerten. Jedes andere Ergebnis — auch das Ausbleiben
eines Ergebnisses — MUSS den Status
undefinedergeben, mit einer Begründung vom Typdefault, derenmessageden beanstandeten Wert benennen SOLLTE. - Ausdrücke SOLLTEN deterministisch sein. Die nicht-deterministischen JSONata-Funktionen
$random,$nowund$millissowie$evalDÜRFEN verwendet werden; ein Ausdruck, der sie verwendet, ist aus denselben Eingaben nicht mehr zwingend reproduzierbar (Regel OP-05OP-05 Ein Parser MUSS einen Kombinierer akzeptieren, der nicht-deterministische Eingaben verwendet, einschließlich einerruml:expression, die$random,$now,$millisoder$evalaufruft.).$evalführt eine Zeichenkette als Ausdruck aus, die angewandte Regel steht dann also nicht notwendig inexpressionselbst — umso mehr Gewicht trägtdescription. - Ein Ausdruck, dessen Ergebnis einem logischen Operator entspricht (etwa
$children[0].status = "true" and $children[1].status = "true"), SOLLTE als Warnung gemeldet werden; der logische Operator ist die prüfbare Form.
Beispiele
Mindestens drei der aufgeführten Merkmale:
"1": { "id": "0eb360a6-626a-406d-89a1-9f434ced141b", "operator": "DELEGATED", "label": "Mindestens drei Merkmale erfüllt", "children": ["3", "4", "5", "6", "7"], "capabilities": [ { "id": "ruml:expression", "payload": { "description": "Mindestens drei der fünf Merkmale müssen erfüllt sein", "expression": "$count($children[status = 'true']) >= 3" } } ]}Höchstens eine Voraussetzung darf fehlen:
"expression": "$count($children[status = 'false']) <= 1"Mehrheit der ausgewerteten Kinder:
"expression": "$count($children[status = 'true']) * 2 > $count($children)"Subsidiarität — das zweite Kind greift nur, wenn das erste nicht greift:
"expression": "$children[0].status = 'false' and $children[1].status = 'true'"Eine Fiktion, die die Kinder insgesamt überspielt:
"expression": "dp_alter >= 65 or $count($children[status = 'true']) = 3"Festhalten des Ergebnisses
Das Knotenergebnis führt den Ausdruck, die von ihm gesehenen Kind-Status und den berechneten Wert mit, sodass die Entscheidung allein aus der RUML-Result-Datei nachvollzogen werden kann — siehe Kapitel 4.14.
3.6.5 Der undefined-Operator
undefined bedeutet, der Operator ist noch nicht definiert. Er DARF während der Erstellung in
Dateien mit Status draft verwendet werden, DARF NICHT in Dateien mit einem anderen Status
verwendet werden und MUSS vor Finalisierung (Status review, approved, inForce) durch einen
gültigen Operator ersetzt werden (Regel OP-07OP-07 operator: "undefined" DARF NICHT vorkommen, außer metadata.status ist draft; in einem Entwurf MUSS ein Parser ihn akzeptieren.). Er ist der Standardwert bei Neuerstellung eines
Knotens. An einem Leaf-Node (ohne children) wird der operator ignoriert; außerhalb eines
Entwurfs DARF ein Leaf-Node überhaupt KEINEN operator haben, undefined an einem
Leaf-Node wird daher entfernt statt ersetzt (Regel NODE-07NODE-07 Ein Parser MUSS die optionalen Knotenfelder aus 3.5.3 akzeptieren, ob vorhanden oder nicht, außer operator an einem Leaf-Node: Ein Leaf-Node DARF KEINEN operator haben, außer metadata.status ist draft; in einem Entwurf MUSS ein Parser jeden der acht Operatoren aus 3.6 an einem Leaf-Node akzeptieren.).
| Status | Regel |
|---|---|
draft | undefined DARF vorkommen (Regel OP-07OP-07 operator: "undefined" DARF NICHT vorkommen, außer metadata.status ist draft; in einem Entwurf MUSS ein Parser ihn akzeptieren.) |
review, approved, inForce, suspended, expired, replaced | undefined DARF NICHT vorkommen → Validierungsfehler (Regel OP-07OP-07 operator: "undefined" DARF NICHT vorkommen, außer metadata.status ist draft; in einem Entwurf MUSS ein Parser ihn akzeptieren.) |
Tools SOLLTEN bei undefined-Operatoren eine Warnung anzeigen. Tools DÜRFEN automatische
Ersetzung durch einen Standard-Operator (z.B. AND) anbieten.