彈性域的使用(整理版)

1、-作者xxxx-日期xxxx彈性域的使用(整理版)【精品文檔】彈性域的使用彈性域分為鍵彈性域和說明性彈性域，本文就針對這兩種彈性域在二次開發(fā)中使用進行舉例說明，并附帶說明彈性域中經(jīng)常使用的值集; 一個彈性域由多個段組合起來，數(shù)據(jù)庫中，段以單個表列形式出現(xiàn)。一、彈性域開發(fā)中需要做的前期工作1.注冊一個可以使用彈性域的表,字段本范例全部以如下對象為基礎(chǔ)，進行彈性域的說明CREATE TABLE flex_ln( name VARCHAR2 (20), age NUMBER, dept VARCHAR2 (20), attribute1 VARCHAR2 (250), attribute2 VARC

2、HAR2 (250), attribute3 VARCHAR2 (250), attribute4 VARCHAR2 (250), attribute_category VARCHAR2 (250);注冊數(shù)據(jù)庫表,列系統(tǒng)中的數(shù)據(jù)庫表和列的注冊旨在支持系統(tǒng)的彈性域和預(yù)警系統(tǒng)兩個特性如果不需要這些特性不需要注冊表.注冊方法: 用如下的過程注冊表語法: ad_dd.register_table(所有者,表名,T自動擴展/S非自動擴展,下一區(qū),自由,已使用)execute ad_dd.register_table ( EDU,FLEX_LN,T);檢查注冊成功與否: select ft.table_i

3、d from fnd_tables ft where ft.table_name = CUX_OM_POP_VALIDITY_ALL; 刪除注冊: execute ad_dd.delete_table ( CUX,CUX_OM_POP_VALIDITY_ALL);這里說明下，EDV 是在系統(tǒng)注冊過的一個應(yīng)用簡稱，二次開發(fā)的程序，最好重新注冊一個應(yīng)用，這樣便于今后的管理。如下圖：注冊表中的列(彈性域列)語法: execute ad_dd.register_column(所有者,表名, 字段名,序號,類型,字段寬度,是否為空，是否可以轉(zhuǎn)換）execute ad_dd.register_column

4、 (EDV,FLEX_LN,ATTRIBUTE1,1,VARCHAR2,50,N,N);execute ad_dd.register_column (EDV,FLEX_LN,ATTRIBUTE2,2,VARCHAR2,50,N,N);execute ad_dd.register_column (EDV,FLEX_LN,ATTRIBUTE3,3,VARCHAR2,50,N,N);execute ad_dd.register_column (EDV,FLEX_LN,ATTRIBUTE4,4,VARCHAR2,150,N,N);execute ad_dd.register_column (EDV,F

5、LEX_LN,ATTRIBUTE_CATEGORY,5,VARCHAR2,30,N,N);注冊說明性彈性域應(yīng)用：選擇注冊的應(yīng)用名稱：填寫注冊說明彈性域的名稱（必須唯一）標(biāo)題：彈性域的標(biāo)題，在今后的應(yīng)用中，此說明彈性域?qū)诖翱跇?biāo)題上顯示在此定義的標(biāo)題內(nèi)容表應(yīng)用：在注冊表，列時指定的應(yīng)用（appl_short_name）表名： 選擇注冊的表名稱結(jié)構(gòu)列：必須也是存在于注冊過的列，結(jié)構(gòu)列的意義就是存放說明性彈性域上下文提示的值上下文提示：是在說明性彈性域上下文字段的標(biāo)題描述參考字段BUTTON里，如下界面：上面的界面是輸入界面，系統(tǒng)提供輸入，這里可以輸入多個記錄，當(dāng)然最終只能有一個字段來起作用，需要

6、在段里指定。字段名：必須與彈性域中選擇的表中的字段一致。說明：對字段的描述性文字參考字段的含義：參考字段的主要作用是 與結(jié)構(gòu)列的作用類似，可以在不選擇上下文字段的情況下，系統(tǒng)根據(jù)參考字段的含義來對應(yīng)顯示不用的彈性域，舉例說明：例如參考字段為 NAME，則在系統(tǒng)中輸入NAME信息后，系統(tǒng)會自動根據(jù)NAME的信息來確定顯示什么樣的彈性域，這樣就可以避免來選擇上下文來顯示需要的彈性域。列BUTTON里，如下界面這里面顯示的是注冊后的列字段(如果填寫了結(jié)構(gòu)列字段，則這里面將不在顯示結(jié)構(gòu)列字段，因為系統(tǒng)認(rèn)為結(jié)構(gòu)列字段與彈性字段是不同的) 如果對某個彈性字段不需要，可以將起用CHECKED失效，這樣在構(gòu)造

