EBS环境下PLSQL和接口开发.docx

Doc Ref: MD070/UG/003 MD.070 Application Extension Technical DesignMarch 17, 2006Document ContDocument ContiiEBS环境下PL/SQL请求开发1并发请求(SRS)基础1EBS下的请求开发基础2调试和跟踪模式6常用的数据库包11EBS环境下PL/SQL请求开发模版13EBS环境下接口开发基础15概述15导入问题解决途径15SQL*Loader工具介绍15DBLink使用16PL/SQL Developer Text Importer16EBS环境下接口开发 接口表(Open Interface)类型的接口18概述18EBS提供接口表类型列表18实例解析 物料导入(Item Import)19EBS环境下接口开发 API Procedure类型的接口20概述20实例解析 20Open and Closed Issues for this Deliverable21Open Issues21Closed Issues21Note: To update the table of contents, put the cursor anywhere in the table and press F9. To change the number of levels displayed, select the menu option InsertIndex and Tables, make sure the Table of Contents tab is active, and change the Number of Levels to a new value.Document Cont iiiEBS环境下File Ref: EBS环境下PLSQL和接口开发.doc (v. 1.0 )Company Confidential - For internal use onlyDoc Ref: Error! Reference source not found.Error! Reference source not found.Error! Reference source not found.EBS环境下接口开发 接口表(Open Interface)类型的接口 20Error! Reference source not found.File Ref: 5e72e3bd78fcd6eb98716efe0674f4f2.pdf (v. Error! Reference source not found. )Company Confidential - For internal use onlyEBS环境下PL/SQL请求开发并发请求(SRS)基础通过并发处理服务器运行的程序称为并发请求。当用户通过Web页面或者Form界面提交一个请求时，一行记录会插入到数据库表中。而后面并发管理器会从数据库表中读取相关的信息，启动合适的并发程序。UNIX后台进程EBS系统中启动并发程序后，一个基于操作系统的后台进程被启动，因此用户可以在UNIX系统命令行中查找并发管理器的进程和相关服务进程：ps ef | grep FNDLIBRps ef | grep FNDSM是通过上面的第二条命令查询处理的进程IDps ef | grep 请求的生命周期 每个并发请求都有自己的生命周期，包括如下的三个或者是四个阶段：阶段活动图示待定(Pending)请求正在等待运行运行中(Running)请求正在运行完成(Completed)请求已经运行完成失效(Inactive)请求被失效请求的结果状态并发请求运行的结果有三种状态：返回值描述图示0成功 请求成功运行结束1警告 - 请求运行完成，但是存在警告2错误 - 请求运行结束，但是以错误结束请求相关后台数据库表 并发请求涉及的后台数据库表：表内容FND_CONCURRENT_REQUESTS用户所运行的请求详细信息，包括状态、请求运行开始时间和完成时间等FND_CONCURRENT_PROGRAMS并发程序定义的详细信息，包括执行方法、程序的约束等等FND_CONCURRENT_PROCESSESFND_CONCURRENT_QUEUESEBS下的请求开发基础并发请求SRS并发程序的过程第1，2个参数是固定的传出参数：参数名类型数据类型描述ERRBUFOUTVARCHAR2并发程序返回错误信息RETCODEOUTVARCHAR2并发程序返回状态0 成功1 警告2 错误两个传出参数用来标示请求运行的结果。在PL/SQL过程中，这两个参数用来将程序的运行结果状态返回给并发请求管理器，以显示请求运行的结果。因此如果开发人员想在PL/SQL逻辑中手工来控制并发请求的运行返回状态，可以通过对RETCODE赋予对应的返回状态值即可。请求输出(Output)请求运行结束后有一定的输出产生，而这种输出就是通过请求的输出来实现的。用户在请求运行结束后，可以通过输出查看器来查看请求运行的输出结果。在SRS窗口中通过点击查看输出按钮来查看请求的输出信息。在PL/SQL程序中，开发人员可以使用FND_FILE数据库包来打印出请求的输出信息；开发人员可以将报表运行的结果信息、一些接口的运行情况等等信息写入到输出信息，让用户能够从输出信息中查看到报表请求运行的结果情况。请求日至(Log)用户在请求运行结束后，可以通过日至查看器来查看请求运行的日志。在SRS窗口中通过点击查看日志按钮来查看请求的日志信息。开发人员使用日志机制来输出一些请求运行过程中的日志信息，将一些程序的调试信息、程序变量的中间值和辅助信息打印到日志信息里面，让开发人员、系统管理员和最终用户能够根据日志信息在最短的时间内找到问题所在。在PL/SQL程序中，开发人员可以使用FND_FILE数据库包来打印出请求的日至信息父请求和子请求一个请求在运行的过程中可以带出另外的请求，而运行的请求被称为父请求，被带出的请求称为子请求，根据子请求与父请求的关系可以分为：1 强关联子请求：这类请求被父请求启动后，父请求马上转为等待状态，它等待子请求运行完成后再继续运行，如果子请求运行失败，则父请求也运行失败。对于一些子请求运行的结果将作为父请求的后续工作输入时，经常使用这类请求关系2 弱关联子请求：这类请求被父请求启动后，父请求继续运行，并不停下来等待子请求的运行，子请求运行的成功与否与父请求没有直接的关系。父请求和子请求都应该在EBS系统中定义为能够独立运行的并发程序。在PL/SQL的请求过程中可以通过以下的过程来调用启动子请求：FND_REQUEST.SUBMIT_REQUESTPL/SQL并发程序定义1 可执行的定义2 并发程序定义定义并发程序参数以上定义的请求参数会按照参数的定义依次传入到PL/SQL过程中，因此在定义PL/SQL类型的并发请求参数时，需要注意PL/SQL过程中的传入参数的顺序和并发请求中参数的顺序(按照序号来排序)，它们应该一一对应起来。一句话，并发请求的参数和对应的PL/SQL过程传入参数是按照顺序来匹配的(两个OUT参数不计算在内)调试和跟踪模式PL/SQL Developer中调试PL/SQL程序 PL/SQL的开发过程中，需要进行频繁的调试跟踪操作，使用PL/SQL Developer工具中的Test Window来进行PL/SQL程序的调试在PL/SQL Developer中如何进行PL/SQL程序的调试呢？1 在PL/SQL 过程中，在需要关注的输出和变量之前添加断点2 在PL/SQL的包体或者包声明中右击，选择探出窗口中的Test项3 启动Test窗口，而且PL/SQL Developer自动将过程或功能的参数写到测试窗口中4 对传入类型的参数赋予测试的参数值5 点击测试窗口工具条中的Start Debugger，或者按F9快捷键开始测试，后按Ctrl+R开始运行，6 使用测试工具栏来一步一步进行程序的调试用户登录的职责职责所属的应用EBS用户 调试工具栏在Test窗口中，调用调试的过程或功能之前先调用过程：FND_GLOBAL.APP_INITIALIZE (USER_ID NUMBER, RESP_ID NUMBER, RESP_APPL_ID NUMBER);来模仿EBS应用用户来初始化环境信息，这个初始化特别是在PL/SQL代码中使用了受到安全性或系统变量限制的视图或功能时是非常必须的，如果不做这个初始化工作，在PL/SQL Developer中无法查询出任何的数据，或者查询出来的数据是不正确的。如果开发人员想使用PL/SQL Developer工具中的DBMS Output窗口来输出一些调试信息时，可以在PL/SQL代码中使用DBMS_OUTPUT数据库包来输出调试信息，具体使用请看DBMS_OUTPUT一节如何使用PL/SQL Developer工具中的Debug功能，请参考相关的手册SRS日志并发请求的日志是用来打印出一些请求在运行过程中产生的日志信息，因此可以利用并发请求的日志机制来输出PL/SQL程序的调试信息，来帮助开发人员打印出程序过程中所关注的变量值、表达式和辅助信息。在PL/SQL中，使用FND_FILE.PUT_LINE (FND_FILE.LOG, LOG_MSG) 过程来输出日志信息对于PL/SQL类型的请求，多使用这种方式来输出各种调试信息实际例子可以参考OM模块的后台调试包：OE_DEBUG_PUB日志文件日志信息除了写入请求日志文件中，另外一种被开发人员经常使用的方式是：将日志信息写入到服务器上的一个文件中；这种方式和请求日志并不能说谁好谁不好，只是在不同的情况下采取不同的实现方式。由于有些PL/SQL程序需要通过非请求方式来调用，特别是在Form中来调用程序，这个时候就不能够使用请求的日志机制来打印出程序的调试和辅助信息，因此在这种情况下，将调试信息写入到服务器上的一个指定文件就是一个很好的选择要在PL/SQL程序中将调试信息写到服务器上的文件，需要使用：UTL_FILE.PUT_LINE (FILE_DIR, LOG_MSG) 实际例子可以参考OM模块的后台调试包：OE_DEBUG_PUB日志数据库表上面通过请求日志或者服务器日至文件来实现调试信息的表现；而对于PL/SQL数据库开发人员来说，使用数据库的方式来体现调试信息是最方便和最熟悉的方式。因此在PL/SQL程序过程中，可以将日志信息写入数据库表中，再通过数据库表查询出相关的调试信息。实际例子可以参考PO订单审批工作流的后台调试包：PO_WF_DEBUG_PKG，其中对应的数据库表为：PO_WF_DEBUG如何启用调试模式在实际的开发过程中，开发人员常用的两种启动调试模式的方法：1 请求中添加一个“调试标志”参数来启用调试模式。这种方式是在并发程序中添加一个调试标志的参数，使用请求参数中的“显示”参数，可以很容易的实现开发和正式运行之间的切换，在请求正式使用之后，只要将这个参数隐藏即可；而在PL/SQL程序中，在输出调试和辅助信息之前都去判断调试标志参数，这样无需任何的程序修改，只要修改一下并发程序的定义就可以将程序从开发状态转为正式使用。对于请求类的PL/SQL程序很多时候使用这种方式，如“将应付帐款传送至总帐”请求中就添加了一个“debug_flag”来启动调试模式2 通过设置一个预制文件。 这种方法是为请求专门定义一个预制文件，当预制文件为某个值的时候即认为调试模式已启动。在PL/SQL程序中，在输出调试和辅助信息之前去判断预制文件是否等于特定的值，这样无需任何的程序修改，只要修改一下设置一下预制文件的值就可以将程序从开发状态转为正式使用。对于非请求类的PL/SQL程序比较多使用这种方法，如OM模块中的调试信息就是通过预制文件“OM： 调试级别”来启动的这种方式所带来的问题是需要专门创建一个预制文件，因此给安装和维护带来了一定的工作量，但是相比上面一种方法要灵活一些。常用的数据库包 以下小结描述了在PL/SQL程序开发中经常引用到的数据库包。DBMS_OUTPUTDBMS_OUTPUT可以在PL/SQL代码中将信息打印到标准输出上，PL/SQL代码可以是在存贮过程、包和触发器。因此很多PL/SQL的开发人员使用DBMS_OUTPUT来输出调试信息，但是对于在Oracle EBS环境下开发，无法使用这个包将信息打印到标准输出上，因此如果使用它就没有办法实现在正式的程序代码中包括调试信息，所以也很少使用它。在PL/SQL Developer中，如果使用DBMS_OUTPUT来输出信息，在调试的时候，可以在DBMS标签页中查看输出在DBMS_OUTPUT窗口中输出调试信息：FND_GLOBALFND_GLOBAL作为Oracle EBS环境初始化、环境信息的后台数据库包FND_FILEFND_APIFND_MSG_PUBFND_MESSAGEAPP_EXCEPTIONEBS环境下PL/SQL请求开发模版 CREATE OR REPLACE PACKAGE BODY CUX_CONC_TEMPLATE_PUB AS/*= Copyright (C) HAND Enterprise Solutions Company Ltd. AllRights Reserved =* =* PROGRAM NAME:* * DESCRIPTION: * * HISTORY: * 1.00 2005-09-26 xxxxxx Creation* * =*/ G_PKG_NAMECONSTANT VARCHAR2(30):= CUX_CONC_TEMPLATE_PUB; PROCEDURE main( errbuf OUT VARCHAR2, retcode OUT VARCHAR2, p_parameter1 IN VARCHAR2, p_parameter2 IN VARCHAR2) IS l_return_status VARCHAR2(30); l_msg_count NUMBER; l_msg_data VARCHAR2(2000); BEGIN retcode := 0; - convert parameter data type, such as varchar2 to date - l_date := fnd_conc_date.string_to_date(p_parameter1); - conc body 用户代码区 - conc end body EXCEPTION WHEN fnd_api.g_exc_error THE