Aller au contenu

Domaines et isolement

Un domaine porte un secteur métier, comme hr ou sales. Les doctypes, les hooks et les attributions se trouvent tous à l’intérieur. Rien ne franchit la limite de son propre chef. Chaque flux inter-domaines exige un consentement explicite.

Read crosses a domain boundary? Read crosses a domain boundary?

Ce que porte un domaine. Un domaine est un document core.Domain, et son id est le nom du domaine. Tout id de doctype est donc qualifié, comme hr.Employee. Le domaine doit exister avant l’enregistrement de ses doctypesà ; sinon, l’enregistrement répond 422.

Le domaine possède ses doctypes et leurs modèles de vue. Il possède aussi les hooks déclarés sur le document du domaine, et les attributions qu’il accorde à d’autres domaines. Il possède enfin son état de brouillon : un domaine de brouillon porte un id qui commence par _. Vous publiez un brouillon dans un nouveau domaine réel. Les attributions ne concernent jamais des brouillons — les deux côtés doivent être des domaines réels.

Un domaine se déplace comme un tout. Le domaine est aussi l’unité de portabilité. L’export et l’import transportent un domaine avec ses définitions et ses données.

L’isolement est la règle par défaut. Les données ne quittent pas un domaine de leur propre chef. Une lecture inter-domaines exige l’un de deux consentements explicitesà :

  • L’API de documents. Les lectures suivent les permissions du rôle. Le rôle doit porter une ligne de permission qui nomme le doctype étranger.

  • Les surfaces d’automatisation. Les champs de réplication, les hooks à

    source étrangère et les lectures Lua d’un doctype étranger exigent une attribution de domaine active. Sans couverture, la lecture est refusée.

    Les flux au sein d’un même domaine sautent tous ces contrôles. Un domaine qui se lit lui-même ne pose pas de décision de partage.

    Ce que partage une attribution. Une attribution est un document sous le domaine producteur, et une attribution couvre un seul domaine consommateur. Elle porte une liste de ressourcesà : une entrée par doctype producteur, et chaque entrée nomme des étiquettes de champ. Les attributions donnent un accès en lecture seulement — aucun accès en écriture n’existe.

    Un champ est partagé quand ses étiquettes correspondent. Les champs sans étiquette comptent comme default, donc une entrée qui nomme default atteint chaque champ sans étiquette. Le consommateur reçoit seulement les champs couvertsà ; le serveur retire les autres avant la livraison.

    Le producteur décide de l’activation. L’activation appartient au producteur, et elle est tout ou rien par attribution. Une publication qui élargit les ressources partagées fait repasser une attribution active en inactive. Le producteur doit l’accepter de nouveau.

    Un seul saut. La réplication fait un seul saut. Un champ de réplication ne peut pas alimenter un autre champ de réplicationà ; le contrôle de création refuse la chaîne avec un 422.

Les attributions couplent les domaines. Le consommateur lit la donnée à

la source, donc il dépend du contrat du producteur. Désactivez l’attribution : les copies cessent de se mettre à jour. Réduisez les étiquettesà : les valeurs déj à copiées restent en place. Aucun traitement ne les efface. Réactivez l’attribution : le prochain événement source renvoie la valeur.

L’isolement strict coûte de la duplication. Les deux options sont pleinement prises en charge. Quand le couplage coûte plus que la copie, dupliquez le champ et gardez les domaines totalement indépendants.