7、彈性域的時候，此彈性字段不會作用顯示系統(tǒng)注冊完彈性域的名稱后，下一步需要配置彈性域的彈性字段.界面如下：彈性域上下文的范圍定義在值集里面,每一個值,都會定義自己的段;根據(jù)參考字段的值和上下文字段的值進行比較，如果存在,則顯示維護彈性值,如果不存在,則不顯示.名稱：填寫注冊說明彈性域的名稱（必須唯一）此處的界面需要重點注意的地方：上下文字段-提示：這里的提示是上下文PROMPT的信息，在這里輸入信息后，在注冊彈性域 “上下文提示” 欄的內(nèi)容，兩者的內(nèi)容是一致的-值集：為上下文字段的內(nèi)容提供一個值的LOV形式選擇，以本例說明：值集SET_VALUE_DESC_FLEX中包括的信息是“彈性一”、“彈

8、性二”,這樣，就可以根據(jù)選擇不同的信息來實現(xiàn)不同的彈性域，而且，選擇的上下文字段信息（此處就是彈性域上下文AAAA欄）會保存在結(jié)構(gòu)列中。-默認(rèn)值： 設(shè)定上下文的默認(rèn)值-參考字段：此處系統(tǒng)提供的是一個LOV輸入，此處LOV里的數(shù)據(jù)來源于在注冊彈性域里的時候“參考字段：”BUTTON里的輸入記錄。參考字段的含義是，可以以其他字段的輸入記錄來判斷是否顯示哪種彈性域。上下文字段值 這里可以定義多個彈性域段：比如 彈性域1=彈性字段1+彈性字段2 彈性域2=彈性字段1+彈性字段2+彈性字段3彈性域3=彈性字段1+彈性字段2+彈性字段3+彈性字段4這里需要說明下：每個彈性的段信息中，都有一個默認(rèn)的段定義

9、Global Data Elements 彈性域Global Data Elements 的段結(jié)構(gòu)如下:如果我們定義的彈性域只有一種段結(jié)構(gòu)的話，可以直接在Global Data Elements段中進行定義，如果有多個的話，需要在另創(chuàng)建記錄進行段定義的需要，有一點需要說明的是，一旦有注冊了的字段在 Global Data Elements中定義了結(jié)構(gòu)的話，那么用戶自己在創(chuàng)建其他的段結(jié)構(gòu)，則不會顯示在Global Data Elements中使用了的字段具體定義彈性域中需要那些彈性字段，需要在“段”BUTTON里的界面中進行定義如 彈性一 的段結(jié)構(gòu)彈性二 的段結(jié)構(gòu) 以本文中的為例進行說明： Gl

10、obal Data Elements 段中定義了一個 ATTRIBUTE1字段，那么在彈性一、彈性二中的段定義的時候，無法在選擇 ATTRIBUTE1這個字段。針對此彈性域的配置，在實際使用中的說明：圖中紅色框代表的是加載說明性彈性域的字段，點擊此處，便可出現(xiàn)彈性域的結(jié)構(gòu)。由于在系統(tǒng)設(shè)置彈性域段的時候，給上下文段一個默認(rèn)值 = “彈性一” 則系統(tǒng)會自動將彈性一的段結(jié)構(gòu)給顯示出來（定義了三個彈性字段TITLE分別為10、15、20），由于此彈性域還定義了一個Global Data Elements 的段結(jié)構(gòu)，則系統(tǒng)會將Global Data Elements 顯示在最前面，作為整個彈性域的公共字

11、段（不論彈性域上下文AAAA選擇的是“彈性一、彈性二”）整個彈性域都將會顯示 Global Data Elements的段結(jié)構(gòu)。選擇“彈性二” 后的界面如下： 下面在圖文說明下 定義的參考字段“NAME”的作用在應(yīng)用彈性域界面中 在“NAME”欄輸入 “彈性一”，選擇彈性欄位 得到的結(jié)果如下如果在“NAME”欄輸入 “彈性二” 選擇彈性欄位 得到的結(jié)果如下從以上兩個圖可以說明 參考字段也可以決定需要顯示的彈性結(jié)構(gòu)。在這里需要提一個：參考字段+上下文段（不顯示+不需要） 這樣就可以在界面中動態(tài)的控制彈性的結(jié)構(gòu)，而不需要來選擇上下文的內(nèi)容當(dāng)然，參考字段與上下文段還是有所區(qū)別的，在參考字段輸入“彈性

