odoo 開發入門教程系列-一些用戶界面

一些用戶界面

資料檔案 (XML)

參考: 該主題關聯檔案可以查看Data Files.

上一章，我們通過CSV檔案添加了資料，當需要添加資料格式簡單時，用CSV格式還是很方便的，當資料格式更復雜時(比如視圖架構或者一個郵件模板)，我們使用XML格式，比如包含HTML tags的 help field，雖然可以通過CSV檔案加載這樣的資料，但是使用XML更方便，

類似CSV檔案，XML檔案也必須按約定添加到合適的目錄，并在 __manifest__.py中進行定義，資料檔案中的內容也是在模塊安裝或者更新時按序加載，因此，對CSV檔案所做的所有說明對XML檔案都適用，當資料鏈接到視圖時，我們將它們添加到views檔案夾中

本章，我們將通過XML檔案加載我們第一個action和選單，Actions 和選單為資料庫中的標準記錄，

注解：

當程式很注重性能時，CSV格式優先于XML格式，這是因為，在odoo中加載CSV檔案比加載XML檔案更快，

odoo中，用戶介面(action，選單和視圖)大部分是通過創建和組裝XML檔案中的記錄來定義的，常見的模式為 選單> action > 視圖，為了訪問記錄，用戶在幾個選單級中導航，最深層是觸發打開記錄串列的action，

操作(Actions)

參考: 主題相關檔案可以查看 Actions.

動作可以通過三種方式觸發 :

1. 點擊選單專案(鏈接接到指定動作)
2. 點擊視圖按鈕(如果與action關聯)
3. 物件的背景關系action

本章僅涵蓋第一種情況， 我們Real Estate例子中，希望將一個選單連接到 estate.property model, 以便創建一個新記錄， action可以視為選單和model之間的鏈接

test.model 的基本action:

<record id="test_model_action" model="ir.actions.act_window">
    <field name="name">Test action</field>
    <field name="res_model">test.model</field>
    <field name="view_mode">tree,form</field>
</record>

• id 外部標識，它可以用于參考記錄（不需要知道其在資料庫中的識別符號），
• model ir.actions.act_window (Window Actions (ir.actions.act_window))的一個固定值
• name action名稱
• res_model action應用的范圍，
• view_mode 可獲取的視圖，本例中為串列(樹)和表格視圖，

odoo中到處都可以找到例子，但是這個 簡單action的好例子，關注XML 資料檔案結構，因為你在后續的練習中會用到，

<?xml version="1.0"?>
<odoo>
    <record id="crm_lost_reason_view_search" model="ir.ui.view">
        <field name="name">crm.lost.reason.view.search</field>
        <field name="model">crm.lost.reason</field>
        <field name="arch" type="xml">
            <search string="Search Opportunities">
                <field name="name"/>
                <filter string="Include archived" name="archived" domain="['|', ('active', '=', True), ('active', '=', False)]"/>
                <separator/>
                <filter string="Archived" name="inactive" domain="[('active', '=', False)]"/>
            </search>
        </field>
    </record>

    <record id="crm_lost_reason_view_form" model="ir.ui.view">
        <field name="name">crm.lost.reason.form</field>
        <field name="model">crm.lost.reason</field>
        <field name="arch" type="xml">
            <form string="Lost Reason">
                <sheet>
                    <div  name="button_box">
                        <button name="action_lost_leads" type="object"
                             icon="fa-star">
                            <div >
                                <field name="leads_count" />
                                <span > Leads</span>
                            </div>
                        </button>
                    </div>
                    <widget name="web_ribbon" title="Archived" bg_color="bg-danger" attrs="{'invisible': [('active', '=', True)]}"/>
                    <div >
                        <div >
                            <label for="name"/>
                        </div>
                        <h1 >
                            <field name="name" />
                        </h1>
                        <field name="active" invisible="1"/>
                    </div>
                </sheet>
            </form>
        </field>
    </record>

    <record id="crm_lost_reason_view_tree" model="ir.ui.view">
        <field name="name">crm.lost.reason.tree</field>
        <field name="model">crm.lost.reason</field>
        <field name="arch" type="xml">
            <tree string="Channel" editable="bottom">
                <field name="name"/>
            </tree>
        </field>
    </record>

    <!-- Configuration/Lead & Opportunities/Lost Reasons Menu -->
    <record id="crm_lost_reason_action" model="ir.actions.act_window">
        <field name="name">Lost Reasons</field>
        <field name="res_model">crm.lost.reason</field>
        <field name="view_mode">tree,form</field>
        <field name="help" type="html">
          <p >
            Define a new lost reason
          </p><p>
            Use lost reasons to explain why an opportunity is lost.
          </p><p>
            Some examples of lost reasons: "We don't have people/skill", "Price too high"
          </p>
        </field>
    </record>

    <record id="menu_crm_lost_reason" model="ir.ui.menu">
        <field name="action" ref="crm.crm_lost_reason_action"/>
    </record>
