字段和小部件?

字段結構化數據庫模型。如果你把模型想象成一個表格或電子表格,字段就是記錄中存儲數據的列(即行)。字段還定義了存儲在其中的數據類型。數據在 UI 上的呈現和格式化由它們的小部件定義。

從技術角度來看,Odoo有15種字段類型。然而,在Studio中,您可以選擇20種字段類型,因為某些字段類型具有不同的默認小部件而可用多次。

小技巧

只有在 表單列表 視圖中才能添加 新字段 。在其他視圖中,只能添加 現有字段 (已經在模型中的字段) 。

簡單字段?

簡單字段包含基本值,如文本、數字、文件等。

注解

如果有非默認的小部件可用,則會將其作為項目符號列在下面。

文本 ( char )?

文本 字段用于包含任何字符的短文本。填寫字段時會顯示一行文本。

  • 徽章 : 在一個圓形的形狀內顯示值,類似于標簽。該值無法在UI上編輯,但可以設置默認值。

  • 復制到剪貼板 : 用戶可以通過點擊按鈕復制該值。

  • 電子郵件 :該值將變成可點擊的 mailto 鏈接。

  • 圖片 : 使用URL顯示圖片。該值不能手動編輯,但可以設置默認值。

    注解

    使用 Text 字段和 Image 小部件時,與直接選擇 Image 字段 不同,因為圖像不會存儲在 Odoo 中。例如,如果您想節省磁盤空間,這可能很有用。

  • 電話 :該值將變成可點擊的 tel 鏈接。

    小技巧

    勾選 啟用短信 ,在字段旁邊添加一個直接從Odoo發送短信的選項。

  • URL :該值變為可點擊的URL。

Example

不同小部件的文本字段示例

多行文本 ( text )?

多行文本 字段用于包含任何類型字符的較長文本。在填寫該字段時,UI上會顯示兩行文本。

  • 復制到剪貼板 : 用戶可以通過點擊按鈕復制該值。

Example

不同小部件的多行文本字段示例

整數 ( integer )?

整數 字段用于所有整數( 正數、負數或零,不帶小數點 )。

  • 百分比餅圖 : 在一個百分比圓圈內顯示值,通常用于計算值。該值無法在UI上編輯,但可以設置默認值。

  • 進度條 : 顯示計算值的百分比條旁邊的值。該字段不能手動編輯,但可以設置默認值。

  • Handle : 顯示一個拖動句柄圖標,用于在 列表視圖 中手動排序記錄。

Example

不同小部件的整數字段示例

十進制數 ( float )?

Decimal 字段用于所有十進制數( 正數、負數或零,帶小數點 )。

注解

小數在用戶界面上顯示為小數點后兩位,但在數據庫中存儲時具有更高的精度。

  • Monetary : 它類似于使用 Monetary field 。建議使用后者,因為它提供了更多的功能。

  • 百分比 : 在數值后顯示百分號 % 。

  • 百分比餅圖 : 在百分比圓圈內顯示值,通常用于計算值。該字段不能手動編輯,但可以設置默認值。

  • 進度條 : 顯示計算值的百分比條旁邊的值。該字段不能手動編輯,但可以設置默認值。

  • 時間 : 值必須遵循 hh:mm 格式,最多為 59 分鐘。

Example

不同小部件的十進制字段示例

貨幣 ( monetary )?

Monetary 貨幣字段用于所有貨幣值。

注解

當您首次添加一個 Monetary 字段時,系統會提示您添加一個 Currency 字段,如果模型中還沒有該字段。Odoo 會為您提供添加 Currency 字段的選項。一旦添加了該字段,再次添加 Monetary 字段即可。

Example

貨幣字段示例及其貨幣字段

