摘要：大家好鴨，我又來更新啦還記得我們?cè)诘诙坛讨刑岬竭^的動(dòng)作嗎，今天我們就來專門講講在中的，學(xué)習(xí)不同類型的動(dòng)作對(duì)應(yīng)的應(yīng)用場(chǎng)景，并且在我們的應(yīng)用中使用上其中一些類型的動(dòng)作。報(bào)表動(dòng)作這類型的動(dòng)作用于觸發(fā)報(bào)表打印，例如打印發(fā)票等。

大家好鴨，我又來更新啦！還記得我們?cè)诘诙坛讨刑岬竭^的動(dòng)作（actions）嗎，今天我們就來專門講講在 Odoo 中的 action，學(xué)習(xí)不同類型的動(dòng)作對(duì)應(yīng)的應(yīng)用場(chǎng)景，并且在我們的 Todo 應(yīng)用中使用上其中一些類型的動(dòng)作。

窗口動(dòng)作在 Odoo 中是最常見也是最常用的動(dòng)作類型，在第二篇教程中我們創(chuàng)建菜單的時(shí)候就已經(jīng)用過窗口動(dòng)作了，我們打開 menus.xml 來看看一個(gè)窗口動(dòng)作的組成：

    
    
        待辦事項(xiàng)
        todo.task
        form
        tree,form
        current
    

這里的 model 之前我們也說過，對(duì)應(yīng)的是這個(gè)動(dòng)作的類型（每個(gè)類型的動(dòng)作都對(duì)應(yīng)一個(gè)模型），我們重點(diǎn)來看看下面列出的字段以及沒有列出來的字段，分別說明一下它們各自的作用。

res_model：要打開的視圖（窗口）關(guān)聯(lián)的數(shù)據(jù)模型

view_type：視圖類型，默認(rèn)值為 form，一般情況下我們?nèi)∧J(rèn)值就可以了

view_mode：允許打開的視圖類型，以逗號(hào)分隔，默認(rèn)值為 tree,form

target：打開的窗口類型，常用的有 current（當(dāng)前窗口打開）和 new （彈窗打開）這兩種，默認(rèn)為 current

除了上述列出的一些字段外，還有一些非必填的字段在某些時(shí)候我們是會(huì)用上的，這里也分列出來：

view_ids：關(guān)聯(lián)的視圖對(duì)象 id，需注意區(qū)分和 view_id 的區(qū)別

view_id：關(guān)聯(lián)的視圖的 id, 例如在不同時(shí)候需要打開同一個(gè)數(shù)據(jù)模型不同的表單視圖，就可以通過這個(gè)字段指定要打開的視圖的 id

res_id：僅在視圖類型為 form 時(shí)有效，表示打開該 id 對(duì)應(yīng)的記錄的表單視圖，如未指定則打開新建頁(yè)面

context：傳遞到上下文中的數(shù)據(jù)，一個(gè)字典

domain：過濾規(guī)則，對(duì)視圖中的記錄進(jìn)行過濾

limit：列表中每頁(yè)顯示的記錄數(shù)量，默認(rèn)為 80

search_view_id：指定搜索視圖，不指定則按默認(rèn)規(guī)則加載

multi：如果設(shè)置為 True 且動(dòng)作綁定了模型（src_model）的話，該動(dòng)作按鈕會(huì)只出現(xiàn)在所綁定模型列表視圖的「動(dòng)作」下拉列表中（在搜索視圖左側(cè)）

views：由 (view_id, view_type) 這樣的元組對(duì)組成的列表，view_id 為指定視圖的 id 或是 False（按默認(rèn)值取出對(duì)應(yīng)視圖），view_type 表示視圖類型

其中 views 是一個(gè)計(jì)算字段，該字段會(huì)根據(jù) view_ids, view_mode 和 view_id 自動(dòng)計(jì)算出來，大致分為三個(gè)步驟：

從 view_ids 中順序取出 id 和視圖類型，組成 (view_id, view_type) 元組對(duì)加入到 views 列表中

若定義了 view_id 且對(duì)應(yīng)的視圖類型不在 view_ids 中，則加入到 views 中

最后對(duì) view_mode 中指定的視圖類型，但是不存在于 view_ids 和 view_id 中，則將其 view_id 置為 False 組成元組對(duì)后加入到 views 中

這里需要強(qiáng)調(diào)一點(diǎn)的是，如果我們?cè)谀承r(shí)候需要直接通過 Python 代碼或 JS 代碼打開一個(gè)窗口動(dòng)作，此時(shí)我們將需要自己添加 views 字段，否則將會(huì)拋出錯(cuò)誤，具體的實(shí)例我們將在之后使用到了再進(jìn)行講解分析。

Server Action 可以在服務(wù)端執(zhí)行復(fù)雜的邏輯代碼，是非常強(qiáng)大的一種動(dòng)作類型。我們先給代辦事項(xiàng)添加一個(gè) Server Action 用于快速完成任務(wù)的動(dòng)作，這樣我們就不用每次都要點(diǎn)進(jìn)去一個(gè)任務(wù)然后進(jìn)入編輯狀態(tài)再勾選保存這么多步驟了。

我們來看看定義一個(gè)最簡(jiǎn)單的 Server Action 應(yīng)該包含哪些內(nèi)容：

    
    
        標(biāo)記完成
        
        
        code
        records.write({"is_done": True})
    

