EasyFlowGP与TIPTOP系统整合设定2011PPT.ppt

按一下以編輯標題樣式,按一下以編輯母片,第二層,第三層,第四層,第五層,*,EasyFlow GP,與,Tiptop GP,整合說明,鼎新電腦,BPM,產品部,1,大綱,系統整合架構,建立,/,更新,EFGP,資料庫,系統整合設定,附件功能設定及測試,備註整合,(,非系統整合的必要功能,),追蹤同單據流程,(,非系統整合的必要功能,),客製單據整合步驟,FAQ,2,大綱,系統整合架構,建立,/,更新,EFGP,資料庫,系統整合設定,附件功能設定及測試,備註整合,(,非系統整合的必要功能,),追蹤同單據流程,(,非系統整合的必要功能,),客製單據整合步驟,FAQ,3,系統整合架構,Tiptop GP,EasyFlow GP,SOAP Service,Web Layer,Web Service,Service Layer,DAO,Data Base,RCP Service,RCP Service,Configuration,User Interface,Domain,4,大綱,系統整合架構,建立,/,更新,EFGP,資料庫,系統整合設定,附件功能設定及測試,備註整合,(,非系統整合的必要功能,),追蹤同單據流程,(,非系統整合的必要功能,),客製單據整合步驟,FAQ,5,建立,/,更新,EFGP,資料庫,建立新的資料庫,(MS SQL/Oracle),InitNaNaDB_SQLServer2000.sql,InitNaNaDB_ORACLE9i.sql,InitTiptopModel_SQLServer2005.sql,InitTiptopModel_ORACLE9i.sql,-69_InitDBwithTiptopProcesses3x.patch,-69_InitDBwithTiptopProcesses5x.patch,建立,EasyFlow GP,之初始資料庫,建立,TIPTOP,整合時所需的表格與基本資料,建立,TIPTOP,整合時的標準表單與流程資料,設定環境,依照客戶的環境設定系統參數,6,建立,/,更新,EFGP,資料庫,更新現有資料庫,(MS SQL/Oracle),InitTtiptopModel_SQLServer2000.sql,InitTtiptopModel_ORACLE9i.sql,建立,TIPTOP,整合時所需的表格與基本資料,系統管理員內的,Config TIPTOP,匯入,TIPTOP_Process_Mapping.prsmapping,匯入流程與表單資料,建立,TIPTOP,整合時的標準表單與流程資料,依照客戶的環境設定系統參數,設定環境,7,Table schema,(TiptopModel),欄位名稱,資料型態,(SQL),說明,id,nvarchar(50),此,model,的,ID,description,ntext,Tiptop,主機的,(,名稱,),說明,mappingSet,ntext,存放,tiptop,與,EasyFlow GP,流程對應關係的,XML,字串,appOIDList,ntext,存放呼叫,Tiptop web service,時，每一個,Method,所使用的,WebApplication OID,，以,XML,字串方式儲存。,wsdlSet,ntext,存放呼叫,Tiptop web service,時，每一個,Method,所使用的,WSDL,檔，以,XML,字串方式儲存。,workflowServerID,nvarchar(50),存放呼叫,Tiptop web service,時，所使用的,WorkFlowServer,的,ID,。,tiptopServerUserID,ntext,存放需使用,rcp,指令進行附件上傳的動作時，用來登入,Tiptop,主機的帳號,ID,。,tiptopServerIP,ntext,存放需使用,rcp,指令進行附件上傳的動作時，欲登入之,Tiptop,主機,IP,。,templateFieldAccessDefMap,ntext,存放表單欄位存取權限的設定,modelConfig,ntext,存放一般整合設定,memoConfig,ntext,存放備註設定,資料庫,8,大綱,系統整合架構,建立,/,更新,EFGP,資料庫,系統整合設定,附件功能設定及測試,備註整合,(,非系統整合的必要功能,),追蹤同單據流程,(,非系統整合的必要功能,),客製單據整合步驟,FAQ,9,修改,(,新增,)workflow server(id=,tiptopWfs01,),名稱,值,說明,ID,tiptopWfs01,此欄位之值為固定常數值，請勿更改。,Is Default,False,不建議設為預設伺服器,ApplicationServerAddress,請設定,EasyFlow GP,的應用伺服器位址,Web Server Address,請設定,EasyFlow GP,的網站伺服器的,IP,與,Port,IP,位址請勿設定,localhost,或,127.0.0.1,Default Doc Server,請設定預設文件伺服器的位址,系統整合設定,10,系統整合設定,設定,流程主機代號,tiptopWfs01,11,系統整合設定,多,TIPTOP,主機設定方式,(,新增,),TP,主機環境區域名稱,(,由,TP,提供,),=,開單,XML,中的,TPServerEnv,TP,主機,IP(,由,TP,提供,),=,開單,XML,中的,TPServerIP,TP,主機,SOAP,網址,(,由,TP,提供,),TP,主機登入者,(,由,TP,提供,),TP,主機的名稱,(EFGP,設定,),12,系統整合設定,多,TIPTOP,主機設定方式,(,移除,),13,系統整合設定,流程重要性,(,緊急程度,),TIPTOP,開單時若,xml,中有傳送,標籤時，則,EFGP,會依,NaNaWeb.properties,的設定對應其流程重要性,(,緊急程度,),須設定,Importance,分別為,0,1,2,時與,EFGP,流程重要性,(,緊急程度,),對應關係,TIPTOP Importance,：,0=,低,1=,普通,2=,高,14,建立,tiptop,單據與,EFGP,流程對應索引,建立所有標準整合,單據與流程對應關係,點選,匯入對映索引,並匯入下列檔案,T,IPTOP_Process_Mapping.prsmapping,對映索引建立完成後,對映索引,就會出現所有標準整合單據與流程對應關係,15,建立,tiptop,單據與,EFGP,流程對應索引,建立特定整合,單據與流程對應關係,對映索引建立完成後,對映索引,就會出現所有標準整合單據與流程對應關係,tiptop,的程式代號,EasyFlow GP,的流程模型代號,16,系統整合設定,設定,(,修改,),呼叫,Tiptop,網路服務的,wsdl,若,方法名稱,中不存在,MethodSetStatus,時，設定步驟如下,新增網路服務設定,選擇,MethodSetStatus,填寫相關欄位,載入,(,或貼上,)TIPTOPGateWay.wsdl(,須修改成正確的,SOAP,網址,),17,系統整合設定,TIPTOPGateWay.wsdl,18,檢查組織代號,檢查,tiptop,與,EFGP,的公司別是否相同,檢查部門代號,EFGP,會檢查,tiptop,所傳送的該部門代號是否屬於,流程發起人,/,流程關係人,EFGP,流程關係人,EFGP,流程的關係人設定為,tiptop,填單人,(FormCreator)/tiptop,發起人,(LogonId)/tiptop,表單關係人,(FormOwner),EFGP,流程發起人,EFGP,流程的關係人設定為,tiptop,填單人,(FormCreator)/tiptop,發起人,(LogonId)/tiptop,表單關係人,(FormOwner),是否將,TIPTOP,的表單代號,(,SourceFormID,),加入,EFGP,的流程主旨中,是否將,TIPTOP,的工廠代號,(,PlantID,),加入,EFGP,的流程主旨中,是否將,TIPTOP,的程式名稱,(,ProgramID,),加入,EFGP,的流程主旨中,開單送簽的檢查條件說明,19,大綱,系統整合架構,建立,/,更新,EFGP,資料庫,系統整合設定,附件功能設定及測試,備註整合,(,非系統整合的必要功能,),追蹤同單據流程,(,非系統整合的必要功能,),客製單據整合步驟,FAQ,20,Tiptop,系統須先進行以下設定Tiptop,設定,EasyFlow GP,的,wsdl,所在,10.20.10.50:8080/NaNaWeb/services/TipTopIntegration?wsdl,Tiptop,設定主機信任關係,EasyFlow GP,的主機,IP,該安裝,EasyFlow GP,機器的使用者帳戶,(,用來登入該主機作業系統的帳號,),附件功能測試,rsh,指令測,試,(,權限,測,試,),rsh target host ip-l login user id-n command,Ex.rsh 10.40.40.30-l tiptop-n ls,rcp,指令測,試,rcp b remote host.user:source pathdestination,Ex.rcp,-b,10.40.40.30.tiptop:test.txt.localtest.txt,附件功能設定及測試,(1/3),21,附件功能設定及測試,(2/3),步驟一：選擇命令列指令並輸入相關參數,步驟二：產生命令列指令,步驟三：執行,命令列指令,22,附件功能設定及測試,(3/3),步驟四：顯示在,EFGP,主機上的執行結果,(,逾時,),最長等待時間：,60,秒,23,大綱,系統整合架構,建立,/,更新,EFGP,資料庫,系統整合設定,附件功能設定及測試,備註整合,(,非系統整合的必要功能,),追蹤同單據流程,(,非系統整合的必要功能,),客製單據整合步驟,FAQ,24,TIPTOP,發起流程,NaNa,系統整合模組,備註,整合,備註整合架構,TIPTOP,備註欄位設定,TIPTOP,整合設定,設定流程使用的,TIPTOP,備註設定,依照設定選擇流程使用的,TIPTOP,備註設定,組成表單實例,Runtime,TIPTOP,傳送表單資料發起流程,整合設定,發起流程,傳送表單欄位資料,25,備註整合,開單送簽時同時取得在,Tiptop,表單上所填寫的備註說明，設定步驟如下,檢查相關檔案,更新表單,更新表單,script,更新系統整合設定,26,備註整合,檢查相關檔案,進行備註整合時，必須先,確認以下檔案是否存在,tiptopmemo.js,.NaNaWeb.warjstiptopmemo.js,TiptopMemo.jsp,.NaNaWeb.warCustomOpenWinTiptopMemo.jsp,27,備註整合,更新表單定義,在該整合表單中新增下列表單元件,新增一個,ID,為,TIPTOP_MEMO_COL,的隱藏文字欄位,(HiddenTextBox),新增一個,ID,為,TIPTOP_MEMO_DATA,的隱藏文字欄位,(HiddenTextBox),新增一個,ID,為,MemoBtn,的按鈕,(B,utton,),作為顯示備註的元件,(,按鈕代號可自訂，但需與,Script,中的,Function,名稱對應,),，須在要查看該備註的流程關卡上，將該此元件,MemoBtn,設定為,enable,28,備註整合,更新表單定義,表單實例範例,TIPTOP_MEMO_COL,TIPTOP_MEMO_DATA,項,次,說明,顯示位置,1,備註說明一,0,2,備註說明二,1,29,備註整合,更新表單script,更新表單,script,Script,開頭中請加入以下程式代碼,document.write();,p.s.,若為以下代碼亦可：,document.write();,或,document.write();,Script,中新增方法名稱為,MemoBtn_onclick(),程式代碼如下,function MemoBtn_onclick(),/,備註欄位,var tLabelString1=document.getElementById(TIPTOP_MEMO_COL).value;,/,備註資料,var tLabelString2=document.getElementById(TIPTOP_MEMO_DATA).value;,openWindTipTop(tLabelString1,tLabelString2);,30,備註整合,更新系統整合設定,修改系統整合設定的對映索引設定,範例如下,31,TIPTOP,備註設定規格,標籤,DATA_FORM_ID,格式form_id$,說明,TIPTOP,開單時指定發起欲流程內的表單代號,(,如果流程內有定義型態為表單的流程參數,且流程參數的代號符合,),發起時會將傳入的資料轉換成該表單代號的實例並掛入流程實例中,memoid,代表該對應要使用的備註定義代號,(memo config,會隨著,TIPTOP,呼叫,ColumnSet,存放於,TIPTOP Model,中,),範例,apmt110_ntn,如果流程內有定義型態為表單的流程參數,且流程參數的代號符合此代號,apmt110_ntn),發起時會將傳入的資料轉換成該表單代號的實例並掛入流程實例中，若無此設定，預設取用程式代號,(ProgramID)作為備註的代號,備註整合,更新系統整合設定,32,大綱,系統整合架構,建立,/,更新,EFGP,資料庫,系統整合設定,附件功能設定及測試,備註整合,(,非系統整合的必要功能,),追蹤同單據流程,(,非系統整合的必要功能,),客製單據整合步驟,FAQ,33,追蹤同單據流程,新增按鈕,以代號,btnRefprocess,為例,在,Script,中加入該按鈕的,onclick,事件,function btnRefprocess_onclick()var tURL=/NaNaWeb/GP/WMS/TraceRelationalProcess/TraceRelationalProcessMain+?hdnMethod=obtainProessInstList,34,大綱,系統整合架構,建立,/,更新,EFGP,資料庫,系統整合設定,附件功能設定及測試,備註整合,(,非系統整合的必要功能,),追蹤同單據流程,(,非系統整合的必要功能,),客製單據整合步驟,FAQ,35,客製單據整合步驟,Tiptop,表單轉換成,EFGP,表單,流程設定,建立,Tiptop,單據與,EFGP,流程對應關係,36,Tiptop,表單轉換成,EFGP,表單,Tiptop,表單與,EFGP,表單中的各個欄位,id,必須相同才能在雙方系統中彼此傳送及更新資料,將,Tiptop,的表單定義,(.xml),轉存成,EFGP,表單定義,(.tpform),開啟,EFGP,表單設計師並匯入該表單定義,適當調整,EFGP,表單定義的欄位及版面,若該,Tiptop,表單在開單送簽時會傳送附件，則須在該,EFGP,表單中新增,(or,檢查是否存在,)Attachment,元件,新增該表單中所需的,Script,該表單中若有單身欄位,(Grid),時，須增加以下程式碼，否則無法顯示該,Grid(Tiptop,單身,),的資料,function formOpen(),var bodyGrid=document.getElementById(,s_oeb,);,var bodyData=eval(bodyGrid.value);,s_oebObj,.reload(bodyData);,return true;,37,流程設定,流程變數設定,TIPTOP-EFGP,整合流程中所必須建立的流程變數,(Basic Data Type),，並給定初始值,(,與,id,相同,),TIPTOP_PROCESS_VARIABLE,這是用來儲存 TIPTOP呼叫EFGP發起流程(CreateForm)服務時所傳入的相關變數值，未來於本流程結束或終止時可將相關變數回寫TIPTOP。,processSerialNumber,這是用來取得流程發起後的流程序號,流程掛載相對應的表單,在流程變數中新增,Form Type,，並將該流程所對應到的表單掛載到此流程中,38,流程變數設定,掛載表單,ID,與,Data Type,不可變更，並須設定初始值,流程設定,39,流程關卡設定,第一個關卡須為,Participant(,參與者,),活動，參與者設定為,Requester,(,發起人,),。,流程設定,40,流程設定回寫,Tiptop,關卡,流程的最後關卡,(,回寫,Tiptop),請設定為,invoke,活動,(,呼叫,Session Bean,),JNDI Name,：,TiptopManager,函式名稱：,processAgreed,Home Class Name,：,com.dsc.nana.services.sysintegration.tiptop.TiptopManagerHome,ActualParameter,須設定成,ID,為,processSerialNumber,的流程變數，作為呼叫此,Session Bean,的傳入參數,除名稱可自行命名外，其餘欄位須正確填入,EFGP AP server,的相關設定值,設定是否回傳,EFGP,表單欄位資訊和其,xml,格式,(,此參數為非必要，也可以不增加此參數,),。傳入一個基本型態的字串參數：,NONE,代表回寫,TP,時不回傳表單欄位值、,EFGP,代表回寫,TP,時回傳,EFGP,預設的表單欄位值、,TIPTOP,代表回寫,TP,時回傳,TP,格式的表單欄位值,41,流程設定,流程事件,當發生,流程撤銷、終止,事件時，呼叫,Session Bean,，設定方式同前一頁說明,流程撤銷,JNDI Name,：,TiptopManager,函式名稱：,processAborted,Home Class Name,：,com.dsc.nana.services.sysintegration.tiptop.TiptopManagerHome,流程終止,JNDI Name,：,TiptopManager,函式名稱：,processDisAgreed,Home Class Name,：,com.dsc.nana.services.sysintegration.tiptop.TiptopManagerHome,42,建立,Tiptop,單據與,EFGP,流程對應關係,建立整合的單據及流程後，須,設定,Tiptop,單據與,EFGP,流程對應關係,tiptop,的程式代號,EasyFlow GP,的流程模型代號,43,建立,Tiptop,單據與,EFGP,流程對應關係,修改系統管理員內的,TIPTOP,相關設定,新增對應索引,TIPTOP,鍵值,EFGP,鍵值,PlantID,工廠代號,TargetSheetNo,EFGP,的流程模型代號,ProgramID,程式代號,SourceFormID,單別,StatSlip,狀況碼,44,大綱,系統整合架構,建立,/,更新,EFGP,資料庫,系統整合設定,附件功能設定及測試,備註整合,(,非系統整合的必要功能,),追蹤同單據流程,(,非系統整合的必要功能,),客製單據整合步驟,FAQ,45,FAQ,Tiptop,開單送簽失敗,發起失敗,TIPTOP,設定之,EFGP IP,是否正確,EFGP,內之流程關係人是否有主部門設定,EFGP,之流程關卡設定是否無法派送,XML parser error,EFGP,組織設定與,TIPTOP,組織不同步,使用者代號,部門代號,組織代號,46,FAQ,回寫,Tiptop,狀態失敗,回寫,Tiptop,狀態碼失敗,SOAP,網址是否正確,(,由,TIPTOP,提供,),EFGP,回寫關卡之,Session Bean,設定是否正確,TIPTOP,自動確認是否成功,Log,顯示,Server Error,訊息,Tiptop,所提供的網路服務是否正確啟動、參數設定是否正確、是否,rebuild,成功,EFGP,傳入之,XML,標籤是否不正確斷行或包含,Tiptop,無法解析之特殊字元,47,FAQ,追蹤流,程失敗,追蹤流,程失敗,檢查,TIPTOP,表格欄位長度,wsk09,、,azg06,長度需為,32,字元,若更改需,rebuild TIPTOP,程式,檢查,EFGP,系統管理員設定,TIPTOP,工作流程主機的網路伺服器位址,48,FAQ,單身欄位、附件,單身無法顯示,傳送之資料是否包含,EFGP,無法顯示之特殊字元,(&),附件無法傳送,Tiptop,是否設定主機信任關係與信任帳號,測試附件,功能,Tiptop,的,xml,中對於附件檔的規格是否正確,(,規格如下,),49,FAQ,客製單據,客製單據,問題,Tiptop,表單中新增表單欄位，但開單送簽時,EFGP,表單的該欄位值為空值,可能原因,EFGP,表單定義中是否也有新增該欄位,EFGP,表單中的欄位代號必須與,TIPTOP,表單中的欄位代號完全相同，才能在開單時正確傳送、接收到該欄位值,TIPTOP,傳給,EFGP,的資料是否正確,程式畫面需顯示欲傳送的欄位,直接修改呼叫,EFGP,的程式將欄位資料加入,50,FAQ,錯誤碼,Fail to locking StringWorkflowRuntimeValue for updating data,、,com.dsc.nana.persistence.DBServerException,、,Caused by:om.dsc.nana.persistence.DBServerException:Cannot update entity:null,error message:null,該流程中的流程變數未設定初始值,51,大綱,系統整合架構,建立,/,更新,EFGP,資料庫,系統整合設定,附件功能設定及測試,備註整合,(,非系統整合的必要功能,),追蹤同單據流程,(,非系統整合的必要功能,),客製單據整合步驟,FAQ,進階功能,52,進階功能回寫特定,Tiptop,主機,可針對特定的流程回寫,(SetStatus),到該特定的,Tiptop,主機,。,若未設定該流程所要回寫到的,Tiptop,主機時，則會回寫到預設的,Tiptop,主機,設定格式有以下兩種,(,皆可,),、系統會自動補上,PROPERTY_ROOT,10.20.10.10:6394/ws/r/aws_efsrv_top2o,53,進階功能,多主機的簽核意見查詢,功能說明,當,TIPTOP,查詢簽核意見時，若該流程不存在於目前,EFGP,主機上時，會再去檢查該流程是否存在於其他,EFGP,主機上,設定方式,開啟系統管理員，新增流程主機,54,TIPTOP,發起流程時表單欄位值取代設定規格,參數,ReplaceParaHandler,標籤,REPLACE_PARA,格式,$to_be_updated_targetTagID$,說明,TIPTOP,開單時指定某個流程變數的某個值被取代為某個流程變數的值,from,定義來源資料之代號,fromType,定義來源資料的型態為表單實例,FormInstance,或流程變數,RelevantData,fromId,定義來源資料內物件代號,target,定義目的地的代號,tartype,定義目的地的資料型態為表單實例,FormInstance,或流程變數,RelevantData,若無設定,start,從,0,開始取,若無設定,end,取到該資料的最後,若設定的,start,超過該資料的長度,取全部,若設定的,end,超過該資料長度,取到該資料的最後,若設定的,end=start.,從,start,取到最後,進階功能取代表單特定欄位值,55,TIPTOP,發起流程時表單欄位值取代設定規格,範例,oeadesc,apmt110,apmt120,1234567,oea01,12345,oeadesc,進階功能取代表單特定欄位值,56,