HTML( html?

Html 字段用于添加可以使用Odoo HTML編輯器進行編輯的文本。

  • 多行文本 : 禁用Odoo HTML編輯器,允許編輯原始HTML。

Example

不同小部件的Html字段示例

日期 ( date )?

Date 日期字段用于在日歷上選擇日期。

  • 剩余天數 : 顯示所選日期前剩余的天數(例如, 5天后 ),基于當前日期。

Example

不同小部件的日期字段示例

日期和時間 ( datetime )?

日期和時間 字段用于在日歷上選擇日期和在時鐘上選擇時間。如果沒有設置時間,將自動使用用戶當前時間。

  • 日期 :用于記錄時間但不在用戶界面上顯示。

  • 剩余天數 :顯示選定日期前剩余的天數(例如, 5天后 ),基于當前日期和時間。

Example

不同小部件的日期和時間字段示例

復選框 ( boolean )?

復選框 字段用于只能為真或假的值,通過勾選或取消勾選復選框來表示。

  • Button :顯示單選按鈕。該小部件可以在不切換到編輯模式的情況下工作。

  • 切換 : 顯示一個切換按鈕。該小部件可以在不切換到編輯模式的情況下工作。

Example

不同小部件的復選框字段示例

選擇 ( selection )?

選擇 字段用于用戶從預定義的值組中選擇單個值。

  • 徽章 : 在一個圓形的形狀內顯示值,類似于標簽。該值無法在UI上編輯,但可以設置默認值。

  • 徽章 : 在矩形形狀內同時顯示所有可選值,水平排列。

  • 優先級 : 顯示星號符號而不是值,可用于指示重要性或滿意度級別。這與選擇 優先級字段 具有相同的效果,盡管對于后者,已經預定義了四個優先級值。

  • 單選框 : 一次性顯示所有可選值,以單選按鈕的形式呈現。

    小技巧

    默認情況下,單選按鈕是垂直排列的。勾選 水平顯示 可以切換它們的顯示方式。

Example

不同小部件的選擇字段示例

優先級 ( 選擇 )?

Priority 字段用于顯示三星評級系統,可用于指示重要性或滿意度水平。該字段類型是一個帶有默認選擇 Priority 小部件和四個預定義優先級值的 選擇字段 。因此, Badge 、 Badges 、 RadioSelection 小部件的效果與 選擇字段 中描述的相同。

小技巧

要通過添加或刪除值來更改可用星級的數量,請單擊“ 編輯值 ”。請注意,第一個值等于0顆星(即未進行選擇時),因此有四個值會導致三星評級系統,例如。

Example

優先級字段示例

文件( 二進制?

文件 字段用于上傳任何類型的文件,或簽署表格( 簽名 小部件)。

  • 圖片 : 用戶可以上傳圖片文件,然后在 表單視圖 中顯示。這與使用 圖片字段 具有相同的效果。

  • PDF Viewer : 用戶可以上傳PDF文件,然后可以從 表單視圖 中瀏覽。

  • 簽名 : 用戶可以電子簽署表單。這與選擇 簽名字段 有相同的效果。

Example

不同小部件的文件字段示例

圖片 ( 二進制 )?

Image 字段用于上傳圖像并在 表單視圖 中顯示。該字段類型是一個 文件字段 ,默認選擇了 Image 小部件。因此, File 、 PDF ViewerSign 小部件具有與 文件 下描述的相同效果。

小技巧

要更改上傳圖片的顯示大小,請在 Size 選項下選擇 Small 、 MediumLarge 。

簽名 ( 二進制 )?

Sign 字段用于電子簽名表單。該字段類型是一個帶有默認選擇的 Sign 小部件的 文件字段 。因此, File 、 ImagePDF Viewer 小部件具有與 文件 中描述的相同效果。

小技巧

為了讓用戶在需要繪制簽名時選擇 自動 選項,選擇可用的 自動完成 字段之一(僅在模型上選擇 文本 、 Many2OneRelated Field )。簽名將使用所選字段的數據自動生成。

關聯字段?

關系字段用于鏈接和顯示另一個模型上的記錄數據。

注解

如果有非默認的小部件可用,則會將其作為項目符號列在下面。

多對一 ( many2one )?

Many2One 字段用于將另一個記錄(來自另一個模型)鏈接到正在編輯的記錄。來自另一個模型的記錄名稱將顯示在正在編輯的記錄上。

Example

銷售訂單 模型中, 客戶 字段是一個指向 聯系人 模型的 Many2One 字段。這允許 多個 銷售訂單鏈接到 一個 聯系人(客戶)。

顯示多對一關系的圖表

小技巧

  • 防止用戶在關聯模型中創建新記錄,請勾選“禁用創建”: Disable creation 。

  • 為了防止用戶在彈出窗口中打開記錄,請勾選“ 禁止打開 ”選項。

  • 為了幫助用戶僅選擇正確的記錄,請單擊 Domain 創建過濾器。

  • 徽章 : 在圓形形狀內顯示值,類似于標簽。該值無法在UI上進行編輯。

  • 單選框 : 一次性顯示所有可選值,以單選按鈕的形式呈現。

一對多 ( one2many )?

One2Many 字段用于顯示當前模型記錄與另一個模型中多個記錄之間的現有關系。

Example

您可以在 聯系人 模型上添加一個 One2Many 字段,以查看 一個 客戶的 多個 銷售訂單。

顯示一對多關系的圖表

注解

要使用 One2Many 字段,兩個模型必須已經使用 Many2One 字段 進行了鏈接。One2Many 關系不存在獨立的存在方式:會執行現有 Many2One 關系的反向搜索。

行( one2many?

Lines 字段用于創建帶有行和列的表格(例如,銷售訂單上的產品行)。

小技巧

要修改列,請單擊 字段,然后單擊 編輯列表視圖 。要編輯用戶單擊 添加一行 時彈出的表單,請單擊 編輯表單視圖 。

Example

多行文本框示例

多對多 ( many2many )?

Many2Many 字段用于將另一個模型中的多個記錄鏈接到當前模型中的多個記錄。Many2Many字段可以使用 禁用創建 , 禁用打開 , ,就像 Many2One字段 一樣。

Example

Task 模型中, Assignees 字段是一個指向 Contact 模型的 Many2Many 字段。這允許一個用戶被分配到 多個 任務,也允許 多個 用戶被分配到一個任務。

顯示多對多關系的圖表
  • 復選框 : 用戶可以使用復選框選擇多個值。

  • 標簽 : 用戶可以選擇出現在圓形形狀中的多個值,也稱為 標簽 。這與選擇 標簽字段 的效果相同。

標簽( many2many?

“Tags”字段用于顯示來自另一個模型的多個值,以圓形標簽的形式呈現。該字段類型是一個帶有默認選擇“Tags”小部件的 Many2Many field 。因此, CheckboxesMany2Many 小部件具有與 Many2Many 下描述的相同效果。

小技巧

若要顯示不同背景顏色的標簽,請勾選 使用顏色 。

Example

標簽字段示例

屬性?

  • 不可見 : 當用戶在UI上不需要查看字段時,請勾選 不可見 。它有助于通過僅顯示特定情況下的必要字段來清除UI。

    Example

    聯系人 模型的 表單 視圖中,只有在選擇了 個人 時, 稱謂 字段才會出現,因為對于 公司 聯系人來說,該字段沒有幫助。

    注解

    Invisible 屬性同樣適用于Studio。要在Studio中查看隱藏的字段,請單擊視圖的 View 選項卡并勾選 Show Invisible Elements 。

  • 必填項 : 如果一個字段在用戶能夠繼續之前必須始終由用戶填寫完成,請勾選 必填項 。

  • 只讀 : 如果用戶不應該能夠修改字段,請勾選 只讀 。

    注解

    您可以通過點擊 條件 并創建篩選器,選擇僅對特定記錄應用這三個屬性。

  • 標簽 : 標簽 是該字段在用戶界面上的名稱。

    注解

    這個名稱與PostgreSQL數據庫中使用的名稱不同。要查看和更改后者,請激活 開發者模式 ,并編輯 技術名稱 。

  • 幫助提示 : 如果需要解釋一個字段的用途,請在 幫助提示 下面編寫描述。當鼠標懸停在字段標簽上時,它會顯示在工具提示框內。

  • 占位符 : 為了提供一個字段應該如何填寫的示例,在 占位符 下面寫入它。它以淺灰色顯示,代替字段的值。

  • 小部件 : 選擇可用的小部件以更改字段的默認外觀或功能。

  • 默認值 : 如果要在創建記錄時向字段添加默認值,請使用 默認值 。

  • 限制可見性到組 : 選擇一個用戶訪問組來限制可以看到該字段的用戶。