FORM个性化

Form
个性化控制讲义
Kenver(译)

纲要：
概述
如何使用 Form
个性化控制
转移个性化设计至其他环境

1.
概述
Form
个性化允许您修改基于Form
基础页面的事件，包括：修改物件的属性、执行内建函数、产生提示信息和添加标签入口。
对于每个功能（需在功能处指定上下文条件，相应的Form才能执行）来说，您可以制定一个或一个以上的规则。每条规则包括：一个事件，事件执行的条件（可选），事件执行的范围，一个或多个动作。

Form上的一个Trigger
就是一个事件。例如，开启页面的Trigger
（WHEN-NEW-FORM-INSTANCE），或者光标从一条记录移至另一条新的记录所触发的Trigger
（WHEN-NEW-RECORD-INSTANCE）等等，这几乎是每个Form
传送资料都必须执行的，或者确认传送资料附加的事件。
若指定了事件执行的范围，当Form
在运行的时候，系统会去检查当前的规则是否可执行。事件执行的范围有以下层级：Site、Resoponsibility、User、Industry，每个规则可有相应层级的执行范围与之相关联。
注：Industry
层级的执行范围指的是为下一版本预留。

事件执行的条件是一段SQL
语句，来控制事件在何时执行。只有在执行条件的返回结果是真时，该时间才会执行。

一个动作包含以下的任意一项内容：
²
设置属性，如：设置一个栏位状态为必输，隐藏一个Tab
页签等。
²
执行内建函数，如：GO_BLOCK，DO_KEY，FND_FUNCTION.EXECUTE
等。
²
显示提示信息。
²
呼叫一个特殊标签入口。

规则一旦建立，当目标功能执行时，这些规则会被系统视为Form
里的一个事件，并且会自动执行。
2.
如何使用Form
个性化控制
要创建一个个性化控制，首先要进入到目标功能Form
，然后按下拉菜单 Help
àDiagnotics
à Custoner Code
àPersonalize
。若该下拉菜单不可见，请检查系统Profile
设定选项：FND_HIDE_DIAGNOSTICS(Hide Diagnostics menu entry)
和DIAGNOSTICS (Utilities:Diagnostics)。
进入到个性化控制页面时，系统会罗列当前功能页上已定义的规则。您若做了修改，请保存然后重新进入该功能页，这样所做的改动才能生效。您也可以按下按钮‘Validate’和‘Apply’，分别来验证修改的值和快速查看所做改动的执行结果，而不必重新进入功能页。



个性化设置的界面（当前功能页：FND_FNDSCAUS，FORM：FNDSCUS）
每个规则包含的栏位：

Seq
：对应规则的序号。值从1-100，序号可重复，值小的优先执行。
Description
：描述，可用于注明当前规则的用途。
Enable：勾选时当前规则才有效。

定位至Condition页签有如下栏位：

Trigger Event
：选择规则执行的Trigger
，您可以从LOV
中挑选，或者自己键入当前Form
还未用到的Tirgger，该栏位是复合型的，可从LOV挑选，也可自己输入。个性化规则会先匹配事件，然后按序号顺序执行。

Trigger Object
：选择对象。对象的挑选值依赖Trigger Event，根据不同的Trigger
Event 其状态亦不同。即，可能是不可输入的，也可能是必须输入的。例如，如果你挑选的Trigger Event
是
WHEN–NEW–ITEM–INSTANCE
，此时您必须输入一个 Trigger Object
。

Condition：这个栏位是选择性输入的SQL
语句段，只有SQL
语句段返回值是真，个性化定义的动作才会执行。条件可包含如下内容：
²
SQL
函数和运算子，如AND
、OR
、TO_CHAR
、DECODE
和 NVL
等。
²
关联到Form
某个字段（:Block.feild），包括：:System,
:Globle, :parameter 。
²
调用服务器上没有外部参数的函数。
输入的判断条件语法上必须是正确的，可按下按钮‘Validate’来检查语法的正确性。若语法上有错误，系统会弹出一个错误信息提示框警示出错的部分。
一些判断条件的例子：

条件	备注
:users.user_name is not null and :users.description is null	个性化规则动作执行的条件，User_name不为空，且 Description 为空
sysdate >= to_date(‘1-1-2005’, ‘DD- MM-RRRR’)	个性化规则动作执行的条件，系统日期大于等于2005年1月1号

Processing Mode
：设定执行的模式。Not-in-Entry-Query-Mode，查询模式下不使用个性化规则；
Only-in-Entry-Query-Mode
，仅在查询模式下使用个性化规则；BOTH,
两种状态下都使用个性化规则。
Level
：个性化规则执行的层级。
Value
：层级的值。
定位至Actions页签有如下栏位：



Seq
：个性化规则动作的序号，值从1-100，序号可重复，值小的优先执行。

