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

managedModelAuthorTask

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

Cette référence décrit la structure complète de managedModelAuthorTask. 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 "task" Requis. Sélectionne la variante et les propriétés admises dans cette branche.
uses string; min length 1; max length 120; /^[a-z][a-z0-9-]*$/u Requis. Définit « uses » pour cet objet. Respecter le type, les variantes et les limites de la colonne Options.
title string; min length 1; max length 4000 Requis. Titre de l’objet ou de la section dans l’interface.
initialFields Record<string, true | false OR number OR string OR Array<true | false OR number OR string>> Requis. Définit « initial Fields » pour cet objet. Respecter le type, les variantes et les limites de la colonne Options.
completionCriteria Array<string; min length 1; max length 4000>; max length 100 Requis. Conditions qui permettent de considérer le travail terminé.
inputs Record<string; min length 1; max length 120; /^[a-z][a-z0-9-]*$/u, closed object OR closed object OR closed object OR closed object OR closed object OR closed object OR closed object OR closed object> Requis. Entrées nommées et typées nécessaires à la composition ou à l’opération.
inputs{key}.[kind=input].kind "input" Requis. Sélectionne la variante et les propriétés admises dans cette branche.
inputs{key}.[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é.
inputs{key}.[kind=input-node-id].kind "input-node-id" Requis. Sélectionne la variante et les propriétés admises dans cette branche.
inputs{key}.[kind=input-node-id].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é.
inputs{key}.[kind=field].kind "field" Requis. Sélectionne la variante et les propriétés admises dans cette branche.
inputs{key}.[kind=field].definitionPath string; min length 1; max length 600; /^workspace\/[a-z0-9-]+(?:\/surface\/[a-z0-9-]+)*$/u Requis. Chemin exact d’une définition du Model; il ne désigne pas l’ID d’une fiche.
inputs{key}.[kind=field].fieldKey string; min length 1; max length 120 Requis. Clé d’un Field déclaré sur la définition de Surface référencée.
inputs{key}.[kind=literal].kind "literal" Requis. Sélectionne la variante et les propriétés admises dans cette branche.
inputs{key}.[kind=literal].value string; max length 4000 OR number OR true | false OR null Requis. Valeur effective interprétée selon le type et le discriminant du contexte parent.
inputs{key}.[kind=collection-item].kind "collection-item" Requis. Sélectionne la variante et les propriétés admises dans cette branche.
inputs{key}.[kind=collection-node-id].kind "collection-node-id" Requis. Sélectionne la variante et les propriétés admises dans cette branche.
inputs{key}.[kind=iteration-number].kind "iteration-number" Requis. Sélectionne la variante et les propriétés admises dans cette branche.
inputs{key}.[kind=step-output].kind "step-output" Requis. Sélectionne la variante et les propriétés admises dans cette branche.
inputs{key}.[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é.
inputs{key}.[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é.
outputs Array<closed object>; max length 20 Requis. Résultats exposés par la composition selon leurs noms déclarés.
outputs[].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é.
outputs[].minimum 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.
outputs[].maximum integer; ≥ 1; ≤ 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.
outputs[].result "reference" | "summary" | "outputs" | "decisions" | "nextSteps" | "blockers" Requis. Définit « result » pour cet objet. Respecter le type, les variantes et les limites de la colonne Options.
reservedCostUnits integer; ≥ 0; ≤ 1000000 Requis. Définit « reserved Cost Units » pour cet objet. Respecter le type, les variantes et les limites de la colonne Options.
maximumAttempts integer; ≥ 1; ≤ 10 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": "client",
  "kind": "task",
  "uses": "client",
  "title": "client",
  "initialFields": {},
  "completionCriteria": [],
  "inputs": {},
  "outputs": [],
  "reservedCostUnits": 0,
  "maximumAttempts": 1
}

Références associées

Index complet du Model · Construire un Model

Exemples appliqués : Préparer une soumission

Le Flow déclare les entrées Client et Besoin, une étape exécutable et un budget borné.

Configuration

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

{
  "key": "client",
  "kind": "task",
  "uses": "client",
  "title": "client",
  "initialFields": {},
  "completionCriteria": [],
  "inputs": {},
  "outputs": [],
  "reservedCostUnits": 0,
  "maximumAttempts": 1
}

Variante et raccordement

Fragment à placer dans flowBlueprints[].composition.inputs. Propriétés et valeurs admises.

[
  {
    "key": "client",
    "type": "surface-reference",
    "provenance": "caller",
    "minimum": 1,
    "maximum": 1
  },
  {
    "key": "need",
    "type": "text",
    "provenance": "caller",
    "minimum": 1,
    "maximum": 1
  }
]

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. Qualifier le besoin
  2. Préparer la proposition
  3. Attendre la décision
  4. Conserver le résultat
DISPOSITION ILLUSTRATIVEApp Clients / Soumissions
SurfaceClients / Atelier NordExemple
managedModelAuthorTaskmanagedModelAuthorTask
Clients
CONTEXTE DU MODELAtelier NordConfiguration déclarative
key
client
kind
task
uses
client
title
client
initialFields
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