surfaceWorkHeader

Cette référence décrit la structure complète de surfaceWorkHeader. 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
purpose	closed object; null	Requis. Définit « purpose » pour cet objet. Respecter le type, les variantes et les limites de la colonne Options.
purpose.scope	"rootWork" | "selectedStage" | "retainedTarget"	Requis. Définit « scope » pour cet objet. Respecter le type, les variantes et les limites de la colonne Options.
purpose.source	closed object OR closed object	Requis. Définit « source » pour cet objet. Respecter le type, les variantes et les limites de la colonne Options.
purpose.source.[kind=native].kind	"native"	Requis. Sélectionne la variante et les propriétés admises dans cette branche.
purpose.source.[kind=native].property	"title" | "description" | "createdAt" | "updatedAt"	Requis. Nom d’une propriété native reconnue; ce sélecteur ne permet pas un accès arbitraire.
purpose.source.[kind=field].kind	"field"	Requis. Sélectionne la variante et les propriétés admises dans cette branche.
purpose.source.[kind=field].fieldPath	string; min length 8; max length 127; /^fields\/[a-zA-Z][a-zA-Z0-9]*$/u	Requis. Sélecteur sémantique de Field utilisant le préfixe fields/.
purpose.valueLabels	Array<closed object>; max length 100	Requis. Correspondances entre valeurs stables et libellés destinés à l’usager.
purpose.valueLabels[].value	string; max length 4000 OR number OR true | false	Requis. Valeur effective interprétée selon le type et le discriminant du contexte parent.
purpose.valueLabels[].label	string; min length 1; max length 4000	Requis. Libellé destiné à l’usager dans l’interface.
status	closed object; null	Requis. Définit « status » pour cet objet. Respecter le type, les variantes et les limites de la colonne Options.
status.scope	"rootWork" | "selectedStage" | "retainedTarget"	Requis. Définit « scope » pour cet objet. Respecter le type, les variantes et les limites de la colonne Options.
status.source	closed object OR closed object	Requis. Définit « source » pour cet objet. Respecter le type, les variantes et les limites de la colonne Options.
status.source.[kind=native].kind	"native"	Requis. Sélectionne la variante et les propriétés admises dans cette branche.
status.source.[kind=native].property	"title" | "description" | "createdAt" | "updatedAt"	Requis. Nom d’une propriété native reconnue; ce sélecteur ne permet pas un accès arbitraire.
status.source.[kind=field].kind	"field"	Requis. Sélectionne la variante et les propriétés admises dans cette branche.
status.source.[kind=field].fieldPath	string; min length 8; max length 127; /^fields\/[a-zA-Z][a-zA-Z0-9]*$/u	Requis. Sélecteur sémantique de Field utilisant le préfixe fields/.
status.valueLabels	Array<closed object>; max length 100	Requis. Correspondances entre valeurs stables et libellés destinés à l’usager.
status.valueLabels[].value	string; max length 4000 OR number OR true | false	Requis. Valeur effective interprétée selon le type et le discriminant du contexte parent.
status.valueLabels[].label	string; min length 1; max length 4000	Requis. Libellé destiné à l’usager dans l’interface.
facts	Array<closed object>; max length 20	Requis. Définit « facts » pour cet objet. Respecter le type, les variantes et les limites de la colonne Options.
facts[].scope	"rootWork" | "selectedStage" | "retainedTarget"	Requis. Définit « scope » pour cet objet. Respecter le type, les variantes et les limites de la colonne Options.
facts[].source	closed object OR closed object	Requis. Définit « source » pour cet objet. Respecter le type, les variantes et les limites de la colonne Options.
facts[].source.[kind=native].kind	"native"	Requis. Sélectionne la variante et les propriétés admises dans cette branche.
facts[].source.[kind=native].property	"title" | "description" | "createdAt" | "updatedAt"	Requis. Nom d’une propriété native reconnue; ce sélecteur ne permet pas un accès arbitraire.
facts[].source.[kind=field].kind	"field"	Requis. Sélectionne la variante et les propriétés admises dans cette branche.
facts[].source.[kind=field].fieldPath	string; min length 8; max length 127; /^fields\/[a-zA-Z][a-zA-Z0-9]*$/u	Requis. Sélecteur sémantique de Field utilisant le préfixe fields/.
facts[].valueLabels	Array<closed object>; max length 100	Requis. Correspondances entre valeurs stables et libellés destinés à l’usager.
facts[].valueLabels[].value	string; max length 4000 OR number OR true | false	Requis. Valeur effective interprétée selon le type et le discriminant du contexte parent.
facts[].valueLabels[].label	string; min length 1; max length 4000	Requis. Libellé destiné à l’usager dans l’interface.
facts[].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é.
facts[].label	string; min length 1; max length 4000	Requis. Libellé destiné à l’usager dans l’interface.
criteria	closed object; null	Requis. Définit « criteria » pour cet objet. Respecter le type, les variantes et les limites de la colonne Options.
criteria.sectionKey	string; min length 1; max length 120; /^[a-z][a-z0-9-]*$/u	Requis. Référence par clé stable à la déclaration nommée correspondante; le compilateur contrôle son existence et sa compatibilité.
criteria.bindingKey	string; min length 1; max length 120; /^[a-z][a-z0-9-]*$/u	Requis. Référence par clé stable à la déclaration nommée correspondante; le compilateur contrôle son existence et sa compatibilité.

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.

