workspaceCompositionPresentation

Cette référence décrit la structure complète de workspaceCompositionPresentation. 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
contract	"WorkspaceCompositionPresentation@1"	Requis. Discriminant exact de cette variante du contrat. Respecter la valeur littérale indiquée.
catalogue	Surface-admitted value; canonical semantic validation	Requis. Définit « catalogue » pour cet objet. Respecter le type, les variantes et les limites de la colonne Options.
screens	Array<closed object OR closed object OR closed object OR closed object>; min length 1; max length 241	Requis. Définit « screens » pour cet objet. Respecter le type, les variantes et les limites de la colonne Options.
screens[].[kind=home].kind	"home"	Requis. Sélectionne la variante et les propriétés admises dans cette branche.
screens[].[kind=home].composition	Surface-admitted value; canonical semantic validation	Requis. Organisation déclarative des composants, sources ou Spaces dans la variante indiquée.
screens[].[kind=collection].kind	"collection"	Requis. Sélectionne la variante et les propriétés admises dans cette branche.
screens[].[kind=collection].destinationKey	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é.
screens[].[kind=collection].viewKey	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é.
screens[].[kind=collection].composition	Surface-admitted value; canonical semantic validation	Requis. Organisation déclarative des composants, sources ou Spaces dans la variante indiquée.
screens[].[kind=record].kind	"record"	Requis. Sélectionne la variante et les propriétés admises dans cette branche.
screens[].[kind=record].recordProfileKey	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é.
screens[].[kind=record].composition	Surface-admitted value; canonical semantic validation	Requis. Organisation déclarative des composants, sources ou Spaces dans la variante indiquée.
screens[].[kind=work].kind	"work"	Requis. Sélectionne la variante et les propriétés admises dans cette branche.
screens[].[kind=work].experienceKey	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é.
screens[].[kind=work].composition	Surface-admitted value; canonical semantic validation	Requis. Organisation déclarative des composants, sources ou Spaces dans la variante indiquée.

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.

Les paramètres d’implémentation de cette structure sont gérés par Surface. Utilisez les outils du Model pour les produire; ils ne sont pas des valeurs à saisir dans une fiche.

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

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

{
  "recordProfileKey": "client",
  "fieldPath": "fields/notes"
}

Variante et raccordement

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

{
  "binding": {
    "kind": "record-relations",
    "recordProfileKey": "client",
    "groupKey": "quotes"
  }
}

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

workspaceCompositionPresentationworkspaceCompositionPresentation

Clients

CONTEXTE DU MODELAtelier NordConfiguration déclarative

recordProfileKey

client

fieldPath

fields/notes

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