Construtor de Views XML do Odoo

Visão Geral

Esta habilidade gera e revisa definições de views XML do Odoo para views Kanban, Formulário, Lista, Busca, Calendário e Gráfico. Ela entende modificadores de visibilidade, groups, domain, context e o uso de widgets em todas as versões do Odoo de 14 a 17, incluindo a migração de attrs (v14–16) para expressões inline (v17+).

Quando Usar Esta Habilidade

• Criando uma nova view de formulário ou lista para um modelo personalizado.
• Adicionando campos, abas ou botões inteligentes a uma view existente.
• Construindo uma view Kanban com codificação por cor ou barras de progresso.
• Criando uma view de busca com filtros e opções de agrupamento.

Como Funciona

1. Ativar: Mencione @odoo-xml-views-builder e descreva a view que você deseja.
2. Gerar: Obtenha definições completas de view XML prontas para colar.
3. Revisar: Cole o XML existente e obtenha correções para erros comuns.

Exemplos

Exemplo 1: View de Formulário com Abas

<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>

Exemplo 2: View Kanban

<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>

Melhores Práticas

• ✅ Faça: Use invisible="condition" inline (Odoo 17+) em vez de attrs para lógica de mostrar/ocultar.
• ✅ Faça: Use attrs="{'invisible': [...]}" apenas se você estiver visando Odoo 14–16 — ele é depreciado na v17.
• ✅ Faça: Sempre defina um atributo string em seu registro de view para clareza na depuração.
• ✅ Faça: Use <chatter/> (v17) ou <div class="oe_chatter"> + tags de campo (v16 e anteriores) para rastreamento de atividades.
• ❌ Não Faça: Use attrs no Odoo 17 — ele é totalmente depreciado e gera avisos nos logs.
• ❌ Não Faça: Coloque lógica de negócios em XML de view — mantenha-a em métodos de modelo Python.
• ❌ Não Faça: Use strings domain codificadas em views quando um campo domain no modelo puder ser usado dinamicamente.

Limitações

• Não cobre widgets JavaScript OWL ou desenvolvimento de componentes do lado do cliente.
• Views de painel de busca (<searchpanel>) não são totalmente cobertas — elas exigem conhecimento de frontend.
• Não aborda views QWeb de website — use @odoo-qweb-templates para elas.
• Views de Cohort e Mapa (apenas Enterprise) não são cobertas por esta habilidade.