在地化 · ODOO
不同國家的地址書寫順序不同。台灣通常先寫縣市,再寫鄉鎮市區與街路門牌;美國地址則通常先寫街道,再寫城市、州與郵遞區號。Odoo 可依聯絡人的國家,調整報表上的地址格式。
修改前,先確認目前的國家設定
Odoo 原生的地址顯示方式,會採用聯絡人所選國家的地址格式;沒有可用的國家格式時,才使用標準排列方式。在地化模組或先前的設定,可能已經調整過格式,因此應先檢查目前內容,不能認定每個資料庫的排列都相同。
這項設定只改變地址的顯示方式,不會改寫聯絡人的街道、城市、州/省或郵遞區號。國家資料通常由同一資料庫內的各家公司共用,修改後可能影響不只一家公司使用的報表。
在哪裡設定報表的地址格式?
- 具備設定權限後,開啟「聯絡人 → 設定 → 在地化 → 國家」(Contacts → Configuration → Localization → Countries)。實際選單位置可能依已安裝的應用程式與權限有所不同。
- 開啟要調整的國家,例如台灣,查看「報表中的版面配置」(Layout in Reports)。若也需要檢查「輸入檢視」(Input View)等技術欄位,可啟用開發者模式。
- 修改前先備份原本的格式,再依報表需求調整支援的欄位代碼與換行,確認後儲存設定。
- 確認測試聯絡人的國家與地址欄位正確,再重新產生使用原生地址元件的報價單、發票或出貨報表。
- 分別檢查帳單地址、送貨地址與公司地址,也要確認其他語言與共用同一國家設定的公司是否受到影響。
常用地址欄位代碼
請保留範例中的代碼語法:欄位名稱放在括號內,後方接小寫 s。不要將代碼中的欄位名稱改成中文標籤。
| 欄位代碼 | 用途 |
|---|---|
%(country_name)s | 國家名稱 |
%(country_code)s | 兩碼國家代碼,例如 TW |
%(state_name)s | 州/省名稱;台灣可用來存放縣市 |
%(state_code)s | 州/省代碼,不一定是完整名稱 |
%(city)s | 城市欄位;台灣可依資料規劃存放鄉鎮市區 |
%(zip)s | 郵遞區號 |
%(street)s | 街路門牌地址 |
%(street2)s | 地址第二行 |
台灣地址格式範例
如果資料一致地將縣市放在「州/省」、鄉鎮市區放在「城市」,其餘地址放在「街道」,可以參考以下排列方式。這是設定範例,不是強制的國家標準,仍應依郵寄與單據需求調整。
如果州/省選單尚未建立台灣縣市,請先由管理員建立屬於台灣的縣市資料。聯絡人未填寫或選取的縣市名稱,不會只因修改地址格式就自動出現。
%(zip)s %(state_name)s%(city)s%(street)s
%(street2)s
%(country_name)s
假設示範資料的郵遞區號為 100、州/省為「臺北市」、城市為「中正區」、街道為「範例路 1 號」、地址第二行為「5 樓」,且國家名稱以中文顯示,地址部分會呈現如下:
100 臺北市中正區範例路 1 號
5 樓
台灣
以上是示意資料,並非真實投遞地址,請為每位聯絡人填入正確的郵遞區號。避免在不同欄位重複填入縣市或鄉鎮市區,也要測試地址第二行留空的情況。公司或聯絡人名稱可能由報表另外顯示,加入地址格式前,應先確認是否會重複。
報表排列與輸入表單,是不同的設定
「報表中的版面配置」控制原生地址的顯示方式;「輸入檢視」則指定聯絡人表單的檢視,調整地址欄位的輸入方式。修改報表格式,不會自動重排輸入欄位、增加鄉鎮市區選單,或驗證郵遞區號,這些需求要另外處理。
中文與英文地址,要分開考慮
一筆國家資料只有一組報表地址格式,並不是每種語言各有一組。報表的語言設定可以影響已翻譯的國家名稱,但不會自動將中文街道或鄉鎮市區轉成英文郵寄地址。地址排列與地址翻譯,是不同的需求。
如果同時需要國內使用的中文單據,以及給海外收件人的英文單據,應先規劃兩種地址如何儲存,以及各報表何時使用哪一種。只修改國家的地址格式,不一定能滿足這個需求。
為什麼報表仍是原本的順序?
- 確認報表實際使用的是哪一筆資料:客戶、帳單地址、送貨地址,還是自己的公司。
- 檢查聯絡人的國家是否正確,以及地址欄位是否依約定的方式填寫。
- 重新產生報表,不要只開啟先前儲存的 PDF;部分報表會沿用已儲存的附件。
- 檢查客製化 QWeb 報表與外部物流串接。若範本直接列印個別欄位,或介面自行組合地址字串,就不一定會採用國家的報表地址格式。
單純調整地址順序,可先使用原生的國家設定。若還需要中英文地址、鄉鎮市區主檔,或物流商專用標籤,則應一併評估資料欄位、報表與串接方式。
參考資料: Odoo 國家地址格式欄位; 原生聯絡人地址顯示邏輯; 聯絡人設定選單.