Actions et boutons
Déclarer une opération et la présenter au bon endroit.
Une Action exprime une intention
Nouveau client, Préparer une proposition et Archiver sont des Actions. Le Model définit leur opération, leur contexte et les informations nécessaires. Une carte d’action ou un bouton est leur présentation dans une vue.
Une Action peut lancer un Flow, ouvrir une Form de création, préparer une opération ou naviguer vers un contexte déclaré. Elle ne lance pas systématiquement un Flow. Choisissez l’opération qui correspond au résultat attendu.
| Élément | Valeurs attendues | Description |
|---|---|---|
| Clé | Identifiant stable | Référencer la même Action depuis plusieurs vues |
| Libellé | Verbe et objet, par exemple Créer une soumission | Rendre l’intention compréhensible |
| Contexte | Objet courant, sélection ou paramètres déclarés | Définir sur quoi l’Action agit |
| Opération | Variante admise dans le Model | Créer, modifier, lancer ou ouvrir |
| Form | Référence à une Form si une saisie est nécessaire | Recueillir les paramètres |
| Disponibilité | Conditions et droits applicables | Expliquer une Action indisponible |
Cartes d’action
Pour une sélection de texte dans une Surface, l’Action identifie le composant de texte enrichi
propriétaire avec blockId, ainsi que ses positions from et to. Les positions seules ne
permettent pas d’identifier le texte d’une Page contenant plusieurs composants de texte enrichi.
La sélection reste liée à la Surface et à la révision admises pour cette Action.
L’accueil Clients peut présenter Préparer une proposition avec une icône et une description. La carte référence l’Action du Model; elle ne contient pas son propre moteur d’exécution. Sur la fiche Atelier Nord, un bouton peut invoquer la même Action avec le client déjà sélectionné.
Confirmation et résultat
Présentez l’effet utile avant confirmation : le client concerné, les données utilisées et le résultat créé. Après l’opération, affichez son résultat ou son suivi. Une réponse tardive ou un changement de sélection ne doit pas appliquer l’Action à un autre client.
La carte distingue une opération à examiner d’un résultat enregistré. Ses détails donnent accès aux références et versions exactes sans encombrer la lecture principale. Un nom absent est signalé, jamais remplacé par un nom supposé. Voir le résultat consulte le reçu; ce geste ne relance pas l’Action. Une demande en attente ou en erreur reste la même demande à examiner.
Depuis un travail, l’Action reste liée à son contexte et aux informations déclarées à son origine. Une évolution de l’application ne remplace pas silencieusement le formulaire ni les valeurs d’une demande déjà retenue. Après une réponse perdue, reprenez cette même revue plutôt que lancer une autre Action.
Lorsqu’une Action conserve des sources de référence, sa revue et son historique présentent le travail d’origine et les versions exactes des sources. Une évolution de l’application ne remplace ni ces sources ni la règle de conservation originale. L’export utilise cette capture historique sélectionnée et vérifie de nouveau vos accès actuels.
Pour une référence de formulaire, la revue distingue conserver la référence enregistrée, laisser sans référence et choisir une cible. Ce choix fait partie de la même confirmation que les autres informations du formulaire. Conserver ne choisit pas une autre cible et ne recrée pas la référence enregistrée; une réponse perdue reprend la demande et ses choix d’origine.
Exemple
Depuis Atelier Nord, Préparer une proposition ouvre une Form avec le client prérempli et demande le besoin. La confirmation démarre le Flow de préparation. L’interface ouvre ensuite le travail et ses étapes; elle ne prétend pas que la soumission est finalisée dès le lancement.
Exemples appliqués : Créer ou lancer un travail
Une Action de Flow prépare une soumission; une Action de création ouvre une Form dédiée.
Configuration
Fragment à placer dans actions[]. Propriétés et valeurs admises.
{
"key": "prepare-quote",
"label": "Préparer une soumission",
"targetDefinitionPaths": [
"workspace/clients/surface/client"
],
"kind": "flow",
"operationKey": "prepare-quote",
"formKey": "prepare-quote",
"ruleKeys": [],
"contextPolicyKey": "quote-context",
"minimumRole": "member",
"confirmation": true
}Variante et raccordement
Fragment à placer dans actions[]. Propriétés et valeurs admises.
{
"key": "create-client",
"label": "Créer un client",
"targetDefinitionPaths": [],
"kind": "semantic-command",
"operationKey": "create-client",
"formKey": "new-client",
"ruleKeys": [],
"contextPolicyKey": null,
"minimumRole": "member",
"confirmation": true
}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.
- Objet concerné
- Changement proposé
- Vérifications
- Confirmer
- Changement proposé
- Une Action de Flow prépare une soumission; une Action de création ouvre une Form dédiée.
- Données et références
- Client · Besoin · Tarifs