Siebel常用User Property介绍 - 图文

SIEBEL常用USER PROPERTY介绍

日期 03/20/2012 作者 Coco_lia 版本 1.0 备注

Siebel_DR1_常用User Property介绍 Coco_lia 1 / 22

目录

目录 .................................................................................................................................................. 2 User Property .................................................................................................................................... 3

1. Applet User Properties .......................................................................................................... 3

1.1 CanInvokeMethod: MethodName .............................................................................. 3 1.2 Aspect User Property .................................................................................................. 4 1.3 Drilldown Visibility ...................................................................................................... 4 1.4 Hide List Column / Control .......................................................................................... 4 1.5 Others .......................................................................................................................... 4 2. Application User Properties .................................................................................................. 5 3. Business Component User Properties ................................................................................... 5

3.1 Field Read Only Field ................................................................................................... 5 3.2 BC Read Only Field ...................................................................................................... 6 3.3 State Model ................................................................................................................. 7 3.4 On Field Update Set n ................................................................................................. 8 3.5 On Field Update Invoke n ............................................................................................ 9 3.6 Deep Copy / Deep Delete n ......................................................................................... 9 3.7 Sequence field ........................................................................................................... 10 3.8 Sequence use max..................................................................................................... 10 3.9 Manager List Mode ................................................................................................... 11 4. Control User Properties ....................................................................................................... 12

4.1 View ........................................................................................................................... 12 4.2 Popup ........................................................................................................................ 12 5. Field User Properties ........................................................................................................... 13

5.1 Required .................................................................................................................... 13 5.2 Read Only .................................................................................................................. 14

附录1 Aspect User Property .......................................................................................................... 15

功能......................................................................................................................................... 15 使用方法 ................................................................................................................................. 15

1) Class选择 ................................................................................................................ 15 2) 在Applet层建立Default Aspect ........................................................................... 16 3) 在BC层建立Aspect Default Value ........................................................................ 17 4) 编译 ......................................................................................................................... 17 适用范围及注意点 ................................................................................................................. 18 附录2 Sequence Field .................................................................................................................... 18

功能......................................................................................................................................... 18 使用方法 ................................................................................................................................. 19

1) Detail BC .................................................................................................................. 19 2) 新建Sequence BC ................................................................................................... 20 3) 编译 ......................................................................................................................... 21 适用范围及注意要点 ............................................................................................................. 21 附录3 参考文档 ............................................................................................................................ 22

Siebel_DR1_常用User Property介绍 Coco_lia 2 / 22

User Property

? User Property作为Application、Applet、BC等的子属性，用以实现（或辅助实

现）某一特定的功能或者方法。

? 其适用范围非常普遍，最常用于以下几个对象：Applet/BC/Control/Field/List

column等。

? 针对某一类型的User Property，某一特定的BC上可以有多个，如：On Field

Update Invoke / On Field Update Set / Deep Copy / Deep Delete等。同一个类型的User Property若存在多个，其后用n区分即可，如 Deep Copy 1， Deep Copy 2，等等。

? 但是，序列n须遵循以下规则： ? ? ?

数字最好为连续的；

如果不连续，则两个数字之间的空挡不得大于9； 不得超过两位数，即n < 100。

以下，按照文档的指引，综合个人理解、及实际项目实践，一一罗列出各种User Property的功能、适用范围、及具体使用方法。未详细提及的部分，将会在日后的运用过程中逐渐更新、补充。

1.Applet User Properties 1.1CanInvokeMethod: MethodName

1.1.1 功能

CanInvokeMethod: MethodName，多用于对按钮的触发控制，如Copy Record、New Record，以及一些客户化的其他功能。

较为简单的按钮触发功能可以通过此User Property实现；某些较为复杂的逻辑需要通过代码中的“PreCanInvokeMethod”来代替实现。

1.1.2 使用方法

【Name】：CanInvokeMethod: MethodName（如Copy Record、New Record） 【Value】：Value or expression that returns TRUE or FALSE 当值、或条件表达式返回为真时，该方法（按钮）被触发。

