第一次使用 iDempiere：基礎設定全攻略
剛安裝好 iDempiere 卻不知道從何開始？別擔心！這篇完整攻略將帶你一步步完成所有必要的初始設定，包括 System Configurator 參數調整、使用者帳號管理、SMTP 郵件配置與語言切換。跟著本教學操作，你的 ERP 系統將能立即上線運作，為企業流程數位化打下穩固基礎。
一、登入後的第一件事：了解 iDempiere 介面
成功安裝 iDempiere 後，開啟瀏覽器前往 http://你的伺服器IP:8080/webui/，你會看到登入畫面。預設的管理員帳號資訊如下：
- 使用者名稱：SuperUser
- 密碼：System
- Client：System
- Organization：*
- Role：System Administrator
登入後，你會進入 iDempiere 的主介面。讓我們先熟悉幾個重要區域：
1.1 主要介面元素
- 左側選單 (Menu)：所有功能模組的入口，可展開各個資料夾找到需要的功能
- 頂部工具列：包含搜尋、通知、使用者設定等快捷功能
- 工作區 (Workspace)：中央區域，開啟的視窗會以分頁方式顯示
- 狀態列：顯示目前登入的 Client、Organization 與 Role 資訊
1.2 搜尋功能
iDempiere 內建強大的全域搜尋功能。按下 Ctrl + K（或點擊搜尋圖示），即可快速搜尋任何功能視窗。例如輸入「System Configurator」就能直接開啟系統設定。
二、System Configurator 設定：打造專屬你的 ERP
System Configurator 是 iDempiere 的核心設定中心，讓你能夠自訂系統行為與外觀。以下是新手必須調整的重要參數：
2.1 開啟 System Configurator
- 在選單搜尋中輸入「System Configurator」
- 或依路徑：System Admin → General Rules → System Rules → System Configurator
2.2 更換 Logo (WEBUI_LOGOURL)
想讓 iDempiere 顯示公司品牌 Logo？找到 WEBUI_LOGOURL 參數：
| 參數名稱 | 說明 | 建議值 |
|---|---|---|
| WEBUI_LOGOURL | 網頁介面左上角的 Logo 圖片網址 | 圖片尺寸建議 100×52 像素 |
| ZK_LOGO_LARGE | 登入頁面的大型 Logo | 建議使用較大尺寸的公司 Logo |
設定步驟：
- 準備好你的 Logo 圖片，上傳到可公開存取的位置
- 在 System Configurator 搜尋「WEBUI_LOGOURL」
- 在 Value 欄位填入圖片的完整 URL
- 儲存後重新整理頁面即可看到變更
2.3 修改瀏覽器標題 (ZK_BROWSER_TITLE)
預設的瀏覽器標題是「iDempiere」，你可以改成公司名稱或自訂文字：
- 參數名稱：ZK_BROWSER_TITLE
- 範例值：ABC 公司 ERP 系統
2.4 調整檔案上傳限制 (ZK_MAX_UPLOAD_SIZE)
如果需要上傳較大的附件檔案，必須調整此參數：
- 參數名稱：ZK_MAX_UPLOAD_SIZE
- 預設值：5（MB）
- 建議值：依業務需求調整，一般設為 10-50 MB
2.5 設定每頁顯示筆數 (ZK_PAGING_SIZE)
這個參數決定列表畫面預設顯示多少筆資料：
- 參數名稱：ZK_PAGING_SIZE
- 預設值：20
- 建議值：依螢幕大小調整，50-100 筆較為適中
2.6 Session 超時設定 (ZK_SESSION_TIMEOUT_IN_SECONDS)
設定使用者閒置多久後自動登出：
- 參數名稱：ZK_SESSION_TIMEOUT_IN_SECONDS
- 預設值：1800（30 分鐘）
- 建議值：依安全需求調整，3600（1 小時）較為寬鬆
三、使用者管理：建立帳號與安全設定
完成系統基礎設定後，接下來要設定使用者帳號。良好的帳號管理是系統安全的第一道防線。
3.1 建立新使用者帳號
- 進入 System Admin → General Rules → Security → User
- 點擊「新增」按鈕建立新記錄
- 填寫必要欄位：
- Name：使用者顯示名稱
- Search Key：登入帳號（建議使用英文）
- Email：使用者電子郵件
- Password：設定初始密碼
- 在「User Roles」分頁指派角色權限
- 儲存即完成
3.2 修改使用者密碼
有兩種方式可以修改密碼：
方法一：管理員修改
- 開啟 User 視窗，找到要修改的使用者
- 直接修改 Password 欄位
- 儲存即完成
方法二：使用者自行修改
- 點擊右上角的使用者圖示
- 選擇「Change Password」
- 輸入舊密碼與新密碼
- 確認即完成
3.3 關閉預設 System 帳號（重要！）
為了安全考量，強烈建議在建立自己的管理員帳號後，關閉預設的 System 帳號：
- 先確認已建立並測試新的系統管理員帳號
- 進入 User 視窗，找到「System」或「SuperUser」帳號
- 取消勾選「Active」欄位
- 儲存即完成
四、SMTP 郵件設定：讓系統能寄送通知
iDempiere 需要 SMTP 設定才能發送系統通知、密碼重設郵件等。以下說明如何設定郵件伺服器：
4.1 進入郵件設定
路徑：System Admin → General Rules → System Rules → Mail Server
4.2 SMTP 參數設定
| 欄位名稱 | 說明 | 範例值 |
|---|---|---|
| Name | 郵件伺服器名稱 | 公司郵件伺服器 |
| SMTP Host | SMTP 伺服器位址 | smtp.gmail.com 或自建主機 |
| SMTP Port | SMTP 連接埠 | 587（TLS）或 465（SSL）或 2525 |
| Request User | SMTP 認證帳號 | [email protected]（需含完整 Domain） |
| Request User Password | SMTP 認證密碼 | 你的郵件密碼或應用程式密碼 |
| Is SMTP Authorization | 是否需要認證 | 勾選（大多數情況） |
- Request User 必須填寫完整的 Email 格式（含 @domain）
- 如果使用 Gmail，需要開啟「應用程式密碼」功能
- 部分郵件服務需要開啟「允許較不安全的應用程式」選項
4.3 測試郵件發送
設定完成後，可以透過以下方式測試：
- 儲存 Mail Server 設定
- 點擊工具列的「Test EMail」按鈕
- 輸入測試收件者 Email
- 檢查是否成功收到測試郵件
五、語言設定：切換為繁體中文介面
iDempiere 支援多國語言，以下說明如何啟用繁體中文：
5.1 啟用語言
- 進入 System Admin → General Rules → System Rules → Language
- 搜尋「zh_TW」（繁體中文）
- 勾選以下欄位：
- System Language：允許系統使用此語言
- Login Locale：在登入畫面顯示此語言選項
- 儲存設定
5.2 載入語言翻譯
啟用語言後，需要執行翻譯同步：
- 執行 Language Maintenance 程序
- 選擇要同步的語言（zh_TW）
- 等待同步完成
5.3 使用者切換語言
每個使用者可以自行選擇介面語言：
- 點擊右上角使用者圖示
- 選擇「Preference」或「偏好設定」
- 在 Language 欄位選擇「繁體中文 (台灣)」
- 儲存並重新登入
六、常見問題排解
6.1 無法登入系統
問題：輸入帳號密碼後無法登入
解決方案：
- 確認帳號密碼大小寫正確
- 檢查 Client、Organization、Role 是否選擇正確
- 確認使用者帳號為 Active 狀態
- 嘗試清除瀏覽器快取或使用無痕模式
6.2 設定沒有生效
問題：修改 System Configurator 後看不到變化
解決方案：
- 確認已正確儲存設定
- 嘗試登出後重新登入
- 部分設定需重啟 iDempiere 服務才會生效
- 清除瀏覽器快取（Ctrl + Shift + R）
6.3 郵件無法發送
問題：SMTP 設定後測試郵件失敗
解決方案：
- 確認 SMTP Host 與 Port 設定正確
- Request User 需包含完整 @domain.com
- 檢查防火牆是否阻擋 SMTP 連接埠
- 如使用 Gmail，確認已設定應用程式密碼
- 查看伺服器 Log 取得詳細錯誤訊息
6.4 中文顯示亂碼
問題：介面或報表出現亂碼
解決方案：
- 確認資料庫編碼為 UTF-8
- 檢查瀏覽器編碼設定
- 確認已正確執行語言同步程序
七、總結與下一步
完成以上基礎設定後，你的 iDempiere 系統已經具備：
- ✅ 客製化的品牌外觀（Logo、標題）
- ✅ 符合業務需求的系統參數
- ✅ 安全的使用者帳號配置
- ✅ 可運作的郵件通知功能
- ✅ 繁體中文操作介面
接下來，你可以開始設定組織架構、會計科目、產品資料等業務核心設定。在下一篇文章中，我們將深入介紹 iDempiere 的組織與角色權限設定。
常見問題 FAQ
Q1：iDempiere 的預設帳號密碼是什麼？
預設管理員帳號為「SuperUser」，密碼為「System」。首次登入後請務必修改密碼並建立自己的管理員帳號，以確保系統安全。
Q2：System Configurator 修改後為什麼沒有立即生效？
部分設定需要重新登入或重啟 iDempiere 服務才會生效。建議先登出再登入，若仍無效則重啟服務。另外也可嘗試清除瀏覽器快取（Ctrl + Shift + R）。
Q3：SMTP 郵件設定一直失敗怎麼辦？
常見原因包括：(1) Request User 沒有填寫完整的 Email 格式（需含 @domain.com）；(2) 防火牆阻擋 SMTP 連接埠；(3) 使用 Gmail 等服務需另外設定應用程式密碼。建議檢查伺服器 Log 取得詳細錯誤訊息。
Q4：如何更換 iDempiere 的 Logo？
在 System Configurator 搜尋「WEBUI_LOGOURL」參數，將 Value 欄位改成你的 Logo 圖片 URL。建議圖片尺寸為 100×52 像素。登入頁面的大 Logo 則修改「ZK_LOGO_LARGE」參數。
Q5：可以讓不同使用者使用不同的介面語言嗎？
可以！每個使用者可在自己的 Preference（偏好設定）中選擇慣用語言。系統管理員需先在 Language 設定中啟用該語言，並確認已執行語言同步。
發佈留言