DocRef:REFDocRefNumber<DocumentReferenceNumber>深入淺出之Form個性化DATE\@"MMMMd,yyyy"December24,2015STYLEREFHD2DocumentControlIfSection1>1“DateAuthorVersionChangeReference10-Aug-15Ao.Du1.0NoPreviousDocumentReviewersNamePositionDistributionCopyNo.NameLocationLibraryMasterProjectLibraryProjectManagerNoteToHolders:Ifyoureceiveanelectroniccopyofthisdocumentandprintitout,pleasewriteyournameontheequivalentofthecoverpage,fordocumentcontrolpurposes.Ifyoureceiveahardcopyofthisdocument,pleasewriteyournameonthefrontcover,fordocumentcontrolpurposes.ContentsTOC\o"2-3"DocumentControl ii1. XXX 21.1. XXXX 21.2. XXXX 22. XXX 32.1. XXXX 32.2. XXXX 33. OpenandClosedIssuesforthisDeliverable 4OpenIssues 4ClosedIssues 4PAGE10Form個性化基礎介紹Form個性化介紹什么情況下使用個性化個性化主要用于客戶化標準功能的Form。對于我們自己開發的Form，除非已經上線很久、很穩定了，不想改源文件了否則沒必要用個性化。使用個性化的好處個性化的好處在于，基本上不用擔心升級問題，因為個性化信息是保存在表中的，獨立于源代碼，EBS版本升級或打Patch時，fmb可能被覆蓋，但個性化信息仍然得以保留。個性化信息保存的表applsys.fnd_form_custom_rules

applsys.fnd_form_custom_scopesapplsys.fnd_form_custom_actions個性化表關系SELECTfcr.function_name,--個性化對應function名稱

fcr.description,--個性化說明

fcr.trigger_event,--觸發器

fcr.trigger_object,--對象名稱

fcr.condition,--內容

fcr.enabled,--是否可用

fcs.level_id,

fcs.level_value

FROMapplsys.fnd_form_custom_rules

fcr,

applsys.fnd_form_custom_scopesfcs,

applsys.fnd_form_custom_actionsfca

WHEREfcr.id=fcs.rule_id(+)