12、一”后，雖然顯示的是彈性一的段結(jié)構(gòu)，然而也可以在選擇上下文段的值來重新選擇需要的段結(jié)構(gòu)，這樣的話，參考字段的值=彈性一，而上下文的值=彈性二，也就是說，參考字段的作用是在于初始話一個彈性域的結(jié)構(gòu)，一旦該彈性段有值以后，就不在作用了。真正跟彈性結(jié)構(gòu)相關(guān)的字段還是結(jié)構(gòu)列字段，也就是上下文段這里可以看到，雖然參考字段是“彈性二”，但可以在繼續(xù)選擇上下文來需要相應(yīng)的段結(jié)構(gòu)。 編寫FORM設(shè)置和彈性域1:加入非基表域用于容納彈性域,我們做一個ITEM叫DESC_FLEX 注意這個ITEM的CLASS屬性為 TEXT_ITEM， LOV處選擇ENABLE_LIST_LAMP，并把檢查有效性設(shè)為NO。2:F

13、ORM中要包含所設(shè)置的彈性域如ATTRIBUTE_CATEGORY,ATTRIBUTE1,ATTRIBUTE2. 注意這些域為基表項,設(shè)置CANVANS為NULL或者顯示在畫布上都可以 3:把DESC_FLEX放在CANVANS上,弄成彈性域的樣子.設(shè)置其屬性:值列表=ENABLE_LIST_LAMP4:在FORM中注冊彈性域為了FORM識別彈性域,在FORM級別的WHEN-NEW_FORM_INSTANCE 上加上如下的代碼從列表中驗證=否 fnd_descr_flex.define( FLEX_LN, - form中的block name field=DESC_FLEX, - form中的

14、彈性域的item name appl_short_name=EDV, - 注冊彈性域在那個user下 desc_flex_name=FLEX_LN - 注冊彈性域的名稱);含有彈性域的BLOCK叫FLEX_LNDESC_FLEX我們命名的那個容納彈性域的域. FLEX_LN 我們注冊的那個彈性域的名稱.5:加入觸發(fā)器以支持彈性域.分別在BLOCK級別加入如下的觸發(fā)器.PRE-QUERYPRE-UPDATEPRE-INSERTPOST-QUERY其觸發(fā)器的代碼分別對應(yīng)FND_FLEX.EVENT(PRE-QUERY );FND_FLEX.EVENT(PRE-UPDATE );FND_FLEX.E

15、VENT(PRE-INSERT );FND_FLEX.EVENT(POST-QUERY );在容納彈性域的域ITEM級別加入如下的觸發(fā)器WHEN-VALIDATE_ITEMFND_FLEX.EVENT(WHEN-VALIDATE-ITEM);至此我們完成了本FORM ,只要打開彈性域我們就可以像用系統(tǒng)彈性域一樣用這些彈性域了。手工刪除說明性彈性域腳本：/* 刪除說明性彈性域的段結(jié)構(gòu) */DELETE fnd_descr_flex_col_usage_tl WHERE (application_id = 660) AND (descriptive_flexfield_name LIKE FLEX

16、_LN); /* 刪除說明性彈性域的段 */DELETE fnd_descr_flex_contexts_tl WHERE (application_id = 660) AND (descriptive_flexfield_name LIKE FLEX_LN); DELETE fnd_descr_flex_column_usages WHERE (application_id = 660) AND (descriptive_flexfield_name LIKE FLEX_LN); /* 刪除說明性彈性域的注冊信息 */DELETE fnd_descriptive_flexs_tl a WHE

17、RE a.application_id = 660 AND a.descriptive_flexfield_name = FLEX_LN;注冊鍵彈性域鍵彈性域的注冊如下圖 應(yīng)用：選擇注冊的應(yīng)用代碼：填寫注冊鍵彈性域的CODE（必須唯一，最多四個字符，在調(diào)用鍵彈性域必須使用的值）標(biāo)題：鍵彈性域的標(biāo)題，在今后的應(yīng)用中，此鍵彈性域?qū)诖翱跇?biāo)題上顯示在此定義的標(biāo)題內(nèi)容說明：表應(yīng)用：在注冊表，列時指定的應(yīng)用（appl_short_name）表名： 選擇注冊的表名稱結(jié)構(gòu)列：必須也是存在于注冊過的列，結(jié)構(gòu)列的意義就是存放鍵彈性域使用的是哪個段結(jié)構(gòu)的代碼唯一標(biāo)識列：是記錄鍵彈性域唯一的值，要找到健彈性域的具