和其他所有在數(shù)據(jù)文件（XML）中定義的數(shù)據(jù)一樣，首先是一個(gè)包含屬性 id 和 model 的 標(biāo)簽，我們要定義的是 Server Action, 所以需要將 model 設(shè)置為 ir.actions.server，然后是對(duì)應(yīng) Server Action 模型下的一些字段：

model_id：當(dāng)前的動(dòng)作是在哪個(gè)模型上運(yùn)行的

binding_model_id：綁定的模型，當(dāng)前動(dòng)作將會(huì)出現(xiàn)在綁定的模型的視圖中

state：服務(wù)器動(dòng)作的類型，總共有 4 種可選的類型，分別是 code（執(zhí)行 Python 代碼），object_create（創(chuàng)建一條新記錄），object_write（更新記錄），multi（執(zhí)行多個(gè)動(dòng)作）

code：對(duì)應(yīng) state 的類型 code，為當(dāng)前動(dòng)作運(yùn)行時(shí)所要執(zhí)行的 Python 代碼

大家應(yīng)該都留意到了在上面的定義中出現(xiàn)了一個(gè)屬性 ref，如果我沒有理解錯(cuò)，它應(yīng)該是 reference 的縮寫，它的值是一個(gè)外部 ID（external id），我們上面定義的這個(gè)動(dòng)作的外部 ID 就是定義時(shí)添加的 id 屬性的值 action_mark_todo_task_done，它指向一條具體的記錄（就像 Many2one 字段一樣）。

我們定義的所有模型都會(huì)在 ir.model.data 對(duì)應(yīng)的表中存在相應(yīng)的記錄，這些模型的外部 ID 形如 model_model_name，其中 model_name 是將模型名 [model.name](http://model.name) 的 . 替換成 _，例如我們的 todo.task 模型的外部 ID 就是前綴 model_ 加上 todo_task 組成的 model_todo_task 了。

接下來我們?cè)倏吹阶侄?code 里面的內(nèi)容，在這里面我們有一些變量是可以直接使用的：

env：Odoo 的運(yùn)行環(huán)境

model：動(dòng)作觸發(fā)時(shí)對(duì)應(yīng)的 Odoo 模型實(shí)例

record：動(dòng)作觸發(fā)時(shí)對(duì)應(yīng)的單個(gè)記錄（如在表單視圖中運(yùn)行對(duì)應(yīng)當(dāng)前表單所指向的記錄），可能是空的

records：動(dòng)作觸發(fā)時(shí)對(duì)應(yīng)的記錄集（如在列表視圖中勾選多條記錄觸發(fā)，記錄集指向這些選中的記錄），可能是空的

Python 庫(kù)：time, datetime, dateutil, timezone 時(shí)間相關(guān)的 Python 庫(kù)

log：用來記錄日志信息

Warning：通過 raise Warning("xxxxx") 拋出警告信息

除了上述可以直接使用的變量外，還有一個(gè) action 變量，當(dāng)我們想讓當(dāng)前動(dòng)作執(zhí)行完畢之后，返回一個(gè)新的動(dòng)作繼續(xù)執(zhí)行，就可以將返回的動(dòng)作的定義（一個(gè)字典）賦值給變量 action，客戶端將會(huì)自動(dòng)執(zhí)行該動(dòng)作。

OK, 前面說了這么多，我們更新一下代碼，然后刷新瀏覽器看看效果吧：

在列表視圖中，當(dāng)我們勾選了任意的記錄后，將會(huì)出現(xiàn)一個(gè)「動(dòng)作」菜單，打開之后就可以看到我們剛剛定義的「標(biāo)記完成」這個(gè) Server Action 了，試試看執(zhí)行會(huì)發(fā)生什么，注意觀察「已完成?」這一列的變化。然后再創(chuàng)建一條新的記錄，在表單頁(yè)面中，同樣有「動(dòng)作」菜單，我們?cè)谶@里也可以執(zhí)行「標(biāo)記完成」的動(dòng)作，怎么樣，是不是比原本的編輯再勾選再保存要方便得多了，而且我們還能在列表里勾選多條記錄進(jìn)行批量操作，不能更方便了！

受限于篇幅，我們這里只涉及了 state 為 code 類型的服務(wù)器動(dòng)作，相對(duì)其他三種類型，已經(jīng)足以應(yīng)付絕大多數(shù)場(chǎng)景的需求了，這里就不展開細(xì)說，感興趣的同學(xué)可以看看官方模塊的相關(guān)實(shí)現(xiàn)，要學(xué)會(huì)看源碼哈！

URL Action 用來打開一個(gè)網(wǎng)頁(yè)鏈接，十分簡(jiǎn)單的一種動(dòng)作類型：

    
        打開谷歌
        new
        https://google.com
    

上面這個(gè)動(dòng)作觸發(fā)后將會(huì)新開瀏覽器窗口（或新標(biāo)簽）打開谷歌首頁(yè)，主要的兩個(gè)字段如下：

target：有兩個(gè)可選值，分別是新窗口（new）打開鏈接，相當(dāng)于 ，以及當(dāng)前窗口（self）打開，相當(dāng)于

    
        Dashboard
        backend_dashboard