跳轉到內容

ERP5 手冊/讓我們開始吧...

來自華夏公益教科書,開放的書籍,開放的世界

讓我們開始吧...

[編輯 | 編輯原始碼]

核心安裝

[編輯 | 編輯原始碼]

使用 RPM 倉庫是安裝和執行 ERP5 站點的另一種方法。下面是簡短而簡潔的說明,如何在幾個步驟內讓 ERP5 執行起來。

首先,我們需要獲取 Zope/ERP5 原始碼以及一些額外的軟體包。如果系統中已存在 Zope 安裝,我們需要解除安裝它。ERP5 使用一個經過修補的 Zope 版本,該版本與 ERP5 一起下載和安裝。可以安裝兩個 Zope 版本,但這屬於高階主題,這裡不會介紹。

有關詳細的下載說明,請閱讀 ERP5 主頁上的 下載指南。成功下載並安裝完所有軟體包後,我們可以繼續配置和設定。

仍然以 root 使用者身份,我們進入新建 Zope INSTANCE_HOME 目錄的 Products 子目錄,並執行 svn_update 指令碼,它會完成所有繁重的工作。由於 INSTANCE_HOME 應該位於 /var/lib/zope/,我們輸入以下命令:

cd /var/lib/zope/Products
ls (as shown on a screenshot this should show us some dirs and a script)
sh svn_update.sh

從 SVN 倉庫更新完資料後,我們需要確保 Zope 可以訪問它。我們可以將所有子目錄和其中的檔案設為 Zope 擁有:

chown -R zope:zope *

在控制檯中應該看起來像這樣: 使用 SVN 更新產品和業務模板

在執行 Zope 例項之前,還需要做最後一步。我們需要建立主管理員使用者。使用者名稱無所謂,只要包含標準字母即可。例如,如果我們要建立使用者名稱為 'zope'、密碼為 'zope' 的使用者,我們需要執行以下命令:

zopectl stop (to make sure Zope is stopped for adding a user)
zopectl adduser zope zope
zopectl start

輸出類似於:

Adding a manager user to new Zope instance

不要害怕 DeprecationWarnings。如果你不介意它們,它們也不會介意你。:)
執行完最後一個命令後,Zope 應該已經啟動並執行,我們可以透過在選擇的網路瀏覽器中訪問地址 https://:9080/manage 來檢查。
授權對話方塊應該彈出,要求輸入使用者名稱和密碼。我們輸入新建立的 zope 使用者名稱和密碼。

Creating a new database and assigning rights to it

如果對話方塊沒有彈出,瀏覽器顯示某種“無法連線”訊息,這意味著 Zope 例項並未真正啟動。要檢查是什麼阻止了正確啟動,最好進入 zopectl 介面並檢查啟動輸出。為此,我們可以輸入以下命令:

zopectl

並接收 zopectl> 提示後,輸入以下命令:

zopectl> logtail

以顯示啟動日誌的最後幾行(希望那裡有錯誤訊息),或者輸入

zopectl> stop
zopectl> foreground
(or zopectl> fg)

檢視啟動過程的完整輸出。消除潛在的錯誤不在本節的範圍之內。

在我們繼續建立和啟動 ERP5 站點之前,我們需要確保它在 MySQL 伺服器中擁有自己的空間。這很重要,因為 MySQL 中存在的預設測試資料庫用於測試程式,如果將其用於常規 ERP5 站點,可能會導致意外問題。要為新站點建立 erp5 資料庫,我們需要執行以下操作(我們假設資料庫名稱為 'erp5',但可以是其他任何名稱):

mysql (enter the mysql interface)
mysql> CREATE DATABASE erp5;
mysql> GRANT ALL ON erp5.* TO erp5@localhost IDENTIFIED BY 'erp5';
mysql> quit

輸出應該類似於:

Creating a new database and assigning rights to it

這將建立一個 'erp5' 資料庫,MySQL 使用者 'erp5@localhost' 可以使用密碼 'erp5' 訪問它,就像這樣。

一旦我們設定了資料庫,Zope 執行起來,並且我們以管理員使用者身份登入,就可以安裝 ERP5 站點物件,以便使用 ERP5 的所有功能。

Main Zope Management Interfaces screen

