Actions

Statut documentaire : reference — voir Maturité et preuves.

Une action est une capacité déclarée du modèle. Elle porte une intention métier et une signature d'invocation ; son implémentation concrète reste derrière la frontière du Runtime.

Action interne, publiée, exposée

Interne : utilisée dans le modèle, un script, une vue ou un processus.
Publiée : marquée comme faisant partie des capacités appelables du concept.
Exposée : une action publiée reliée à un mécanisme d'accès concret, par exemple HTTP, agent, message ou interface.

La publication n'est pas une autorisation. L'authentification, l'autorisation, la visibilité et les validations restent des couches séparées.

Signature canonique

actions:
  - action:
      name: Verify
      type: ObjectItem
      published: true
      params:
        - Login:
            dataType: String
            paramType: ptIn
        - Password:
            dataType: String
            paramType: ptIn
        - Result:
            dataType: Boolean
            paramType: ptReturn

Dans une liste polymorphe actions, le type d'item est explicite : action: ou actionGroup:.

Bonnes pratiques

nommer l'action avec un verbe métier (Verify, Enroll, Finalize, Search) ;
stabiliser sa signature avant de l'exposer ;
garder l'orchestration longue dans un processus ;
ne pas mettre HTTP, UI ou RPC dans le nom métier ;
n'utiliser aucun nom de classe d'implémentation privé dans les exemples publics.

Voir aussi Services and publication.