Aller au contenu
SurfaceDocs
ENCommencer
DocsFlows et automatisation

Déclencheurs et échéances

Lancer une opération en réponse à une condition explicite.

Définir ce qui déclenche

Un déclencheur relie un événement ou une échéance à une opération déclarée. Il précise son périmètre, ses conditions et sa politique de répétition. Les changements de données et les opérations automatiques conservent les mêmes contrôles que les Actions manuelles.

Élément Valeurs attendues Description
Source Événement ou donnée déclarée Origine du signal
Condition Règle et contexte autorisé Détermine si l’effet s’applique
Échéance Date, heure ou politique du contrat Détermine le moment applicable
Effet Action ou opération admise Travail à lancer ou signaler
Identité Clé stable et occurrence Contrôle des répétitions

Exemple

Une soumission À approuver approche de son échéance. Le déclencheur vérifie qu’elle attend toujours une décision puis signale l’attention nécessaire. Une soumission déjà acceptée ne doit pas recevoir le même traitement parce qu’un ancien signal arrive en retard.

Temps et reprise

Utilisez une politique temporelle explicite : date effective, fuseau et règles de calcul si elles s’appliquent. Le moteur conserve le signal et son traitement. Une relance doit retrouver l’occurrence déjà traitée plutôt que reproduire son effet.

Voir la référence des échéances et les règles avant de configurer un comportement automatique.

Exemples appliqués : Proposer une revue au bon moment

Une révision du montant propose une revue; une échéance borne les objets surveillés.

Configuration

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

{
  "key": "quote-review",
  "enabledByDefault": false,
  "event": {
    "kind": "revision",
    "definitionPaths": [
      "workspace/quotes/surface/quote"
    ],
    "fieldKeys": [
      "amount"
    ]
  },
  "ruleKeys": [
    "positive-amount"
  ],
  "actionKey": "review-quote",
  "mode": "propose",
  "executionCapability": null,
  "maximumCascadeDepth": 1,
  "historicalEvents": "explicit-backfill-only"
}

Variante et raccordement

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

{
  "contract": "SurfaceTriggerDeadline@2",
  "sourceQueryKey": "pending-quotes",
  "maximumScheduledNodes": 50,
  "lateToleranceMs": 300000
}

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
Déclencheurs et échéancesProposer une revue au bon moment
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