1 背景概述
數通暢聯本着分享傳遞的理念已經将産品家族中的核心産品開源，目的在于滿足客戶與夥伴的OEM需求，以及為廣大IT愛好者的內建工具提供多一種選擇，多一種便利。如果需要對産品進行擴充開發或者更深層次的了解産品可以在svn中check out源碼。
本文詳細介紹BPM、Portal、SMC工程在AEAI DP中配置步驟以及方法，來支援擴充開發，以-d模式啟動來支援遠端debug調試，debug模式方法可以參考AEAI DP開發平台技術手冊（http://pan.baidu.com/s/1gdKlQvD）。另外，由于BPMServer、PortalServer、ESBServer的内部運作機制不建議使用MyEclipse或者Eclipse JavaEE來進行擴充開發。
2 預期讀者
- 數通暢聯内部員工
- 外部擴充開發人員
3 名詞解釋
- 使用者庫：可以導入的jar包，為了滿足編譯時的需要。
- SVN：SVN是Subversion的簡稱，是一個開放源代碼的版本控制系統。
4 實作思路
建立SVN路徑，将工程從SVN上check out下來，配置使用者庫引用相應的jar包，解決編譯出錯的問題。設定對應的伺服器配置，修改對應的伺服器中的配置檔案指向開發目錄，正确啟動伺服器，保證程式的正确運作。
5 實作步驟
5.1 AEAI BPM工程
AEAI BPM是以業務流程為中心、幫助企業各業務環節與客戶需求對齊的管理方法，使用者可以在http://pan.baidu.com/s/1i4zLpcD#path=%252FAEAI%2520BPM下載下傳相關媒體以及文檔，源碼托管于開源中國http://git.oschina.net/agileai/aeaibpm，可以從SVN上check out源碼進行二次開發，路徑為svn://git.oschina.net/agileai/aeaibpm。
5.1.1 SVN Check Out程式
1.打開設計器點選
跳轉到界面點選
按鈕
2. 彈出界面在URL中輸入對應的SVN路徑，點選Finish，成功後點選SVN路徑如下圖：
3. 在項目名上右鍵選擇“檢出為”
4. 彈出界面點選NEXT可以檢視項目位址，之後點選Finish
5. 點選
按鈕切換到JAVA透視圖，檢出的工程會出現編譯出錯的問題如下圖：
6. 檢視報錯資訊，問題定位為缺少jar包，下面開始配置使用者庫引入相應的jar包。
5.1.2 配置使用者庫
使用者庫在工程Check Out時已經建立，但是可能會缺少對應的Jar這裡隻需要對使用者庫進行配置引入相應的Jar即可。
1. 在工程下右鍵選擇Build Path –Configure Build Path
2. 選擇Add Library
3. 選擇 User Library點選Next之後點選Finish
4. 選擇新建立的使用者庫點選右側的Add JARs
5. 另需配置使用者庫BPM Server 引入（您伺服器的位址） bpm_server_x86_ Vx.x.x.YYYYMMDD shared下的jar以及
（您伺服器的位址） bpm_server_x86_ Vx.x.x.YYYYMMDD lib下的jsp-api.jar以及servlet-api.jar
6. 使用者庫建立成功後，重新整理應用
7. 修改資料庫配置檔案
5.1.3 BPM Server設定
1. 解壓BPM Server安裝媒體bpm_server_x86_Vx.x.x.YYYYMMDD.rar；
編輯bpm_server_x86_Vx.x.x.YYYYMMDDin目錄下，startconfigtoolNaNd檔案，設定JDK路徑，如圖所示：
2. 打開資料庫配置，設定連接配接URL改為資料庫名，填寫資料庫的使用者、密碼後點選“測試連接配接”，連接配接成功後，初始化資料高亮顯示，若建立的BPM資料庫中沒有内容，則點選初始化資料，将自動生成資料表。若資料庫已經存在且有内容，不可點選初始化資料，否則将覆寫已有的資料庫内容。如圖：
3. 輕按兩下bin目錄下的startup.bat，即可直接啟動BPMServer，如圖所示：
5.1.4 修改伺服器配置檔案
1. （您伺服器的位址）pm_server_x86_ Vx.x.x.YYYYMMDD confCatalinalocalhost
2.添加bpm.xml檔案如下：docBase屬性指向開發目錄
3.删除（您伺服器的位址）pm_server_x86_ Vx.x.x.YYYYMMDD webapps下預置的bpm工程；
4. 輕按兩下bin目錄下的startup.bat，即可直接啟動BPMServer，如圖所示：
5. 浏覽器輸入http://localhost:7070/通路界面如下：
6. 輸入賬号admin（密碼admin）登陸後界面：
5.2 AEAI Portal工程
Portal是門戶內建平台, 可以作為企業的應用中心，或者是企業應用的入口，在統一的界面上聚合現有各業務系統的資料、菜單、界面。 使用者可以在http://pan.baidu.com/s/1mgj3SV2下載下傳相關媒體以及文檔，源碼托管于開源中國http://git.oschina.net/agileai/aeaiportal，可以從SVN上check out源碼進行二次開發，路徑為svn://git.oschina.net/agileai/aeaiportal。
5.2.1 SVN Check Out程式
1. 打開設計器點選
跳轉到界面點選
按鈕，彈出界面在URL中輸入對應的SVN路徑，點選Finish
2. 成功後，點選SVN路徑如下圖：
3. 在項目名上右鍵，選擇“檢出為”
4. 彈出界面點選NEXT可以檢視項目位址，點選Finish
5. 點選
按鈕切換到JAVA透視圖，檢測出的工程會出現變異出錯的問題如下圖：
6. 檢視報錯資訊，定位為缺少jar包，下面開始配置使用者庫引入相應的jar包
5.2.2 配置使用者庫
使用者庫在工程Check Out時已經建立，但是可能會缺少對應的Jar這裡隻需要對使用者庫進行配置引入相應的Jar即可。
1. 在工程下右鍵選擇Build Path –Configure Build Path
2. 指定設計器的Jre
3. 另需配置使用者庫Portal Server 引入（您伺服器的位址）portal_server_x86_ Vx.x.x.YYYYMMDD shared下的jar以及（您伺服器的位址）portal_server_x86_ Vx.x.x.YYYYMMDD lib下的jsp-api.jar以及servlet-api.jar
4. 使用者庫建立成功後重新整理應用
5. 修改資料庫配置資訊及開發目錄下配置資訊
5.2.3 Portal Server設定
1. 解壓PortalServer安裝媒體portal _server_ x86_Vx.x.x.YYYYMMDD.rar；
編輯portal_server _x86_Vx.x.x.YYYYMMDDin目錄下，startconfigtoolNaNd檔案，設定JDK路徑，如圖所示：
2. 打開資料庫配置，設定連接配接URL改為資料庫名，填寫資料庫的使用者、密碼後點選測試連接配接，連接配接成功後，初始化資料高亮顯示，若建立的portal資料庫中沒有内容，則點選初始化資料，将自動生成資料表。若資料庫已經存在且有内容，不可點選初始化資料，否則将覆寫已有的資料庫内容。如圖：
5.2.4 修改伺服器配置檔案
1. （您伺服器的位址）portal_server_x86_ Vx.x.x.YYYYMMDD confCatalinalocalhost
2.打開對應的xml檔案添加屬性docBase指向開發工程的webRoot目錄
3.删除（您伺服器的位址）portal_server_x86_ Vx.x.x.YYYYMMDD webapps下預置的portal與portal_portlets工程結果如下
4. 輕按兩下bin目錄下的startup.bat，即可直接啟動PortalServer，如圖所示：
5. 浏覽器輸入http://localhost:8080/portal/login.jsp通路界面如下：
6. 輸入賬号admin（密碼admin）登陸後界面：
5.3 AEAI ESB SMC工程
AEAI ESB是內建各業務系統，實作異構系統的互聯互通。 使用者可以在http://pan.baidu.com/s/1o6NvxXo下載下傳相關媒體以及文檔，源碼托管于開源中國http://git.oschina.net/agileai/aeaiesb，可以從SVN上check out源碼進行二次開發，路徑為svn://git.oschina.net/agileai/aeaiesb。
5.3.1 SVN Check Out程式
1. 打開設計器點選
跳轉到界面點選
按鈕
2. 彈出界面在URL中輸入對應的SVN路徑，點選Finish
3. 成功後點選SVN路徑，如下圖：
4. 在項目名上右鍵後選擇“檢出為”
5. 彈出界面點選NEXT可以檢視項目位址，點選Finish
6. 點選
按鈕切換到JAVA透視圖，檢測出的工程會出現變異出錯的問題。檢視報錯資訊，問題定位為缺少jar包，下面開始配置使用者庫引入相應的jar包。
5.3.2 配置使用者庫
使用者庫在工程Check Out時已經建立，但是可能會缺少對應的Jar這裡隻需要對使用者庫進行配置引入相應的Jar即可。
1. 在工程下右鍵選擇Build Path –Configure Build Path
2. 指定設計器的jre
3. 建立的使用者庫soaker
4. 重複步驟1和2點選 User Library 後點選Next
5. 點選
彈出界面點選
自定義名稱後點選OK
6. 選擇建立的庫，點選右側的Add JARs添加jar包
7. 引入ESB伺服器下的
**（您的ESBServer的目錄）esb_server_x86_ Vx.x.x.YYYYMMDD shared
**（您的ESBServer的目錄）esb_server_x86_ Vx.x.x.YYYYMMDD lib下的jsp-api.jar以及servlet-api.jar目錄中的jar包，點選OK，選擇添加的使用者庫，點選Finish。
8. 使用者庫建立成功後，重新整理應用解決編譯出錯的問題如下圖：
9. 修改資料庫的配置檔案及開發目錄下配置資訊
5.3.3 ESB Server設定
1. 解壓ESBServer安裝媒體esb_server_x86_Vx.x.x.YYYYMMDD.rar；
編輯esb_server_x86_Vx.x.x.YYYYMMDDin目錄下，startconfigtoolNaNd檔案，設定JDK路徑，如圖所示：
2. 打開資料庫配置，設定連接配接URL改為資料庫名，填寫資料庫的使用者、密碼後點選測試連接配接連接配接成功後，初始化資料高亮顯示，若建立的esb資料庫中沒有内容，則點選初始化資料，将自動生成資料表。若資料庫已經存在且有内容，不可點選初始化資料，否則将覆寫已有的資料庫内容。如圖：
5.3.4 修改伺服器配置檔案
1.**（您的ESBServer的目錄）esb_server_x86_Vx.x.x.YYYYMMDD confCatalinalocalhost
2.添加docBase屬性指向開發工程的webRoot目錄
3.删除**（您的ESBServer的目錄）esb_server_x86_ Vx.x.x.YYYYMMDDwebapps下預置的SMC工程
4.浏覽器輸入http://localhost:9090/SMC/通路界面如下
5.admin（密碼admin）登入後如下圖