Aller au contenu
SurfaceDocs
ENCommencer
DocsFlows et automatisation

Étapes et dépendances

Décomposer un travail en unités compréhensibles et vérifiables.

Donner une responsabilité à chaque étape

Une étape reçoit des informations, effectue un travail et expose un résultat. Son titre doit décrire l’intention métier : Vérifier le besoin, plutôt qu’un nom de fonction interne. Les dépendances indiquent les résultats qui doivent être disponibles avant son exécution.

Configuration Valeurs attendues Description
Clé et titre Identité stable et libellé métier Référence et lecture du suivi
Entrées requises Fields et sources déclarés Conditions de préparation
Dépendances Étapes existantes Exigences avant exécution
Mode Intervention humaine, AI ou opération admise Nature du travail
Résultat Surface et critères attendus Preuve de réalisation

Ordre et parallélisme

Deux étapes sans dépendance mutuelle peuvent avancer en parallèle si les contraintes le permettent. Dans l’exemple, vérifier le besoin client et consulter les tarifs peuvent précéder la rédaction. La revue attend le brouillon; la finalisation attend une décision valide.

Rendre l’étape vérifiable

Définissez ce qui permet de considérer le travail terminé. Une sortie non vide n’est pas nécessairement une proposition correcte. Les critères peuvent exiger des informations, des relations, des résultats ou une décision humaine. Le suivi expose les conditions manquantes et le résultat produit.

La référence des FlowBlueprints et de la composition de Flow donne les propriétés exactes et les variantes.

Exemples appliqués : Relier une étape à son résultat

L’étape prépare la proposition; la sortie du Flow référence le résultat déclaré de cette étape.

Configuration

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

{
  "key": "prepare",
  "kind": "task",
  "workNodeKey": "prepare",
  "actionKey": "prepare",
  "inputs": {},
  "outputs": [
    {
      "key": "proposal",
      "type": "result-reference",
      "provenance": "canonical",
      "minimum": 1,
      "maximum": 1,
      "result": "reference"
    }
  ],
  "reservedCostUnits": 1,
  "maximumAttempts": 3
}

Variante et raccordement

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

[
  {
    "key": "proposal",
    "type": "result-reference",
    "provenance": "canonical",
    "minimum": 1,
    "maximum": 1,
    "source": {
      "kind": "step-output",
      "stepKey": "prepare",
      "outputKey": "proposal"
    },
    "reduction": "first"
  }
]

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
Étapes et dépendancesRelier une étape à son résultat
Clients
✓
Qualifier le besoinTerminé
✓
Préparer la propositionTerminé
03
Attendre la décisionDécision requise
04
Conserver le résultatÀ venir
La préparation attend une décision

La proposition et ses sources restent accessibles pendant l’attente.

Revoir la proposition
Recherchez un concept, un champ ou une action.Esc