Siebel_DR1_常用User Property介绍 Coco_lia 3 / 22

E.g.在某Applet上需要取消“新建”功能，用客户化的“批量添加分部”功能代替，并在批量添加分部后，需要对某一行记录进行复制，通过“复制记录”功能进行辅助，运用到如下3个User Property：

1.1.3 适用范围及注意要点

【Class】CSSFrame, CSSFrameList, and their subclasses

1.2 Aspect User Property

详见附录1

1.3 Drilldown Visibility

该功能已经逐渐被Drilldown Object下的Visibility Type属性代替，不再通过在Applet层写User Property的方法来实现。

1.4 Hide List Column / Control

待补充

1.5 Others

Appelt层可用的User Property还有如下多个类别，但使用较少，这里仅作列举：

? ? ? ? ? ? ? ? ? ? ?

ApplicationContextType Contact Relationship Type DataSourceBuscompName DefaultFocus User Properties Default Applet Method Disable Buscomp Hierarchy DisableDataLossWarning DisableNewRecord DocumentContextType

eGanttChart Busy Free Time Applet User Properties EnableStandardMethods

Siebel_DR1_常用User Property介绍 Coco_lia 4 / 22

? ? ? ? ? ? ? ? ? ? FINS Query Mode Disabled Method n High Interactivity Enabled Named Method n (Applet) NoDataHide Parent Id Field

Political Analysis Field Show Required n Visibility Type

WebGotoPlayerErrorPage WebGotoView

2.ApplicationUser Properties

? （在8.0版本之前需要在.cfg文件中进行某些参数设置，从8.0之后通过在

Application上写User Property的方式可代替实现相应功能； ? 常见的User Property有如下两类：

ClientBusinessServicen PDQDisabledViewn

3.Business ComponentUser Properties 3.1 Field Read Only Field

3.1.1 功能

通过BC上某一个字段，来控制该BC上另一个字段的只读状态；

3.1.2 使用方法

【Name】Field Read Only Field：Field Name

【Value】须为某一字段，且该字段的值返回为布尔值；

当该字段的值返回为真时，指定的字段只读；否则，为不只读；

Siebel_DR1_常用User Property介绍 Coco_lia 5 / 22

3.1.3 适用范围及注意要点

该属性对MVField无效；

在进行该属性设置时，注意Value须为另一字段，而非表达式之类；且该字段返回值须为布尔值；在进行该属性设置时须格外注意！

3.2 BC Read Only Field

3.2.1 功能

通过BC上某一个字段，来控制该BC上记录的只读状态；

3.2.2 使用方法

【Name】BC Read Only Field

【Value】须为某一字段，且该字段的值返回为布尔值；

当该字段的值返回为真时，该BC上对应的记录只读；否则，为不只读；

Siebel_DR1_常用User Property介绍 Coco_lia 6 / 22

3.2.3 适用范围及注意要点

? 如果对应的View上的“Admin Mode Flag”属性为真，则该UP属性不生效；

? 在进行该属性设置时，注意Value须为另一字段，而非表达式之类；且该字段返回值须

为布尔值；在进行该属性设置时须格外注意！ E.g.

【Field Name】BC Read Only Flag

