---

name: odoo-xml-views-builder description: "擅长构建 Odoo XML 视图：表单、列表、看板、搜索、日历和图表。为 Odoo 14-17 生成正确的 XML，使用正确的可见性语法。" risk: safe source: "self"

Odoo XML 视图构建器

概述

本技能生成和审查 Odoo XML 视图定义，包括看板、表单、列表、搜索、日历和图表视图。它理解可见性修饰符、groups、domain、context 和 widget 在 Odoo 14-17 各版本中的用法，包括从 attrs（v14-16）到内联表达式（v17+）的迁移。

适用场景

• 为自定义模型创建新的表单或列表视图。
• 向现有视图添加字段、标签页或智能按钮。
• 构建带有颜色编码或进度条的看板视图。
• 创建带有过滤器和分组选项的搜索视图。

工作原理

1. 激活：提及 @odoo-xml-views-builder 并描述你想要的视图。
2. 生成：获取完整的、可直接粘贴的 XML 视图定义。
3. 审查：粘贴现有 XML 并获取常见错误的修复建议。

示例

示例 1：带标签页的表单视图

<record id="view_hospital_patient_form" model="ir.ui.view">
    <field name="name">hospital.patient.form</field>
    <field name="model">hospital.patient</field>
    <field name="arch" type="xml">
        <form string="Patient">
            <header>
                <button name="action_confirm" string="Confirm"
                    type="object" class="btn-primary"
                    invisible="state != 'draft'"/>
                <field name="state" widget="statusbar"
                    statusbar_visible="draft,confirmed,done"/>
            </header>
            <sheet>
                <div class="oe_title">
                    <h1><field name="name" placeholder="Patient Name"/></h1>
                </div>
                <notebook>
                    <page string="General Info">
                        <group>
                            <field name="birth_date"/>
                            <field name="doctor_id"/>
                        </group>
                    </page>
                </notebook>
            </sheet>
            <chatter/>
        </form>
    </field>
</record>

示例 2：看板视图

<record id="view_hospital_patient_kanban" model="ir.ui.view">
    <field name="name">hospital.patient.kanban</field>
    <field name="model">hospital.patient</field>
    <field name="arch" type="xml">
        <kanban default_group_by="state" class="o_kanban_small_column">
            <field name="name"/>
            <field name="state"/>
            <field name="doctor_id"/>
            <templates>
                <t t-name="kanban-card">
                    <div class="oe_kanban_content">
                        <strong><field name="name"/></strong>
                        <div>Doctor: <field name="doctor_id"/></div>
                    </div>
                </t>
            </templates>
        </kanban>
    </field>
</record>

最佳实践

• 推荐：使用内联 invisible="condition"（Odoo 17+）代替 attrs 来实现显示/隐藏逻辑。
• 推荐：仅在目标为 Odoo 14-16 时使用 attrs="{'invisible': [...]}" — 在 v17 中已弃用。
• 推荐：始终在视图记录上设置 string 属性以便于调试。
• 推荐：使用 <chatter/>（v17）或 <div class="oe_chatter"> + 字段标签（v16 及以下）进行活动跟踪。
• 避免：在 Odoo 17 中使用 attrs — 已完全弃用，会在日志中产生警告。
• 避免：在视图 XML 中放置业务逻辑 — 应保留在 Python 模型方法中。
• 避免：在视图中使用硬编码的 domain 字符串，当模型上的 domain 字段可以动态使用时。

限制

• 不涵盖 OWL JavaScript 组件 或客户端组件开发。
• 搜索面板视图（<searchpanel>）未完全覆盖 — 需要前端知识。
• 不涉及 网站 QWeb 视图 — 请使用 @odoo-qweb-templates。
• 队列和地图视图（仅企业版）不在本技能覆盖范围内。