ANDfcr.id=fca.rule_id(+)怎樣使用個性化開啟個性化設置配置文件值對如下兩個配置文件進行設置，可以隱藏或者開啟個性化配置文件名稱值功能公用程序：診斷是直接進入FORM個性化設置界面否需要先輸入APPS密碼隱藏診斷菜單項是隱藏診斷菜單否不隱藏診斷菜單進入Form個性化界面幫助=>診斷=>自定義代碼=>個性化個性化界面介紹個性化規則區域序號序號不重復即可，序號小的個性化先執行說明用于注明當前個性化動作的用途。層功能僅在當前function中可以使用表單所有應用了當前form的function中可以使用。啟用啟用或禁用該個性化個性化條件區域觸發器事件選擇對應的觸發器觸發器對象觸發器事件對應的對象條件觸發器觸發條件處理模式設置不同的觸發狀態個性化上下文區域層行業為下版本預留地點在地點層均啟用個性化職責設置不同職責是否啟用個性化用戶設置不同用戶是否啟用個性化值對用戶層和職責曾設置對象的值個性化活動區域序號活動的序號，從小到大執行，保持唯一性類型特性設置字段屬性消息彈出不同類型的消息內置執行內置函數菜單增加工具欄菜單說明說明語言語言啟用是否啟用個性化活動內容區域當活動類型為特性的時候對象類型Form存在的對象類型，例如：項目、塊、窗口等目標對象對象類型對應的內容。例如：項目對應的字段、塊對應的block值等特性名稱目標對象對應的屬性值為目標對象對應的屬性賦值當活動類型為消息的時候消息類型顯示/提示/錯誤/調試/警告消息文本消息內容當活動類型為內置的時候內置類型指定所使用的內建函數。變元函數處理內容當活動類型為菜單的時候菜單項需要啟用的菜單菜單標簽菜單顯示標簽編譯菜單前的行若勾選，在標簽上方會出現一條直線以做區隔所用。圖標名稱若需要在工具欄上添加一個圖形，則可以在此指定圖形的名稱。已在塊中啟用需要在對應的塊中激活該菜單CUSTOM.PLL介紹從以上的描述，我們可以看到form個性化滿足了我們對form做某些更改的需求，但是還是有不少的局限。Oracle給我們的個性化還提供了一個途徑CUSTOM.PLL。CUSTOM.PLL可以實現我們更加復雜的個性化需求。因為在這里，我們可以寫更加復雜的PLSQL，但是與我們直接在form里做修改相比，還是有很多限制的。custom.pll的使用當遇到form個性化無法完成的操作，我們可以通過custom.pll來實現。但由于custom.pll是oracle標準的library文件，所以在做個性化的時候必須要注意，備份好原有的custom.pll文件。1. 編譯命令CUSTOM.PLL路徑：$AU_TOP/resource；在$AU_TOP/resource路經下，編譯CUSTOM.PLL的命令：f60gen$AU_TOP/resource/CUSTOM.pllapps/apps2008module_type=libraryoutput_file=$AU_TOP/resource/CUSTOM.plx（R12編譯CUSTOM.PLL的命令：frmcmp_batchModule=$AU_TOP/resource/CUSTOM.pllUserid=apps/appsModule_Type=LIBRARYoutput_file=$AU_TOP/resource/CUSTOM.plx）2.custom中的function和Procedure簡介zoom_available：是否啟用工具欄中：view-zoom。例如：FUNCTIONzoom_availableRETURNBOOLEANISform_nameVARCHAR2(30):=name_in('system.current_form');block_nameVARCHAR2(30):=name_in('system.cursor_block');BEGINIF((form_name='POXPOEPO'ANDblock_name='PO_HEADERS')OR(form_name='POXPOERL'ANDblock_name='PO_RELEASES'))THENRETURNTRUE;ELSERETURNFALSE;ENDIF;RETURNFALSE;ENDzoom_available;style(event_namevarchar2)：是用來指定下面event里面代碼執行的方式，是先執行，后執行，還是覆蓋。可選的有：custom.before、custom.after、custom.override、custom.standard（默認值）。例如：FUNCTIONstyle(event_nameVARCHAR2)RETURNINTEGERISBEGINIFevent_nameIN('SPECIAL10','SPECIAL11','SPECIAL12')THENRETURNcustom.override;ELSERETURNcustom.STANDARD;ENDIF;ENDstyle;event(event_namevarchar2)：這是主要代碼，這里面允許使用的觸發器有：ZOOM、WHEN-NEW-FORM-INSTANCE、WHEN-NEW-BLOCK-INSTANCE、WHEN-NEW-RECORD-INSTANCE、WHEN-NEW-ITEM-INSTANCE、WHEN-VALIDATE-RECORD，還有special。代碼結構：PROCEDUREevent(event_nameVARCHAR2)ISform_nameVARCHAR2(30):=name_in('system.current_form');block_nameVARCHAR2(30):=name_in('system.cursor_block');BEGINIF(event_name='ZOOM')THEN……--個性化代碼ELSIF(event_name='WHEN-NEW-FORM-INSTANCE')THENIF(form_name='POXPOEPO'ANDblock_name='PO_HEADERS')THEN……--個性化指定的form、block、trigger的代碼ENDIF;ELSIF(event_name='WHEN-NEW-BLOCK-INSTANCE')THEN……ELSIF(event_name='SPECIAL10')THEN……ELSENULL;ENDIF;ENDevent;Custom.pll的工作機制在EBS中大部分Form都是在TEMPLATE.fmb的基礎上創建的，另外還有一些HR模塊的Form是在HRTEMPLT.fmb的基礎上創建的，這些模板Form在form級的觸發器中會去調用custom.pll這些Form級的觸發器為：ZOOMWHEN-NEW-FORM-INSTANCEWHEN-NEW-BLOCK-INSTANCEWHEN-NEW-RECORD-INSTANCEWHEN-NEW-ITEM-INSTANCEWHEN-VALIDATE-RECORD在HRMS模塊，還有以下觸發器也調用了custom.pllPRE-DELETEPOST-DELETEPRE-UPDATEPOST-UPDATEPRE-INSERTPOST-INSERTPOST-FORMS-COMMITWHEN-CREATE-RECORDKEY-DELREC在一些觸發器中，我們會看到調用APP_STANDARD.EVENT過程中的call_all_libraries(event_name)，call_all_libraries過程會調用custom.event(event_name)，例如WHEN-NEW-FORM-INSTANCEWHEN-NEW-RECORD-INSTANCEWHEN-NEW-ITEM-INSTANCEWHEN-NEW-BLOCK-INSTANCE個性化舉例隱藏參數按鈕界面展示將圖中字段隱藏選擇觸發器選擇觸發器WHEN-NEW-FORM-INSTANCE,這里是因為打開form就要將按鈕隱藏，觸發器的選擇需要根據個性化實現的不同觸發點來選擇。設置活動內容這里將按鈕參數CONC_PROG.PARAMETERS的DISPLAYED屬性設置為FALSE。即可隱藏按鈕參數字段。效果展示修改程序字段界面展示將程序字段修改為test選擇觸發器選擇觸發器WHEN-NEW-FORM-INSTANCE設置活動內容修改程序字段CONC_PROG.USER_CONCURRENT_PROGRAM_NAME的PROMPT_TEXT屬性，值設置為要顯示的內容。效果展示修改類型字段為必輸界面展示將類型字段設置為必輸選擇觸發器選擇觸發器WHEN-NEW-FORM-INSTANCE設置活動內容設置字段CONC_PROG.REQUEST_TYPE的REQUIRED屬性為TRUE。效果展示對類型字段設置默認值界面展示選擇觸發器選擇觸發器WHEN-NEW-FORM-INSTANCE設置活動內容對CONC_PROG.REQUEST_TYPE設置默認值VALUE屬性為test效果展示修改標準lov界面展示修改標準的lov實際上是為lov重新創建一個記錄組，然后將所用到的lov的記錄組屬性修改為新建的這個記錄組。根據樣式字段的lov舉例。選擇觸發器選擇觸發器WHEN-NEW-ITEM-INSTANCE觸發器對象就是樣式對應的item設置活動內容（1）先新建一個記錄組命名為cux_test，由于這里是測試，所以將where條件寫死，限制取出固定的兩條數據SELECTs.printer_style_name,s.user_printer_style_name,s.descriptionFROMfnd_printer_styles_vlsWHEREs.printer_style_nameIN('A4','AUSTRIANFormat1')ORDERBYs.user_printer_style_name將樣式對應的lov的記錄組屬性設置為剛剛創建的lov，即：CUX_TEST效果展示新增工具欄菜單界面展示在已有的菜單基礎下，新增一個菜單。選擇觸發器選擇觸發器WHEN-NEW-FORM-INSTANCE。設置活動內容選擇一個未被使用的special。可以選擇在特定的塊中啟用菜單。沒有選擇的塊將無法選擇這個菜單。效果展示未添加的數據塊已添加的數據塊調用Form界面選擇觸發器使用前面新增的菜單欄，通過點擊該菜單來實現form跳轉選擇觸發器SPECIAL12設置活動內容選擇內置的啟用功能項在參數里面可以選擇對應的參數，多個參數拼接的時候用空格隔開例如：='ORG_ID='||:EAM_WORKORDERS.ORGANIZATION_ID||'WIP_ENTITY_ID='||:EAM_WORKORDERS.WIP_ENTITY_ID在兩個參數中間需要一個空格，即在WIP_ENTITY_ID前面留一個空格修改查詢條件增加查詢條件經常會在限制部分數據不能被查詢到的時候使用。界面展示現在能查到這個并發程序，通過個性化，限制查詢不到當前并發程序。注意：修改這種查詢條件的時候，我們一定要先找到該數據塊原有的DEFAULT_WHERE，在設置新的DEFAULT_WHERE的時候，保留原有的條件。我們可以通過查看last_query來看，或者通過拉出form查找。這里last_query有一個條件，需要保留。選擇觸發器WHEN-NEW-FORM-INSTANCE設置活動內容這里只是舉例，所以寫死了查詢條件。效果展示OpenandClose