BOS扩展服务组件制作方法.doc

BOS 扩展服务开发指导手册1Action服务扩展1.1 概要说明对BOS的Action进行扩展，需要提供两个组件：其一为Action配置组件，工程类型为ActiveX Control，BOS通过加载该控件，方便用户对Action需要的各种参数进行配置。Action公式可选参数列表、各个参数意义和最终公式组织方法，检验规则，完全由本组件提供、决定，BOS并不参与；如果不希望用户对Action参数进行配置，也可以不提供。另外一个为Action运行组件，工程类型ActiveX DLL，用来执行Action公式，完成预定的功能，这个组件必须提供1.2 创建配置组件配置组件的作用是提供一个最终用户交互界面，接受并返回用户对Action的要求。配置界面上所有可供用户配置的内容和配置方法必须由BOS扩展Action作者自行把握和提供。在1.5节附件所带示例中，我们提供了一个Action，允许用户隐藏几个菜单中的一个或几个。如图，该界面是示例配置组件的设计时刻界面截图：而下图是配置控件在运行时刻的界面截图：该控件必须实现的统一接口如下：上列图中显示的配置组件完整代码请参考1.5节的附件。必须实现的接口函数/属性如下表：函数/属性类型详细说明Action属性可读/写，String类型，用来设置/返回用户配置的Action表达式M_dctTableInfo属性只写，接受单据字段模板包M_Field属性只写，接受Action对应的当前字段模板M_vctClassTypeEntry属性只写，接受单据分录模板包M_dctClassType属性只写，接受单据属性数据包GetAction函数String类型，返回用户设置的Action表达式Initial方法提供接口给调用者，由其触发配置界面初始化FormulaCheck函数Boolean，检查最终用户设置的表达式是否合法，合法则返回真，BOS会接受用户的设置；不合法则应该返回假，BOS不会接受用户的设置1.3 创建运行组件运行组件的作用是根据当前单据内容，按照自定的规则解析用户配置好的Action表达式，并按照自定的执行逻辑执行。每个Action表达式可以完成的功能完全由运行组件决定，千变万化、大小随心。如对单据维护界面的控制、对单据数据修改等。注意：为了使注册到BOS上的Action能够适用于所有单据，请勿直接在运行组件中使用任何可能只存在于特定单据中的变量。如果需要这些变量，请要求Action表达式提供。必须实现的接口函数/属性如下表：函数/属性类型详细说明SetInterface方法接受插件代理组件，单据的模板和数据包都可以从中获取TransAction函数翻译Action表达式暂保留为用DoAction函数解析、执行Action的入口函数1.4 注册到BOS创建的Action如果需要在BOS中起到预期的作用，必须向BOS进行注册，暂时只能手工向表格ICClassAction中添加数据。该表关键字段描述：字段名类型长度Null详细说明FIDint4No编码，唯一，自定义的Action请指定大于100000的编码，避免和BOS内置的FID冲突FNamevarchar20No名称，系统通过FName和具体的Action关联，必须唯一，且无歧义FDescvarchar50No描述FSyntaxvarchar100No语法FParametervarchar7000No参数FTypesmallint2No类型，还未定义FSetComponentVarchar255No配置Action的控件名，可以为，表示不能由用户配置FRunComponentVarchar255No运行Action的组件名，如果为自行扩展的Act