在類似於上面截圖中的根管理頁面中,我們應該從下拉框中選擇一個“ERP5 站點”物件。之後,我們會看到新 ERP5 站點的配置頁面。唯一需要重新配置的是 ERP5/MySQL 連線設定。在這裡,在所有三個欄位中,我們輸入資料庫名稱、該資料庫的使用者及其密碼。
在我們的例子中,應該是:erp5 erp5 erp5
資料庫型別應該保持為 InnoDB。

The ERP5 creation dialog page

最後,我們點選“建立新的 ERP5 例項”按鈕,等待一段時間讓所有內容設定好。

如果該過程成功,我們會重定向到 ERP5 站點的主頁,就像下面截圖中的那個頁面一樣。

The ERP5 main page

恭喜!

啟用首選項

[編輯 | 編輯原始碼]

在繼續之前,透過導航到 https://:9080/erp5/default_site_preference 並從操作框中選擇 **操作...->啟用首選項** 來啟用 default_site_preference。沒有啟用首選項,你可能會遇到神秘的錯誤訊息(與使用者介面 - 表單有關)。

驗證門戶規則

[編輯 | 編輯原始碼]

ERP5 中的新模擬系統需要驗證規則。導航到 https://:9080/erp5/portal_rules 並驗證該容器中的每個規則,使用規則的操作框或容器中的批次驗證操作。沒有驗證規則,許多模擬將無法建立,構建者將無法生成文件。

新增包

[編輯 | 編輯原始碼]

你可能已經注意到,螢幕幾乎是空的,除了欣賞 ERP5 的美麗 logo 之外,你什麼也做不了。這是正常的,因為你建立了一個空站點,還沒有安裝任何包 - 我們稱之為“業務模板”(有關更多資訊,請參閱 業務模板)。

看看“管理業務模板”工具(可從左上角的“我的收藏夾”下拉選單中訪問) - 你會發現你只有三個模板:core、xhtml_style 和 mysql_innodb_catalog。這三個模板是 ERP5 執行所必需的,並在引導時安裝。

要開始,首先安裝 erp5_base - 它提供了最基本的功能,並且所有其他模板都需要它。

有關如何下載、安裝和升級模板的說明,請參閱 安裝技術

一般概念

[編輯 | 編輯原始碼]
典型的業務模板倉庫配置

從開發人員的角度來看,業務模板是一個軟體包,其中包含一些元資料和功能,這些元資料和功能對於打包系統來說是典型的:依賴項、配置、指令碼、安裝/升級/解除安裝系統。開發人員幾乎可以將 ZODB 的任何修改放到業務模板中。有一些限制,但 BT 系統一直在不斷發展。

從顧問的角度來看,業務模板是一組可安裝/升級/解除安裝的物件,其依賴項將自動計算。以 .bt5 結尾的業務模板檔案通常可以與流行的 .rpm.deb 檔案格式相比。ERP5 中的業務模板系統就像 yumrpmdrakedselect

業務模板檔案存在於某種型別的儲存庫中 - 在 http 伺服器上,在本地檔案系統上 - 以及生成的 XML 檔案 bt5list。 一個 ERP5 安裝可以連線到多個業務模板儲存庫; 當然,開發人員可以釋出多種型別的儲存庫,例如 開發測試穩定

erp5_base

[編輯 | 編輯原始碼]

這個 bt5 安裝了三種基本資料型別:人員、組織和貨幣,以及一些輔助型別。 它還安裝了三個模組

  • person_module(人員)
  • organisation_module(組織)
  • currency_module(貨幣)

它還安裝了一些機制來處理有關人員及其可能工作的組織的基本資訊。

基本用例

[編輯 | 編輯原始碼]

我們希望記錄有關一家公司及其一名僱員的資訊。

步驟 1 - 建立一個組織
[編輯 | 編輯原始碼]

轉到組織模組,從“操作”下拉選單中選擇“新增組織”。 將出現一個新表單。 使用一些資料填寫它。

請注意第一個選項卡(“檢視”)底部的“聯絡人”列表框。 它為空; 如果您輸入電子郵件並儲存表單,一段時間後,列表框將顯示“default_email” - 它是一個“電子郵件”型別的物件,包含您剛剛輸入的電子郵件地址。 它的工作方式是,組織的“檢視”選項卡上的“電子郵件”欄位以某種方式連結到“default_email”物件。 您可以新增更多電子郵件地址; 如果您想更改預設電子郵件,請將“default_email”的 ID 更改為您喜歡的任何內容,然後將其他電子郵件的 ID 更改為“default_email”。 它對電話號碼、傳真、地址以及許多其他內容也適用。

