Brouillon → publication
Vous ne modifiez pas directement les doctypes d’un domaine réel. Vous ouvrez un brouillon, vous y changez les définitions, puis vous publiez quand le résultat est prêt. Cette page décrit ce que l’état de brouillon autorise, et ce que la publication vérifie avant d’écrire.
Explication
Section intitulée « Explication »Deux états. Un domaine porte un indicateur draft. Un brouillon est un
vrai domaine, avec un nom généré automatiquement qui commence par _. Facet
fonde chaque garde-fou sur cet indicateur, jamais sur le préfixe. Dans un
brouillon :
-
la version de schéma peut diminuer ou sauter un cran,
-
les modifications destructives, comme la suppression d’un champ ou un changement de type, sont permises à version inchangée,
-
un changement de version n’exige aucune fonction de migration,
-
tout le reste passe toujours la validation : noms de champs, noms d’actions, compilation des scripts.
Ce que fait la publication.
POST /Api/core/Domain/:id/publishtransforme le brouillon en domaine réel. Publier, c’est copier puis supprimer, pas renommer. La cible reçoit de nouvelles lignes sous son propre nomà ; le brouillon est ensuite supprimé. En mode écrasement, le documentcore.Domainréel reste tel quelà : sa description, ses context sets et ses hooks gardent leurs valeurs réelles, et un hook du brouillon que le domaine réel n’a pas revient en avertissement. Avant d’écrire quoi que ce soit, la publication vérifie queà : -
le nom cible ne contient que des lettres minuscules, des chiffres et des tirets, et commence par une lettre. Un
_initial répond422: ce préfixe est réservé aux brouillons, -
la source est un brouillon, lu sous un verrou de ligne,
-
le graphe de composition est fermé — chaque entrée
children:a unmember_ofcorrespondant, -
en mode création (
overwrite: false, par défaut), le nom cible est libre. Un nom qu’un domaine réel porte déj à répond409, -
en mode écrasement (
overwrite: true), le nom cible peut déj à exister. Chaque doctype dont la structure diffère de celle du réel doit porter unschema_versionexactement égal à la version réelle plus un, et une fonction de migration pour cet écartà ; un écart sans fonction répond422. Un doctype de structure identique passe sans changement de version.Puis, en une seule transaction, la publication :
-
copie chaque définition de doctype et ses modèles de vue,
-
repointe les références internes au domaine vers le nouveau nom,
-
en mode écrasement, aligne les modèles de vue du réel sur ceux du brouillon : un modèle changé est mis à jour, un modèle propre au brouillon est créé, un modèle propre au réel est supprimé. Les vues enregistrées ne sont jamais touchées,
-
transfère les éditeurs de domaines du brouillon,
-
ouvre des tickets d’attribution de domaine quand les définitions touchent d’autres domaines,
-
supprime le brouillon.
Un crash avant le commit laisse le brouillon intact. Vous pouvez relancer la même publication.
Que deviennent les documents. La publication ne migre jamais les documents réels à l’avance. Ils restent à leur version de schéma stockée. Une migration à la demande parcourt la chaîne à la prochaine lecture. La barrière de version garantit que chaque écart a une fonctionà ; le parcours à la demande ne peut donc échouer sur une entrée manquante.
Les données d’un brouillon sont jetables. Les documents créés dans le brouillon ne passent pas de l’autre côté — la publication les supprime logiquement avec le brouillon. Seule la structure se publie. Un token d’aperçu vous permet de tester d’abordà : il ouvre les routes standard pour les documents du brouillon, sous votre propre identité.
Le compromis. Les vérifications qui protègent les données réelles ne
tournent pas pendant l’édition. Un problème de version n’apparaît qu’à la
publication, quand la barrière le refuse, et vous revenez au brouillon
pour le corriger. Un brouillon dérivé d’un domaine réel ne suit plus ce
domaine ensuite. Les deux peuvent diverger, et la comparaison n’a lieu
qu’au moment de publier. Deux états, c’est aussi deux copies d’une
définition. Le domaine réel continue de servir ses définitions actuelles
pendant que vous éditez le brouillon. Vos changements n’atteignent les
autres utilisateurs qu’à la publication. Une dernière limiteà : la
réplication reste inerte dans un brouillon. Un domaine de brouillon ne
sert jamais de source ni de consommateur de réplication, vous ne pouvez
donc pas tester un champ replicate avant de publier.
Voir aussi
Section intitulée « Voir aussi »-
Construction — le chemin de création, d’un brouillon vide à
un domaine réel.
-
Concevoir des doctypes — comment déclarer champs et modèles.
-
Domaines et isolation — ce qu’un domaine borne.
-
Évolution du schéma — la barrière de version et la migration à la demande en détail.
-
Internes sur GitHubà : draft-domains.md.