【Value】IIf ([Created By Name] = LoginName(), \

3.3State Model

3.3.1 功能

如下图所示，在使用状态模型的时候需要选择“业务组件”。因此，须先启用该业务组件的“State Model”User Property，使得该业务组件具备状态模型属性，这是状态模型生效的一个重要前提条件。

3.3.2 使用方法

确认需要启动State Model属性的BC，在该BC上增加User Property，如下： 【Name】：State Model 【Value】：Y

Siebel_DR1_常用User Property介绍 Coco_lia 7 / 22

3.3.3 适用范围及注意要点

? 增加该User Property需要修改配置，因此建议在配置时提前做好统一规划，免得临时

启用需要编译、重启，增加工作量；

? 另外，State Model设置本身的增加、或修改亦需要重启整个应用方可生效，此点需格

外注意。

3.4On Field Update Set n

3.4.1 功能

通过BC上某一个字段的更新，来设定该BC上另一个字段的值；

3.4.2 使用方法

【Name】：On Field Update Set n 【Value】：\

? \：更新的字段，即以该字段为依据来设定另一个字段的值； ? \：需赋值的字段；

? \：当\更新后，\即被赋予预先定义好的值；预订该属性

为空，则\将被赋予\的值；

? \：设定的条件，即在满足该条件的情况下，以上字段方被赋值；该条件也可

为空；

3.4.3 适用范围及注意要点

? 对于\：不能为MVField，或者Calculated Field； ? 对于\：该字段不能基于MVG；

Siebel_DR1_常用User Property介绍 Coco_lia 8 / 22

此要求比上述\更为严格，要求该字段完全不能基于MVG； E.g. \

该\字段虽不为MVField，但是基于MVG，所以该UP定义依然失效，Email Address不会按照预期进行赋值；

? 由于该属性在一个BC上通常会设置多个，需要按照数字进行排序，对于数字的编码规

则也应尤为注意。详见前文说明；

3.5On Field Update Invoke n

待补充

3.6Deep Copy / Deep Delete n

3.6.1 功能

在复制、or删除某条记录的时候，借助Deep Copy / Deep Delete功能，可以实现对于子记录（存在1：M关系的父、子BC之间）的同时复制、or删除；即，该功能可以实现深度复制、or删除；

3.6.2 使用方法

【Name】Deep Copy / Delete n 【Value】Child BC Name

3.6.3 适用范围及注意要点

? 如果父、子BC属于同一个BC，则之间的这种关系必须通过Recursive Link User Property

来决定；待补充；

? 从目前的一般业务逻辑来看，Deep Copy和Deep Delete通常是配套使用的；

Siebel_DR1_常用User Property介绍 Coco_lia 9 / 22

? 由于该属性在一个BC上通常会设置多个，需要按照数字进行排序，对于数字的编码规

则也应尤为注意。详见前文说明；

3.7Sequence field

详见附录2

3.8Sequence use max 3.9.1 功能

用于决定序列字段的值是否从当前记录的最大序列数开始；

3.9.2 使用方法

【Name】Sequence Use Max 【Value】Y

? 如果该属性为Y，则新建记录的序列为现有所有记录中最大序列数+1； ? 如果该属性为N，或并未进行此项属性设置，则新建记录的序列为当前记录的序列数+1；

3.9.3 适用范围及注意要点

? 此功能一般和“Sequence Field”配套使用；

Siebel_DR1_常用User Property介绍 Coco_lia 10 / 22

3.9Manager List Mode

3.9.1 功能

? 如果在某个视图中启用了MVField的“Manager”安全性，该User Property进一步决定

该视图中数据的开放权限：

仅主要职位的相关上级职位具有数据查看权限（Primary）； 或者所有职位的相关上级职位都具有数据查看权限（Team）；

3.9.2 使用方法

【Name】Manager List Mode 【Value】Primary / Team

? 其Value为Primary时，仅主要职位的相关上级职位具有数据查看权限； ? 反之，当Value为Team时，所有职位的相关上级职位都具有数据查看权限；

3.9.3 适用范围及注意要点

? 如果仅仅需要对MVField的Primary职位进行该类安全性设置，不启用该属性也可达到

效果；该属性主要用于Value为“Team”的情况；

? 注意：因为MVField的跨职位安全性，相互之间存在多种相互交错的报告关系，较为复

杂。启用该功能后，通过SQL在数据库查询数据，其响应时间为不启用时的3倍左右； ? 因此，在优先考虑系统性能的前提下，建议通过别的方式实现同样的效果，不推荐启用

此User Property。

Siebel_DR1_常用User Property介绍 Coco_lia 11 / 22

4.ControlUser Properties 4.1 View

4.1.1 功能

通过Applet标题进行超链接，一般用于首页等展示界面；

4.1.2 使用方法

? 首先对Control“Applet Title”进行如下设置：

? 然后，在该Control下设置User Property： 【Name】View

【Value】View Name

4.2 Popup

4.2.1 功能

? 可以在某按钮上设置弹出窗口；

? 业务场景：在审核界面，审核人员通常需要参考相应的数据，可通过此种方式弹出报表

或其他界面，以供审核使用；

Siebel_DR1_常用User Property介绍 Coco_lia 12 / 22

4.2.2 使用方法

? 首先对Control，如“Refuse”进行如下设置：

? 然后，在该Control下设置User Property：

【Name】Popup

【Value】Applet Name

? 其中，Popup Dimension属性可以控制弹出窗口的大小；此属性也可以通过管理-集成>WI

符号URL列表中进行全屏设置；

5.FieldUser Properties 5.1 Required

5.1.1 功能

该User Property用于对BC上某字段进行设定条件的必输限制；当然，无条件限制的也可以此种方法进行设置；

5.1.2 使用方法

【Name】Required

【Value】条件表达式；

Siebel_DR1_常用User Property介绍 Coco_lia 13 / 22

当该条件成立时，该字段必输；否则，不必输；

5.1.3 适用范围及注意要点

? BC的Class须为CSSBCBase；

? 当Class为CSSBusComp，以上该User Property设置无效；

5.2 Read Only

5.2.1 功能

该User Property用于对BC上某字段进行设定条件的只读；当然，无条件限制的也可以此种方法进行设置；

5.2.2 使用方法

【Name】Read Only 【Value】条件表达式；

当该条件成立时，该字段只读；否则，不只读；

5.2.3 适用范围及注意要点

暂无

Siebel_DR1_常用User Property介绍 Coco_lia 14 / 22

附录1Aspect User Property

功能

? 基于同一BC的不同Applet，每个Applet显示不同类型的业务数据。

如，基于Account的经销商、零售商、分销商、门店等；或基于Program Container的产品推广项目、主题促销项目等；

? 因此需要对不同的Applet设置不同的默认值，并通过Search条件筛选，以达预期效果。

使用方法

1)