18、體含義，必須通過此唯一標(biāo)識列定義鍵彈性域的段結(jié)構(gòu)，如下圖點擊“段”按紐 進行定義： 此處定義段結(jié)構(gòu)與說明性彈性域一致，在此不再多說。鍵彈性域的開發(fā)例子：/*在客戶化的用戶下*/* 鍵應(yīng)用表 */* Formatted on 2011/11/30 0:12:17 (QP5 v5.115.810.9015) */CREATE TABLE t_key_flex( key_id NUMBER, /* 鍵彈性域唯一值 */ age NUMBER, name VARCHAR2 (30), dept VARCHAR2 (30), TYPE VARCHAR2 (30);/* 創(chuàng)建存放鍵彈性域的結(jié)構(gòu)表 */*

19、Formatted on 2011/11/30 0:13:03 (QP5 v5.115.810.9015) */CREATE TABLE flex_ln_key( key_flex_structure_id NUMBER, key_flex_id NUMBER, summary_flag VARCHAR2 (1), /* 必須有此字段 */ enabled_flag VARCHAR2 (1), /* 必須有此字段 */ start_date_active DATE, /* 必須有此字段 */ end_date_active DATE, /* 必須有此字段 */ last_updated_by

20、NUMBER, /* 必須有此字段 */ last_update_date DATE, /* 必須有此字段 */ segment1 VARCHAR2 (30), segment2 VARCHAR2 (30), segment3 VARCHAR2 (30), segment4 VARCHAR2 (30), segment5 VARCHAR2 (30), segment6 VARCHAR2 (30), segment7 VARCHAR2 (30), segment8 VARCHAR2 (30), segment9 VARCHAR2 (30), segment10 VARCHAR2 (30), se

21、gment11 VARCHAR2 (30), segment12 VARCHAR2 (30), segment13 VARCHAR2 (30), segment14 VARCHAR2 (30), segment15 VARCHAR2 (30);/* 必須要創(chuàng)建一個與鍵結(jié)構(gòu)表對應(yīng)的序列 */ CREATE SEQUENCE FLEX_LN_KEY_S START WITH 1; -創(chuàng)建存放鍵彈性域表的對應(yīng)序列(鍵彈性域表名+_S) /*在公共用戶APPS下*/* 創(chuàng)建同義詞 */ /* Formatted on 2011/11/30 0:14:01 (QP5 v5.115.810.9015) *

22、/CREATE SYNONYM flex_ln_key FOR erp_dev.flex_ln_key;create synonym t_key_flex for erp_dev.t_key_flex ; create synonym flex_ln_key_s for erp_dev.flex_ln_key_s;/* 注冊鍵結(jié)構(gòu)表和字段 */execute ad_dd.register_table(EDV, FLEX_LN_KEY, T);execute ad_dd.register_column(EDV, FLEX_LN_KEY, KEY_FLEX_STRUCTURE_ID, 1, NUM

23、BER, 38, Y,N );execute ad_dd.register_column(EDV, FLEX_LN_KEY, KEY_FLEX_ID, 2, NUMBER, 38, Y, N );execute ad_dd.register_column(EDV, FLEX_LN_KEY, SEGMENT1, 3, VARCHAR2, 30, Y, N );execute ad_dd.register_column(EDV, FLEX_LN_KEY, SEGMENT2, 4, VARCHAR2, 30, Y, N );execute ad_dd.register_column(EDV, FLE

24、X_LN_KEY, SEGMENT3, 5, VARCHAR2, 30, Y, N );execute ad_dd.register_column(EDV, FLEX_LN_KEY, SEGMENT4, 6, VARCHAR2, 30, Y, N );execute ad_dd.register_column(EDV, FLEX_LN_KEY, SEGMENT5, 7, VARCHAR2, 30, Y, N );FORM程序語法:fnd_key_flex.define ( block = T_KEY_FLEX, - 操作的block field = KEY_FLEXITEM, - 創(chuàng)建的ite

25、m，用來容納鍵彈性域 id = KEY_ID, -保存key彈性域的唯一值 appl_short_name = EDV, code = K_LN, - 鍵彈性域的注冊代碼 num = 101 -);分別在BLOCK級別加入如下的觸發(fā)器（可參考說明性彈性域的應(yīng)用代碼）.PRE-QUERYPRE-UPDATEPRE-INSERTPOST-QUERYWHEN-NEW-ITEM-INSTANCEWHEN-VALIDATE-ITEMWHEN-VALIDATE-RECORD其觸發(fā)器的代碼分別對應(yīng)FND_FLEX.EVENT(PRE-QUERY );FND_FLEX.EVENT(PRE-UPDATE );F

26、ND_FLEX.EVENT(PRE-INSERT );FND_FLEX.EVENT(POST-QUERY );FND_FLEX.EVENT(WHEN-NEW-ITEM-INSTANCE);FND_FLEX.EVENT(WHEN-VALIDATE-ITEM);FND_FLEX.EVENT(WHEN-VALIDATE-RECORD);編寫FORM設(shè)置和彈性域加入非基表域用于容納彈性域,我們做一個ITEM叫 KEY_FLEXITEM注意這個ITEM的CLASS屬性為 TEXT_ITEM， LOV處選擇ENABLE_LIST_LAMP，并把檢查有效性設(shè)為NO。由下圖可以看出鍵彈性域的存放關(guān)系，在應(yīng)用表

27、里存放的是鍵唯一值，而在鍵結(jié)構(gòu)表中存放的是鍵結(jié)構(gòu)值（段結(jié)構(gòu)代碼和鍵唯一值） 備注說明：/*鍵彈性域的數(shù)據(jù)字典*/select * from fnd_id_flexs where id_flex_code=K_LN;select * from fnd_id_flex_segments_tl where id_flex_code=K_LN;select * from fnd_id_flex_segments where id_flex_code=K_LN;select * from fnd_id_flex_structures where id_flex_code=K_LN; select * f

28、rom fnd_id_flex_structures_tl where id_flex_code=K_LN;/*完全刪除鍵彈性域的語法*/-刪除鍵彈性域的結(jié)構(gòu)段DELETE FND_ID_FLEX_SEGMENTS_VL WHERE ID_FLEX_CODE = KFTV;-刪除鍵彈性域的結(jié)構(gòu)DELETE FND_ID_FLEX_STRUCTURES_VL WHERE ID_FLEX_CODE = KFTV;-刪除鍵彈性注冊DELETE FND_ID_FLEXS WHERE ID_FLEX_CODE =KFTV;范圍彈性域范圍彈性域是使用的鍵彈性域的一種擴展，其沒有專門的彈性注冊，全部來源于鍵

29、彈性域的結(jié)構(gòu)定義：應(yīng)用表CREATE TABLE flex_rang_ln( concatenated_segments_low VARCHAR2 (300), concatenated_segments_high VARCHAR2 (300), segment1_low VARCHAR2 (30), segment2_low VARCHAR2 (30), segment3_low VARCHAR2 (30), segment4_low VARCHAR2 (30), segment5_low VARCHAR2 (30), segment6_low VARCHAR2 (30), segment7

30、_low VARCHAR2 (30), segment1_high VARCHAR2 (30), segment2_high VARCHAR2 (30), segment3_high VARCHAR2 (30), segment4_high VARCHAR2 (30), segment5_high VARCHAR2 (30), segment6_high VARCHAR2 (30), segment7_high VARCHAR2 (30);需要說明點：segment_low和segment_high 是用來存放上，下范圍的段，在應(yīng)用表中必須出現(xiàn)，CONCATENATED_SEGMENTS_LO

31、W與 CONCATENATED_SEGMENTS_HIGH 也必須成對出現(xiàn)，因為在應(yīng)用腳本中，需要指定的/* 創(chuàng)建同義詞 */ CREATE SYNONYM FLEX_RANG_LN FOR ERP_DEV.FLEX_RANG_LN;fnd_range_flex.define( block= FLEX_RANG_LN, - 操作的block; field= RANGE_FLEX,- 創(chuàng)建的item，用來容納范圍彈性域（在form界面中無range_flex數(shù)據(jù)項，只有range_flex_low與range_flex_high數(shù)據(jù)項） data_field=CONCATENATED_SEGME

32、NTS,-保存范圍性域的值（concatenated_segments_low與 concatenated_segments_high的共同段名稱） appl_short_name= EDV, code= K_LN, - 鍵彈性域的注冊代碼 num= 101,- displayable= !ALL, updateable= !ALL, insertable= !ALL, allownulls= Y);使用范圍彈性域是不需要任何注冊表和字段的，因為其值就保存在應(yīng)用表中，引用的確實鍵彈性域的段結(jié)構(gòu)代碼說明： FIELD= RANGE_FLEX在FORM界面中，不存在RANG_FLEX的項，在此 泛指的是 RANG_FLEX_LOW與RANG_FLEX_HIGH兩個范圍性的項，用來加載范圍彈性域DATA_FIELD=CONCATENATED_SEGMENTS 在FORM界面中，不存在CONCATENATED_SEGMENTS的項，在此 泛指的是CONCATENATED_SEGMENTS_LOW與CONCATENATED_SEGME