Type
：个性化规则动作的类型，包括：（1）Property
即物件的属性。（2）Buildtin
即Form
的内建函数如：GO_BLOCK，DO_KEY
等。（3）Message
即提示消息。（4）Special
呼叫一个下拉菜单入口，定义其标签，已经在哪个Block
可激活。
Discription：用于注明当前个性化动作的用途。
Language：个性化规则动作执行的语言环境
Enable
：勾选该个性化动作才有效。

以下按钮出现依赖于Type
栏位的挑选值：

Add Parameter，出现时机：Type为
Builtin ，挑选值为FND_FUNCTION.EXECUTE
。
Add Block，LOV
挑选Block
的名字。
Add Item，LOV
挑选Item
的名字。

下图区域依Type
挑选值为Property
时出现。



Select By Text
…
快速需找某个栏位名表述方式。

Object Type
：物件类型。如：Item
，Block
，Window
，Tab
，Canvas
，Radio Button，View，
Globle
，Parameter
。

Target Object
：目标物件。指定当前个性化动作的执行对象，即指定要针对哪个物件进行动作设定。

Property Name
：属性名。指定物件的属性。

Value
：给出物件属性值。

Get Value
：取得当前对象属性值。

下图区域依Type
挑选值为Message
时出现。



Message Type
：用于设定提示信息的类型。'Show', 'Hint', ‘Warn’,'Error',
和‘Debug’。值得注意的是，若消息类型挑选了‘Warn’或
'Error', 当您按下按钮 ‘Cancel ’
时，系统会执行 form_trigger_failure
这个Trigger
，以阻止Form
继续执行。‘Debug’
类型的 message
只有页面上的 Show Debug Message
这个复选框勾选才会显示。

Message Text
：提示消息的内容。

下图区域依Type
挑选值为Builtin
时出现。



Builtin Type
：指定所使用的内建函数。
Argument
：内建函数所使用的参数。

当Builtin Type
为FND_FUNCTION.EXECUTE时，会出现以下区域。



Function Name
：指定要执行的函数。
Parameters
：执行函数的参数。

下图区域依Type
挑选值为Special
时出现。



Menu Etry
：指定下拉菜单的入口。由3个集组成。每个集15个，挑选不同的集，下拉标签将出现在不同的下拉菜单位置上。若你挑选了Form
已有的Menu并且创建了个性化控制,那么所创建的个性化规则将改写Form原有的菜单入口功能。

Menu Lable
：标签的标示符。

Render Line Before Menu
：若勾选，在标签上方会出现一条直线以做区隔所用。

Enable In Block
：在哪个Block
标签被激活。

Icon Name
：若需要在工具栏上添加一个图形（功能与点击对应下拉菜单的标签相同），则可以在此指定图形的名称。

每个属性值输入的字符串可能直接被引用，也可能个性化规则在运行时才被检查。（取决于字符串是否以”=
”开头）
不以”=”开头，值在个性化规则运行时直接被引用。
以”=”开头，值在个性化规则运行时被检查，允许添加上下文逻辑，如：
ü
SQL
运算子：||，TO_CHAR，DECODE，和
NVL
ü
绑定变量值：（:Block.Field），:System,:Globle,:Parameter

ü
调用服务器上的函数。
ü
Select
语句，但必须遵循以下条件：
u
需以’ = SELECT’
开头。
u
查询值结果必须为字符型的，且长度不超过2000个字节。
u
所查询的栏位的别名需给“A”。
u
语句段的查询结果集不超过一行，若超过一行，只有第一行被使用。

使用“=”的一些例子：

输入的字符	执行结果
='Your password will expire on '||(sysdate+7)	Your password will expire on 2007-12-28 (假设系统日期为2007-12-21)
='Your password must have at least '||:global.password_length||' characters.'	Your password must have at least 8 characters。 （假设该Global项的值长度为8）
=’Your password isn’’t valid.’	Your password isn’t valid.
=:items.part_number	{栏位=:items.part_number 的值}
=SELECT meaning A from fnd_lookups where lookup_type = 'DAY_NAME' and lookup_code = 'SAT'	Saturday {假设系统作业是在英文环境下执行}
=SELECT 'The office is closed on '||meaning A from fnd_lookups where lookup_type = 'DAY_NAME' and lookup_code = 'SAT'	The office is closed on Saturday {假设系统作业是在英文环境下执行}

3. 转移个性化设计至其他环境上
在测试环境上设计并且通过测试的个性化规则，可通过以下办法快速转移至新的环境。
（1）
下载页面配置命令

FNDLOAD <userid>/<password> 0 Y DOWNLOAD$FND_TOP/patch/115/import/affrmcus.lct

<filename.ldt> FND_FORM_CUSTOM_RULESfunction_name=<function name>
注：<function name>
是该命令必须给出的参数，若不给则不会产生ldt
档。
（2）
上传页面配置命令

FNDLOAD <userid>/<password> 0 Y UPLOAD$FND_TOP/patch/115/import/affrmcus.lct

<filename.ldt>