Formaatreferentie

Expression-placeholders

Het geïnline’de resultaat moet een geldige Mendix microflow/nanoflow boolean expression zijn (Exclusive Split expression-conditie). TBT compile-checkt dit niet verder dan stringsubstitutie.

Lege waarden: gegenereerde flows voeren de expressie ongewijzigd uit, ook als het attribuut leeg is. Schrijf $Value = empty or ..., tenzij de regel lege waarden juist moet afkeuren (bijvoorbeeld een "niet leeg"-regel).

Literal-opmaak bij substitutie van `$ParamName`:

Message-placeholders

`serverOnly`

• `false` (default): beschikbaar voor zowel Validate… (microflow) als DTO… attribuut-nanoflow-paden.
• `true`: blijft opgenomen in de Validate…-microflow-presetlijst (includeServerOnly: true). Op het DTO-nano-pad worden expressions met serverOnly: true uitgesloten (includeServerOnly: false). Bijgehouden als overgeslagen document-ids bij nano-copy.

Matching op `appliesTo`

Een preset wordt aangeboden voor een attribuut wanneer appliesTo het attribuuttype bevat, of het attribuut HashedString is en appliesTo String bevat.

Auto-select via `defaultForAttributes`

Wanneer Validate/DTO een attribuut toevoegt dat nog geen rules heeft, zoekt TBT expression-presets waarvan defaultForAttributes de attribuutnaam bevat (case-insensitive exact). Bij meerdere matches wint die met de kleinste label via localeCompare.

Voorbeeld A — eenvoudig (geen params)

Editor

Opgeslagen JSON

{
  "schemaVersion": 1,
  "label": "Not blank",
  "documentation": "Trimmed string must not be empty",
  "appliesTo": ["String"],
  "serverOnly": false,
  "defaultForAttributes": [],
  "params": [],
  "expression": "trim($Value) != ''",
  "message": "{AttributeName} must not be blank"
}

Voor attribuut Name op entity Person inline’t generate naar trim($Person/Name) != '' en message Name must not be blank.

Voorbeeld B — realistisch met params + operators

Editor

Opgeslagen JSON

{
  "schemaVersion": 1,
  "label": "Range",
  "documentation": "Inclusive/exclusive bounds via operators",
  "appliesTo": ["Integer", "Long", "Decimal"],
  "serverOnly": false,
  "defaultForAttributes": ["Age"],
  "params": [
    {
      "name": "Lower",
      "type": "Integer",
      "required": true,
      "default": 0,
      "operator": { "options": [">=", ">"], "default": ">=" }
    },
    {
      "name": "Upper",
      "type": "Integer",
      "required": true,
      "default": 100,
      "operator": { "options": ["<=", "<"], "default": "<=" }
    }
  ],
  "expression": "$Value = empty or ($Value {Lower.operator} $Lower and $Value {Upper.operator} $Upper)",
  "message": "{AttributeName} must be between {Lower} and {Upper}"
}

Met gebruik Lower=18/>=, Upper=65/<= op $Order/Age → $Order/Age = empty or ($Order/Age >= 18 and $Order/Age <= 65), message Age must be between 18 and 65.

Voorbeeld C — server-only

Zelfde als voorbeeld A maar Server-only aangevinkt → "serverOnly": true. Aangeboden in Validate…; weggelaten uit DTO…-nanoflow-expression-presets.

`name`

Wordt geëmit als de attribuutnaam op de doelentity. Dezelfde string is de catalogus-override-key.

`type` / `length` / `defaultValue`

• length alleen toegepast wanneer type String is (0 = unlimited in Mendix).
• defaultValue geschreven op DomainModels$StoredValue.defaultValue als de string die je invoerde (Boolean-voorbeelden in de seed gebruiken "true"; Decimal gebruikt "0").

`required`

Indien true (en niet calculated) voegt TBT na het aanmaken van het attribuut best-effort een Required-validatieregel toe (DomainModels$RequiredRuleInfo) met fouttekst:

{AttributeName} is required.

Bestaat er al een Required-regel voor dat attribuut, dan blijft die staan. Fouten worden gelogd; attribuut-emit slaagt alsnog.

`calculated`

Indien true:

1. Zorgt voor microflow CAL_{entity}_{attribute} onder map Model/{entity}/Private (map-/naamsjablonen zijn via settings overschrijfbaar; pattern-id cal).
2. Stub End-return: '' / false / empty / 0 per type (Long-returntype wordt Integer in de Microflow-API).
3. Attribuutwaarde = CalculatedValue met die microflow, passEntity: true.
4. Als pattern cal uitstaat in Settings → emit-fout: Calculated attributes are disabled in Settings (pattern cal).
5. Bestaande microflow met die naam → hergebruiken (niet opnieuw aanmaken).

Tags / aliases / `defaultForEntities`

• Picker-zoekscore: name (exact 100, prefix 80, contains 60), daarna aliases (55/45), daarna tags (30).
• Als de doelentitynaam matcht met defaultForEntities (case-insensitive exact), krijgt de score +15 (softBoost). Presets worden nooit verborgen alleen omdat de entity niet matcht.

Voorbeeld A — eenvoudige Boolean

Editor: Name Active; Type Boolean; Default value true; Tags status; Aliases IsActive, Enabled.

{
  "schemaVersion": 1,
  "name": "Active",
  "type": "Boolean",
  "defaultValue": "true",
  "tags": ["status"],
  "defaultForEntities": [],
  "aliases": ["IsActive", "Enabled"]
}

Voorbeeld B — realistische String (geseede Email)

Editor: Name Email; Type String; Length 254; Required uit; Tags contact; Default for entity names Person, Customer, User, Contact; Aliases EmailAddress.

{
  "schemaVersion": 1,
  "name": "Email",
  "type": "String",
  "length": 254,
  "required": false,
  "tags": ["contact"],
  "defaultForEntities": ["Person", "Customer", "User", "Contact"],
  "aliases": ["EmailAddress"]
}

Voorbeeld C — calculated

Editor: Name Total; Type Decimal; Calculated aan (Default value / Required verborgen).

{
  "schemaVersion": 1,
  "name": "Total",
  "type": "Decimal",
  "calculated": true,
  "tags": [],
  "defaultForEntities": [],
  "aliases": []
}

Op entity Order maakt dit attribuut Total (calculated) en microflow Order.CAL_Order_Total onder Model/Order/Private (stub die 0 teruggeeft), tenzij pattern cal is uitgeschakeld.