surfaceFlowReferenceContextSource

Cette référence décrit la structure complète de surfaceFlowReferenceContextSource. 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
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	"flow-reference"	Requis. Sélectionne la variante et les propriétés admises dans cette branche.
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.
source.[kind=input].kind	"input"	Requis. Sélectionne la variante et les propriétés admises dans cette branche.
source.[kind=input].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é.
source.[kind=step-output].kind	"step-output"	Requis. Sélectionne la variante et les propriétés admises dans cette branche.
source.[kind=step-output].stepKey	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é.
source.[kind=step-output].outputKey	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é.
required	true | false	Requis. Indique si cette déclaration exige une valeur.
revision	"captured"	Requis. Définit « revision » pour cet objet. Respecter le type, les variantes et les limites de la colonne Options.
priority	integer; ≥ 0; ≤ 1000	Requis. Définit « priority » pour cet objet. Respecter le type, les variantes et les limites de la colonne Options.
maximumItems	integer; ≥ 1; ≤ 100	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.
maximumCharacters	integer; ≥ 1; ≤ 100000	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.

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.

{
  "key": "feature",
  "kind": "flow-reference",
  "source": {
    "kind": "input",
    "key": "feature"
  },
  "required": true,
  "revision": "captured",
  "priority": 2,
  "maximumItems": 1,
  "maximumCharacters": 20000
}

Références associées

Index complet du Model · Construire un Model

Exemples appliqués : Une proposition fondée sur le contexte

L’AI reçoit le client et les sources requises, dans les bornes de la politique du Model.

Configuration

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

{
  "key": "feature",
  "kind": "flow-reference",
  "source": {
    "kind": "input",
    "key": "feature"
  },
  "required": true,
  "revision": "captured",
  "priority": 2,
  "maximumItems": 1,
  "maximumCharacters": 20000
}

Variante et raccordement

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

{
  "key": "quote-knowledge",
  "targetDefinitionPaths": [
    "workspace/quotes/surface/quote"
  ],
  "sources": [
    {
      "key": "pricing",
      "kind": "knowledge",
      "definitionPaths": [
        "workspace/knowledge/surface/pricing"
      ],
      "linkTypePaths": [],
      "queryKey": null,
      "required": true,
      "revision": "current",
      "priority": 1,
      "maximumItems": 3,
      "maximumCharacters": 12000
    }
  ],
  "maximumCharacters": 16000
}

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. Objet concerné
2. Changement proposé
3. Vérifications
4. Confirmer

SurfaceClients / Atelier NordExemple

surfaceFlowReferenceContextSourcesurfaceFlowReferenceContextSource

Clients

CONTEXTE DU MODELAtelier NordConfiguration déclarative

key

feature

kind

flow-reference

source

Objet déclaré

required

true

priority

2

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