Aller au contenu
SurfaceDocs
ENCommencer
DocsRéférence du Model

managedTypedValue

Propriétés, variantes, types et limites de managedTypedValue.

Cette référence décrit la structure complète de managedTypedValue. Chaque chemin représente une propriété, y compris les objets imbriqués, les éléments de listes et les branches conditionnelles. Une branche identifiée par kind, contract ou mode n’admet que ses propres propriétés.

Structure et valeurs

Champ Options / valeurs attendues Description
[kind=text].kind "text" Requis. Sélectionne la variante et les propriétés admises dans cette branche.
[kind=text].minimumLength integer; ≥ 0; ≤ 1000000 Requis. Borne de cardinalité ou de budget pour la ressource nommée. Les dépassements sont refusés; null signifie une absence de borne uniquement lorsque le schéma l’admet.
[kind=text].maximumLength integer; ≥ 0; ≤ 1000000 Requis. Borne de cardinalité ou de budget pour la ressource nommée. Les dépassements sont refusés; null signifie une absence de borne uniquement lorsque le schéma l’admet.
[kind=boolean].kind "boolean" Requis. Sélectionne la variante et les propriétés admises dans cette branche.
[kind=integer].kind "integer" Requis. Sélectionne la variante et les propriétés admises dans cette branche.
[kind=integer].minimum string; max length 1001; /^(?:0|-?[1-9][0-9]{0,999})(?![\s\S])/u Requis. Borne de cardinalité ou de budget pour la ressource nommée. Les dépassements sont refusés; null signifie une absence de borne uniquement lorsque le schéma l’admet.
[kind=integer].maximum string; max length 1001; /^(?:0|-?[1-9][0-9]{0,999})(?![\s\S])/u Requis. Borne de cardinalité ou de budget pour la ressource nommée. Les dépassements sont refusés; null signifie une absence de borne uniquement lorsque le schéma l’admet.
[kind=integer].unit closed object OR closed object OR closed object Requis. Définit « unit » pour cet objet. Respecter le type, les variantes et les limites de la colonne Options.
[kind=integer].unit.[kind=dimensionless].kind "dimensionless" Requis. Sélectionne la variante et les propriétés admises dans cette branche.
[kind=integer].unit.[kind=unit].kind "unit" Requis. Sélectionne la variante et les propriétés admises dans cette branche.
[kind=integer].unit.[kind=unit].key string; min length 1; max length 120; /^[a-z][a-z0-9-]*$/u Requis. Identifiant sémantique stable utilisé par les références; le modifier change l’identité.
[kind=integer].unit.[kind=currency].kind "currency" Requis. Sélectionne la variante et les propriétés admises dans cette branche.
[kind=integer].unit.[kind=currency].key string; min length 1; max length 120; /^[a-z][a-z0-9-]*$/u Requis. Identifiant sémantique stable utilisé par les références; le modifier change l’identité.
[kind=real].kind "real" Requis. Sélectionne la variante et les propriétés admises dans cette branche.
[kind=real].representation "binary64" Requis. Définit « representation » pour cet objet. Respecter le type, les variantes et les limites de la colonne Options.
[kind=real].precisionBits 53 Requis. Définit « precision Bits » pour cet objet. Respecter le type, les variantes et les limites de la colonne Options.
[kind=real].minimum number Requis. Borne de cardinalité ou de budget pour la ressource nommée. Les dépassements sont refusés; null signifie une absence de borne uniquement lorsque le schéma l’admet.
[kind=real].maximum number Requis. Borne de cardinalité ou de budget pour la ressource nommée. Les dépassements sont refusés; null signifie une absence de borne uniquement lorsque le schéma l’admet.
[kind=real].tolerance closed object Requis. Définit « tolerance » pour cet objet. Respecter le type, les variantes et les limites de la colonne Options.
[kind=real].tolerance.absolute number; ≥ 0 Requis. Définit « absolute » pour cet objet. Respecter le type, les variantes et les limites de la colonne Options.
[kind=real].tolerance.relative number; ≥ 0 Requis. Définit « relative » pour cet objet. Respecter le type, les variantes et les limites de la colonne Options.
[kind=real].unit closed object OR closed object Requis. Définit « unit » pour cet objet. Respecter le type, les variantes et les limites de la colonne Options.
[kind=real].unit.[kind=dimensionless].kind "dimensionless" Requis. Sélectionne la variante et les propriétés admises dans cette branche.
[kind=real].unit.[kind=unit].kind "unit" Requis. Sélectionne la variante et les propriétés admises dans cette branche.
[kind=real].unit.[kind=unit].key string; min length 1; max length 120; /^[a-z][a-z0-9-]*$/u Requis. Identifiant sémantique stable utilisé par les références; le modifier change l’identité.
[kind=choice].kind "choice" Requis. Sélectionne la variante et les propriétés admises dans cette branche.
[kind=choice].labelLocale string; min length 2; max length 100; /^[A-Za-z]{2,8}(?:-[A-Za-z0-9]{1,8})*(?![\s\S])/u Requis. Définit « label Locale » pour cet objet. Respecter le type, les variantes et les limites de la colonne Options.
[kind=choice].choices Array<closed object>; min length 1; max length 1000 Requis. Définit « choices » pour cet objet. Respecter le type, les variantes et les limites de la colonne Options.
[kind=choice].choices[].key string; min length 1; max length 120; /^[a-z][a-z0-9-]*(?![\s\S])/u Requis. Identifiant sémantique stable utilisé par les références; le modifier change l’identité.
[kind=choice].choices[].labels Record<string; min length 2; max length 100; /^[A-Za-z]{2,8}(?:-[A-Za-z0-9]{1,8})*(?![\s\S])/u, string; min length 1; max length 4000> Requis. Définit « labels » pour cet objet. Respecter le type, les variantes et les limites de la colonne Options.
[kind=decimal].precision integer; ≥ 1; ≤ 1000 Requis. Définit « precision » pour cet objet. Respecter le type, les variantes et les limites de la colonne Options.
[kind=decimal].scale integer; ≥ 0; ≤ 1000 Requis. Définit « scale » pour cet objet. Respecter le type, les variantes et les limites de la colonne Options.
[kind=decimal].kind "decimal" Requis. Sélectionne la variante et les propriétés admises dans cette branche.
[kind=decimal].unit closed object OR closed object OR closed object Requis. Définit « unit » pour cet objet. Respecter le type, les variantes et les limites de la colonne Options.
[kind=decimal].unit.[kind=dimensionless].kind "dimensionless" Requis. Sélectionne la variante et les propriétés admises dans cette branche.
[kind=decimal].unit.[kind=unit].kind "unit" Requis. Sélectionne la variante et les propriétés admises dans cette branche.
[kind=decimal].unit.[kind=unit].key string; min length 1; max length 120; /^[a-z][a-z0-9-]*$/u Requis. Identifiant sémantique stable utilisé par les références; le modifier change l’identité.
[kind=decimal].unit.[kind=currency].kind "currency" Requis. Sélectionne la variante et les propriétés admises dans cette branche.
[kind=decimal].unit.[kind=currency].key string; min length 1; max length 120; /^[a-z][a-z0-9-]*$/u Requis. Identifiant sémantique stable utilisé par les références; le modifier change l’identité.
[kind=decimal].minimum string; max length 1003; optional Facultatif. Borne de cardinalité ou de budget pour la ressource nommée. Les dépassements sont refusés; null signifie une absence de borne uniquement lorsque le schéma l’admet.
[kind=decimal].maximum string; max length 1003; optional Facultatif. Borne de cardinalité ou de budget pour la ressource nommée. Les dépassements sont refusés; null signifie une absence de borne uniquement lorsque le schéma l’admet.
[kind=object].kind "object" Requis. Sélectionne la variante et les propriétés admises dans cette branche.
[kind=object].properties Array<closed object>; max length 100 Requis. Définit « properties » pour cet objet. Respecter le type, les variantes et les limites de la colonne Options.
[kind=object].properties[].key string; min length 1; max length 120; /^[a-zA-Z][a-zA-Z0-9]*$/u Requis. Identifiant sémantique stable utilisé par les références; le modifier change l’identité.
[kind=object].properties[].required true | false Requis. Indique si cette déclaration exige une valeur.
[kind=object].properties[].nullable true | false Requis. Définit « nullable » pour cet objet. Respecter le type, les variantes et les limites de la colonne Options.
[kind=object].properties[].schema recursive reference Requis. Définit « schema » pour cet objet. Respecter le type, les variantes et les limites de la colonne Options.
[kind=object].properties[].schema ↻ recursive reference to parent expression Facultatif. Définit « schema ↻ » pour cet objet. Respecter le type, les variantes et les limites de la colonne Options.
[kind=list].kind "list" Requis. Sélectionne la variante et les propriétés admises dans cette branche.
[kind=list].minimumItems integer; ≥ 0; ≤ 1000 Requis. Borne de cardinalité ou de budget pour la ressource nommée. Les dépassements sont refusés; null signifie une absence de borne uniquement lorsque le schéma l’admet.
[kind=list].maximumItems integer; ≥ 0; ≤ 1000 Requis. Borne de cardinalité ou de budget pour la ressource nommée. Les dépassements sont refusés; null signifie une absence de borne uniquement lorsque le schéma l’admet.
[kind=list].itemsNullable true | false Requis. Définit « items Nullable » pour cet objet. Respecter le type, les variantes et les limites de la colonne Options.
[kind=list].items recursive reference Requis. Définit « items » pour cet objet. Respecter le type, les variantes et les limites de la colonne Options.
[kind=list].items ↻ recursive reference to parent expression Facultatif. Définit « items ↻ » pour cet objet. Respecter le type, les variantes et les limites de la colonne Options.