</odoo>

練習

為 estate.property model 創建action，

在適當的位置(本例中為odoo14/custom/estate/models/views)創建 estate_property_views.xml

<?xml version="1.0"?>
<odoo>
    <record id="link_estate_property_action" model="ir.actions.act_window">
        <field name="name">Properties</field>
        <field name="res_model">estate.property</field>
        <field name="view_mode">tree,form</field>
    </record>
</odoo>

修改odoo14/custom/estate/__manifest__.py

#!/usr/bin/env python
# -*- coding:utf-8 -*-
{
    'name': 'estate',
    'depends': ['base'],
    'data':['security/ir.model.access.csv',
            'views/estate_property_views.xml'
            ]
}

重啟服務并觀察檔案加載日志，

選單(Menus)

參考: 和本主題關聯檔案可以查看Shortcuts.

為了減少選單(ir.ui.menu)定義和鏈接到對應action的復雜性，我們可以使用 shortcut

test_model_action 一個的基礎選單:

<menuitem id="test_model_menu_action" action="test_model_action"/>

test_model_menu_action 選單被鏈接到 test_model_action ，action鏈接到model test.model，正如前面所述， action可以看做是選單和model之間的連接，

注意：這里的id的值和action的值不能設定成一樣，否則會報錯，

然而，選單總是遵循一種體系結構，實際上有三個層次的選單：

1. 根選單，顯示在App切換器中（Odoo社區版切換器是一個下拉選單）
2. 第一級選單，顯示在頂部欄中
3. 動作選單

最容易的方式是在XML檔案中定義結構來創建選單，

為 test_model_action 定義的一個基礎選單結構:

<menuitem id="test_menu_root" name="Test">
    <menuitem id="test_first_level_menu" name="First Level">
        <menuitem id="test_model_menu_action" action="test_model_action"/>
    </menuitem>
</menuitem>

第三級選單的名稱，直接從action獲取，即為action屬性值

練習

添加選單

在合適的目錄(本例中為odoo14/custom/estate/models/views)創建 estate_menus.xml 檔案

<?xml version="1.0"?>
<odoo>
    <menuitem id="test_menu_root" name="Test">
        <menuitem id="test_first_level_menu" name="First Level">
            <menuitem id="estate_property_menu_action" action="link_estate_property_action"/>
        </menuitem>
    </menuitem>
</odoo>

修改odoo14/custom/estate/__manifest__.py

#!/usr/bin/env python
# -*- coding:utf-8 -*-
{
    'name': 'estate',
    'depends': ['base'],
    'data':['security/ir.model.access.csv',
            'views/estate_property_views.xml',
            'views/estate_menus.xml'
            ]
}

重啟odoo服務，查看效果

欄位，屬性和視圖(Fields, Attributes And View)

到目前為止，我們只對房產廣告使用了通用視圖，但在大多數情況下，我們希望對視圖進行微調，Odoo有許多微調方式，但通常第一步是確保：

• 某些欄位有默認值
• 某些欄位只讀
• 當記錄重復時，某些欄位不能被拷貝

在我們的房產業務案例中，我們希望：:

• 售價只讀(往后將自動填充)
• 當記錄重復時，可用日期和售價不能被拷貝
• 臥室數量應該默認為2
• 默認可用日期應該為3個月