Class选择

? ?

该BC 基类一定要是CSSBCBase

List Applet基类一定要是：CSSFrameListBase，不能为其Super Class； E.g.经试验，某List Applet其class为CSSFrameList，无效果~更改为CSSFrameListBase，方有效。 ?

相应的Form Applet的基类应该是：CSSFrameBase

P.S.

如果是新建的对象，可以采取上述方式；

如果是基于系统原有的对象，则先用其原Class，如果不行，则顺次去找其Super Class。

Siebel_DR1_常用User Property介绍 Coco_lia 15 / 22

2) 在Applet层建立Default Aspect

? ?

在Applet User Property上分别建立Default Aspect，value可以为显示值，也可以自定义；

在其他Applet层分别作如上定义；

?

Siebel_DR1_常用User Property介绍 Coco_lia 16 / 22

3) 在BC层建立Aspect Default Value

?

找到该BC上相应Field，在其Field User Property建立几条Aspect Default Value，分别对应相应的Applet层，其Value表达式应为不同Applet上的默认值。

如下图所示：

4) 编译

根据具体的业务需求，在相应的Applet层写Search条件进行数据筛选，编译以上所有对象，即可！

Siebel_DR1_常用User Property介绍 Coco_lia 17 / 22

适用范围及注意点

? ?

该默认值的设置对于相应BC、List Applet、Form Applet的Class要求极为精准，需要逐一检查，核对无误！

另外，在Applet层、BC层写User Property时，应注意，尽量不出现数字、空格等现象！（谨遵技术顾问Ysisl谆谆教导，有待进一步验证！总之谨慎行事总是没错啦！）

附录2Sequence Field

功能