Règles de lecture

Les chemins suffixés par [] décrivent chaque élément d’une liste; {key} décrit chaque valeur d’un dictionnaire. Le symbole ↻ renvoie à la même expression récursive. Un objet fermé refuse les propriétés supplémentaires. Les mentions de validation sémantique signalent un contrôle complémentaire : la conformité des types ne suffit pas à rendre une référence, une permission ou une transition valide. Les références doivent être résolues dans le Model et le contexte de l’usager.

La présence d’une ancienne variante ne permet pas d’y ajouter une propriété d’une variante plus récente. Le compilateur contrôle la version et la cohérence du Model complet.

Exemple de structure

Ce fragment respecte le schéma de cette section. Ses références métier doivent être définies dans le Model qui l’utilise.

{
  "kind": "integer",
  "minimum": "0",
  "maximum": "1000000000",
  "unit": {
    "kind": "unit",
    "key": "word"
  }
}

Références associées

Index complet du Model · Construire un Model

Exemples appliqués : Texte requis et choix métier

Entreprise utilise une saisie texte obligatoire; État réutilise une liste de valeurs déclarées.

Configuration

Objet du contrat managedTypedValue. Propriétés et valeurs admises.

{
  "kind": "integer",
  "minimum": "0",
  "maximum": "1000000000",
  "unit": {
    "kind": "unit",
    "key": "word"
  }
}

Variante et raccordement

Fragment à placer dans forms[].fields[]. Propriétés et valeurs admises.

{
  "contract": "WorkspaceFormControl@2",
  "repeatable": false,
  "key": "status",
  "label": "État",
  "input": "choice",
  "binding": {
    "kind": "field",
    "fieldKey": "status"
  },
  "required": true,
  "ruleKeys": [],
  "options": [
    "prospect",
    "active"
  ]
}

Exemple de disposition UI

La disposition illustrative ci-dessous situe cette configuration dans l’app Clients/Soumissions. Chaque fragment s’insère à l’emplacement indiqué; ses références aux Fields, Queries et Actions correspondent aux déclarations du Model.

  1. Identité du client
  2. Notes et suivi
  3. Paramètres
  4. Soumissions liées
DISPOSITION ILLUSTRATIVEApp Clients / Soumissions
SurfaceClients / Atelier NordExemple
managedTypedValuemanagedTypedValue
Clients
CONTEXTE DU MODELAtelier NordConfiguration déclarative
kind
integer
minimum
0
maximum
1000000000
unit
Objet déclaré

Les valeurs ci-dessus reprennent le fragment de configuration; les références se résolvent dans le Model complet.

Recherchez un concept, un champ ou une action.Esc