In many systems a screen is designed in a visual editor and saved as a picture of itself.<\/p>\n
In Odoo, a screen is described in a file<\/strong>. The file says: show this field here, put these three in a group, add this tab, show this button when the record is in this state.<\/p>\n That description is written in XML<\/strong> \u2014 a structured text format. When you see a form in Odoo, you are seeing a rendered version of that description.<\/p>\n Why this matters to you even if you never open one:<\/strong> it explains why some changes are quick, why some are not, and why changes survive upgrades.<\/p>\n Three kinds of thing.<\/p>\n Structure.<\/strong> Groups, tabs, sections, columns. How the screen is laid out.<\/p>\n Fields.<\/strong> Which fields appear, in what order, with what labels.<\/p>\n Conditions.<\/strong> When things appear. A field visible only when a checkbox is ticked. A button shown only in a particular state. A field read-only after confirmation.<\/p>\n That third one is the useful part.<\/strong> A large share of what feels like custom logic is actually a condition in a view \u2014 “hide this unless that is set” needs no code at all.<\/p>\n FIGURE 1: WHAT A VIEW DEFINITION HOLDS<\/p>\n Structure<\/p>\n Fields<\/p>\n Conditions<\/p>\n The single most important concept here, and it is the reason Odoo upgrades work.<\/p>\n When a module needs to change a screen, it does not copy the whole definition and edit the copy. It writes an instruction<\/strong>: find this field in the existing view, and put my new field after it.<\/p>\n Your change is a patch applied on top<\/strong>, not a replacement.<\/p>\n Two consequences:<\/strong><\/p>\n Upgrades work.<\/strong> Odoo improves the standard form; your instruction is re-applied on top. You get the improvements and keep your changes.<\/p>\n Several modules can change the same screen<\/strong> without conflicting, as long as their instructions do not target the same thing.<\/p>\n And the failure mode:<\/strong> if Odoo removes or renames the field your instruction points at, the instruction cannot find its anchor and the view breaks. This is one of the most common things that needs fixing at an upgrade \u2014 and it is usually quick.<\/p>\n FIGURE 2: WHY VIEW CHANGES SURVIVE UPGRADES<\/p>\n Inherited view<\/p>\n Replaced view<\/p>\n Knowing the shape of a view definition explains estimates.<\/p>\n Quick.<\/strong> Moving a field. Changing a label. Adding an existing field to a form or a list. Hiding a field under a condition. Reordering columns.<\/p>\n These are edits to the view description. Nothing else changes.<\/p>\n Not quick.<\/strong> Adding a field that does not exist \u2014 that changes the model, and it may need logic behind it. Changing what a button does. Anything where the layout needs data that is not there.<\/p>\n A useful question when you ask for a change:<\/strong> does this information already exist somewhere in Odoo? If yes, it is usually a view change. If no, it is a bigger piece of work.<\/p>\n Odoo Studio edits views by dragging. Under it, Studio is writing the same inherited view definitions.<\/p>\n So Studio changes are XML changes<\/strong> \u2014 made by clicking rather than by typing.<\/p>\n The difference is not the result. It is the record.<\/strong> A developer’s change lives in a module with a history: who made it, when, and why. A Studio change has none of that.<\/p>\n For moving a field, that hardly matters. For thirty accumulated changes over two years, it matters a great deal \u2014 because eventually somebody has to work out what was changed and why, with nothing to read.<\/p>\n Three common causes, and what each means.<\/p>\n After an upgrade.<\/strong> An inherited view points at a field Odoo moved or renamed. Usually a quick fix once identified.<\/p>\n After installing a module.<\/strong> Two modules trying to change the same part of a screen. Also usually quick.<\/p>\n A field referenced that no longer exists.<\/strong> Often after a module was uninstalled, taking its fields with it.<\/p>\n What to send when reporting one:<\/strong> the exact error message, which screen, and what changed recently. That third item is usually the answer.<\/p>\n FIGURE 3: WHAT TO SEND WHEN A SCREEN BREAKS<\/p>\n The exact message<\/p>\n Which screen and which record<\/p>\n What changed recently<\/p>\n If you commission Odoo work, four things worth expecting.<\/p>\n Changes are inherited, not replacements.<\/strong> Ask directly. A partner replacing whole views is storing up upgrade problems.<\/p>\n Custom views live in modules<\/strong>, under version control, not scattered across Studio.<\/p>\n Studio use is logged.<\/strong> If Studio is used, somebody keeps a written note of what and why.<\/p>\n Views are tested at upgrades.<\/strong> Broken inherited views are one of the most common upgrade issues, and testing catches them before users do.<\/p>\n Be specific about three things and you will get what you wanted:<\/p>\n What information.<\/strong> “The customer’s PO number.”<\/p>\n Where.<\/strong> “On the invoice form, next to the invoice date.”<\/p>\n When.<\/strong> “Only when the customer is a business, not for walk-ins.”<\/p>\n That is enough to build from. “Make the invoice screen better” is not, and it produces a meeting rather than a change.<\/p>\n Odoo screens are descriptions in files<\/strong>, not drawings. That is why they can be patched by modules and why changes survive upgrades.<\/p>\n Inheritance is the key idea<\/strong> \u2014 a change is an instruction applied on top, not a copy.<\/p>\n Moving and hiding existing fields is quick. Adding information that does not exist is a bigger piece of work.<\/p>\n And when you ask for a change, say what, where, and under what condition<\/strong>. Three sentences saves a meeting.<\/p>\n Need screens that match how your team actually works?<\/p>\n Get in touch. Most layout changes are quicker than people expect \u2014 tell us what you want to see and where.<\/p>\n<\/div>","protected":false},"excerpt":{"rendered":" Screens are defined, not drawn In many systems a screen is designed in a visual editor and saved as a picture of itself. In Odoo, a screen is described in a file. The file says: show this field here, put these three in a group, add this tab, show this button when the record is […]<\/p>\n","protected":false},"author":3,"featured_media":9101,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[25],"tags":[],"class_list":["post-9100","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-odoo"],"yoast_head":"\nWhat a view definition contains<\/h2>\n
\n
\n
\n
Inheritance<\/h2>\n
\n
\n
Why some requests are quick and some are not<\/h2>\n
Studio and XML<\/h2>\n
When views break<\/h2>\n
\n
\n
\n
What good practice looks like<\/h2>\n
Asking for a view change<\/h2>\n
The short version<\/h2>\n