如果您想記錄國家或活動,您需要轉到 portal_categories 並建立在相應基本類別(在本例中是區域和活動)下的子類別樹。

步驟 2 - 建立一個人員
[編輯 | 編輯原始碼]

轉到人員模組,從“操作”下拉選單中選擇“新增人員”。 填寫人員姓名、電子郵件和其他資訊。

步驟 3 - 僱傭人員
[編輯 | 編輯原始碼]

轉到人員的“檢視”選項卡 - 那裡有一個名為“組織”的欄位,旁邊有一個小齒輪。 這稱為“關係字串欄位”。 點選齒輪 - 您將看到之前建立的所有組織列表。 選中一個並點選“更新關係”按鈕。 完成 - 該人員現在為這家公司工作。 現在,在齒輪旁邊,您可以看到一架小飛機 - 它會直接帶您到該人員工作的組織。

檢視“職業”選項卡 - 那裡有一個名為“職業步驟”的列表框,其中包含一個名為“default_career”的物件。 這是一個“職業”型別的物件,它代表一份僱傭合同; 它被視為當前僱傭,因為它 ID 是“default_career”。 您可以編輯該物件; 但是,儘管是預設的,但它並不處於活動狀態,因為它狀態是“草稿” - 這是一個工作流狀態。 要開始工作,請從“操作”下拉選單中選擇“開始職業步驟” - 狀態將更改,並且該物件將變為只讀。

有一個快捷方式可以終止當前工作並開始一項新的工作 - 轉到人員物件,並從“操作”下拉選單中選擇“終止當前職業步驟” - 看看會發生什麼。

步驟 4 - 使人員成為使用者
[編輯 | 編輯原始碼]

要讓新建立的人員登入系統,您必須先為他建立一個分配(操作 -> 新增分配),然後開啟它(操作 -> 開啟)。 您甚至不必在分配中填寫任何資料,它只需要存在。

然後,返回人員,選擇“分配”選項卡,為他提供登入名和密碼,您就完成了。

警告:如果您使用的是稍微舊一點版本的 ERP5,您可以跳過分配部分,但“職業”選項卡必須說該人員的角色是“內部”,並且登入名和密碼在“詳細資訊”選項卡上。

erp5_trade

[編輯 | 編輯原始碼]

這個 bt5 安裝了資料型別

  • 內部裝箱單
  • 內部裝箱單行
  • 採購訂單
  • 採購訂單
  • 採購裝箱單
  • 採購裝箱單行
  • 銷售訂單
  • 銷售訂單行
  • 銷售裝箱單
  • 銷售裝箱單行
  • 等等

這個業務模板提供的最重要的模組是

  • internal_packing_list_module(內部裝箱單)
  • sale_order_module(銷售訂單)
  • purchase_order_module(採購訂單)
  • sale_packing_list_module(銷售裝箱單)
  • purchase_packing_list_module(採購裝箱單)

基本用例

[編輯 | 編輯原始碼]

假設:erp5_base、erp5_pdm 和 erp5_trade 業務模板已正確安裝。

場景描述
[編輯 | 編輯原始碼]

我們是 ACME corp.John Smith 是我們的銷售和採購經理。 我們想從供應商那裡購買一些商品,然後將它們賣給客戶。

系統準備
[編輯 | 編輯原始碼]

組織 模組中建立組織 ACME corp.,在 人員 中建立 John Smith。 還在 貨幣 中建立 EUR 貨幣。

購買商品...
[編輯 | 編輯原始碼]

進入 採購訂單,建立新的 採購訂單

... 然後將它們賣出
[編輯 | 編輯原始碼]
  • 指導如何從 Nexedi 的 BT 儲存庫中新增 erp5_base、erp5_trade 和 erp5_pdm
  • 已安裝的 BT 的基本用法:新增產品、新增公司、人員、新增銷售訂單、檢視產品移動歷史記錄
  • 激發讀者玩 ERP5 的慾望
  • 清理以上內容 - 它被複制貼上了 - 需要重新排列
華夏公益教科書