

*************************************
E3客制開發包 2009/09/20
*************************************

1.開發包中附有一開發版E3系統,序號為02-000-0000,此版沒有筆數限制,
2.帳號為1個使用者,1個分倉,1個收銀機,1個會計公司. 
3.開發版僅作為開發用,但所開發完成的程式,可在正式版的系統中執行.
4.發行時,建議放到c:\dasamx_sdk目錄中工作.
5.要在環境變數中加入JAVA_SDK_PATH的路徑指定, 如:D:\java\j2sdk1.4.2






=====================================
開發環境設定
=====================================
1. 安裝MySQL資料庫,相容於4.0x, 4.1x, 5.0x, 5.1x, 5.4x 版.
   http://www.mysql.com

2. 安裝SUN J2SDK 1.4.2以上版本, 包含1.5.x, 1.6.x版.
   http://java.sun.com

3. 先執行/setup.bat,建立MySQL工作檔. 
   可看 http:/www.awanx.com 的系統安裝手冊.

4. 可使用JBuilder,NetBeans,eclipse..等IDE開發工具整合,
   在設定專案資源時要依序做引用jar和classpath設定:
	專案下\classes\
	專案下\resource\
	環境下\pub\web\xclient\*.jar
	環境下\pub\web\WEB-INF\lib\*.jar
   整合重點說明,請看網站www.awanx.com的文件.

5. 專案啟動class:
	com.dasam.e3010001.client.MainFrame  後台
	com.dasam.e3010001.client.PosFrame  前台

6. 設定JAVA_SDK_PATH的環境變數.

7. 建立新客制專案:
   參閱 project\cmz_000\new_project.txt 的說明.









=====================================
開發示範專案各目錄檔案說明
=====================================

ireport.bat	執行ireport圖形報表設計工具
setup.bat	執行建立設定及開啟MySQL資料庫

project\cmz_001 		為專案001的目錄
project\cmz_001\src\		專案原始碼程式目錄
project\cmz_001\classes\	專案java執行碼目錄
project\cmz_001\resource\	專案資源檔存放目錄
project\cmz_001\resource\com\dasam\e3010001\client\res\lang\  語系字詞設定檔目錄
project\cmz_001\resource\com\dasam\e3010001\client\rpt\fmt\   報表格式檔目錄
project\cmz_001\resource\cmz.sql      	專案MySQL異動指令檔,可在正式版setup時
project\cmz_001\resource\xconfig.cfg  	開發時期server端設定值,不封裝jar
project\cmz_001\resource\xworks.cfg  	開發時期client端設定值,不封裝jar
project\cmz_001\client_jar.bat		封裝e3010001_cusxc.jar的指令檔
project\cmz_001\server_jar.bat		封裝e3010001_cusxs.jar的指令檔
project\cmz_001\e3010001_cusxc.jar  	client已封裝完成的程式
project\cmz_001\e3010001_cusxs.jar  	server已封裝完成的程式

pub\		E3的開發公用程式
pub\ireport\	ireport圖形報表設計工具目錄
pub\web\		原正式版的工作目錄
pub\util\		原正式版的工作目錄
pub\util\setup.bat	設定及開啟MySQL資料庫







=====================================
報表設計工具
=====================================
工具檔如下:
	pub\ireport\ireport.jar
	pub\ireport\ireport_lib.jar
	pub\ireport\ireport.bat
	pub\ireport\dtds\jasperreport.dtd

執行ireport.bat指令檔.





=====================================
發行到正式版
=====================================
若研發上線同步階段,可用後台的'[系統]/[系統維護管理]/[指令維護工作]'來更新
客制程式,流程如下:

   1. 建立jar檔, e301_001\client_jar.bat, makejar\server_jar.bat 產生jar檔,

   2. 上傳更新的程式檔或sql:
      指令="upload.cmz.client; [上傳檔]", 上傳e3010001_cusxc.jar為e3010001_cusxc.j
      	如:"upload.cmz.client; C:\e301_dev\project\e301_001\e3010001_cusxc.jar",
      	若 [上傳檔] 沒指定,會開檔案對話框做選擇.

      指令="upload.cmz.server; [上傳檔]", 上傳e3010001_cusxs.jar為e3010001_cusxs.j
      指令="upload.cmz.sql; [上傳檔]", 上傳cmz.sql為util/cmz.sql

   3. 執行\dasamx\e3010001\util\jar_update.bat. (可視實際情況修改bat檔)
      程序: 停止tomcat --> copy *.j為jar --> 啟動tomcat

   4. 若有異動到MYSQL的資料結構,上傳過cmz.sql後,可由以下選一種方式更新:
      a.執行util/setup.bat,主要會留下log紀錄.
      b.在維護指令key: "database.update.cmz" (建議方式)
      c.用mysql client工具執行cmz.sql的內容.
      
   5. 若因客制造成無法正常執行系統,可以將pub\web\xclient\e3010001_cusxc.jar2複蓋
      e3010001_cusxc.jar, 再把server的e3010001_cusxs.jar刪除,
      重啟tomcat可以回復標準的套裝規格.