{
  "purpose": {
    "scope": "rootWork",
    "source": {
      "kind": "field",
      "fieldPath": "fields/objective"
    },
    "valueLabels": []
  },
  "status": {
    "scope": "rootWork",
    "source": {
      "kind": "field",
      "fieldPath": "fields/status"
    },
    "valueLabels": []
  },
  "facts": [
    {
      "scope": "rootWork",
      "source": {
        "kind": "field",
        "fieldPath": "fields/expectedResult"
      },
      "valueLabels": [],
      "key": "expected-result",
      "label": "Résultat attendu"
    },
    {
      "scope": "retainedTarget",
      "source": {
        "kind": "native",
        "property": "title"
      },
      "valueLabels": [],
      "key": "destination",
      "label": "Cible"
    }
  ],
  "criteria": {
    "sectionKey": "requests",
    "bindingKey": "criteria"
  }
}

Références associées

Index complet du Model · Construire un Model

Exemples appliqués : Composer la fiche et ses relations

Deux Stack déclarés portent le contenu principal puis les relations, sans cadres supplémentaires. Le preset choisit la largeur du panneau droit.

Configuration

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

{
  "purpose": {
    "scope": "rootWork",
    "source": {
      "kind": "field",
      "fieldPath": "fields/objective"
    },
    "valueLabels": []
  },
  "status": {
    "scope": "rootWork",
    "source": {
      "kind": "field",
      "fieldPath": "fields/status"
    },
    "valueLabels": []
  },
  "facts": [
    {
      "scope": "rootWork",
      "source": {
        "kind": "field",
        "fieldPath": "fields/expectedResult"
      },
      "valueLabels": [],
      "key": "expected-result",
      "label": "Résultat attendu"
    },
    {
      "scope": "retainedTarget",
      "source": {
        "kind": "native",
        "property": "title"
      },
      "valueLabels": [],
      "key": "destination",
      "label": "Cible"
    }
  ],
  "criteria": {
    "sectionKey": "requests",
    "bindingKey": "criteria"
  }
}

Variante et raccordement

Propriétés du composant RecordLayout.props. Propriétés et valeurs admises.

{
  "asideWidth": "compact"
}

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

SurfaceClients / Atelier NordExemple

surfaceWorkHeadersurfaceWorkHeader

Clients

CONTEXTE DU MODELAtelier NordConfiguration déclarative

purpose

Objet déclaré

status

Objet déclaré

facts

2 éléments

criteria

Objet déclaré

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