深入浅出之预警系统配置-Oracle EBS技术文档整理

DocRef:January21,2015STYLEREFHD2已解决及待解决问题IfSection2>1“日期作者版本变更说明21-Jan-15罗文1.0初版审阅姓名职位分发拷贝编号姓名位置/岗位1234目录TOC\o"2-3"文档控制 ii预警概述 1概述 1概念 1配置 3预警例子 7业务需求 7已解决及待解决问题 14待解决问题 14已解决问题 14PAGE2预警概述概述主要特性监视系统状况及自定义的特殊事件发布自定义样式的关键信息提供数据库状况的常规报表自动完成系统维护，日常在线操作事件预警-事件驱动驱动方式：事件驱动，监测数据库事件，主要是对数据库表的INSERT、UPDATE操作，一经发生，则立刻通知。实现方式：在基表上创建行级别触发器（DBTrigger），进而提交检查请求【检查事件预警】。定期预警-时间驱动驱动方式：时间驱动，按照计划一定时间频率进行监测，每天，每周，每个月等等，亦或是根据需要，手动提交检查。实现方式：定期提交检查请求【检查定期预警】。概念预警（Alert）预警是一个监控系统业务异常并通知、控制异常的应用产品。实例/例外（Exception）预警检查发现的满足条件的异常记录称为一个例外。例如，一个预警希望检测超期仍未送货的送货单信息并检测到三张符合此条件的送货单记录，那么，每个检测到的送货单就是一个例外。如下SQL语句返回的每一条结果均是一个例外：活动类型（ActionType）事件预警或定期预警执行后触发执行的的事件。SELECTal.lookup_type,al.lookup_code,al.meaningFROMalr_lookupsalWHEREal.lookup_type='ACTION_TYPE';LOOKUP_TYPELOOKUP_CODEMEANING_USMEANING_ZHSACTION_TYPECConcurrentProgramRequest并发程序ACTION_TYPEMMessage消息，也即邮件通知ACTION_TYPEOOperatingSystemScript操作系统程序ACTION_TYPESSQLStatementScriptSQL语句程序活动执行层次（ActionLevel）活动的执行层次，主要分三层，详细资料、无例外、汇总。SELECTal.lookup_type,al.lookup_code,al.meaningFROMalr_lookupsalWHEREal.lookup_type='ACTION_LEVEL';LOOKUP_TYPELOOKUP_CODEMEANING_USMEANING_ZHSACTION_LEVELDDetail详细资料ACTION_LEVELNNoException无例外ACTION_LEVELSSummary汇总详细：针对检测到的每一个例外都分别执行一次。汇总：针对检测到的所有例外总体汇总执行一次。无例外：当一次检测没有发现任何例外时执行。配置应用服务器OracleApplicationsVersion:数据库服务器DatabaseVersion:OracleDatabase11gEnterpriseEditionRelease.0-64bitProductionUNIXAppServer（未经验证）需配置UNIXAppServer，需要注意的地方是：修改DNS设置：/etc/resolv.confnameserver3domainname将邮件服务器的域名加入到/etc/hosts中localhostmailerp邮件服务器上有个安全选项：检测发件人域名是否存在。该选项必须设置为不检测，避免系统提示不是真实的域名，发信失败。利用telnet验证验证邮件服务器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的参数值将[mailernode]替换为MailerNode的值将[reply_toaddress]替换为REPLYTO的参数值SMTP的默认端口为25，如果不是，则需要按照实际情况更改在邮件Subject和正文’Testmessagebody’之后，均输入一个空行正文的结尾以”.”结束，且单独成行结束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.$验证结果：RUP4的patch4676589前使用Unixsendmail选项。RUP4的patch4676589后OracleEBS环境实施了RUP4的patch4676589以后，Oracle将Alert的邮件通知消息功能合并到了WorkflowNotificationMailer中，无需在【预警系统管理器系统选项】处做额外设置。预警例子业务需求预期效果当接口完成后，将出错记录以邮件的形式汇总发给IT人员。初步想法接口表增加MAIL_STATUS，以标识邮件是否已发送将出错记录以邮件的形式汇总发送给IT人员（FirstAlertAction）将接口MAIL_STATUS置为SENT（SecondAlertAction）SQLTEXT汇总-发送消息详细资料-更新状态事件预警查看DBTriggerSELECT*FROMdba_triggersdtWHEREdt.table_name='HEL_INT_LW_TEST';测试脚本BEGIN--需初始化环境，可参见事件预警自动创建的触发器中的代码，需检测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实现效果预期：最后COMMIT，预期邮件汇总发出，但是实际则不然；实际：发出四封邮件，每封邮件中内容一致，均包含了10~13的记录信息；解释：实际INSERT时，DBTrigger被执行，此时，10~13对应的请求【检查事件预警】已经提交，但尚未运行，当COMMIT后，请求【检查事件预警】开始运行，同时10~13已提交到数据库，因此，会出现发出多封邮件的情况，且邮件内容一致。定期预警测试脚本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);--写入数据FORiIN10..13LOOPINSERTINTOHEL_INT_LW_TESTVALUES(i,'TEST000'||i,NULL);ENDLOOP;--检查定期预警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;实现效果由于是手动提交请求，因此可以满足需求。邮件格式注意：影响格式的地方有如下几点：预警定义预警详细资料输出最大长度处，如果将某个字段的长度设置为3，那么，超过的则会被截断不予显示。字段的间隔是看实际模板中两个字段之间的间隔，例如，把输出变量定义为&l_organization_code，那么它和下一个字段的间隔至少为lengthb(‘&l_organization_code’)，因此，最好将输出变量定义的简短。预警定义活动活动详细资料文本最大宽度，此处影响页面宽度。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';汇总模板设置如下：生产作业批次投料、完工接口发生错误，汇总信息如下，详细信息可参考接口表。组织批次工单箱头物料特性值类型数量日期处理人错误消息=**=在此行下输入摘要模板=**=**&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,