一些新屬性

在進一步進行視圖設計之前，讓我們回到模型定義，我們看到一些屬性，如required=True，會影響資料庫中的表模式，其他屬性也將影響視圖或提供默認值，

練習 -- 添加一些屬性到欄位，

查找一些合適的屬性 (查看欄位) 來:

• 設定售價為只讀
• 阻止復制可用日期和售價

修改 odoo14\custom\estate\models\estate_property.py 中EstateProperty類屬性expected_price，selling_price的值如下：

expected_price = fields.Float('expected price', digits=(8, 2),  required=True) 
selling_price = fields.Float('selling price', digits=(8, 2), readonly=True, copy=False)

重啟服務和并重繪瀏覽器界面，我們可以看到無法設定任何售價，復制記錄時，可用日期應為空，

預期效果可參考該影片連接：https://www.odoo.com/documentation/14.0/zh_CN/_images/attribute_and_default.gif

默認值

可以為任何欄位設定默認值，欄位定義中，添加 default=X， 其中的X 可以是Python文本值(boolean, integer, float, string) ，也可以是一個以model物件自身為入參并回傳一個值的函式：

name = fields.Char(default="Unknown")
last_seen = fields.Datetime("Last Seen", default=lambda self: fields.Datetime.now())

例中name欄位默認值為‘Unknown’，而last_seen 欄位默認值為當前時間

練習 -- 設定默認值

添加適當的默認值:

• 臥室數量默認值為 2
• 可用日期默認為3個月內

修改 odoo14\custom\estate\models\estate_property.py 中EstateProperty類屬性bedrooms，selling_price的值如下：

bedrooms = fields.Integer(default=2)
date_availability = fields.Datetime('Availability Date', copy=False, default= lambda self: fields.Datetime.today())

重啟服務和并重繪瀏覽器界面驗證

保留欄位

參考: 主題相關檔案可參考 保留欄位名稱.

odoo為預定義行為保留了一些欄位名稱，當需要相關行為時，需要在模型中定義這些保留欄位，

練習 -- 添加active欄位

添加一個 active 欄位到estate.property 模型，

修改 odoo14\custom\estate\models\estate_property.py 中EstateProperty類，增加active屬性

active = fields.Boolean('Active')

重啟服務，重繪瀏覽器界面，新增一條記錄，新增時勾選Active復選框，即active=True，驗證效果，

預期效果可參考該影片鏈接：https://www.odoo.com/documentation/14.0/zh_CN/_images/inactive.gif

注意，已存在的記錄的active欄位默認值為False

練習--為active欄位添加設定

為active欄位設定默認值

為 active 欄位設定適當的屬性值，讓它不再出現在頁面，

練習 -- 添加state欄位

為estate.property model添加state 欄位(欄位名可自定義)，一個選擇串列，可選值: New, Offer Received, Offer Accepted, Sold 和Canceled，必選欄位，且不能被拷貝，默認值New

修改 odoo14\custom\estate\models\estate_property.py 中EstateProperty類，修改active欄位，增加state欄位

    active = fields.Boolean('Active', default=True, invisible=True) # 注意：實踐發現，invisible欄位不起作用
    state = fields.Selection(
        string='State',
        selection=[('New','New'),
                   ('Offer Received','Offer Received'),
                   ('Offer Accepted', 'Offer Accepted'),
                   ('Sold','Sold'),
                   ('Canceled', 'Canceled')],
        copy=False
    )

重啟服務，驗證效果

作者：授客
微信/QQ：1033553122
全國軟體測驗QQ交流群：7156436
Git地址：https://gitee.com/ishouke
友情提示：限于時間倉促，文中可能存在錯誤，歡迎指正、評論！
作者五行缺錢，如果覺得文章對您有幫助，請掃描下邊的二維碼打賞作者，金額隨意，您的支持將是我繼續創作的源動力，打賞后如有任何疑問，請聯系我!!!
           微信打賞                        支付寶打賞                  全國軟體測驗交流QQ群  
              

標籤：Python

上一篇：Java之大數加減乘除——構建類

下一篇：Django筆記八之model中Meta引數的使用