? 具有1：M Link关系的父、子BC（此处统一称为：Master BC、Detail BC），在该子BC

Siebel_DR1_常用User Property介绍 Coco_lia 18 / 22

下新建记录时通常需要按照一定的序列；

? 因此，需要在该Detail BC上定义一个序列字段，使得新建记录时可以自动产生数字，

并依次排列。

使用方法 1) Detail BC

a) Class——CSSBCBase or subclass of CSSBCBase

即：其super class为CSSBCBase，也可以！ 【class选择有误，可能会产生序号字段为空值；】

b) 在该BC上新建两个Field：

Field 1：Line Number or Order【名字可以自定义】； Type：DTYPE_NUMBER；

对应Column的类型：Number

Field 2：用于建立与头BC之间的Link关系，通常该字段我们在前期的准备工作中已经建立完毕，此时只需确认无误即可；

c) 在BC User Property下新建：

Name——Sequence Field【固定】

Value——上述Field 1的name【固定】

Siebel_DR1_常用User Property介绍 Coco_lia 19 / 22

d) 添加该BC到相应BO，建立Link1（该Link称之为Main Link），即Master BC和Detail

BC的关系

2) 新建Sequence BC

a) Name——xx.yy (Sequence)【xx是Detail BC的名字，yy是以上Field 1的名字】； b) Sort Specification——Sequence (DESCENDING)

【如果此处属性不更改，则新建的所有记录序号默认为1；或者如为Asc，则新建记录序号为2；】

c) Class——CSSSequence

d) 新建两个Field

Field 3：Name—Suquence【固定】,Type：DTYPE_NUMBER；Column：Number； 同Field 1所对应的Column；

Field 4：Foreign Key Field，即用于和Master BC建立Link， 同Field 2所对应的Column

Siebel_DR1_常用User Property介绍 Coco_lia 20 / 22

e) 添加该BC到相应BO，建立Link2（该Link称之为Sequence Link），即Sequence BC和

Master BC的关系

f) 在Detail BC对应的Applet上添加该List Column，即序列字段（注意，该字段一般设置

为只读）。

3) 编译

编译以上所有对象，即可！

适用范围及注意要点

? ? ?

Sequence BC上的Sort Specification需要填写，如果不写，则出现的所有记录序号都默认为1，而非自动排序！

另外，除了BC的Class，view上的Admin Mode Flag等可能也会sequence BC上的Sort Specification，如果出现问题，需要逐一检查！

弊端：现有记录一旦被删除，则在数列排序中会出现断号的情况，并且在下次新建记录时，其gap不会立马被填充，而是从当前最大的序号排列（E.g.现有序号为1、2、3的记录，如果将记录2删除，则新建记录时，则序号默认为4）；如果业务上特别强调数字的连续性，需要将该字段设置为非只读，手动修改，以避免gap出现！【注：标准功能“销售订单”、“服务订单”模块中不存在此种现象。在订单模块中，任何情况下，现有数据被删除，则其他记录的序号将会自动排列，填补该gap，不会出现断号的情况。目前尚未查明具体的配置方法，有待进一步补充。】

Siebel_DR1_常用User Property介绍 Coco_lia 21 / 22

附录3 参考文档

? Siebel Developer’s Reference > User Property ? Configuring Siebel Business Applications>Configuring

Components>Configuring Fields>Creating Sequence Fields

Business

? 另，具体实例请参照标准功能“销售订单”or“服务订单”部分之“行项目”

“行号”等字段；

Detail BC：Order Entry - Line Items

Sequence BC：Order Entry - Line Items.Line Number (Sequence) Applet 1：Order Entry - Line Item List Applet

Applet 2：Order Entry - Line Item List Applet (Sales)

另，关于Hide List Column / Hide Control的功能一直实践未果，恳求各位协助、补充！

Siebel_DR1_常用User Property介绍 Coco_lia 22 / 22

本文来源：https://www.bwwdw.com/article/91k3.html