深入淺出之預(yù)警系統(tǒng)配置-Oracle EBS技術(shù)文檔整理

DocRef:January21,2015STYLEREFHD2已解決及待解決問題IfSection2>1“日期作者版本變更說明21-Jan-15羅文1.0初版審閱姓名職位分發(fā)拷貝編號姓名位置/崗位1234目錄TOC\o"2-3"文檔控制 ii預(yù)警概述 1概述 1概念 1配置 3預(yù)警例子 7業(yè)務(wù)需求 7已解決及待解決問題 14待解決問題 14已解決問題 14PAGE2預(yù)警概述概述主要特性監(jiān)視系統(tǒng)狀況及自定義的特殊事件發(fā)布自定義樣式的關(guān)鍵信息提供數(shù)據(jù)庫狀況的常規(guī)報表自動完成系統(tǒng)維護，日常在線操作事件預(yù)警-事件驅(qū)動驅(qū)動方式：事件驅(qū)動，監(jiān)測數(shù)據(jù)庫事件，主要是對數(shù)據(jù)庫表的INSERT、UPDATE操作，一經(jīng)發(fā)生，則立刻通知。實現(xiàn)方式：在基表上創(chuàng)建行級別觸發(fā)器（DBTrigger），進而提交檢查請求【檢查事件預(yù)警】。定期預(yù)警-時間驅(qū)動驅(qū)動方式：時間驅(qū)動，按照計劃一定時間頻率進行監(jiān)測，每天，每周，每個月等等，亦或是根據(jù)需要，手動提交檢查。實現(xiàn)方式：定期提交檢查請求【檢查定期預(yù)警】。概念預(yù)警（Alert）預(yù)警是一個監(jiān)控系統(tǒng)業(yè)務(wù)異常并通知、控制異常的應(yīng)用產(chǎn)品。實例/例外（Exception）預(yù)警檢查發(fā)現(xiàn)的滿足條件的異常記錄稱為一個例外。例如，一個預(yù)警希望檢測超期仍未送貨的送貨單信息并檢測到三張符合此條件的送貨單記錄，那么，每個檢測到的送貨單就是一個例外。如下SQL語句返回的每一條結(jié)果均是一個例外：活動類型（ActionType）事件預(yù)警或定期預(yù)警執(zhí)行后觸發(fā)執(zhí)行的的事件。SELECTal.lookup_type,al.lookup_code,al.meaningFROMalr_lookupsalWHEREal.lookup_type='ACTION_TYPE';LOOKUP_TYPELOOKUP_CODEMEANING_USMEANING_ZHSACTION_TYPECConcurrentProgramRequest并發(fā)程序ACTION_TYPEMMessage消息，也即郵件通知ACTION_TYPEOOperatingSystemScript操作系統(tǒng)程序ACTION_TYPESSQLStatementScriptSQL語句程序活動執(zhí)行層次（ActionLevel）活動的執(zhí)行層次，主要分三層，詳細資料、無例外、匯總。SELECTal.lookup_type,al.lookup_code,al.meaningFROMalr_lookupsalWHEREal.lookup_type='ACTION_LEVEL';LOOKUP_TYPELOOKUP_CODEMEANING_USMEANING_ZHSACTION_LEVELDDetail詳細資料ACTION_LEVELNNoException無例外ACTION_LEVELSSummary匯總詳細：針對檢測到的每一個例外都分別執(zhí)行一次。匯總：針對檢測到的所有例外總體匯總執(zhí)行一次。無例外：當(dāng)一次檢測沒有發(fā)現(xiàn)任何例外時執(zhí)行。配置應(yīng)用服務(wù)器OracleApplicationsVersion:數(shù)據(jù)庫服務(wù)器DatabaseVersion:OracleDatabase11gEnterpriseEditionRelease.0-64bitProductionUNIXAppServer（未經(jīng)驗證）需配置UNIXAppServer，需要注意的地方是：修改DNS設(shè)置：/etc/resolv.confnameserver3domainname將郵件服務(wù)器的域名加入到/etc/hosts中l(wèi)ocalhostmailerp郵件服務(wù)器上有個安全選項：檢測發(fā)件人域名是否存在。該選項必須設(shè)置為不檢測，避免系統(tǒng)提示不是真實的域名，發(fā)信失敗。利用telnet驗證驗證郵件服務(wù)器MailerNode:SELECTtarget_nodeFROMfnd_concurrent_queuesWHEREconcurrent_queue_nameLIKE'WFMLRSVC%';OutboundAndReplyToAddress:SELECTponent_name,cpb.parameter_name,cpv.parameter_valueFROMfnd_svc_componentscomp,fnd_svc_comp_param_valscpv,fnd_svc_comp_params_bcpbWHEREponent_id=ponent_idANDponent_type=ponent_typeANDcpb.parameter_id=cpv.parameter_idANDponent_nameLIKE'%Mailer%'ANDcpb.encrypted_flag='N'ANDcpb.parameter_nameIN('OUTBOUND_SERVER','REPLYTO')ORDERBYcpb.parameter_name;驗證方式：telnet[outboundserver]25ehlo[mailernode]mailfrom:[reply_toaddress]rcptto:[my_test_email_address]datasubject:TestmessageTestmessagebody.quit注意：將[outboundserver]替換為OUTBOUND_SERVER的參數(shù)值將[mailernode]替換為MailerNode的值將[reply_toaddress]替換為REPLYTO的參數(shù)值SMTP的默認端口為25，如果不是，則需要按照實際情況更改在郵件Subject和正文’Testmessagebody’之后，均輸入一個空行正文的結(jié)尾以”.”結(jié)束，且單獨成行結(jié)束telnet會話，輸入’quit’并且回車即可驗證實例：$telnet125Trying...Connectedto1.Escapecharacteris'^]'.220OAMAIL.ESMTPService(IBMDominoRelease9.0.1FP2)readyatWed,21Jan201511:28:48+0800ehlop570test250-OAMAIL.Hellop570test([5]),pleasedtomeetyou250-HELP250-AUTHLOGIN250-SIZE20971520250PIPELININGmailfrom:admin@250admin@...SenderOKrcptto:xxx@250xxx@...RecipientOKdata354Entermessage,endwith"."onalinebyitselfsubject:TestMessage123TestMessageBody456.250Messageacceptedfordeliveryquit221OAMAIL.SMTPServiceclosingtransmissionchannelConnectionclosed.$驗證結(jié)果：RUP4的patch4676589前使用Unixsendmail選項。RUP4的patch4676589后OracleEBS環(huán)境實施了RUP4的patch4676589以后，Oracle將Alert的郵件通知消息功能合并到了WorkflowNotificationMailer中，無需在【預(yù)警系統(tǒng)管理器系統(tǒng)選項】處做額外設(shè)置。預(yù)警例子業(yè)務(wù)需求預(yù)期效果當(dāng)接口完成后，將出錯記錄以郵件的形式匯總發(fā)給IT人員。初步想法接口表增加MAIL_STATUS，以標(biāo)識郵件是否已發(fā)送將出錯記錄以郵件的形式匯總發(fā)送給IT人員（FirstAlertAction）將接口MAIL_STATUS置為SENT（SecondAlertAction）SQLTEXT匯總-發(fā)送消息詳細資料-更新狀態(tài)事件預(yù)警查看DBTriggerSELECT*FROMdba_triggersdtWHEREdt.table_name='HEL_INT_LW_TEST';測試腳本BEGIN--需初始化環(huán)境，可參見事件預(yù)警自動創(chuàng)建的觸發(fā)器中的代碼，需檢測ORG_ID等fnd_global.apps_initialize(user_id=>18413,resp_id=>61969,resp_appl_id=>20003);FORiIN10..13LOOPINSERTINTOHEL_INT_LW_TESTVALUES(i,'TEST000'||i,NULL);ENDLOOP;COMMIT;END;查看隊列SELECTwno.q_name,wno.msgid,wno.corrid,wno.state,wno.delay,wno.enq_time,wno.sender_name,wno.sender_address,wno.recipient_keyFROMapplsys.wf_notification_outwnoWHEREwno.corridLIKEUPPER('%ALR%');--State:0-Ready1-Delayed2-Retained3-Exception,IfEqualto2,thenSentSuccefully實現(xiàn)效果預(yù)期：最后COMMIT，預(yù)期郵件匯總發(fā)出，但是實際則不然；實際：發(fā)出四封郵件，每封郵件中內(nèi)容一致，均包含了10~13的記錄信息；解釋：實際INSERT時，DBTrigger被執(zhí)行，此時，10~13對應(yīng)的請求【檢查事件預(yù)警】已經(jīng)提交，但尚未運行，當(dāng)COMMIT后，請求【檢查事件預(yù)警】開始運行，同時10~13已提交到數(shù)據(jù)庫，因此，會出現(xiàn)發(fā)出多封郵件的情況，且郵件內(nèi)容一致。定期預(yù)警測試腳本DECLAREl_request_idNUMBER;l_program_nameVARCHAR2(240);l_application_idNUMBER;l_alert_idNUMBER;l_alert_nameVARCHAR2(240);l_type_codeVARCHAR2(15);BEGINFND_GLOBAL.APPS_INITIALIZE(user_id=>18413,resp_id=>20456,resp_appl_id=>160);--寫入數(shù)據(jù)FORiIN10..13LOOPINSERTINTOHEL_INT_LW_TESTVALUES(i,'TEST000'||i,NULL);ENDLOOP;--檢查定期預(yù)警SELECTuser_concurrent_program_nameINTOl_program_nameFROMfnd_concurrent_programs_vlWHEREconcurrent_program_name='ALECDC'ANDapplication_id=160;SELECTalr.application_id,alr.alert_id,alr.alert_name,decode(alr.type,'P','S',alr.type)type_codeINTOl_application_id,l_alert_id,l_alert_name,l_type_codeFROMalr_periodic_alerts_viewalrWHEREalr.alert_id=101023;--SUBMITTHEREQUESTl_request_id:=fnd_request.submit_request(application=>'ALR',program=>'ALECDC',description=>l_alert_name,start_time=>SYSDATE,sub_request=>FALSE,argument1=>to_char(l_application_id),argument2=>to_char(l_alert_id),argument3=>l_type_code,argument4=>chr(0));IFl_request_id>0THENCOMMIT;dbms_output.put_line('RequestID:'||l_request_id);ELSEdbms_output.put_line('SubmitFailed!');ROLLBACK;ENDIF;END;實現(xiàn)效果由于是手動提交請求，因此可以滿足需求。郵件格式注意：影響格式的地方有如下幾點：預(yù)警定義預(yù)警詳細資料輸出最大長度處，如果將某個字段的長度設(shè)置為3，那么，超過的則會被截斷不予顯示。字段的間隔是看實際模板中兩個字段之間的間隔，例如，把輸出變量定義為&l_organization_code，那么它和下一個字段的間隔至少為lengthb(‘&l_organization_code’)，因此，最好將輸出變量定義的簡短。預(yù)警定義活動活動詳細資料文本最大寬度，此處影響頁面寬度。SqlText：SELECTerface_id,anization_code,txn.job_name,txn.wip_entity_name,txn.elvbox_name,txn.item_num,txn.lot_number,txn.subinventory_code,mtt.transaction_type_name,txn.transaction_quantity,to_char(txn.transaction_date,'YYYY-MM-DD'),txn.transaction_by,txn.error_code,txn.error_messageINTO&l_interface_id,&1,&2,&3,&4,&5,&6,&7,&8,&9,&10,&11,&12,&13FROMhel_int_job_trans_txntxn,mtl_transaction_typesmttWHEREmtt.transaction_type_id=txn.transaction_type_idANDcess_flagIN('3','4')ANDtxn.mail_status='N';匯總模板設(shè)置如下：生產(chǎn)作業(yè)批次投料、完工接口發(fā)生錯誤，匯總信息如下，詳細信息可參考接口表。組織批次工單箱頭物料特性值類型數(shù)量日期處理人錯誤消息=**=在此行下輸入摘要模板=**=**&1&2&3&4&5&6&8&9&10&11&13=**=在此行上輸入摘要模板=**=測試腳本：DECLAREx_return_statusVARCHAR2(1);x_msg_countNUMBER;x_msg_dataVARCHAR2(2000);x_request_idNUMBER;BEGINFND_GLOBAL.APPS_INITIALIZE(user_id=>18413,resp_id=>20456,