OAF中的MASTER-DETAIL关系

在日常开发中，我们经常会遇到头行结构，并且要求打开界面，行是隐藏的，点击头上的“显示”按钮，才要求头对应的行信息全部显示出来，这样，我们就用到了Master-Detail结构。

 

下面，我们就一步一步来实现他吧。

学习目的:

    1、掌握AM，View Object，View Link的创建方法

    2、学会用向导创建表格

    3、可以制作简单条件查询(simpleSearchPanel)

    4、掌握创建Detail的方法，以及属性的设置

一、新建AM：DetailAM

    选择项目TESTOAProject，点击右键New->Business Tier->ADF Business Components->Application Module

    设置   Package:test.oracle.apps.cux.details.server

             Name：DetailAM

 

点击下一步，一直到完成。

二、新建VO：PoHeaderVO

    选择包test.oracle.apps.cux.details.server，右键选择 New View Object

    设置   Package：test.oracle.apps.cux.details.server

             Name：PoHeaderVO

 

选择下一步，到Step5,SQL Statement，输入SQL

SELECT 'N' selectflag ,poh.po_header_id ,poh.segment1 po_number ,poh.vendor_id ,pv.vendor_name ,poh.vendor_site_id ,pvs.vendor_site_code ,0 viewline FROM po_headers_all poh ,po_vendors pv ,po_vendor_sites_all pvs WHERE poh.vendor_id = pv.vendor_id AND poh.vendor_site_id = pvs.vendor_site_id AND nvl(pv.enabled_flag,'Y') = 'Y'

点下一步，一直到完成。

更改PoHeaderVO的属性

       右键PoHeaderVO，选择Edit PoHeaderVO->Attributes->Viewline

       更改Type为Boolean

三、新建VO：PoLineVO

    选择包test.oracle.apps.cux.details.server，右键选择New View Object

    设置   Package：test.oracle.apps.cux.details.server

             Name：PoLineVO

 

选择下一步，到Step5 SQL Statement，输入SQL。

SELECT pol.po_header_id ,pol.po_line_id ,pol.line_num ,pol.item_id ,msib.segment1 item_code ,pol.item_description FROM po_lines_all pol ,mtl_system_items_b msib WHERE pol.item_id = msib.inventory_item_id AND pol.org_id = msib.organization_id AND nvl(msib.enabled_flag,'Y') = 'Y'

下一步，一直到完成。

 

四、新建View Link：PoHeaderToLineLink

    选择包test.oracle.apps.cux.details.server，右键选择New View Link

    设置    Package：test.oracle.apps.cux.details.server

              Name：PoHeaderToLineLink

点下一步。

选择Cardinality：0..1 to *

选择Select Source Attribute：PoHeaderVO.PoHeaderId

选择Select Destination Attribute：PolineVO.poHeaderId

点Add

下一步到Step 4：View Link Properties

保证Source和Destination的In View Object复选框被选中

点完成。

五、将VO添加到AM中

    选中DetailAM，右键Edit DetailAM(或双击)

    选对PoHeaderVO添加到AM下，然后把PoLineVO via PoHeaderToLineLink添加到AM下

 确定。

六、新建Page：DetailPG

 

选择test.oracle.apps.cux.details

点右键，New->Web Tier->OA Components->Page

 

输入      Name：DetailPG

       Package：test.oracle.apps.cux.details.webui

 

点完成。

修改PageLayout

           ID：PageLayoutRN

AM Definition：test.oracle.apps.cux.details.server.DetailAM

 Window Title：主从表测试

        Title：主从表测试

新建一个RN：QueryRN

选择PageLayoutRN，点右键，New->Region

 

更改以下信息

                          ID：QueryRN

                Region Style：query

           Construction Mode：autoCustomizationCriteria

      Include Advanced Panel：True

用向导新建一个表格

右键点击QueryRN，New->Region Using Wizard...

 

  Application Module：test.oracle.apps.cux.details.server.DetailAM

Available View Usage：PoHeaderVO1

下一步。

   Region ID：ResultTable

Region Style：table

 

下一步。

选中PoheaderId，PoNumber，VendorName，VendorSiteCode，Viewline到右边。

下一步，修改表格信息。

完成。

可以看到，结构图如下

修改ITEM的Search Allowed全部为True。

更改ResultTable属性

Detail View Attribute：Viewline

                Width：100%

添加查询条件

选择QueryRN，右键选New->simpleSearchPanel

系统会自动创建一个Header和一个Region

修改Header属性

        ID：SimpleSearchHdr

      TEXT：订单查询

修改Region属性

        ID：SearchComponentLayout

然后在Region下面新建一个messageTextInput

修改ITEM的属性

        ID：PoHeaderID

        Search Allowed：True

        Maximum Length：40

                Prompt：订单ID

                Length：20

添加查询的对应关系

选择QueryRN，右键New->simpleSearchMappings

更改属性

                  ID：PoHeaderMap

         Search Item：PoHeaderId

        Results Item：PoHeaderId

完成后，结构图如下：

 现在可以运行看一下效果了...

 

 

选择ResultTable，右键New->details

系统会创建一个header域

 

用向导创建表格

选择detailHdr，右键New->Region Using Wizard...

Application Module：test.oracle.apps.cux.details.server.DetailAM

Available View Usage：PolineVO1

下一步：Region Properties

    Region ID：LineTable

    Region Style：table

选中LineNum，ItemCode，ItemDescription到右边

下一步，修改表格属性

完成。

更改表格属性，修改search_allowed全部为True

更改LineTable

View Link Instance：PoHeaderToLineLink1

             Width：90%

选择ResultTable，点右键New->MultipleSelection

修改multipleSelection1的属性值

            ID：SelectFlag

 View Instance：PoHeaderVO1

View Attribute：Selectflag

 

到此为止，我们就完成了Master-Details的全部设置，运行后，你就可以收获成功的喜悦了。。

 

 注：

当运行时，系统报如下错误时:

oracle.apps.fnd.framework.OAException: Detail View Attribute Name is not set for the table even though a detail named child has been specified. Please specify a Boolean or String ("Y" or "N") view attribute for this table property.

请检查：

主块的Table属性中，Detail View Attribute字段是否有类型为Boolean的值

属性